Visión general
La API REST permite leer y escribir datos de la plataforma (contactos, conversaciones, mensajes y más). La autenticación usa un token de acceso, y los webhooks entregan eventos a tu sistema en tiempo real.
Requisitos previos
- Un token de acceso válido.
- Un endpoint HTTPS para recibir webhooks.
Paso a paso
- Genera un token de acceso en la configuración.
- Incluye el token en el encabezado de autenticación de tus llamadas a la API.
- Realiza solicitudes a los recursos de la API (ej.: listar contactos, crear conversación).
- Configura un webhook indicando la URL y los eventos deseados.
- Valida la firma/secreto del webhook antes de procesar el payload.
Configuración y opciones
- Alcance del token: limita el acceso a lo necesario.
- Eventos del webhook: suscríbete solo a los eventos que usas.
- Reentrega: maneja reintentos e idempotencia en tu endpoint.
Casos de uso
- Replicar conversaciones en un data warehouse.
- Notificar a un sistema externo cuando una conversación se crea o se resuelve.
Consejos, límites y buenas prácticas
- Verifica siempre la firma del webhook antes de actuar.
- Garantiza idempotencia (dedup por identificador del evento).
- Respeta los límites de tasa y usa backoff en errores 429/5xx.
Solución de problemas
- 401/403: token inválido o sin permiso.
- Webhook duplicado: implementa dedup por ID del evento.