> For the complete documentation index, see [llms.txt](https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/controle/integracoes/webhook.md).

# Webhook

### Como funciona?

Um webhook funciona de forma proativa: quando um evento específico ocorre em um sistema (exemplo: criação de um pedido, conclusão de um pagamento), ele envia uma mensagem (normalmente no formato JSON) para uma URL específica configurada por você.

### Componentes principais<br>

**1. Evento:**

• É a ação que dispara o webhook, como “novo cadastro”, “compra realizada”, ou “pedido cancelado”.

**2. Endpoint (URL):**

• É a URL configurada no sistema que vai receber as informações enviadas pelo webhook. Normalmente, é um servidor configurado para lidar com esses dados.

**3. Payload:**

• É o conjunto de informações enviadas pelo webhook, geralmente em formato JSON. Contém detalhes sobre o evento.

**4. Resposta (opcional):**

• Após o envio do webhook, o sistema receptor pode enviar uma resposta para confirmar que a mensagem foi recebida corretamente.

{% hint style="info" %}
**Exemplo do fluxo de um Webhook**\
\
**1.** Um cliente realiza uma compra em pelo Link do Plano.

**2.** Nosso sistema então dispara um webhook para a URL configurada.

**3.** O servidor da Ferramenta que fez integração recebe o webhook, lê o payload e registra o pagamento o evento..
{% endhint %}

### Benefícios

<br>

• **Automação em tempo real:** Não é necessário “checar” o status de eventos; o sistema avisa quando algo acontece.

• **Integração simplificada**: Conecta diferentes serviços ou sistemas sem necessidade de consulta constante (pull).

• **Escalabilidade**: Adequado para sistemas que precisam lidar com múltiplos eventos.

<br>

## Webhooks enviados da Insights, como configurar?

Clicando em Configurações, você poderá criar uma nova configuração para envio de webhooks baseado em eventos.

\
**1. Primeiro você vai no menu no item Controle > Integrações**

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

**2. Clique no card "Webhook Conversão" e no sidebar lateral no campo "Webhook URL" insira seu link.**

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