Integração via Webhook do Fala Cliente

O Fala Cliente oferece um webhook — uma API HTTP simples — que conecta qualquer sistema de gestão (CRM, ERP, PDV, e-commerce ou sistema próprio) à plataforma de pesquisa de satisfação e NPS. A cada nova venda, contrato ou atendimento no seu sistema, os dados do cliente são enviados automaticamente para o Fala Cliente, que dispara a pesquisa de satisfação — sem nenhuma intervenção manual.

Esta é a documentação técnica pública do webhook do Fala Cliente. Ela serve a desenvolvedores, integradores e a qualquer sistema, automação ou agente de IA capaz de fazer uma requisição HTTP.

O que você pode conectar ao Fala Cliente

O webhook aceita dados de qualquer sistema capaz de fazer uma requisição HTTP POST:

CRMs — HubSpot, RD Station, Pipedrive, Salesforce, Kommo
ERPs e PDVs — Omie, Bling, Tiny, TOTVS, SAP
E-commerce — Shopify, WooCommerce, Nuvemshop, VTEX
Plataformas de automação — n8n, Zapier, Make (Integromat), Albato
Sistemas próprios — qualquer backend que faça HTTP POST

Endpoint

O webhook recebe requisições POST neste endereço:

POST https://wdnzyxbubrdpvaujzfnb.supabase.co/functions/v1/webhook-receiver

O corpo da requisição deve ser um JSON com os dados do cliente, e o cabeçalho Content-Type deve ser application/json.

Autenticação

Cada webhook tem um token exclusivo, gerado automaticamente quando você cria o webhook no painel do Fala Cliente. Envie o token no cabeçalho Authorization:

Authorization: Bearer SEU_TOKEN

O token não expira — funciona enquanto o webhook estiver ativo. Se suspeitar de vazamento, regenere-o a qualquer momento no painel; o token antigo para de funcionar na hora. Cada webhook tem o seu próprio token: não reutilize o mesmo token entre sistemas diferentes.

Campos do payload

Os dados do cliente vão no corpo da requisição, em JSON. Apenas dois campos são obrigatórios; os demais enriquecem os relatórios e a segmentação das pesquisas.

Campos obrigatórios

Campo	Tipo	Descrição
`nome_razao_social`	texto (até 255)	Nome completo do cliente ou razão social
`telefone`	texto	Celular brasileiro com DDD + 9 dígitos (ex.: 31999998888)

Campo recomendado

Campo	Tipo	Descrição
`email`	texto (até 255)	E-mail do cliente — permite enviar a pesquisa também por e-mail

Campos opcionais

Campo	Tipo	Descrição
`servico`	texto	Produto ou serviço contratado
`valor_proposta`	número	Valor da venda ou do pedido
`unidade`	texto	Nome da filial ou unidade
`tipo_unidade`	texto	Tipo de unidade (loja, filial, sede, etc.)
`regional`	texto	Regional ou cidade da operação
`nome_vendedor`	texto	Nome do vendedor responsável
`codigo_vendedor`	texto	Código ou ID do vendedor
`id_cliente`	texto	ID do cliente no seu sistema
`id_proposta`	texto	Número da proposta ou contrato
`id_pedido`	texto	Número do pedido
`data_pagamento`	texto	Data da venda no formato DD/MM/AAAA
`canal`	texto	Canal de venda (online, presencial, telefone, etc.)
`id_execucao`	texto	ID de execução ou lote
`campo_extra1` a `campo_extra5`	texto (até 100)	Campos livres para dados adicionais do seu sistema

Exemplo de requisição

Exemplo com cURL enviando um pedido para o Fala Cliente:

curl -X POST \
  https://wdnzyxbubrdpvaujzfnb.supabase.co/functions/v1/webhook-receiver \
  -H "Authorization: Bearer SEU_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "nome_razao_social": "Joao da Silva",
    "telefone": "31999998888",
    "email": "joao@email.com",
    "servico": "Plano Mensal",
    "valor_proposta": 250.00,
    "unidade": "Loja Centro",
    "id_proposta": "PED-12345"
  }'

Respostas HTTP

Código	Significado
`200`	Sucesso — o pedido foi criado e a pesquisa será disparada
`400`	Payload inválido — campo obrigatório faltando ou telefone inválido
`401`	Token inválido ou ausente no cabeçalho Authorization
`429`	Limite de requisições ou de créditos do plano excedido

Normalização automática dos dados

O Fala Cliente normaliza os dados recebidos automaticamente:

Telefone — convertido para o formato internacional (55 + DDD + número). Aceita apenas celulares brasileiros com DDD válido.
E-mail — convertido para minúsculas.
Textos (unidade, regional, serviço, vendedor, canal) — convertidos para maiúsculas e sem acentos.
Data — convertida de DD/MM/AAAA para o formato ISO. Se o formato estiver incorreto, o campo é ignorado.

Limites e regras

Rate limit: 100 requisições por minuto por empresa.
Créditos: cada requisição bem-sucedida consome 1 crédito do plano.
Telefone: são aceitos apenas celulares brasileiros — números fixos e inválidos são rejeitados.
Envio em lote: é possível enviar um array de objetos JSON; cada objeto é processado como um pedido individual.
Duplicatas: pedidos com o mesmo id_proposta recebidos nas últimas 24 horas são ignorados.
HTTPS: o endpoint é HTTPS por padrão. Nunca compartilhe sua URL e token publicamente.

Como configurar o webhook em 6 passos

No painel do Fala Cliente, acesse Gatilhos → aba Webhook.
Clique em "+ Adicionar Webhook" e escolha uma integração pré-configurada (ex.: Pacto) ou o Webhook Genérico.
Dê um nome ao webhook e selecione a unidade vinculada.
Copie a URL e o token gerados.
No seu sistema ou automação, configure um HTTP POST para essa URL, com o header Authorization: Bearer SEU_TOKEN e o JSON no corpo.
Clique em "Testar Conexão" e confira o resultado na aba de Logs de eventos.

Você pode criar quantos webhooks quiser — o cenário mais comum é um webhook por unidade ou filial. Os créditos são compartilhados entre todos os webhooks da empresa.

Integrações pré-configuradas

Alguns sistemas têm integração nativa, sem necessidade de programar nem mapear campos manualmente — basta seguir o assistente de configuração. Atualmente o Fala Cliente conta com integração pré-configurada para o Pacto Soluções (sistema de gestão para academias), com outros parceiros em expansão. Consulte a lista atualizada no painel, em Gatilhos → Webhook → Adicionar.

Conectar via n8n, Zapier ou Make

Se o seu sistema não tem webhook nativo, use uma plataforma de automação para conectá-lo ao Fala Cliente:

Crie um fluxo disparado por um evento do seu CRM ou ERP (ex.: "nova venda").
Adicione um passo de HTTP Request.
Configure: método POST, a URL do webhook e o header Authorization.
Mapeie os campos do seu sistema para os campos do JSON descritos acima.
Ative o fluxo.

Perguntas frequentes

Preciso de um desenvolvedor para integrar?

Depende do sistema. Sistemas que já têm webhook nativo são configurados em minutos, sem código. Para sistemas próprios, a integração é feita pela equipe de desenvolvimento. Plataformas de automação como n8n, Zapier e Make permitem conectar sistemas sem programar.

Meu sistema não tem webhook nem API. Consigo usar o Fala Cliente?

Sim. Além do webhook, o Fala Cliente aceita importação de planilhas CSV, cadastro manual de pedidos e um gatilho por e-mail em formato JSON. Nenhuma integração técnica é obrigatória.

A integração via webhook está disponível em todos os planos?

Sim. A integração via webhook está disponível em todos os planos do Fala Cliente. Consulte os planos atuais em falacliente.ia.br.

Posso enviar vários pedidos de uma vez?

Sim. Envie um array de objetos JSON no corpo da requisição — cada objeto é processado como um pedido individual.

O que acontece se eu enviar o mesmo pedido duas vezes?

Pedidos com o mesmo id_proposta recebidos nas últimas 24 horas são ignorados automaticamente, evitando pesquisas duplicadas para o mesmo cliente.

Última atualização: maio de 2026. Para a configuração assistida e os logs de eventos em tempo real, acesse o painel do Fala Cliente em Gatilhos → Webhook.