Webhooks

Los Webhooks permiten a Trimoji enviar notificaciones en tiempo real a su aplicación tan pronto como ocurra un evento (fin de una prueba, creación de una campaña, etc.). Es el método más eficiente para sincronizar sus datos sin solicitar innecesariamente la API.

1. Configuración del Webhook

La gestión de los webhooks se realiza en su interfaz de cliente: Mi Cuenta Trimoji.

Pasos de configuración:

1. Introduzca la URL de destino de su servidor (ej: https://su-sitio.com/api/webhook).
2. Seleccione los eventos que desea escuchar.
3. Valide la adición.
4. Importante: Una vez creado el webhook, Trimoji genera automáticamente un Secreto (Token) único. Debe recuperar este token para asegurar su endpoint.

2. Seguridad y Autenticación

Para cada envío, Trimoji utiliza el secreto generado para firmar y autenticar la solicitud. Debe verificar esta información en el lado del servidor para asegurarse de que la llamada proviene realmente de nuestros servicios.

El token se transmite de dos maneras en cada llamada:

• En la cabecera HTTP: Authorization: SU_TOKEN_GENERADO
• En el cuerpo JSON: { "_token": "SU_TOKEN_GENERADO", ... }

3. Estructura de la carga útil (Payload)

Todas las solicitudes enviadas por Trimoji siguen un formato JSON estandarizado que permite una identificación rápida de la acción.

4. Lista de eventos disponibles

Puede suscribirse a diferentes tipos de acciones según sus necesidades de automatización:

5. Especificaciones Técnicas

• User-Agent: Las solicitudes se envían con el identificador trimoji/1.0.0.
• Respuesta esperada: Su servidor debe devolver un código 200 OK. En caso de error de su lado, Trimoji registra el fallo en los registros de su cuenta.
• Formato: El cuerpo de la solicitud siempre está en JSON.