> ## Knowledge Base Index
> Fetch the complete knowledge base index at: https://ajuda.themembers.com.br/sitemap.xml
> Use this file to discover available pages before exploring further.
> Pure-Markdown content can be obtained by appending a '.md' suffix to the content URLs listed in the sitemap (without the trailing slash).

# Checkout TheMembers: Como integrar com o BotConversa

${youtube}[](ijlwQzoHCko)

${youtube}[](Xggsb_cRa_w)

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](http://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.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/image-u-iac5c6_2jh65s.png =903xauto)
| 💡 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.

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/image-z5lte2yy_efhhc9.png =912xauto)
**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

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/image-jfqau9gd_tdt69o.png =943xauto)
**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. 

![](https://storage.crisp.chat/users/helpdesk/website/-/d/d/8/4/dd84fe263ed8d000/mceclip0_1w24j15.png =904xauto)
