Chatbot de IA
Listar conversaciones
Lista todas las conversaciones del usuario autenticado con filtrado y paginación por cursor
GET
Este endpoint devuelve una lista paginada por cursor de las conversaciones que pertenecen a los asistentes del usuario autenticado. Úsalo para consultar el historial de conversaciones, filtrar por tipo o integrar con tu CRM.
Este endpoint usa paginación basada en cursor para un mejor rendimiento con grandes volúmenes de datos. Usa
next_cursor y prev_cursor para navegar entre páginas.Parámetros de consulta
string
Filtra las conversaciones por tipo. Valores posibles:
test, widget, whatsapp, apiinteger
Filtra las conversaciones por ID de asistente (debe pertenecer al usuario autenticado)
string
Filtra las conversaciones por el número de teléfono del cliente (coincidencia exacta). Útil para encontrar todas las conversaciones con un cliente concreto.
string
Filtra las conversaciones por el número de teléfono del expedidor de WhatsApp (coincidencia exacta). Útil para encontrar todas las conversaciones de un número de WhatsApp Business concreto.
string
Filtra las conversaciones por un identificador externo. Útil para encontrar conversaciones vinculadas a registros de tu sistema externo.
integer
Número de conversaciones por página (1-100, predeterminado: 15)
string
Cursor de paginación. Usa
next_cursor o prev_cursor de una respuesta anterior.Campos de respuesta
array
string
Cursor para obtener la siguiente página de resultados. Pásalo como parámetro
cursor en tu próxima solicitud. null si no hay más resultados.string
Cursor para obtener la página de resultados anterior.
null si es la primera página.integer
Número de elementos por página
Tipos de conversación
Parámetros de filtrado
Todos los parámetros de filtrado usan columnas indexadas para consultas eficientes:Detalles de las conversaciones de WhatsApp
En las conversaciones de WhatsApp, la respuesta incluye campos adicionales:- whatsapp_sender: el número de WhatsApp Business que llevó la conversación (nombre y número de teléfono de tu expedidor de WhatsApp)
- customer: el cliente que inició o recibió la conversación (su nombre y número de teléfono)
whatsapp y ayudan a identificar a las partes implicadas al integrar con tu CRM o tus sistemas de soporte.
Detalles de las conversaciones de API
En las conversaciones creadas a través de la API, puedes definir unexternal_identifier al crear la conversación. Este identificador se devuelve en la respuesta y puede usarse para:
- Vincular conversaciones con tus leads o contactos de CRM
- Hacer seguimiento de conversaciones a través de tus sistemas internos
- Filtrar conversaciones por tu referencia externa
Casos de uso
- Panel de analítica: mostrar métricas y tendencias de conversaciones
- Integración con CRM: sincronizar datos de conversación con tu base de clientes usando
external_identifier - Búsqueda de clientes: encontrar todas las conversaciones con un cliente concreto mediante
customer_phone - Control de calidad: revisar el volumen de conversaciones por tipo y por asistente
- Auditoría de facturación: hacer seguimiento de los costes de conversación dentro de tu organización