> For the complete documentation index, see [llms.txt](https://botconversa.gitbook.io/bem-vindo-ao-botconversa/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://botconversa.gitbook.io/bem-vindo-ao-botconversa/integracoes/api-botconversa/webhook-botconversa.md).

# Webhook BotConversa

{% hint style="info" %}
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
{% endhint %}

{% embed url="<https://youtu.be/3mrD_mLsB4A>" %}

### ❓ 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 Webhook" para gerar o link de integração via Webhook do BotConversa.&#x20;

<figure><img src="/files/qjNadNBZvKGiIxSFQg8s" alt=""><figcaption><p>Crie seu Webhook</p></figcaption></figure>

{% hint style="warning" %}
Observação: o limite de requisições para sua companhia é de 10000/mês. Esse limite é reiniciado todo dia 1 de cada mês.
{% endhint %}

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

<figure><img src="/files/gmjYdlSM65PlnxaW6XWT" alt=""><figcaption><p>Configure seu Webhook</p></figcaption></figure>

### 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:

<figure><img src="/files/7Bf8T8N7GmoWtdeRILPB" alt=""><figcaption></figcaption></figure>

### 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

{% hint style="info" %}
Se o Webhook não trazer o DDD ou DDI juntos, poderá mapear o telefone digitando 55 antes de selecionar os campos.
{% endhint %}

<figure><img src="/files/i0QxzSLNl3CqzRDQ2o7f" alt=""><figcaption></figcaption></figure>

## Saiba mais em:

[API BotConversa](/bem-vindo-ao-botconversa/integracoes/api-botconversa.md)

[Blocos de integrações do BotConversa](/bem-vindo-ao-botconversa/integracoes/api-botconversa/bloco-de-integracao.md)

[Documentação API do BotConversa](/bem-vindo-ao-botconversa/integracoes/api-botconversa/documentacao-api-botconversa.md)