> 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

Webhook é uma técnica usada para comunicação entre sistemas, permitindo que um aplicativo envie informações ou notificações para outro automaticamente e em tempo real.

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

## Os três webhooks da Trade Insights

| Webhook                                                                                                                                          | Quando envia                                                                                                                                                     | Onde configurar                            |
| ------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------ |
| [Webhook Customizável](https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/controle/integracoes/webhook/webhook-costumizavel.md) | Nos eventos que você escolher (compra aprovada, carrinho abandonado, conclusão de conteúdo e outros), filtrando por plano ou oferta. É o mais completo.          | Card **Webhook Customizável**              |
| **Webhook de Conversão**                                                                                                                         | A cada mudança no cadastro ou plano de um aluno: cadastro, compra, renovação, cancelamento, carrinho abandonado e pagamento recusado. Uma única URL recebe tudo. | Card **Webhook de Conversão** (admin novo) |
| [Webhook de Login](https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/controle/integracoes/webhook/webhook-de-login.md)         | No primeiro acesso do dia de cada aluno.                                                                                                                         | Card **Webhook de Login**                  |

Os três ficam em **Integrações**: no admin antigo, menu **Controle > Integrações**; no admin novo, **Configurações > Integrações**.

{% hint style="info" %}
Começando agora? Use o **Webhook Customizável**: você escolhe os eventos e vê a lista completa em [Eventos de webhook](https://centraldeajuda.tradeinsights.com/bem-vindo-a-trade-insights/controle/integracoes/webhook/eventos-de-webhook.md).
{% endhint %}

## Webhook de Conversão

Envia os dados do aluno e do plano para uma única URL sempre que algo muda no cadastro ou no plano dele. O conteúdo inclui nome, e-mail, CPF, telefone, endereço, plano (`plano`, `plano_cod`), oferta (`link`, `link_cod`), valor, status do plano (por exemplo `active`, `inactive` ou `pending`; `cadastro` quando o aluno ainda não tem plano), data, vencimento, tags e UTMs.

**1. No admin novo, abra Configurações > Integrações e clique no filtro Webhooks.**

<figure><img src="https://2520162152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAf7j6zODfGcke8zi1ePI%2Fuploads%2Fgit-blob-ca702a8d19b7cc6fa2f9db82957d71c443acfeea%2Fadmin-novo-integracoes-webhooks-2026.png?alt=media" alt="Tela Integrações do admin novo filtrada por Webhooks, com os cards Webhook de Conversão, Webhook Customizável e Webhook de Login"><figcaption><p>Imagem exemplo da plataforma</p></figcaption></figure>

**2. Abra o card "Webhook de Conversão", ligue "Ativar webhook", preencha a "Webhook URL" e clique em Salvar.**

<figure><img src="https://2520162152-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAf7j6zODfGcke8zi1ePI%2Fuploads%2Fgit-blob-887df4bad7f6a60cb7e1d7a55d974eaceacbd42d%2Fadmin-novo-webhook-conversao-2026.png?alt=media" alt="Card Webhook de Conversão aberto, com a opção Ativar webhook ligada, o campo Webhook URL, o botão Verificar logs e o botão Salvar"><figcaption><p>Imagem exemplo da plataforma</p></figcaption></figure>

Em **Verificar logs** você vê o histórico de envios.

{% hint style="info" %}
**Admin antigo:** o card **Webhook Conversão** só aparece em **Controle > Integrações** para marcas que já o configuraram antes. Se ele não aparecer para você, configure pelo admin novo.
{% endhint %}
