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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/controle/integracoes/webhook.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.