Como usar os Webhooks da Snov.io

Resumo:

• O que são webhooks
• Parâmetros de Webhooks da Snov.io
• Como assinar webhooks via API da Snov.io
• Como gerenciar webhooks via API da Snov.io

Os webhooks são uma maneira de os aplicativos se comunicarem entre si. Em essência, são notificações enviadas de um aplicativo para outro quando ocorre um evento predeterminado:

• Um aplicativo aciona um webhook quando ocorre um evento escolhido
• O outro aplicativo recebe informações em tempo real sobre o evento

Por exemplo, quando um destinatário responde a um e-mail de campanha, um webhook é enviado para o endpoint de URL especificado. O endpoint pode então agir com base nas informações recebidas de um webhook. Isso cria possibilidades para configurar integrações automatizadas. Usando Webhooks da Snov.io, você pode:

 Integrar seu próprio aplicativo com a Snov.io

Ser notificado de eventos ou atividades que aconteceram em sua conta Snov.io

Enviar dados em tempo real da Snov.io para seu aplicativo

Existem três webhooks disponíveis na Snov.io no momento (no futuro, teremos mais atualizações):

E-mail enviado (Email sent)
A Snov.io enviará um webhook quando sua campanha de gotejamento de e-mail for enviada. Você pode escolher quando obtê-lo: somente quando o primeiro e-mail for enviado a um destinatário ou após cada e-mail enviado.

Resposta da campanha recebida (Campaign reply received)

A Snov.io enviará um webhook quando você receber uma resposta à sua campanha de gotejamento por e-mail. Você pode escolher quando recebê-lo: somente após a primeira resposta de um destinatário ou após cada resposta.

As informações do webhook incluirão:

• E-mail do destinatário
• Timestamp de um evento: quando o evento ocorreu
• Nome da campanha: o nome da campanha de gotejamento em que o evento ocorreu
• Assunto do e-mail: a linha de assunto do e-mail enviado a um destinatário
• Corpo do e-mail: o conteúdo do e-mail enviado a um destinatário

E-mail da campanha aberto (Campaign email opened)

A Snov.io enviará um webhook quando seu e-mail de campanha de gotejamento for visualizado por um destinatário.

As informações do webhook incluirão:

• E-mail do destinatário 
• Timestamp de um evento: quando o evento ocorreu
• Nome da campanha: o nome da campanha de gotejamento onde ocorreu o evento
• Assunto do e-mail: a linha de assunto do e-mail enviado a um destinatário
• Corpo do e-mail: o conteúdo do e-mail enviado a um destinatário 

Parâmetros de webhooks da Snov.io

Os parâmetros do webhook incluem o seguinte:

• Objeto: o objeto sobre o qual a ação é executada. Em outras palavras, este é um componente da Snov.io (e-mail, resposta, prospecto ou negócio) vinculado a um webhook.
• Ação: a ação realizada no objeto. Simplificando, este é o evento que ativa um webhook.
• Endpoint: o endereço da URL para onde o webhook é enviado.

Abaixo está a lista de objetos e ações atualmente disponíveis:

Objeto	Ação	Quando é ativado?
campaign_email	sent	Quando qualquer e-mail é enviado ao destinatário em qualquer campanha de gotejamento
	first_sent	Quando o primeiro e-mail é enviado ao destinatário em qualquer campanha de gotejamento
	opened	Quando o destinatário abre um e-mail em qualquer uma das campanhas de gotejamento
campaign_reply	received	Quando o destinatário responde a qualquer e-mail em qualquer uma das campanhas de gotejamento
	first_received	Quando o destinatário responde ao e-mail pela primeira vez em qualquer uma das campanhas de gotejamento

Para ver um webhook sendo executado em tempo real, vamos usar o Postman e qualquer um dos geradores de endpoint online.

Prepare o ambiente de teste da API e obtenha um token de acesso à API

Inscreva-se com o Postman

Obtenha um token de acesso à API

Prepare uma chamada de API e autentique-a com um token de acesso

Aqui está um passo a passo detalhado sobre como autenticar sua chamada de API da Snov.io e usar o Postman para chamadas de API.

  Obtenha um endereço de endpoint de URL

Como exemplo, usaremos o Beeceptor para gerar um endpoint gratuito. Em seu site, digite qualquer nome de endpoint e clique no botão Create endpoint.

Você obterá um endereço de URL de terminal para o qual um webhook e dados relacionados a um evento na Snov.io serão enviados. Salve ou copie este URL para usá-lo na próxima etapa.

  Assine um webhook por meio de chamada de API 

Use as configurações abaixo para fazer uma chamada de API no Postman ou em qualquer outro ambiente de teste de API de sua escolha:

• Tipo: POST
• URL de solicitação: https://api.snov.io/v2/webhooks
• Parâmetros de entrada (consulte também o capítulo de parâmetros do Webhook acima):

Alterar status do webhook

Altera o status de uma assinatura de webhook escolhida.

Inclua o valor “id” exclusivo do webhook escolhido no final do endereço URL da solicitação.

Use o método “Listar todos os webhooks” para obter os valores de ID dos seus webhooks.

• Tipo : PUT
• URL de solicitação : https://api.snov.io/v2/webhooks/webhook_id
• Parâmetros de entrada :

Status

ativo ou desativado

• Exemplo de URL de solicitação: https://api.snov.io/v2/webhooks/14

Observação: você pode criar até 50 webhooks. Eles estão disponíveis apenas para contas premium.

Atualize seu plano agora, expanda a funcionalidade de sua conta Snov.io e assine webhooks!