Catálogo de eventos
Todos los eventos llegan con el mismo sobre de tres llaves. Lo que cambia entre uno y otro es type y la forma de data.
2 min de lectura
El sobre
El cuerpo de cada aviso es un objeto JSON con exactamente estas tres llaves, en este orden:
| Llave | Tipo | Qué es |
|---|---|---|
id | string | Identificador del evento. Es el mismo en todos los reintentos y en todos tus destinos. En sms. son 32 caracteres hexadecimales en minúsculas. |
type | string | Tipo de evento. Llega también en la cabecera X-Hablame-Event-Type. |
data | object | Los datos del evento. Su forma depende de type y está en el catálogo de eventos. |
Lee las llaves por nombre y no rechaces un evento porque data traiga una llave que no conoces.
Tipos de evento
| Tipo | Cuándo llega | Detalle |
|---|---|---|
sms. | Una persona le escribió un SMS a tu código corto. | SMS entrante |
Cómo se forma el tipo
El tipo va en minúsculas, con letras, dígitos y separadores (., _ o -), y sin espacios. Cuando tiene una parte variable, como el código corto de sms., esa parte va al final: el SMS que llega al 87654 trae el tipo sms., tanto en type como en la cabecera X-Hablame-Event-Type.