Responda aos clientes no WhatsApp com dados em tempo real: preços, stock e disponibilidade do seu sistema
Para responder a perguntas no WhatsApp sobre preços, stock ou disponibilidade com valores atuais, envie a mensagem do cliente para o seu sistema assim que chegar, procure o valor lá e devolva o texto da resposta. O passo de webhook de uma automatização faz isto: envia por POST a mensagem e o número do cliente, e uma resposta JSON com um campo reply, devolvida em até 20 segundos, segue como resposta no WhatsApp.
O easyCoexistence liga o número do WhatsApp Business que mantém na aplicação à Cloud API da Meta, através da Coexistência, e executa automatizações nele.
Tempo que o passo Chamar o meu webhook espera pela resposta do seu sistema antes de falhar.
Mensagens recentes da conversa enviadas com o pedido, da mais antiga para a mais recente, para que uma pergunta de seguimento mantenha o contexto.
Caracteres de uma resposta enviada como um único texto no WhatsApp; o texto mais longo é cortado.
Os URL de webhook têm de ser HTTPS públicos; http e endereços privados são recusados, e os redirecionamentos não são seguidos.
Janela após a última mensagem do cliente em que a Meta aceita respostas de texto livre; uma nova pergunta abre-a de novo.
Como funciona uma resposta com dados em tempo real?
Uma automatização apanha a mensagem, normalmente uma automatização por palavra-chave para palavras de preço ou stock. O passo Chamar o meu webhook envia por POST a mensagem, o número do cliente e a conversa recente para o seu URL, assinado com o segredo próprio da automatização. O seu código lê o valor e responde com HTTP 200 e um corpo JSON, por exemplo {"reply": "Pão de fermentação natural: US$ 6.50, restam 14 hoje."}. O easyCoexistence verifica a janela de 24 horas e envia esse texto a partir do seu número.
Antes de o seu sistema ser chamado, a execução já passou pelas proteções incorporadas: as entregas repetidas da Meta nunca iniciam uma segunda execução, e uma conversa à qual respondeu a partir do telemóvel fica sem intervenção durante 4 horas, por predefinição. A resposta também aparece no fio da conversa na aplicação, para que quem tem o telemóvel veja o que foi dito ao cliente.
Porque não manter preços e stock numa resposta fixa ou nas Instruções da IA?
Uma resposta fixa é escrita uma vez, e o passo Responder com IA escreve apenas a partir de duas fontes: as suas Instruções e a conversa recente. Nenhuma delas muda quando um produto se esgota ou um horário é reservado. O passo de IA também recebe a indicação, nas suas instruções, de nunca inventar preços, stock, datas ou políticas que não consegue ver, por isso uma pergunta sobre o stock de hoje recebe um encaminhamento cortês em vez de um número.
Os valores que mudam ao longo do dia pertencem ao sistema que já os guarda: a loja, a folha de cálculo, o calendário de marcações ou o ERP. O passo Chamar o meu webhook deixa esse sistema responder diretamente ao cliente, com o valor que tem naquele segundo, a partir do número do WhatsApp Business que a equipa continua a usar na aplicação.
Que perguntas devem ir para o seu sistema?
As que têm uma resposta que muda mais depressa do que edita um texto. Encaminhe-as com um gatilho Tem palavra-chave no modo Contém, até 30 palavras, em cada idioma que serve. As automatizações por palavra-chave são verificadas antes de Primeira mensagem, Fora de horas e do apanha-tudo, e só uma automatização responde a cada mensagem, por isso um assistente de IA no apanha-tudo mantém as outras perguntas. Contém corresponde dentro das palavras, por isso prefira termos completos a fragmentos curtos:
- Preços: price, how much, price list, preço, quanto custa, precio, cuánto cuesta.
- Stock: stock, available, in store, em stock, disponível, disponible.
- Horários livres: appointment, slot, table for, horário, vaga, una cita, mesa para.
- Taxa de entrega ou zona por código postal: delivery fee, portes, taxa de entrega, envío, código postal.
- Estado de hoje: open today, holiday, aberto hoje, feriado, abierto hoy.
Que recebe o seu sistema e que devolve?
Um POST JSON com o cabeçalho X-EC-Event definido como automation.step. Os campos de que uma consulta precisa são message.text, onde aparece o nome ou código do produto, e contact.wa_id, o número do cliente em dígitos internacionais sem o sinal de mais, útil para preços por grupo de clientes ou um carrinho guardado. O campo history contém até 10 mensagens recentes, por isso «e em vermelho?» pode ser lido em relação à pergunta anterior. Um teste feito em Testar envia dry_run como true com um history vazio.
Responda com HTTP 200 e um texto de nível superior chamado reply. Um campo reply vazio ou em falta não envia nada, e a execução passa para qualquer passo posterior. Um código de estado fora de 2xx, um redirecionamento ou silêncio para além de 20 segundos faz o passo falhar. A página do agente n8n mostra o corpo completo.
POST https://shop.example/whatsapp/live
X-EC-Event: automation.step
X-EC-Signature: t=1762869731,v1=5f0c...
{
"event": "automation.step",
"dry_run": false,
"contact": { "id": "5511987654321", "wa_id": "5511987654321", "name": "Ana Souza" },
"message": { "id": "wamid.HBgN...", "type": "text", "text": "Is the linen shirt in size M available?", "at": "2026-11-11T14:02:11.000Z" },
"history": [ ...up to 10 recent messages, oldest first... ]
}
HTTP 200, within 20 seconds:
{ "reply": "Linen shirt, size M: 3 left, US$ 42. Want me to hold one for you until 6 pm?" }Como se constrói o endpoint em Node.js?
Leia o corpo como texto bruto, verifique o X-EC-Signature contra ele e só depois faça o parse. O cabeçalho é t=<unix seconds>,v1=<hex>, onde v1 é um HMAC-SHA256 de t, de um ponto e do corpo, com a chave do segredo de assinatura whsec_ completo da automatização. Recuse um t com mais de 5 minutos de diferença do seu relógio e compare em tempo constante.
Depois faça uma consulta rápida: uma consulta à base de dados, uma chamada em cache à API da sua loja ou uma leitura de uma lista de preços mantida em memória. Corra-a em paralelo com um temporizador, para que uma base de dados lenta ainda produza uma resposta amigável antes do limite de 20 segundos, em vez de uma execução falhada. Quando nada corresponde, peça o nome ou código do produto em vez de adivinhar.
import express from "express";
import crypto from "node:crypto";
const SECRET = process.env.EC_SIGNING_SECRET; // the automation's Signing secret, from its editor page
function signed(req) {
const m = /^t=(\d+),v1=([0-9a-f]{64})$/.exec(req.get("X-EC-Signature") || "");
if (!m || Math.abs(Date.now() / 1000 - Number(m[1])) > 300) return false;
const mac = crypto.createHmac("sha256", SECRET).update(m[1] + "." + req.body).digest();
return crypto.timingSafeEqual(mac, Buffer.from(m[2], "hex"));
}
const app = express();
app.post("/whatsapp/live", express.text({ type: "application/json" }), async (req, res) => {
if (!signed(req)) return res.status(401).end();
const { message } = JSON.parse(req.body);
// Answer before the 20-second limit whatever happens: a slow lookup gets a fallback at 15 s.
const late = new Promise((r) => setTimeout(() => r("late"), 15000));
const item = await Promise.race([findProduct(message.text), late]); // your SQL, API or cache
if (item === "late") return res.json({ reply: "Let me check that for you. A person will reply here shortly." });
if (!item) return res.json({ reply: "Which product do you mean? Send its name or code and I will look it up." });
const stock = item.stock > 0 ? item.stock + " in stock" : "out of stock today";
res.json({ reply: item.name + ": " + item.price + ", " + stock + "." });
});
app.listen(3000);A um modelo pode escrever a resposta a partir dos dados em tempo real?
Sim, por detrás do webhook. O seu endpoint, ou um fluxo n8n com um nó AI Agent, obtém primeiro os valores, através de uma consulta ou de uma ferramenta, e pede ao seu modelo que formule a resposta com eles: «O cliente perguntou X. Stock atual: Y. Responda numa ou duas frases, no idioma do cliente.» O campo reply passa então a conter o texto do modelo. O passo Responder com IA, sozinho, não tem ferramentas nem navegação, por isso este é o caminho para respostas que misturam redação com dados.
Mantenha toda a ida e volta, consulta mais chamada ao modelo, bem abaixo de 20 segundos. Peça ao modelo uma resposta curta, escolha um modelo rápido e mantenha o temporizador de recurso para o dia em que o fornecedor estiver lento.
Quais são os limites de uma resposta por webhook?
A resposta por webhook é texto simples enviado uma vez, o que cobre a maioria das respostas sobre preços, stock e disponibilidade. Tudo o que for mais rico segue pela Cloud API da Meta, enviada pelo seu sistema. Os pontos a planear:
- Só texto, até 4,096 caracteres, sem markdown. Imagens, botões ou templates: envie-os a partir do seu sistema com o endpoint de envio de
get_api_credentialse não devolva resposta. - Uma tentativa, sem repetição. Um tempo esgotado ou um erro marca a execução como Falhada e envia-lhe um e-mail, no máximo uma vez por automatização a cada 6 horas.
- Um passo de resposta colocado depois do webhook também envia, por isso o cliente receberia duas mensagens.
- Respostas de texto livre só saem nas 24 horas após a última mensagem do cliente; um passo Aguardar antes do webhook pode ultrapassá-la.
Como configurar
- Expose the lookupPublish an HTTPS endpoint or an n8n workflow that verifies X-EC-Signature, reads message.text and contact.wa_id, and returns {"reply": "..."}.
- Create the automation, switched OffIn Automations, click New automation, pick Send to my system under Start from an example, change the trigger to Has keyword with your price or stock words, paste the URL into Webhook URL, set the switch to Off and click Save.
- Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's settings.
- Try a real questionClick Test, type a question such as "Is the linen shirt in size M available?" in Try it and press Run test. Your system really runs with dry_run true; the result shows the reply.
- Switch it OnWhen the reply reads right, set the switch to On and save. Send a question from another phone and open the run under Runs to see the timing.
Erros comuns
- Colar preços nas Instruções da IA e esquecê-los. O modelo cita valores do mês passado com confiança; mantenha os números que mudam no seu sistema e deixe que o webhook os leia.
- Executar um relatório lento dentro do pedido. Ao fim de 20 segundos o passo falha e nada é enviado; consulte um índice ou uma cache, e responda com uma linha de recurso aos 15 segundos.
- Acrescentar um passo Responder com texto depois do webhook como rede de segurança. Corre também após uma resposta bem-sucedida, por isso os clientes recebem duas mensagens; coloque os textos de recurso no seu endpoint.
- Usar fragmentos curtos de palavras-chave como «tem» ou «cost». Contém corresponde dentro das palavras, por isso item, temperatura ou costume acionam a consulta; use termos completos e teste-os em Testar.
Um passo Chamar o meu webhook traz o seu próprio sistema para a conversa: envia a pergunta, assinada, e entrega a resposta que o seu sistema devolver, com deduplicação, a pausa quando responde a partir do telemóvel e a verificação das 24 horas incluídas, sem custo extra por execução. De US$ 9 a US$ 0.75 por número ligado por mês, descendo à medida que adiciona números, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Pode uma folha de cálculo do Google Sheets ser a lista de preços?
Sim. Um fluxo n8n pode procurar o produto na folha com um nó do Google Sheets e depois devolver o preço e o stock da linha como resposta. O Google limita as leituras por minuto e por utilizador, por isso, para números movimentados, guarde a folha em cache no fluxo ou no seu backend e atualize-a a cada poucos minutos.
O meu sistema tem de estar online permanentemente?
Para esta automatização, sim: um pedido que falhe ou exceda o tempo marca a execução como Falhada, não envia nada e envia-lhe um e-mail. Coloque uma segunda automatização, de prioridade inferior, como um assistente de IA no apanha-tudo, para as outras perguntas, e mantenha a linha de recurso do próprio endpoint para os momentos lentos.
Podem o ChatGPT ou o Claude configurar esta automatização por mim?
Sim. Com o conector do easyCoexistence, peça uma automatização por palavra-chave no seu número que chame o seu URL; a IA usa create_automation com um passo call_webhook e depois test_automation. O segredo de assinatura não é devolvido através do MCP, por isso copie-o da página da automatização no painel.
As respostas com dados em tempo real custam mais?
Não pelo easyCoexistence: as automatizações não têm custo por execução nem limite de execuções. A Meta cobra as mensagens à conta WhatsApp Business da própria empresa, por mensagem, por categoria e por país, e o easyCoexistence nunca as acrescenta. O seu servidor ou ferramenta de fluxos custa o que custa hoje.
Continue a ler
Pronto para começar?
Configure a Coexistência do WhatsApp em minutos, não em meses. A aplicação continua a funcionar no telemóvel.
Começar período experimental gratuitoVerificado em