> ## Documentation Index
> Fetch the complete documentation index at: https://help.vistum.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# Conectar Eduzz

> Receba as vendas aprovadas e cancelamentos da Eduzz direto no CRM, com os dados do comprador já preenchidos.

## O que é a Eduzz

A Eduzz é uma plataforma brasileira de venda de produtos digitais e infoprodutos. Cada compra, reembolso ou cancelamento pode ser avisado ao Vistum por **postback/webhook** — e o CRM transforma isso em contato + negociação automaticamente.

## Como funciona a conexão

No Vistum, conectar a Eduzz significa criar uma **automação com o gatilho "Webhook recebido"**. Esse gatilho gera uma **URL única com um token**. Você cola essa URL no painel da Eduzz e escolhe os eventos.

<Note>
  Não existe botão de "conectar com 1 clique". A ligação é sempre feita pela URL + token que o Vistum gera para a sua automação.
</Note>

## Passo 1 — Pegar a URL no Vistum

<Steps>
  <Step title="Crie ou abra a automação">
    No CRM, vá em **Automações** e crie uma nova automação (ou abra uma existente) para receber as vendas da Eduzz.
  </Step>

  <Step title="Escolha o gatilho Webhook recebido">
    No primeiro nó da automação, selecione o gatilho **Webhook recebido**.
  </Step>

  <Step title="Selecione a plataforma">
    No campo **Plataforma**, selecione **Eduzz**. Assim o Vistum já sabe o formato dos dados que vão chegar. As opções disponíveis são Hotmart, Kiwify, Eduzz, Perfect Pay, Kirvano, Monetizze, Braip, Lastlink e Cartpanda.
  </Step>

  <Step title="Confira os campos mapeados">
    O Vistum já traz o **mapeamento de campos** pronto para a Eduzz, no painel **Campos mapeados**: Nome, E-mail, Telefone, Produto, Valor, ID externo (para evitar duplicar a mesma transação), Evento (ex.: `myeduzz.invoice_paid`) e CPF/CNPJ. Só confira se está tudo certo.

    <Note>
      Por padrão, apenas a **fatura paga** (`myeduzz.invoice_paid`) dispara a automação. Reembolso, cancelamento e boleto em aberto são ignorados sozinhos — você não precisa filtrar na mão.
    </Note>
  </Step>

  <Step title="Copie a URL gerada">
    O Vistum mostra uma URL única, parecida com:

    ```
    https://crm.vistum.com.br/api/automations/webhook-in/SEU_TOKEN
    ```

    Clique em **Copiar**.
  </Step>
</Steps>

<Note>
  Essa URL é exclusiva da sua automação e do seu workspace. Trate como senha.
</Note>

<Frame>
  <img src="https://mintcdn.com/vistumcrm/oDKWqyzWRlFuIrzQ/images/integracoes/eduzz.png?fit=max&auto=format&n=oDKWqyzWRlFuIrzQ&q=85&s=eee2d07084a0708388a62084c7335f62" alt="Gatilho Webhook recebido no Vistum mostrando a URL e o token da automação Eduzz" width="1440" height="900" data-path="images/integracoes/eduzz.png" />
</Frame>

## Passo 2 — Colar na Eduzz

<Steps>
  <Step title="Abra a área de Webhooks">
    Na Eduzz, vá em **Ferramentas → Webhooks (myEduzz)**.
  </Step>

  <Step title="Cadastre uma nova URL">
    Clique em **Adicionar webhook** e cole a URL que você copiou do Vistum.
  </Step>

  <Step title="Selecione o evento">
    Marque **Fatura paga** (`myeduzz.invoice_paid`) — é a venda que vira lead no CRM.

    Se quiser reagir a cancelamento ou reembolso, marque também os eventos correspondentes e trate-os em uma **automação separada** com filtro de evento próprio. Veja [Reembolso e cancelamento](/automacoes/gatilhos#reembolso-e-cancelamento).
  </Step>

  <Step title="Salve e dispare uma venda de teste">
    Confirme o cadastro na Eduzz.
  </Step>
</Steps>

## Eventos que a Eduzz envia

O Vistum reconhece estes eventos da Eduzz:

| Evento                            | O que significa                                    |
| --------------------------------- | -------------------------------------------------- |
| `myeduzz.invoice_paid`            | Fatura paga — **é o único que dispara por padrão** |
| `myeduzz.invoice_waiting_payment` | Aguardando pagamento (boleto/Pix gerado)           |
| `myeduzz.invoice_refused`         | Pagamento recusado                                 |
| `myeduzz.invoice_canceled`        | Fatura cancelada                                   |
| `myeduzz.invoice_refunded`        | Reembolso                                          |
| `myeduzz.invoice_chargeback`      | Chargeback                                         |
| `myeduzz.contract_canceled`       | Assinatura cancelada                               |
| `myeduzz.contract_up_to_date`     | Assinatura em dia                                  |

## Campos detectados

| Campo            | Variável nas mensagens  |
| ---------------- | ----------------------- |
| Nome             | `{{name}}`              |
| E-mail           | `{{email}}`             |
| Telefone         | `{{phone}}`             |
| Produto          | `{{webhook.product}}`   |
| Valor            | `{{webhook.amount}}`    |
| Status da compra | `{{webhook.status}}`    |
| Tipo do evento   | `{{webhook.eventType}}` |
| CPF/CNPJ         | `{{webhook.document}}`  |

<Note>
  Os dados da compra usam sempre o prefixo **`webhook.`**. Digite duas chaves na mensagem e **escolha na lista**, no grupo **Webhook** — `{{webhook.product}}`, `{{webhook.amount}}`, `{{webhook.status}}`, `{{webhook.email}}`, `{{webhook.document}}`, `{{webhook.externalId}}` e `{{webhook.eventType}}` estão todas lá. Veja todas em [Usar variáveis nas mensagens](/automacoes/variaveis).
</Note>

## Passo 3 — Testar

A Eduzz normalmente tem um botão de **testar / enviar postback de teste** na própria configuração. Use ele para mandar um evento sem precisar de venda real. Se não houver, faça uma **compra de teste**.

No Vistum, o status muda para **● Conectado** e aparece o **último evento recebido**.

## Passo 4 — Ver a execução

Depois do evento, confira em **Execuções** (`/automacoes/execucoes` ou em **Histórico**). Lá você vê se o contato foi criado e o que a automação fez.

## Deu erro? Webhook não chegou?

Se nada apareceu no Vistum, veja [O webhook não chegou](/problemas/webhook-nao-chegou). Verifique:

* URL colada certa (sem perder parte do token).
* Evento marcado na Eduzz.
* Limite de eventos do mês não excedido.