O que é um webhook no Bot Conversa?

Neste vídeo, você será introduzido ao conceito e à funcionalidade dos webhooks no Bot Conversa:

1. Definição de Webhook:

• Webhook é uma ferramenta que permite ao Bot Conversa gerar links.

• Esses links podem ser incorporados em várias ferramentas externas, como plataformas de pagamento e e-commerce.

2. Integração com Plataformas Externas:

• Com o webhook, é possível integrar o Bot Conversa a outras plataformas como Hotmart, Edu, entre outras

• Essas plataformas geralmente têm uma opção de webhook onde solicitam um link.

• O link gerado pelo Bot Conversa pode ser copiado e colado nessas ferramentas para estabelecer a integração.

3. Funcionalidade do Webhook:

• Ao integrar o webhook, o Bot Conversa receberá informações e notificações de eventos externos.

• Por exemplo, quando ocorre uma compra aprovada, geração de boleto, ou criação de um Pix em uma plataforma de pagamento, o Bot Conversa é notificado.

• Esse recurso permite que o Bot Conversa reaja a eventos específicos, personalizando ainda mais a experiência do usuário.

Os webhooks são essenciais para criar automações dinâmicas e respostas personalizadas no Bot Conversa, tornando a comunicação com os usuários ainda mais eficaz.

Este artigo foi preparado para você que deseja aprender como utilizar a ferramenta de Webhook do BotConversa, aproveite ao máximo tudo que está presente nesse artigo e não deixe de ver o vídeo abaixo:

💡 Observação: Para realizar integrações, usaremos a ferramenta de Webhook do BotConversa, disponível somente no plano PRO, veja mais em: botconversa.com.br

 
❓ Para que serve a funcionalidade do Webhook do BotConversa?

O Webhook é um modo de integração que serve para conectar 2 softwares, podemos dizer que é como um gancho que vai até o software de interesse e puxa as informações para utilizar em sua aplicação, e é dai que vem o nome Webhook.

O Webhook do BotConversa faz parte das integrações PASSIVAS do BotConversa, ou seja, onde o outro software inicia a integração.

Exemplo: Em um determinado produto na Hotmart, toda vez que alguém adquiri o produto, o BotConversa receberá os dados daquela transação (status, nome, telefone, email, valores), após receber todos os dados, o BotConversa adicionará o contato na audiência e enviar uma mensagem de boas vindas.

❓Como utilizar a ferramenta de Webhook do BotConversa?

Crie seu Webhook:

Vá em Automações > Webhook > clique no botão "Criar Novo Webhook" para gerar o link de integração via Webhook do BotConversa.

 

💡 Observação: o limite de requisições para sua companhia é de 10000/mês. Esse limite é reiniciado todo dia 1 de cada mês.

Configure seu Webhook:

Após criado seu Webhook no BotConversa, copie a URL gerada pela ferramenta e insira no software compatível com Webhook que deseja integrar com o BotConversa.

Para realizar os testes de integração e verificar se estão chegando todos os dados que espera do outro software, certifique-se de que o seu Webhook está com o status TESTE no canto superior direito. Após tudo configurado, alterne para ATIVO para usar seu webhook na prática.

 
Crie sua integração no BotConversa:

Após criar e configurar seu Webhook para receber os dados do software de interesse, chegou a parte boa! monte toda sua integração: Criando o contato, enviando fluxos e mensagens e adicionado etiquetas, veja abaixo o que é possível fazer usando o Webhook do BotConversa

Observações para criar seu contato no Webhook do BotConversa:

Para criar o contato de forma correta, obrigatoriamente deve conter: DDI+DDD+9+TELEFONE, na seguinte estrutura:

Exemplo: 5511912341234

💡 Se o Webhook não trazer o DDD ou DDI juntos, poderá mapear o telefone digitando 55 antes de selecionar os campos.

 

🔧 Passo a Passo para Criar um Webhook no BotConversa

1. Acesse o painel do BotConversa:

   • Faça login na sua conta do BotConversa.​

2. Navegue até a seção de Webhooks:

   • No menu lateral, vá em Automações > Webhook.​

3. Crie um novo webhook:

   • Clique em Criar Novo Webhook.

   • Dê um nome descritivo para o webhook (exemplo: "Compra Aprovada").

   • Após a criação, será gerada uma URL exclusiva para o webhook.​

4. Configure o webhook:

   • Copie a URL gerada e insira-a no dashboard da TheMembers.

   • Certifique-se de que o webhook está em modo TESTE para realizar os testes iniciais.

   • Após verificar que os dados estão sendo recebidos corretamente, altere o status para ATIVO.​

5. Mapeie os campos recebidos:

   • Dentro do webhook no BotConversa, você pode mapear os dados recebidos para campos personalizados.

   • Por exemplo, associe o campo "email" recebido ao campo personalizado "Email" no BotConversa.​

6. Utilize os dados nos seus fluxos:

   • Com os dados mapeados, você pode criar automações, enviar mensagens personalizadas, adicionar etiquetas, entre outras ações.​

 

ADICIONANDO O WEBHOOK NO DASHBOARD: 

Clique em TheBank > Webhooks > Criar webhook. 

Preencha os campos necessários e finalize a configuração clicando em criar webhook.