Os webhooks de saída permitem 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

• Você pode criar até 40 webhooks de saída na sua conta Brevo. Se você atingir esse limite, exclua um webhook existente antes de criar um novo.
• Os webhooks de saída também podem ser criados usando uma automação ou a API.
• Se você quiser criar webhooks 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 criar um webhook de saída no Brevo:

1. No Brevo, clique no nome da sua conta e selecione Integrations > Webhooks (Integrações > Webhooks).
2. Clique em Add webhook (Adicionar webhook).
3. Selecione Outbound webhook (Webhook de saída).
4. 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. Selecione sua estratégia de envio de webhook:
   • Enviar um de cada vez
     Envie eventos individualmente em tempo real.
   • Enviar em lotes
     Envie eventos em lotes de até 500. Isso é recomendado se você tiver limites de taxa mais baixos, pois pode reduzir o número de solicitações.
7. 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 (por exemplo, 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 Send test request (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.