Como enviar um webhook

Um webhook é um mecanismo para notificar um sistema sobre eventos. Usar webhooks no Automation 360 é uma forma de notificar seu sistema sobre eventos que acontecem.

O que um webhook pode fazer

O envio de webhooks permite que o serviço SendPulse receba atualizações quando o status do cliente muda ou quando a série automatizada atinge um objetivo específico.

Por exemplo, clientes potenciais deixam solicitações em seu site; seus detalhes de contato são enviados para seu sistema CRM e sincronizados com SendPulse. Um fluxo do Automation 360 ajuda a aquecer seus leads. Você deseja ligar para todos que abrirem o terceiro e-mail no fluxo. Para fazer isso, você precisa alterar o status dos leads em seu CRM. Você pode fazer isso com a ajuda de um webhook, enviando dados sobre um evento para o seu sistema.

Como enviar um webhook em um fluxo de automação

Para enviar notificações de eventos a outro sistema, vincule o bloco "Ação" - "Enviar webhook" ao bloco a partir do qual deseja rastrear um evento. Você pode rastrear o recebimento ou a abertura de um e-mail, filtrado por uma condição especificada, atingindo uma meta ou qualquer outra ação realizada por um assinante em um fluxo de automação.

Webhook settings in A360

Especifique um nome de webhook e um URL para o qual o webhook será enviado. Somente números e caracteres latinos são permitidos em um nome de webhook.

Configure o envio da chave em resposta ao primeiro webhook para remover o limite de envio de webhooks. Caso contrário, o serviço permitirá que você envie um webhook por hora.

The key for removing webhook frequency limits

Estrutura de webhook

Um webhook transmite esses dados:

  • um ID de fluxo;
  • um nome de webhook;
  • uma data de acionamento do webhook;
  • um endereço de e-mail e um número de telefone de um assinante para o qual o webhook foi enviado;
  • dados variáveis.

Se uma automação começa com uma lista de discussão, as variáveis da lista de discussão são enviadas no webhook. Se a automação começa com um evento, as variáveis do evento são enviadas no webhook.

[
   {
      "automation_id":"123456789",
      "título": "New Automation",
      "execução_data":"2022-01-04 09:02:39",
      "email":"example@example.com",
      "telefone":"+380631234567",
      "variáveis":[
         {
            "name1":"value1"
         },
         {
            "name2":"value2"
         }
      ]
   }
]

Como enviar uma solicitação de teste

Você pode enviar uma solicitação de teste para verificar se suas configurações estão corretas e identificar possíveis problemas ou erros. Selecione Executar uma solicitação de teste.

Na janela de diálogo, você encontrará uma solicitação de teste com a URL do seu site, webhook e resposta do webhook.

O webhook retorna respostas diferentes dependendo dos parâmetros da sua solicitação ou status do sistema.

A resposta do webhook contém os seguintes parâmetros:

status Indica se a operação acionada pelo webhook foi concluída com sucesso (true) ou sem sucesso (false).
message Contém uma resposta do webhook ou uma notificação de resultado da operação.
code Indica um status específico ou resultado da operação.

O webhook pode retornar as seguintes respostas:

Em caso de erro de código:

[
   {
     "status": false,
     "message": 'Error during query execution',
     "code": 21111011
   }
]

Em caso de erro de execução da solicitação:

[
   {
     "status": false,
     "message": 'The request failed',
     "code": 11110111
   }
]

Em caso de erro causado pelo usuário não responder no formato JSON:

[
   {
     "status": false,
     "message": 'Invalid response format. Expects json!',
     "code": 11110112
   }
]

Em caso de erro causado por um código de verificação incorreto para usuários da assinatura gratuita:

[
   {
     "status": false,
     "message": 'The request did not pass code verification',
     "code": 11110113
   }
]

Em caso de erro de verificação de endereço IP, como quando o endereço IP está bloqueado ou local:

[
   {
     "status": false,
     "message": 'Incorrect url ip',
     "code": 11110114
   }
]

Em caso de uma solicitação bem-sucedida:

[
   {
     "status": true,
     "(string)message": (webhook response),
     "code": 1
   }
]

Como rastrear cancelamentos de inscrições e reclamações de spam

Você pode configurar o rastreamento de cancelamentos de inscrições e reclamações de spam nas configurações de sua conta.

Um exemplo de webhook de reclamação de spam:

[
   {
      "timestamp": 1496827422,
       "evento": "spam",
       "task_id": 3668141,
       "email": "john.doe@sendpulse.com",
       "fonte": "automação360",
       "automatic_id": "123456789"
   }
]

Um exemplo de webhook de cancelamento de inscrição:

[
   {
      "task_id": "3668141",
       "timestamp": "1496827872",
       "from_all": 1,
       "email": "john.doe@sendpulse.com",
       "razão": nulo,
       "book_id": 490686,
       "evento": "cancelar",
       "categorias": "",
       "fonte": "automação360",
       "automatic_id": "123456789"
   }
]
    Rate this article about "Como enviar um webhook"

    User Rating: 5 / 5

    Anterior

    Elemento Ação na Automação 360

    Próximo

    Como configurar uma contagem de conversão

    Popular em nosso blog

    Teste o SendPulse hoje gratuitamente