Activar los webhooks
Mientras Cloud no tenga una pantalla para hacerlo, el equipo de Hablame registra tu destino a pedido. Esto es lo que necesitas enviar y lo que recibes a cambio.
3 min de lectura
Qué enviarle a soporte
Escribe a developers@hablame.co con estos cuatro datos:
| Dato | Qué debe cumplir |
|---|---|
| Organización | El nombre de tu organización en Hablame. |
| URL pública del destino | https (recomendada) o http, de hasta 2.048 caracteres y alcanzable desde internet. No se aceptan direcciones IP privadas o reservadas, localhost ni nombres que terminen en . o .. |
| Código corto | El código corto cuyos SMS quieres recibir. Cada código corto se nombra: un destino solo recibe los códigos que tiene registrados. |
| Contacto técnico | Nombre y correo de quien responde por la integración en tu equipo. |
Nunca nos envíes secretos
Ni tu clave de API completa, ni una contraseña SMPP, ni un secreto de firma. Para identificar tu cuenta basta el nombre de tu organización.
Antes de pedir el registro
- Tu URL responde 2xx a un
POSTen menos de 15 s. - Tu código verifica la firma y descarta los repetidos. Puedes partir de los receptores de ejemplo.
- La URL no sigue redirecciones: debe ser la final. Un
301o un302cuenta como fallo.
Tu secreto de firma
Al registrar el destino, su secreto de firma lo obtienes en Cloud: whsec_ seguido de 48 caracteres hexadecimales. Se muestra una sola vez y no se puede volver a consultar. Guárdalo en tu gestor de secretos o en una variable de entorno; nunca en el código ni en el navegador. Cada destino tiene el suyo.
Después del registro
- Los avisos pueden tardar hasta 30 segundos en empezar a llegar.
- Los SMS que llegaron a tu código corto antes del registro no se guardan ni se entregan después. Pide el registro antes de anunciar el código corto.
Suspender, rotar o cambiar el destino
Todo cambio se pide igual, a developers@hablame.co: suspender los avisos, cambiar la URL o el código corto, o rotar el secreto.
Rotar sin perder avisos
Durante las 24 horas siguientes a una rotación, cada aviso llega firmado dos veces: X-Hablame-Signature con el secreto nuevo y X-Hablame-Signature-Prev con el anterior. Así puedes cambiar el tuyo cuando te quede bien. Verificar la firma.