Credencial por integración
Un token por sistema conectado, con alcance mínimo. Revocar uno no tumba los otros.
Integración · Técnico
API REST y webhooks.
Toda integración de brisk4 se apoya en estos dos mecanismos. La plataforma consume APIs de tus sistemas y también expone su propia API, para que tu equipo construya lo que necesite sin depender del roadmap de un proveedor.
Recursos
Qué permite la API.
| Recurso | Dirección | Uso típico |
|---|---|---|
| Envío de mensaje | Tu sistema → brisk4 | Disparar notificación por WhatsApp oficial a partir de un evento en tu backend. |
| Contactos | Bidireccional | Crear, consultar y actualizar contactos y sus campos personalizados. |
| Conversaciones e historial | brisk4 → tu sistema | Exportar transcripción, canal, duración y responsable a tu data warehouse o BI. |
| Webhook de mensaje recibido | brisk4 → tu sistema | Reaccionar en tiempo real a lo que el cliente escribe, para lógica que corre de tu lado. |
| Webhook de estado | brisk4 → tu sistema | Entregado, leído o fallido: seguir la entrega de cada mensaje enviado. |
Estándares técnicos
Qué entra en vivo primero.
- REST con JSON y OAuth 2.0Endpoints REST sobre HTTPS, payload JSON y autenticación por OAuth 2.0 o token de aplicación, con alcance por recurso y revocación en cualquier momento.
- Webhooks con firma y reintentoCada entrega va firmada para que tu servidor valide el origen. Un fallo de recepción genera reintento con backoff, sin perder evento.
- Idempotencia y paginaciónLas llamadas aceptan clave de idempotencia para no duplicar la operación en un reintento, y los listados están paginados por cursor.
Buenas prácticas
Método y prerrequisitos.
Entorno de homologación
Toda integración se valida en entorno de prueba antes de cualquier llamada en producción.
Observabilidad
Log de llamadas, latencia y error disponible para que tu equipo siga la salud de la integración.
- Protocolo
- HTTPS con TLS
- Formato
- JSON
- Autenticación
- OAuth 2.0 o token de aplicación
- Eventos
- Webhooks firmados con reintento y backoff
- Límites
- Rate limit por credencial, dimensionado en el contrato
- Documentación
- Referencia técnica entregada al inicio de la implantación
Preguntas frecuentes
API de brisk4: dudas.
¿brisk4 tiene API propia?
La tiene. La plataforma expone una API REST sobre HTTPS, con payload JSON y autenticación por OAuth 2.0 o token de aplicación. Permite enviar mensajes, gestionar contactos y exportar el historial de conversaciones a tu sistema.
¿Cómo funcionan los webhooks?
brisk4 notifica a tu servidor cuando ocurre un evento: mensaje recibido, estado de entrega, cambio en un contacto. Cada entrega va firmada para que valides el origen, y los fallos generan reintento con backoff.
¿Mi equipo puede construir la integración solo?
Puede. La referencia técnica se entrega al inicio de la implantación, y la API fue diseñada para uso directo por tu equipo de desarrollo, sin depender de nuestro roadmap para cada ajuste.
¿Existe límite de llamadas?
Existe rate limit por credencial, dimensionado según el volumen contratado. Las llamadas aceptan clave de idempotencia, así que un reintento nunca duplica la operación.
Habla con quien entiende de API.
En el diagnóstico gratuito tu equipo técnico habla directo con el nuestro, sin intermediario comercial traduciendo requisitos.