> 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

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:

{% 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="https://381698884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKN5jVER9WQHLGiLeuhi9%2Fuploads%2F2bAg6qdEIQIAwn8k59jS%2Fimage.png?alt=media&amp;token=3c168b4e-66e7-4b4e-858b-963260c6d9b1" 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="https://381698884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKN5jVER9WQHLGiLeuhi9%2Fuploads%2F5X53NrFqsGcmM8rUQFcm%2Fimage.png?alt=media&amp;token=25c7aa43-02bd-4d67-b842-1f8a0f5d58c7" 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="https://381698884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKN5jVER9WQHLGiLeuhi9%2Fuploads%2FHdaQV24Ic58CDzHXXnNI%2Fimage.png?alt=media&amp;token=185c3d51-75ba-4188-a27c-9e6a91857994" 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="https://381698884-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKN5jVER9WQHLGiLeuhi9%2Fuploads%2FzkurrjoqGkK0XJR8TsaO%2Fimage.png?alt=media&amp;token=366c8020-9854-49aa-833d-e8f18368fcd4" 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)