Skip to main content
Lista las conversaciones de la cuenta. Puedes filtrar por asignado a mí, sin asignar, estado (open/resolved/pending/snoozed), inbox, equipo, etiquetas o término de búsqueda en mensajes.

​
Autenticación

​
api_access_token
string
required
Token de usuario (userApiKey).

​
Parámetros de ruta

​
account_id
integer
required
ID de la cuenta.

​
Parámetros de consulta

​
assignee_type
string
default:"all"
Filtro por asignación: me, unassigned, all, assigned.
​
status
string
default:"open"
Estado: all, open, resolved, pending, snoozed.
​
q
string
Término de búsqueda en el contenido de los mensajes.
​
inbox_id
integer
Filtrar por ID de inbox.
​
team_id
integer
Filtrar por ID de equipo.
​
labels
array
Lista de etiquetas (strings).
​
page
integer
default:"1"
Número de página.

​
Ejemplo de solicitud

curl -X GET 'https://app.yampi.ai/api/v1/accounts/1/conversations?status=open&assignee_type=unassigned&page=1' \
  -H 'api_access_token: TU_TOKEN' \
  -H 'Content-Type: application/json'

​
Respuesta exitosa

Objeto con lista de conversaciones según el esquema conversation_list del OpenAPI (payload de conversaciones y metadatos de paginación).

​
Errores

  • 400: Bad Request — parámetros inválidos.
  • 401: No autenticado.