Neste artigo, você aprenderá como configurar e gerenciar webhooks usando a API da Snov.io para suas integrações personalizadas.
O que é um webhook?
Os webhooks permitem que você seja notificado sobre eventos que ocorrem em suas prospecções por e-mail, como respostas de clientes potenciais ou conclusão de campanhas.
Basicamente, quando o evento ao qual você se inscreveu ocorre, a Snov.io envia dados relacionados a esse evento para o seu endpoint (URL do webhook) em tempo real. Você pode usar esses dados para integrações ou automações por meio de aplicativos como Zapier ou Make.
Como criar webhooks
Para se inscrever em webhooks, escolha o evento que deseja rastrear, prepare a URL do seu endpoint e envie uma solicitação para a API da Snov.io.
Escolha o evento
Selecione o evento que deseja rastrear na lista de eventos compatíveis.
Quando o evento selecionado ocorrer, a Snovio enviará automaticamente os dados dele para o seu endpoint.
Os eventos de webhook atualmente compatíveis estão listados abaixo. Por exemplo, você pode receber dados de webhook quando um lead responde a um e-mail de campanha, um e-mail retorna ou um cliente potencial conclui uma campanha.
| Objeto do webhook (event_object) | Ação (event_action) | Ativado |
|---|---|---|
| campaign_email | sent | Quando um e-mail é enviado a um destinatário em qualquer campanha |
| campaign_email | first_sent | Quando o primeiro e-mail é enviado a um destinatário em qualquer campanha |
| campaign_email | opened | Quando um destinatário abre um e-mail de uma campanha |
| campaign_email | bounced | Quando um e-mail enviado de uma campanha não pode ser entregue e resulta em uma mensagem de erro (bounce) |
| campaign_reply | received | Quando um destinatário responde a um e-mail de uma campanha |
| campaign_reply | first_received | Quando um destinatário responde a um e-mail de uma campanha pela primeira vez |
| prospect | campaign_finished | Quando um lead chega ao final de uma campanha e nenhuma outra ação está agendada |
| company | found_domains_by_names | Quando um domínio de empresa é encontrado com base em seu nome |
| prospect | found_by_li_url | Quando um perfil de potencial cliente é encontrado com base em um URL do LinkedIn |
| email_verification | verified | Quando uma solicitação de verificação de e-mail é concluída |
Prepare a URL do seu endpoint
Esta é a sua própria URL pública que pode aceitar solicitações HTTP de entrada. Por exemplo, uma URL de webhook no Zapier/Make ou o endpoint do seu aplicativo.
Envie a solicitação para criar o webhook
Para criar um webhook na sua conta Snov.io, use a opção Adicionar endpoint de webhook da API Snov.io.
.Envie uma solicitação de API com os parâmetros abaixo. Saiba, porém, que tais modelos de webhook são predefinidos com base no tipo de evento que você deseja rastrear.
- Método: POST
- URL da solicitação: https://api.snov.io/v2/webhooks
Parâmetros do webhook
- event_object — o que você deseja rastrear, como prospecto ou e-mail (copie os valores correspondentes da tabela acima)
- event_action — o evento específico que precisa ocorrer para que o webhook seja ativado (copie os valores correspondentes da tabela acima)
- endpoint_url — forneça seu próprio URL público para onde a Snov.io enviará os dados
Para criar um webhook para respostas de clientes potenciais (quando um destinatário responde a qualquer e-mail em qualquer campanha), escolha estes modelos:
- event_object: campaign_reply
- event_action: received
Exemplo de corpo de requisição da API:
{ "event_object": "campaign_reply", "event_action": "received", "endpoint_url": "https://your-domain.com/webhooks/snov-replies" }
Verifique se o webhook está funcionando
Após criar o webhook:
- Certifique-se de que seu endpoint retorne um status HTTP 200–299 em até 3 segundos
- Se o endpoint retornar um status diferente (ou expirar o tempo limite), a Snov.io tentará reenviar o webhook automaticamente
Política de repetição: o comportamento abaixo reflete como a Snov.io entrega eventos de webhook na prática.
O webhook é considerado bem-sucedido se a Snov.io receber um status HTTP no intervalo de 200 a 299 em até 3 segundos.
Em outras palavras, se recebermos qualquer outro status HTTP ou ocorrer um tempo limite, faremos sete tentativas de repetição com intervalos crescentes, até 38 horas após o evento que disparou o webhook:
Se todas as tentativas falharem, o webhook será desativado.
- 1ª: imediatamente após o evento
- 2ª: 20 minutos após a última tentativa (20 minutos após o evento)
- 3ª: 40 minutos após a última tentativa (1 hora após o evento)
- 4ª: 60 minutos após a última tentativa (2 horas após o evento)
- 5ª: 4 horas após a última tentativa (6 horas após o evento)
- 6ª: 8 horas após a última tentativa (14 horas após o evento)
- 7ª: 24 horas após a última tentativa (38 horas após o evento)
Sinto por isso 😢
Como podemos melhorar?