O webhook de saída permite que você envie dados em tempo real do Brevo para um aplicativo externo. Quando um evento específico acontece no Brevo, seu aplicativo externo receberá uma notificação contendo detalhes do evento.

Você pode criar webhooks de saída para eventos relacionados aos seguintes recursos do Brevo:

É bom saber

• Qualquer webhook de saída existente criado a partir das páginas Contatos, Campanhas ou Transacionais usando a experiência clássica para gerenciamento de webhooks foi migrado para a página Webhooks.
• Você pode criar até 40 webhooks de saída na sua conta Brevo. Se esse limite for excedido, exclua um webhook existente para criar um novo.
• Você também pode criar um webhook de saída a partir de uma automação ou da API.
• Se você quiser criar um webhook de entrada para receber dados em tempo real de outro aplicativo no Brevo, confira nosso artigo dedicado Criar webhooks de entrada para receber dados em tempo real no Brevo.

Antes de começar

No seu aplicativo externo, recupere:

• O URL do servidor ou ponto de extremidade para o qual você deseja enviar o webhook de saída
• (Opcional) O método de autenticação e as credenciais necessárias
• Qualquer nome e valor de cabeçalho necessário

Se não tiver certeza de onde recuperar essas informações, verifique a central de ajuda do seu aplicativo externo ou entre em contato com a equipe de suporte.

Etapa 1: Crie um webhook de saída no Brevo

Para começar, você precisa criar um webhook de saída no Brevo.

1. No Brevo, clique no nome da sua conta e selecione Integrations (Integrações).
2. Vá para a guia Webhooks.
3. Clique em Add webhook (Adicionar webhook).
4. Selecione Outbound webhook (Webhook de saída).
5. Clique em Add webhook (Adicionar webhook).

Etapa 2: configurar o webhook de saída

Em seguida, configure o nome, o URL e o método de autenticação do webhook de saída.

1. Insira um nome para o webhook.
2. Clique em Continue (Continuar).
3. Insira a URL do servidor ou ponto de extremidade para o qual você deseja enviar seus eventos. Isso informa ao Brevo para onde enviar o webhook de saída quando um evento acontece.
   

4. (Opcional) Por padrão, No authentication (Nenhuma autenticação) é selecionado como o método de autenticação. Para adicionar uma camada extra de segurança, ou se o aplicativo externo para o qual você está enviando o webhook exigir isso, você pode escolher:

   • Autenticação básica (nome de usuário e senha), ou

   • Autenticação de token
     

5. (Opcional) Para adicionar um cabeçalho ao seu webhook de saída:
   1. Clique em + Add an object (Adicionar um objeto).
   2. Insira o nome e o valor do título.
      
6. Clique em Continue (Continuar).

Etapa 3: Escolha os eventos e envie as solicitações de teste

Por fim, escolha os eventos para os quais você deseja receber o webhook de saída e enviar solicitações de teste para seu aplicativo externo.

1. Selecione a categoria do evento para o qual deseja criar um webhook de saída (ex. e-mail transacional, Oportunidades, Formulários etc.).
   
   💡 É bom saber

   Os eventos de contatos estão localizados na categoria E-mails de marketing.
2. Por padrão, todos os eventos dentro da categoria selecionada são ativados. Se necessário, você pode desativar eventos específicos desmarcando-os.
   
3. (Opcional) Para enviar solicitações de teste para os eventos:
   1. clique no ícone de três pontos ao lado de um evento e selecione enviar solicitação de teste.
      
   2. Verifique seu aplicativo externo para confirmar se você recebeu o webhook de saída.
4. clicado Ative webhook quando terminar.

Proteja seu webhook de saída

Para proteger seu webhook de saída, você precisa colocar alguns intervalos de IP da Brevo na lista de permissões. Isso garante que somente solicitações autorizadas possam ativar o webhook. 

➡️ Para saber mais, confira nosso artigo dedicado Breve intervalo do IP: lista de serviços expostos publicamente.

excluir um webhookde saída

Se você não precisar mais de um webhook de saída, poderá excluí-lo permanentemente.

1. No Brevo, clique no nome da sua conta e selecione Integrations (Integrações).
2. Vá para a guia Webhooks.
3. Selecione a opção webhookde saída .
4. Ao lado do webhook de saída que você deseja excluir, clique no ícone de lixeira 🗑️.
   
5. clique em excluir webhook para confirmar.

O webhook de saída foi excluído permanentemente.

🤔 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.

Se você está procurando ajuda com um projeto usando o Brevo, podemos encontrar à agência parceira da Brevo certa.