Funnelchat APIConversaciones
Una conversación es el chat de WhatsApp entre tu negocio y un contacto: puede estar activa o no (active_conversation), asignada a un asesor, marcada como favorita o sin leer, y la atiende uno de tus números.
Una conversación es el chat de WhatsApp entre tu negocio y un contacto: puede estar activa o no (active_conversation), asignada a un asesor, marcada como favorita o sin leer, y la atiende uno de tus números. Acá podés listarlas con filtros, contarlas, gestionarlas traer el historial de mensajes de un contacto y ver un mensaje por su id, por ejemplo el que te devolvió un envío. Para armar tu propia bandeja, empezá por Listar conversaciones con updated_since.
Endpoints
Listar conversaciones
GET /api/v1/conversations · Usalo para construir tu propia bandeja de entrada o sincronizar conversaciones: filtrá por número, asesor, etiquetas, etapa del kanban, no leídas o lead score, y traé solo lo nuevo con updated_since.
Contar conversaciones sin leer
GET /api/v1/conversations/count/unread · Sirve para mostrar un contador de conversaciones sin leer, por ejemplo en un badge o tablero, filtrable por asesores o favoritas.
Contar conversaciones abiertas
GET /api/v1/conversations/count/open · Usalo para medir la carga de trabajo actual: cuántas conversaciones abiertas hay, en total o por asesor.
Contar conversaciones cerradas
GET /api/v1/conversations/count/closed · Sirve para contar las conversaciones cerradas, por ejemplo para métricas de atención por asesor.
Contar todas las conversaciones
GET /api/v1/conversations/count/all · Usalo para obtener el total de conversaciones, como base para calcular la proporción de abiertas, cerradas o sin leer.
Marcar todas como leídas
POST /api/v1/conversations/mark-all-read · Sirve para poner en cero los no leídos de una vez, por ejemplo cuando ya atendiste por otro canal; se puede acotar por asesores o favoritas.
Marcar todas como no leídas
POST /api/v1/conversations/mark-all-unread · Usalo para volver a marcar como no leídas las conversaciones de un conjunto (por asesores o favoritas) y que el equipo las retome. Tiene un tope y la respuesta avisa si se alcanzó.
Actualizar la conversación de un contacto
PUT /api/v1/contacts/{contact}/update · Sirve para gestionar la conversación con un contacto: asignarla a un asesor, abrirla o cerrarla, marcarla como favorita o no leída, o cambiar el número que la atiende.
Enviar un mensaje a un contacto
POST /api/v1/contacts/{contact}/message · Usalo para enviarle a un contacto un mensaje de texto o un archivo desde uno de tus números, con opción de responder a un mensaje previo, sumar opciones o vista previa de link.
Listar los mensajes de un contacto
GET /api/v1/contacts/{contactId}/messages · Sirve para traer el historial de mensajes de un contacto y mantenerlo sincronizado en tu sistema, con paginación por cursor y updated_since para pedir solo lo nuevo.
Ver un mensaje
GET /api/v1/contacts/{contact}/messages/{message} · Usalo para saber qué pasó con un mensaje que enviaste: con el id que te devolvió el envío ves su estado (en cola, enviado, entregado, leído o fallido) y, si falló, el motivo.
Referencia
Todos los endpoints de la API v0, con las piezas primero, ejemplos en varios lenguajes y prueba en vivo.
Listar conversaciones GET
Usalo para construir tu propia bandeja de entrada o sincronizar conversaciones: filtrá por número, asesor, etiquetas, etapa del kanban, no leídas o lead score, y traé solo lo nuevo con updated_since.