Skip to main content
GET
API de Famulor 1.0 (legado). Esta página se aplica únicamente a Famulor 1.0 (app.famulor.de) y se conserva por compatibilidad. Para la plataforma actual, usa la referencia de la API de Famulor 2.0.
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, api
integer
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)
Estos campos solo están presentes en conversaciones de tipo 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 un external_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