Funnelchat APISuscripciones de webhooks
Una suscripción le indica a Funnelchat a qué URL HTTPS enviar, con un POST firmado, los eventos que elegiste en events, de cualquiera de las tres áreas: por ejemplo message.received, group_participant.joined o device.disconnected.
Una suscripción le indica a Funnelchat a qué URL HTTPS enviar, con un POST firmado, los eventos que elegiste en events, de cualquiera de las tres áreas: por ejemplo message.received, group_participant.joined o device.disconnected. Tiene un solo secreto, que se muestra una única vez al crearla, y un solo historial de entregas. Con una clave, cada evento pide además el permiso de lectura de su área. Empezá por Crear un webhook y verificá cada entrega con la cabecera X-Funnelchat-Signature.
Endpoints
Crear un webhook
POST /api/v1/webhooks · Sirve para empezar a recibir eventos en tu sistema: elegís la URL y los eventos de cualquiera de las tres áreas, y guardás el secreto de firma, que se muestra solo esta vez.
Listar webhooks
GET /api/v1/webhooks · Usalo para revisar a qué URLs le está mandando eventos tu cuenta y en qué estado está cada suscripción.
Ver un webhook
GET /api/v1/webhooks/{id} · Usalo para ver la configuración de una suscripción: URL, eventos, filtros y estado.
Actualizar un webhook
PUT /api/v1/webhooks/{id} · Sirve para cambiar la URL, los eventos, la descripción o los filtros de una suscripción, o para pausarla y reactivarla.
Eliminar un webhook
DELETE /api/v1/webhooks/{id} · Usalo para dejar de recibir los eventos de una suscripción; se borran también su historial de entregas.
Enviar un evento de prueba
POST /api/v1/webhooks/{id}/test · Sirve para probar tu receptor y tu verificación de firma con una entrega firmada, sin esperar a que pase algo en tu cuenta.
Listar entregas de un webhook
GET /api/v1/webhooks/{id}/deliveries · Usalo para depurar tu receptor: ves cada intento de entrega de una suscripción, con su resultado.
Listar tipos de evento
GET /api/v1/webhooks/events · Usalo para conocer el catálogo de eventos de la cuenta y sus números, cuáles ya se emiten y cuáles están planificados, con un ejemplo del cuerpo de cada uno.
Suscripciones
Una suscripción recibe eventos de las tres áreas: mensajes y contactos, grupos, y cuenta y números.
Crear un webhook POST
Sirve para empezar a recibir eventos en tu sistema: elegís la URL y los eventos de cualquiera de las tres áreas, y guardás el secreto de firma, que se muestra solo esta vez.