Pular para o conteúdo principal

Crie webhooks para receber atualizações em tempo real sobre seus e-mails e contatos

Se você está familiarizado com as métricas detalhadas que a Brevo oferece para e-mails, sabe como pode ser complicado tentar entender tudo isso. Em vez de vasculhar um palheiro de dados para encontrar as informações que você precisa, os webhooks permitem que você receba os dados certos diretamente, permitindo que você acesse os detalhes importantes de que precisa sem complicações.

O que é um webhook?

Webhooks podem ser definidos como notificações acionadas por eventos específicos. Eles são normalmente usados para facilitar a comunicação entre vários sistemas. Essencialmente, os webhooks fornecem um meio direto de receber alertas sempre que um evento ocorre em outro sistema.

Em termos mais técnicos, um webhook é um retorno de chamada HTTP que permite que vários sistemas se interconectem e mantenham ações consistentes entre eles. Quando ocorre um evento em um sistema, uma solicitação POST é enviada para o URL fornecido em tempo real. Esta solicitação HTTP POST contém informações relacionadas a esse evento específico, por exemplo, a hora em que ocorreu, o nome do evento e os principais identificadores.

Como funcionam os webhooks na Brevo?

Na Brevo, um webhook é um URL que você pode integrar em nosso sistema para receber atualizações em tempo real sobre eventos relacionados ao envio de seus e-mails de marketing e transacionais e ao gerenciamento de seus contatos. Com webhooks, você pode rastrear eventos específicos de seu interesse, como quando um e-mail foi aberto ou um contato foi excluído.

Existem vários tipos de eventos que você pode acompanhar. Por exemplo, você pode receber notificações sobre o status de sua campanha de marketing em andamento e saber como está o desempenho dela em tempo real. Você também pode acompanhar quando suas mensagens transacionais estão sendo enviadas, entregues ou abertas pelos destinatários. Ou você também pode ser notificado sobre alterações em seus contatos.

Quais eventos estão disponíveis na Brevo?

Todos os eventos disponíveis que você pode acompanhar na Brevo estão agrupados em duas categorias:

Eventos de marketing Eventos transacionais
Quando um e-mail é: Quando um contato é:
  • Marcado como spam
  • Marcado como hard bounce
  • Entregue
  • Aberto
  • Cancelado
  • Clicado
  • Soft Bounce
  • Adicionado a uma lista
  • Atualizado
  • Excluído

Você pode encontrar mais informações sobre eventos de marketing e seus dados associados em nossa documentação da API.

Crie seu webhook

💡 É bom saber
Você pode criar até 40 webhooks para e-mails transacionais e de marketing.

Para nossos exemplos, focaremos no evento “Aberto” da plataforma transacional. Basicamente, sempre que enviarmos um novo e-mail transacional, receberemos uma notificação através do nosso webhook indicando que o e-mail chegou com sucesso à caixa de entrada do destinatário.

De Campanhas e Transacionais De uma automação Da API
  1. Vá para a página Webhooks:
  2. Clique em Add a new webhook (Adicionar um novo webhook).
  3. No campo URL, insira o URL de notificação onde os dados do evento serão enviados sempre que o evento for acionado.
  4. Nos campos When the message is (Quando a mensagem for) ou When the contact is (Quando o contato for), selecione os eventos dos quais deseja receber notificações.
  5. No campo Description (Descrição), insira uma descrição para o webhook.

  6. Quando terminar, clique em Save (Salvar).
  7. Depois de criar seu webhook, recomendamos que você o teste. Ao lado do webhook que você criou, clique em Actions (Ações) > Send a test (Enviar um teste) ou Test (Teste). Assim que o evento for acionado, você receberá uma notificação no URL especificado para o webhook.

Proteja seu webhook

Depois de criar e testar seu webhook, recomendamos que você o proteja para garantir que não fique acessível a outras pessoas na web. Para proteger seus webhooks, você precisa colocar na lista de permissões os seguintes intervalos de IP Brevo:

  • 185.107.232.0/24
    • Primeiro endereço IP: 185.107.232.1
    • Último endereço IP: 185.107.232.254
  • 1.179.112.0/20
    • Primeiro endereço IP: 1.179.112.1
    • Último endereço IP: 1.179.127.254
💡 É bom saber
Esses intervalos de IP estão relacionados a webhooks de marketing, webhooks transacionais e webhooks chamados diretamente de uma automação.

🤔 Dúvidas?

Em caso de dúvida, sinta-se à vontade para entrar em contato com nossa equipe de suporte, criando um tíquete a partir da sua conta. Caso ainda não tenha uma conta, entre em contato conosco aqui.

💬 Este artigo foi útil?

Utilizadores que acharam útil: 3 de 22