EntrarComeçar teste grátis
Meta Tech Provider

Responda clientes no WhatsApp com dados em tempo real: preços, estoque e disponibilidade direto do seu sistema

Para responder perguntas no WhatsApp sobre preços, estoque ou disponibilidade com valores atualizados, encaminhe a mensagem do cliente para o seu próprio sistema assim que ela chegar, consulte o valor lá e devolva o texto da resposta. A etapa de webhook de uma automação faz isso: ela faz um POST com a mensagem e o número do cliente, e uma resposta JSON com um campo reply, devolvida em até 20 segundos, sai como a resposta no WhatsApp.

O easyCoexistence conecta o número do WhatsApp Business que você mantém no app à Cloud API da Meta por meio da Coexistência e executa automações nele.

20 s

Quanto tempo a etapa Call my webhook espera pela resposta do seu sistema antes de falhar.

10

Mensagens recentes da conversa enviadas com a requisição, da mais antiga para a mais nova, para que uma pergunta seguinte mantenha o contexto.

4,096

Caracteres de uma resposta enviada como um único texto do WhatsApp; o texto mais longo é cortado.

https only

As URLs de webhook precisam ser HTTPS públicas; http e endereços privados são recusados, e redirecionamentos não são seguidos.

24 hours

Janela após a última mensagem do cliente em que a Meta aceita respostas em texto livre; uma nova pergunta abre a janela de novo.

Como funciona uma resposta com dados em tempo real?

Uma automação captura a mensagem, normalmente uma automação por palavra-chave para termos de preço ou estoque. A etapa Call my webhook faz um POST com a mensagem, o número do cliente e a conversa recente para a sua URL, com a requisição assinada pelo segredo próprio da automação. Seu código lê o valor e responde HTTP 200 com um corpo JSON como {"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 pelo seu número.

Antes de o seu sistema ser chamado, a execução já passou pelas proteções integradas: entregas repetidas da Meta nunca iniciam uma segunda execução, e uma conversa que você respondeu pelo celular fica sem resposta automática por 4 horas, por padrão. A resposta também aparece na conversa do app, para que quem está com o celular veja o que foi dito ao cliente.

1Customer asks"Do you have the blue one in size M?"
2Has keywordstock, available, price, preço, precio...
3Call my webhookSigned POST with the text and the customer's number
4Your systemReads stock now, answers {"reply": "..."}
5Reply sentWithin 20 seconds, also visible in the app

Por que não deixar preços e estoque em uma resposta fixa ou nas Instruções da IA?

Uma resposta fixa é escrita uma única vez, e a etapa Reply with AI escreve a partir de apenas duas fontes: suas Instruções e a conversa recente. Nenhuma delas muda quando um produto esgota ou um horário é reservado. A etapa de IA também recebe, abaixo das suas instruções, a orientação de nunca inventar preços, estoque, datas ou políticas que não consegue ver; por isso, uma pergunta sobre o estoque de hoje recebe um encaminhamento educado, e não um número.

Valores que mudam ao longo do dia devem ficar no sistema que já os guarda: a loja, a planilha, a agenda de reservas ou o ERP. A etapa Call my webhook permite que esse sistema responda diretamente ao cliente, com o valor que tem naquele segundo, a partir do número do WhatsApp Business que a equipe continua usando no app.

Quais perguntas devem ir para o seu sistema?

Aquelas cuja resposta muda mais rápido do que você conseguiria editar um texto. Encaminhe-as com um gatilho Has keyword no modo Contains, com até 30 palavras, em cada idioma que você atende. As automações por palavra-chave são verificadas antes de First message, After hours e do catch-all, e apenas uma automação responde a cada mensagem, então um assistente de IA no catch-all fica com as demais perguntas. O modo Contains também encontra trechos dentro de palavras, então prefira termos completos a fragmentos curtos:

  • Preços: price, how much, price list, preço, quanto custa, precio, cuánto cuesta.
  • Estoque: stock, available, in store, estoque, disponível, disponible.
  • Horários livres: appointment, slot, table for, horário, vaga, una cita, mesa para.
  • Taxa ou área de entrega por CEP: delivery fee, frete, taxa de entrega, envío, código postal.
  • Funcionamento de hoje: open today, holiday, aberto hoje, feriado, abierto hoy.

O que o seu sistema recebe e 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 o código do produto, e contact.wa_id, o número do cliente em dígitos no formato internacional, sem o sinal de mais, útil para preços por grupo de clientes ou um carrinho salvo. history traz até 10 mensagens recentes, para que "e em vermelho?" seja lido junto com a pergunta anterior. Um teste feito pelo Try it envia dry_run true com o histórico vazio.

Responda HTTP 200 com uma string no nível raiz chamada reply. Se reply vier vazio ou não existir, nada é enviado e a execução segue para a próxima etapa, se houver. Um status fora da faixa 2xx, um redirecionamento ou mais de 20 segundos sem resposta fazem a etapa falhar. A página do agente n8n mostra o corpo completo.

Request (trimmed) and the answer your system returns
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 criar o endpoint em Node.js?

Leia o corpo como texto bruto, valide o X-EC-Signature com base nele e só então faça o parse. O cabeçalho tem o formato t=<unix seconds>,v1=<hex>, em que v1 é um HMAC-SHA256 de t, um ponto e o corpo, usando como chave o Signing secret completo da automação, com o prefixo whsec_. Rejeite um t com mais de 5 minutos de diferença em relação ao seu relógio e faça a comparação em tempo constante.

Depois, faça uma única consulta rápida: uma query no banco de dados, uma chamada com cache à API da sua loja ou a leitura de uma lista de preços mantida em memória. Ponha essa consulta para correr contra um temporizador, para que um banco lento ainda gere uma mensagem amigável antes do limite de 20 segundos, em vez de uma execução com falha. Quando nada corresponder, peça o nome ou o código do produto em vez de adivinhar.

Express endpoint for a Call my webhook step: live price and stock
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);

Um modelo de IA pode escrever a resposta com os dados em tempo real?

Sim, por trás do webhook. Seu endpoint, ou um workflow do n8n com um nó AI Agent, busca os valores primeiro, por meio de uma consulta ou de uma ferramenta, e pede ao seu modelo que redija a resposta com eles: "O cliente perguntou X. Estoque atual: Y. Responda em uma ou duas frases, no idioma do cliente." O campo reply passa então a levar o texto do modelo. A etapa Reply with AI sozinha não tem ferramentas nem navegação, então este é o caminho para respostas que combinam redação e dados.

Mantenha a ida e volta completa, consulta mais chamada ao modelo, bem abaixo de 20 segundos. Peça ao modelo uma resposta curta, escolha um modelo rápido e mantenha a mensagem de contingência do temporizador para o dia em que o provedor estiver lento.

Quais são os limites de uma resposta por webhook?

A resposta por webhook é um texto simples enviado uma única vez, o que cobre a maioria das respostas sobre preço, estoque e disponibilidade. Qualquer coisa mais elaborada sai pela Cloud API da Meta, enviada pelo seu próprio sistema. Os pontos a considerar:

  • Somente texto, até 4.096 caracteres, sem markdown. Imagens, botões ou templates: envie-os pelo seu sistema com o endpoint de envio obtido em get_api_credentials e não retorne reply.
  • Uma única tentativa, sem repetição. Um timeout ou erro marca a execução como Failed e avisa você por e-mail, no máximo uma vez por automação a cada 6 horas.
  • Uma etapa de resposta colocada depois do webhook também envia, e o cliente receberia duas mensagens.
  • Respostas em texto livre só saem dentro de 24 horas da última mensagem do cliente; uma etapa Wait antes do webhook pode ultrapassar esse prazo.

Como configurar

  1. 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": "..."}.
  2. 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.
  3. Copy the Signing secretSelect the Call my webhook step of the saved automation and copy Signing secret into your endpoint's settings.
  4. 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.
  5. 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 esquecer de atualizá-los. O modelo informa os valores do mês passado com toda a segurança; mantenha os números que mudam no seu sistema e deixe o webhook lê-los.
  • Rodar um relatório lento dentro da requisição. Passados 20 segundos, a etapa falha e nada é enviado; consulte um índice ou um cache e responda com uma mensagem de contingência aos 15 segundos.
  • Adicionar uma etapa Reply with text depois do webhook como rede de segurança. Ela também roda após uma resposta bem-sucedida, e os clientes recebem duas mensagens; coloque os textos de contingência no seu endpoint.
  • Usar fragmentos curtos de palavra-chave, como "tem" ou "cost". O modo Contains encontra trechos dentro de palavras, então item, temperature ou costume disparam a consulta; use termos completos e teste-os no Try it.
Fazendo isso com o EasyCoexistence

Uma etapa Call my webhook traz o seu próprio sistema para a conversa: ela envia a pergunta, assinada, e entrega a resposta que o seu sistema devolve, com deduplicação, pausa quando você responde pelo celular e verificação da janela de 24 horas já incluídas, sem cobrança extra por execução. De R$ 29,90 a R$ 3,90 por número por mês, valor que cai conforme você adiciona números, com os 3 primeiros dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Dá para usar uma planilha do Google como lista de preços?

Sim. Um workflow do n8n pode buscar o produto na planilha com um nó Google Sheets e devolver o preço e o estoque daquela linha como resposta. O Google limita as leituras por minuto por usuário; por isso, para números com muito movimento, guarde a planilha em cache no workflow ou no seu backend e atualize a cada poucos minutos.

Meu sistema precisa ficar online 24 horas por dia?

Para esta automação, sim: uma requisição que falha ou excede o tempo marca a execução como Failed, não envia nada e avisa você por e-mail. Deixe uma segunda automação de prioridade mais baixa, como um assistente de IA no catch-all, cuidando das outras perguntas, e mantenha a mensagem de contingência do próprio endpoint para os momentos de lentidão.

O ChatGPT ou o Claude conseguem configurar essa automação para mim?

Sim. Com o conector do easyCoexistence, peça uma automação por palavra-chave no seu número que chame a sua URL; a IA usa create_automation com uma etapa call_webhook e depois test_automation. O Signing secret não é retornado pelo MCP, então copie-o da página da automação no painel.

Respostas com dados em tempo real custam a mais?

Não pelo easyCoexistence: as automações não têm cobrança por execução nem limite de execuções. A Meta cobra as mensagens na própria conta do WhatsApp Business da empresa, por mensagem, conforme a categoria e o país, e o easyCoexistence nunca aplica margem sobre elas. Seu servidor ou sua ferramenta de workflow continuam custando o que já custam hoje.

Continue lendo

Pronto para começar?

Configure o WhatsApp Coexistence em minutos, não em meses. O aplicativo continua funcionando no celular.

Começar teste grátis

Verificado em