Webhooks

Envie dados das respostas para qualquer sistema externo.

Disponibilidade

Esta funcionalidade está disponível nos planos Pro e Premium.

O que é um webhook?

Um webhook é uma URL que recebe dados automaticamente quando um evento acontece (ex: nova resposta).

Configurando webhooks

Passo 1: Acessar configurações

1. Vá em Configurações → Integrações
2. Clique no card "Webhooks"
3. Clique em "Novo Webhook"

Passo 2: Configurar

• URL do Endpoint: Endereço que receberá os dados (ex: https://seu-site.com/webhook)
• Eventos: Selecione quais eventos disparam o webhook
• Formulário: Todos ou um específico

Passo 3: Salvar e testar

Após criar o webhook, ele aparece na lista. Você pode:

• Ativar/desativar usando o switch
• Clicar no botão ▶ (play) para testar o webhook
• Ver os logs de disparos no menu de opções

Eventos disponíveis

• Resposta criada (response.created): Quando uma resposta começa
• Resposta completada (response.completed): Quando uma resposta é finalizada
• Resposta atualizada (response.updated): Quando uma resposta é modificada
• Resposta analisada (response.analyzed): Quando a análise de IA da resposta conclui

Formato dos dados

Os dados são enviados como POST em JSON:

{
  "event": "response.completed",
  "timestamp": "2026-08-07T10:30:00.000Z",
  "data": {
    "response_id": "xyz789",
    "form_id": "abc123",
    "form_title": "Diagnóstico comercial",
    "organization_id": "org123",
    "status": "COMPLETED",
    "respondent_email": "pessoa@exemplo.com",
    "total_score": 42,
    "completed_at": "2026-08-07T10:29:58.000Z",
    "answers": [
      {
        "question_id": "q1",
        "question_title": "Qual é o seu objetivo?",
        "question_type": "SHORT_TEXT",
        "value": "Aumentar conversões"
      }
    ]
  }
}

O evento response.analyzed inclui também data.insight com a classificação e a análise da IA.

Integrações comuns

• Zapier (via Webhook)
• Make (Integromat)
• n8n
• Sistemas próprios
• CRMs

Segurança

Cada webhook recebe uma chave secreta única, mostrada apenas uma vez após a criação. O FormGuru envia:

• X-FormGuru-Signature: HMAC-SHA256 hexadecimal do corpo JSON bruto usando a chave secreta
• X-FormGuru-Timestamp: instante Unix da entrega
• X-FormGuru-Event: nome do evento
• X-FormGuru-Delivery: ID estável da entrega

Valide a assinatura com comparação em tempo constante e rejeite timestamps antigos. Guarde X-FormGuru-Delivery como chave idempotente: em uma falha rara depois do seu servidor responder 2xx, a mesma entrega pode ser reenviada com o mesmo ID.

Logs e monitoramento

Na lista de webhooks, você pode ver:

• Quantidade de disparos
• Taxa de sucesso (%)
• Data do último disparo

Clique em "Ver logs" para ver o histórico detalhado de cada disparo.