Envía datos a tus sistemas con webhooks

Un webhook envía datos a la URL que elijas en el momento en que pasa algo, por ejemplo cuando alguien se registra o gana un premio. Tu desarrollador configura el sistema que los recibe. Los webhooks están incluidos a partir del plan Basic.

Añade un webhook

Puedes añadir webhooks a una campaña, en el editor en Conectar > Webhooks, o para toda tu cuenta en Configuración > Webhooks.

1. Haz clic en Añadir webhook.
2. Introduce la URL del payload. Debe usar HTTPS.
3. Elige el Tipo de contenido: application/json o application/x-www-form-urlencoded.
4. Elige el Método: POST o GET. Usa POST salvo que tu sistema necesite GET, que envía los datos en la URL.
5. Introduce un Secreto para firmar las peticiones (recomendado).
6. Elige los eventos en ¿Qué eventos deben activar el webhook?:
   • «Cuando se crea un nuevo lead» (a nivel de cuenta)
   • «Cada vez que un lead participa en una campaña»
   • «Cuando un lead gana un premio»
7. Asegúrate de que Activo está activado y guarda.

En el editor de campañas también puedes elegir Basic Auth en Autenticación y usar Payload personalizado para decidir tú mismo los nombres de los campos.

Qué se envía

El cuerpo tiene un event y un objeto data con la campaña (id y nombre), los campos del lead, el canal, los consentimientos con texto, hora y dirección IP, las respuestas del cuestionario y, para los ganadores, el premio con su código. Los valores vacíos se omiten.

Comprueba la firma

Si defines un secreto, cada petición lleva una cabecera X-Hub-Signature: sha1= seguido de un HMAC-SHA1 de los datos codificados en JSON, con tu secreto como clave. Calcula lo mismo en tu lado y compáralo, para asegurarte de que la petición viene de Scratcher.

Envíos y reintentos

Si tu URL no responde o devuelve un error, Scratcher lo intenta dos veces más: a los 5 segundos y al cabo de un minuto. Haz clic en Mostrar envíos (o Ver envíos) para ver cada petición y respuesta, mostrar solo las fallidas y usar Reintentar en un envío. Los envíos se guardan 60 días.

Activa Registrar el cuerpo de la respuesta para guardar también lo que respondió tu sistema, algo útil para depurar errores.