Skip to main content

Padrão de integração

Todas as integrações do Vistum seguem o mesmo padrão técnico: inbound via gatilho de automação. Em vez de manter um conector específico por plataforma, o Vistum oferece o gatilho de automação “Webhook recebido”, que gera uma URL única + token por automação. A plataforma externa faz um POST nessa URL com o payload dela, e a automação faz o field mapping (nome, e-mail, telefone, produto, valor, status) para criar leads, abrir cards, adicionar tags, etc. Como o mapeamento é feito na automação, qualquer plataforma capaz de disparar um webhook HTTP se conecta ao Vistum — mesmo que não esteja na lista abaixo.
A segurança do inbound é o token na URL, não HMAC. A verificação de assinatura HMAC documentada em Verificação de Assinatura vale só para webhooks de saída. Detalhes em Webhooks de Entrada.

Disponibilidade por plano

As integrações usam a cota de webhooks de entrada, que é separada da cota de webhooks outbound:
Integrar Hotmart, Kiwify, Eduzz e afins já está incluído no plano Essencial. A restrição de webhooks do Essencial vale apenas para os webhooks outbound (CRM notificando o seu sistema). Veja Planos e Limites.

O que muda de uma plataforma para outra

O mecanismo é sempre o mesmo. As únicas diferenças entre plataformas são:
  • O nome do evento de “compra aprovada”, “reembolso” ou “cancelamento” (cada plataforma usa o seu).
  • O formato do payload (nomes de campos e estrutura — alguns aninham dados do comprador em objetos como buyer ou customer).
Por isso o field mapping é feito caso a caso, dentro da automação. Veja exemplos representativos por plataforma em Plataformas de Checkout.

Plataformas suportadas

Páginas desta seção

Plataformas de Checkout

Referência técnica das 7 plataformas: evento a configurar, payload representativo e mapeamento sugerido.

Vistum Forms

Como o Vistum Forms entrega respostas como leads no CRM.

Webhooks de Entrada

O mecanismo inbound completo: URL + token, field mapping e idempotência.

Criar Lead (API)

Porta de entrada programática via POST /api/v1/leads.