Artigos sobre: O Checkout da TheMembers

Checkout TheMembers: Como integrar com o BotConversa



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. 



Atualizado em: 28/06/2025