En este artículo aprenderás cómo configurar y administrar webhooks a través de la API de Snov.io para tus integraciones personalizadas.
¿Qué es un webhook?
Los webhooks te permiten recibir notificaciones sobre eventos que ocurren en tus campañas, como respuestas de prospectos o la finalización de una campaña.
Cuando se produce el evento al que te suscribiste, Snov.io envía en tiempo real los datos relacionados con ese evento a tu endpoint (URL del webhook). Puedes usar estos datos para integraciones o automatizaciones mediante aplicaciones como Zapier o Make.
Cómo crear webhooks
Para suscribirte a webhooks, elige el evento que deseas rastrear, prepara la URL de tu endpoint y envía una solicitud a la API de Snov.io.
Elige el evento
Decide qué evento deseas rastrear de la lista de eventos compatibles.
Cuando ocurra el evento seleccionado, Snov.io enviará automáticamente los datos del evento a tu endpoint.
A continuación se muestran los eventos de webhook compatibles actualmente. Por ejemplo, puedes recibir datos cuando un prospecto responde a un correo de campaña, cuando un email rebota o cuando un prospecto completa una campaña.
| Objeto del webhook(event_object) | Acción (event_action) | Cuándo se activa |
|---|---|---|
| campaign_email | sent | Cuando se envía cualquier correo a un destinatario en cualquier campaña |
| campaign_email | first_sent | Cuando se envía el primer correo a un destinatario en cualquier campaña |
| campaign_email | opened | Cuando un destinatario abre cualquier correo de una campaña |
| campaign_email | bounced | Cuando un correo enviado desde una campaña no puede entregarse y genera un rebote |
| campaign_reply | received | Cuando un destinatario responde a cualquier correo en cualquier campaña |
| campaign_reply | first_received | Cuando un destinatario responde por primera vez a un correo de campaña |
| prospect | campaign_finished | Cuando un prospecto llega al final de una campaña y no hay más pasos programados |
| company | found_domains_by_names | Cuando se encuentra el dominio de una empresa a partir de su nombre |
| prospect | found_by_li_url | Cuando se encuentra el perfil de un prospecto a partir de una URL de LinkedIn |
| email_verification | verified | Cuando se completa una solicitud de verificación de correo electrónico |
Prepara la URL de tu endpoint
Esta es tu propia URL pública que puede aceptar solicitudes HTTP entrantes. Por ejemplo, una URL de webhook en Zapier/Make o el endpoint de tu aplicación.
Envía la solicitud para crear el webhook
Para crear un webhook en tu cuenta de Snov.io, utiliza el endpoint Add webhook de la API de Snov.io.
Envía una solicitud a la API con los siguientes parámetros. Los parámetros del webhook están predefinidos según el tipo de evento que deseas rastrear.
- Método: POST
- URL de la solicitud: https://api.snov.io/v2/webhooks
Parámetros del webhook
- event_object — qué deseas rastrear, como prospecto o correo (copia los valores correspondientes de la tabla anterior)
- event_action — el evento específico que debe ocurrir para que el webhook se active (copia los valores correspondientes de la tabla anterior)
- endpoint_url — proporciona tu propia URL pública donde Snov.io enviará los datos
Para crear un webhook de respuestas de prospectos (cuando un destinatario responde a cualquier correo en cualquier campaña), elige estos parámetros:
- event_object: campaign_reply
- event_action: received
Ejemplo del cuerpo de la solicitud a la API:
{ "event_object": "campaign_reply", "event_action": "received", "endpoint_url": "https://your-domain.com/webhooks/snov-replies" }
Verifica que el webhook funcione correctamente
Después de crear el webhook:
- Asegúrate de que tu endpoint devuelva un estado HTTP 200–299 en un plazo de 3 segundos.
-
Si el endpoint devuelve un estado diferente (o se agota el tiempo), Snov.io reintenta enviar el webhook automáticamente.
Política de reintentos: El comportamiento a continuación refleja cómo Snov.io entrega los eventos de webhook en la práctica.
El webhook se considera exitoso si Snov.io recibe un estado HTTP en el rango 200–299 dentro de los 3 segundos.
Si se recibe cualquier otro estado HTTP o se produce un timeout, se realizan siete intentos de reenvío con intervalos crecientes, hasta 38 horas después del evento que activó el webhook. Si todos los reintentos fallan, el webhook se desactiva:
- 1.º: inmediatamente después del evento
- 2.º: 20 minutos después del último intento (20 minutos después del evento)
- 3.º: 40 minutos después del último intento (1 hora después del evento)
- 4.º: 60 minutos después del último intento (2 horas después del evento)
- 5.º: 4 horas después del último intento (6 horas después del evento)
- 6.º: 8 horas después del último intento (14 horas después del evento)
- 7.º: 24 horas después del último intento (38 horas después del evento)