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.

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

PlataformaComo conecta
HotmartWebhook recebido (inbound)
KiwifyWebhook recebido (inbound)
EduzzWebhook recebido (inbound)
BraipWebhook recebido (inbound)
MonetizzeWebhook recebido (inbound)
Perfect PayWebhook recebido (inbound)
KirvanoWebhook recebido (inbound)
Vistum FormsEntrega de leads via o mesmo mecanismo de webhook/endpoint de leads
Webhook genéricoQualquer sistema que faça POST HTTP na URL do gatilho

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.