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: Quando uma resposta começa
• Resposta completada: Quando uma resposta é finalizada
• Resposta atualizada: Quando uma resposta é modificada

Formato dos dados

Os dados são enviados como POST em JSON:

{
  "event": "response.completed",
  "form_id": "abc123",
  "response_id": "xyz789",
  "data": {
    "pergunta_1": "Resposta 1",
    "pergunta_2": "Resposta 2"
  },
  "submitted_at": "2024-01-15T10:30:00Z"
}

Integrações comuns

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

Segurança

Cada webhook recebe uma chave secreta única. Use essa chave para validar que as requisições realmente vêm do FormGuru. A chave é mostrada apenas uma vez após a criação - guarde-a em local seguro.

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.