Como Conectar Webhooks, Zapier e Make ao SocialProof.Reviews

Os depoimentos são mais poderosos quando fluem automaticamente para o resto do seu negócio — seu CRM, seu Slack, sua plataforma de e-mail marketing, sua planilha. O SocialProof.Reviews dispara um webhook toda vez que um novo depoimento é enviado, dando a você um gatilho em tempo real que pode ser roteado para qualquer lugar.

O Que É um Webhook?

Um webhook é uma requisição HTTP POST que seu workspace envia para uma URL que você escolhe, no momento em que um novo depoimento chega. O payload contém tudo sobre o envio — o nome do avaliador, e-mail, classificação, texto da avaliação, fotos e metadados. Seu sistema receptor pode então fazer qualquer coisa: registrar, notificar sua equipe, atualizar um registro de CRM ou acionar uma sequência de drip.

Configurando Sua URL de Webhook

Passo 1: Navegue até as configurações do seu workspace

Faça login no SocialProof.Reviews, abra seu workspace e vá para a seção Embed e Integrações no seu painel de administração. Encontre a guia Webhooks.

Passo 2: Adicione sua URL de endpoint

Cole a URL que deve receber a requisição POST. Pode ser:

Passo 3: Salve e teste

Clique em Salvar e use o botão Enviar evento de teste para disparar um payload de exemplo para seu endpoint. Verifique se ele chega corretamente antes de entrar em produção.

Formato do payload de webhook

Cada envio de depoimento envia um payload JSON estruturado assim:

{
  "event": "testimonial.submitted",
  "workspaceId": "abc123",
  "testimonialId": "t_xyz789",
  "submittedAt": "2026-03-17T10:30:00Z",
  "reviewer": {
    "name": "Jane Smith",
    "email": "[email protected]",
    "jobTitle": "Head of Marketing",
    "company": "Acme Corp",
    "photoUrl": "https://..."
  },
  "rating": 5,
  "review": "Esta ferramenta mudou completamente a forma como coletamos e exibimos o feedback dos clientes.",
  "photos": ["https://...", "https://..."],
  "videoUrl": null,
  "approved": false,
  "source": "collect-form"
}

Conectando ao Zapier

O Zapier permite que você conecte o SocialProof.Reviews a mais de 6.000 aplicativos sem escrever nenhum código.

Passo 1: Crie um novo Zap

Faça login em zapier.com e clique em Criar Zap.

Passo 2: Configure o gatilho

  1. Pesquise e selecione Webhooks by Zapier como seu aplicativo de gatilho
  2. Escolha Catch Hook como o evento de gatilho
  3. Clique em Continuar — o Zapier gerará uma URL de webhook única como https://hooks.zapier.com/hooks/catch/123456/abcdef/
  4. Copie essa URL

Passo 3: Cole a URL no SocialProof.Reviews

  1. Vá para a página Webhooks e Zapier do seu workspace no painel de administração
  2. Cole a URL do Zapier no campo URL do Endpoint
  3. Clique em Salvar alterações

Passo 4: Teste — o Zapier deve estar ouvindo primeiro

⚠️ Importante: O Zapier só aceita o payload de teste enquanto está ativamente aguardando um gatilho. Se não estiver ouvindo, você receberá um erro 401.

  1. No Zapier, certifique-se de que está na etapa Testar gatilho — o Zapier agora está ouvindo
  2. Volte ao SocialProof.Reviews e clique em ⚡ Enviar teste
  3. Retorne ao Zapier e clique em Testar gatilho — ele confirmará que recebeu o payload e mostrará todos os campos disponíveis (nome do avaliador, e-mail, classificação, texto da avaliação, etc.)

Passo 5: Adicione sua ação

Agora conecte qualquer ação que desejar. Exemplos:

Notifique sua equipe no Slack:

Adicione o avaliador à sua lista de e-mail (Mailchimp):

Registre em uma Planilha Google:

Crie um contato no HubSpot:

Passo 6: Ative seu Zap

Clique em Publicar e cada novo envio de depoimento agora acionará automaticamente seu fluxo de trabalho.


Conectando ao Make (anteriormente Integromat)

O Make é uma plataforma de automação mais visual e amigável para desenvolvedores. É ideal se você precisar de fluxos de múltiplas etapas, lógica condicional ou transformação de dados.

Passo 1: Crie um novo cenário

Faça login em make.com e clique em Criar um novo cenário.

Passo 2: Adicione um módulo Webhooks

  1. Clique no + para adicionar um módulo
  2. Pesquise por Webhooks
  3. Selecione Custom webhook (escolha este — não "Custom mailhook")
  4. Clique em Adicionar → dê um nome (ex.: "SocialProof Reviews") → clique em Salvar
  5. O Make gera uma URL como https://hook.eu1.make.com/abc123xyzcopie-a
  6. Clique em OK no módulo de webhook — o módulo mostrará um ícone de relógio (🕐), o que significa que agora está aguardando dados ativamente

Passo 3: Cole no SocialProof.Reviews

  1. Vá para a página Webhooks e Zapier do seu workspace no painel de administração
  2. Cole a URL do Make no campo URL do Endpoint
  3. Clique em Salvar alterações

Passo 4: Envie o teste — o Make deve estar ouvindo primeiro

⚠️ Importante: O Make só aceita o webhook enquanto está ouvindo ativamente. Se o Make não estiver no modo de escuta, você receberá um erro 401.

  1. No Make, confirme que o ícone de relógio está visível no módulo de webhook — isso significa que está aguardando
  2. Se o relógio não estiver mostrando, clique em Executar uma vez (canto inferior esquerdo do editor de cenário) para reativá-lo
  3. Volte ao SocialProof.Reviews e clique em ⚡ Enviar teste
  4. Retorne ao Make — ele terá capturado o payload e detectado automaticamente todos os campos (event, nome do avaliador, e-mail, classificação, texto da avaliação, etc.)
  5. Clique em OK para confirmar a estrutura de dados

Passo 5: Determine a estrutura de dados

Após o payload de teste ser recebido, o Make mostra todos os campos disponíveis para usar em sua automação.

Passo 5: Adicione módulos após o gatilho

Exemplos de automações poderosas no Make:

Filtre por classificação e notifique:

Aprove automaticamente depoimentos de alta classificação:

Adicione a um CRM com lógica condicional:

Crie uma entrada de banco de dados no Notion:

Passo 6: Ative o cenário

Clique no toggle de energia no canto inferior esquerdo do editor de cenário para ativá-lo. O Make agora processará cada webhook de depoimento recebido.


Nota de Segurança

O SocialProof.Reviews envia webhooks de um conjunto fixo de endereços IP e inclui um cabeçalho de assinatura (X-SPR-Signature) que você pode usar para verificar se a requisição é genuína. Para validar:

  1. Compute HMAC-SHA256 do corpo bruto da requisição usando sua chave secreta do workspace
  2. Compare com o valor em X-SPR-Signature
  3. Processe a requisição apenas se eles coincidirem

Isso previne ataques de replay e garante que ninguém possa falsificar depoimentos falsos em suas automações.


Casos de Uso Comuns de Webhook

Caso de uso Plataforma Gatilho Ação
Alerta em tempo real no Slack Zapier testimonial.submitted Mensagem Slack
Auto-tag na lista de e-mail Make testimonial.submitted (rating ≥ 4) Marcar assinante
Registrar todas as avaliações Zapier testimonial.submitted Linha no Planilhas Google
Enviar ao CRM Make testimonial.submitted Contato HubSpot/Salesforce
Auto-aprovar 5 estrelas Make testimonial.submitted (rating = 5) API PATCH approved=true
Acionar sequência de drip Zapier testimonial.submitted Automação Mailchimp

Solução de Problemas

Passo 1 — Verifique com webhook.site primeiro

Antes de culpar o Make, Zapier ou seu próprio servidor, confirme que o SocialProof.Reviews está realmente enviando a requisição:

  1. Vá para webhook.site — você obterá uma URL única imediatamente (sem necessidade de cadastro)
  2. Copie essa URL
  3. Cole-a no campo URL do Endpoint nas suas configurações de Webhooks e Zapier
  4. Clique em Salvar alterações
  5. Clique em ⚡ Enviar teste

Você deve ver ✓ Enviado! Payload entregue ao seu endpoint. no aplicativo, e uma nova requisição aparecer no webhook.site em um ou dois segundos. Clique nela para inspecionar o payload JSON completo.

Se o webhook.site o receber, seu webhook do SocialProof.Reviews está funcionando corretamente — o problema está na configuração do Make/Zapier, não na plataforma. Prossiga para o Passo 2.

Se o webhook.site não o receber, verifique novamente se você clicou em Salvar alterações após colar a URL e que o toggle Habilitar webhooks está ativado.


Passo 2 — Corrigir erro 401 do Make: exclua e recrie o módulo de webhook

Um 401 do Make significa que o token de webhook é inválido ou não registrado — o Make não reconhece a URL. Isso acontece quando um cenário não foi salvo corretamente após a criação do webhook, ou o webhook foi excluído. Simplesmente clicar em "Executar uma vez" não corrigirá um 401; você precisa recriar o módulo de webhook completamente.

  1. No seu cenário Make, clique com o botão direito no módulo Webhooks → clique em Excluir
  2. Clique no + para adicionar um novo módulo → pesquise por Webhooks → selecione Custom webhook
  3. Clique em Adicionar → dê um nome (ex.: "SocialProof Reviews") → clique em Salvar
  4. O Make gera uma nova URL — copie-a e clique em OK para fechar o diálogo
  5. Crítico: clique no botão 💾 Salvar (topo do editor de cenário) para persistir o novo webhook. Se você pular esta etapa, o token não será registrado e você receberá 401 novamente.
  6. Agora clique em Executar uma vez (canto inferior esquerdo) — um ícone de relógio (🕐) deve aparecer no módulo de webhook, o que significa que o Make está agora ouvindo ativamente
  7. Volte ao SocialProof.Reviews — cole a nova URL em URL do Endpoint, clique em Salvar alterações, depois clique em ⚡ Enviar teste

O Make capturará o payload e mostrará todos os campos disponíveis. Clique em OK para confirmar a estrutura de dados e continue construindo seu cenário.


✗ HTTP 401 — Make/Zapier rejeitou a requisição. A causa mais comum é que o Make ou Zapier não estava ouvindo ativamente quando você clicou em Enviar teste, ou o token de webhook é inválido (veja o Passo 2 acima para o Make). Solução:

✗ HTTP 404 — URL de webhook não encontrada. A URL foi excluída ou o cenário/zap foi desativado. Volte ao Make ou Zapier, verifique se o módulo de webhook ainda existe e copie uma URL nova.

✗ Não foi possível conectar / HTTP 0. A URL não é alcançável ou você ainda não a salvou. Certifique-se de ter clicado em Salvar alterações após colar a URL e que a URL começa com https://.

O teste entrega, mas envios reais não. Verifique duas coisas: (1) o toggle Habilitar webhooks está ativado e salvo, e (2) os eventos que você deseja estão marcados em Eventos para enviar. Envios reais só disparam quando o webhook está habilitado.

Meu endpoint não está recebendo o webhook. Verifique se sua URL é publicamente acessível — URLs de localhost serão rejeitadas. Use webhook.site para confirmar que o payload está sendo enviado (veja o Passo 1 acima).

Estou recebendo eventos duplicados. Implemente idempotência em seu endpoint receptor usando testimonialId como chave de deduplicação.