# Obtener Todos los Contactos

### 🔍 Obtener la Bandeja de Entrada de Usuarios

Este endpoint permite recuperar datos de usuarios desde la bandeja de entrada, ofreciendo diversas opciones de filtrado para personalizar la consulta.​

* **🛠️ URL del Endpoint:**

```
https://api.v7.express-chat.com/inbox/users
```

* **📨 Método HTTP:**\
  `POST`​

#### 🛡️ Encabezados de la Solicitud

Se requiere un token Bearer válido para la autenticación.​

* **Authorization:**\
  `Bearer [TU_TOKEN]`​

*Nota:* Reemplaza `[TU_TOKEN]` con tu token de API válido.​

#### 📝 Cuerpo de la Solicitud

El cuerpo de la solicitud debe ser un objeto JSON que contenga diversos criterios de filtrado para personalizar la consulta. A continuación, se detallan los campos disponibles:​

* **searchText** *(string)*:\
  Texto de búsqueda para filtrar usuarios.​
* **tags** *(array)*:\
  Un array de etiquetas para filtrar usuarios.​
* **status** *(array)*:\
  Un array de valores de estado para filtrar usuarios.​
* **isOnline** *(boolean)*:\
  Indica si los usuarios están en línea.​
* **\_botWebsite** *(array)*:\
  Filtra usuarios basados en interacciones en el sitio web.​
* **\_botWhatsapp** *(array)*:\
  Filtra usuarios basados en interacciones en WhatsApp.​
* **\_botTelegram** *(array)*:\
  Filtra usuarios basados en interacciones en Telegram.​
* **\_botFacebook** *(array)*:\
  Filtra usuarios basados en interacciones en Facebook.​
* **\_agentAssigned** *(array)*:\
  Filtra usuarios asignados a agentes específicos.​
* **segments** *(array)*:\
  Un array de segmentos para filtrar usuarios.​
* **applicableFilters** *(array)*:\
  Un array de filtros aplicables.​
* **lastSeenAt** *(objeto)*:\
  Filtro de rango de fechas para la última vez que se vio al usuario.​
* **createdAt** *(objeto)*:\
  Filtro de rango de fechas para la fecha de creación.​
* **userInteracted** *(boolean)*:\
  Indica si los usuarios han interactuado.​
* **lastMessageBy** *(array)*:\
  Filtra usuarios basados en el remitente del último mensaje.​
* **isLiveChatActive** *(boolean)*:\
  Indica si el chat en vivo está activo para los usuarios.​
* **hasOrdered** *(objeto)*:\
  Filtra usuarios basados en su historial de pedidos.​

#### 🧪 Ejemplo de Solicitud

```bash
bashCopiarEditarcurl 'https://api.v7.express-chat.com/inbox/usersinbox/users' \
  -X 'POST' \
  -H 'Authorization: Bearer [TU_TOKEN]' \
  -H 'Content-Type: application/json' \
  -d '{
    "searchText": "",
    "tags": [],
    "status": [],
    "isOnline": false,
    "_botWebsite": [],
    "_botWhatsapp": [],
    "_botTelegram": [],
    "_botFacebook": [],
    "_agentAssigned": [],
    "segments": [],
    "applicableFilters": ["userInteracted"],
    "lastSeenAt": {
      "startAt": "",
      "endsAt": ""
    },
    "createdAt": {
      "startAt": "",
      "endsAt": ""
    },
    "userInteracted": true,
    "lastMessageBy": [],
    "isLiveChatActive": false,
    "hasOrdered": {
      "status": false,
      "lastAt": ""
    },
    "page": 1,
    "isExport": "none",
    "isContact": true
  }' \
  --compressed
```

*Nota:* Reemplaza `[TU_TOKEN]` en la solicitud con tu token de API real y personaliza los filtros del cuerpo de la solicitud según tus necesidades específicas.​

#### 📬 Respuesta

La API responderá con un objeto JSON que contiene los datos de los usuarios basados en los filtros aplicados. El formato de la respuesta puede variar dependiendo de los datos disponibles y los filtros aplicados.​

{% hint style="info" %}
*Nota:* Asegúrate de manejar adecuadamente la respuesta y considerar posibles paginaciones si el número de resultados es grande.
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://recursos.demandu.tech/guia-de-productos-y-formacion/contactos-y-chat-api/obtener-todos-los-contactos.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.