Como enviar um webhook no elemento Ação

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.

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.

Para adicionar variáveis do fluxo automatizado à sua solicitação, inclua os parâmetros na URL do webhook conforme o exemplo abaixo:

?key1={{variable1}}&key2={{variable2}}

Por exemplo:

https://webhook.site/3579a6ad-2824-4dee-b75d-626093c7faec?email={{email}}&product={{product_id}}

Você pode adicionar nomes de variáveis com base no gatilho do fluxo, como variáveis personalizadas, do CRM, de curso online ou da lista de endereçamento.

Todos os caracteres especiais e não latinos são codificados automaticamente na URL durante a solicitação, o que garante que os valores sejam recebidos corretamente na resposta.

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.

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.

{
  "title": "NewOrder",
  "variables": {
    "event_date": "2026-10-06",
    "user_id": 48213,
    "products": [
      {
        "product_name": "Wireless headphones",
        "product_img_url": "https://example.com/images/wireless-headphones.png",
        "product_price": 59
      }
    ]
  },
  "execution_date": {
    "date": "2026-10-06 13:25:31.290826",
    "timezone_type": 3,
    "timezone": "UTC"
  },
  "automation": 186204,
  "phone": null,
  "email": "olivia.harper@example.com"
}

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:

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,
  "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"
   }
]

Última Atualização: 22.04.2026