Integração · Webhook e API

A Formlytics chama o seu endpoint a cada resposta, com o método e o token que você definir

Para quem tem um sistema próprio: a cada resposta concluída, a Formlytics envia os dados para o seu endpoint usando POST, PUT ou PATCH, com um token Bearer se você quiser. O pacote já vai completo, com respostas e origem.

Formlytics + API personalizada

  • Plano Pro ou Business
  • Um endpoint público em HTTPS que aceite JSON
  • Opcional: token de autenticação

Como funciona

O caminho de cada resposta

  1. Você informa o endpoint público do seu sistema.
  2. Escolhe o método HTTP: POST, PUT ou PATCH.
  3. Se o endpoint exigir autenticação, informa um token, enviado como Authorization Bearer.
  4. A cada resposta concluída, a Formlytics chama o endpoint com os dados completos.

O que você ganha

Na prática

  • Método HTTP à escolha: POST, PUT ou PATCH
  • Autenticação com token Bearer
  • Dados completos: respostas, UTMs, IDs de clique, consentimento e metadados
  • Até 4 tentativas automáticas em caso de falha

Configuração

Como conectar o API personalizada

  1. Prepare o endpoint

    O seu sistema precisa aceitar uma requisição JSON no método escolhido e responder com sucesso.

  2. Configure no formulário

    Na aba Integrar, abra a API personalizada e preencha "Endpoint público" e "Método HTTP".

  3. Informe o token, se houver

    O "Token de autenticação" é enviado no cabeçalho Authorization, como Bearer.

  4. Envie uma resposta de teste

    Preencha o formulário publicado e confira o registro no seu sistema.

Casos de uso

Para que as pessoas usam

Sistema interno

Grave as respostas direto no ERP, no sistema de atendimento ou no painel da empresa.

Endpoint protegido

Quando o destino exige token, a autenticação Bearer resolve sem ferramenta intermediária.

Atualização de registros

Use PUT ou PATCH quando a resposta deve atualizar um registro em vez de criar um novo.

Cliente com tecnologia própria

Agências entregam o lead direto no sistema do cliente, com a origem da campanha.

Bom saber

Limites desta integração

  • É uma integração de saída: a Formlytics envia dados para o seu sistema. Não existe uma API pública para consultar formulários ou respostas.
  • O formato do corpo é fixo; não há mapeamento de campos.
  • Não há assinatura HMAC nesta integração. Se precisar dela, use o webhook.
  • Só respostas concluídas são enviadas.
FAQ

Dúvidas frequentes

Qual a diferença para o webhook?
O webhook sempre usa POST e pode assinar as requisições. A API personalizada deixa escolher o método (POST, PUT ou PATCH) e autentica com token Bearer.
Posso consultar as respostas pela API?
Não. A Formlytics não tem API de leitura. Os dados saem por exportação em CSV, pelas integrações, pelo webhook ou por esta integração.
E se o meu sistema estiver fora do ar?
A entrega é tentada de novo, até 4 vezes.
Sua vez

Crie seu primeiro formulário em menos de 1 minuto

Perguntas certas, na ordem certa, que fazem a resposta acontecer.

Plano Grátis sem cartão de crédito · 7 dias de teste nos planos pagos