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

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

## O que é a Kirvano

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

## Como funciona a conexão

No Vistum, conectar a Kirvano significa criar uma **automação com o gatilho "Webhook recebido"**, que gera uma **URL única com um token**. Você cola essa URL no painel da Kirvano 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 Kirvano.
  </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 **Kirvano**. 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 Kirvano, no painel **Campos mapeados**: Nome, E-mail, Telefone, Produto, Valor, ID externo (para evitar duplicar a mesma transação), Evento (ex.: `PURCHASE_APPROVED`) e CPF/CNPJ. Só confira se está tudo certo.
  </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/kirvano.png?fit=max&auto=format&n=oDKWqyzWRlFuIrzQ&q=85&s=6a20a97f8e2d1e927b9f84a445ff2362" alt="Gatilho Webhook recebido no Vistum mostrando a URL e o token da automação Kirvano" width="1440" height="900" data-path="images/integracoes/kirvano.png" />
</Frame>

## Passo 2 — Colar na Kirvano

<Steps>
  <Step title="Abra a área de Webhooks">
    Na Kirvano, entre na área de **Webhooks / Integrações** da plataforma (normalmente dentro das configurações da conta ou do produto).
  </Step>

  <Step title="Cadastre uma nova URL">
    Crie um novo webhook e cole a URL que você copiou do Vistum.
  </Step>

  <Step title="Selecione os eventos">
    Marque pelo menos:

    * **Compra aprovada / pagamento aprovado** — é a venda que vira lead no CRM
    * **Reembolso / cancelamento** (opcional) — caso queira reagir quando o cliente cancela
  </Step>

  <Step title="Salve">
    Confirme o cadastro na Kirvano.
  </Step>
</Steps>

## 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 Kirvano costuma oferecer um botão de **testar webhook** dentro da configuração. Use ele para enviar um evento de teste. 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 Kirvano.
* Limite de eventos do mês não excedido.