AccediInizia la prova gratuita
Meta Tech Provider

Rispondi ai clienti WhatsApp con dati in tempo reale: prezzi, scorte e disponibilità dal tuo sistema

Per rispondere alle domande WhatsApp su prezzi, scorte o disponibilità con dati aggiornati, passa il messaggio del cliente al tuo sistema appena arriva, cerca lì il valore e restituisci il testo della risposta. Il passaggio webhook di un'automazione fa proprio questo: invia in POST il messaggio e il numero del cliente, e una risposta JSON con un campo reply, restituita entro 20 secondi, parte come risposta WhatsApp.

easyCoexistence collega il numero WhatsApp Business che tieni nell'app alla Cloud API di Meta tramite Coexistence ed esegue automazioni su di esso.

20 s

Quanto attende il passaggio Chiama il mio webhook la risposta del tuo sistema prima che il passaggio fallisca.

10

Ultimi messaggi della chat inviati con la richiesta, dal più vecchio, così una domanda di follow-up mantiene il contesto.

4,096

Caratteri di una risposta inviata come un unico testo WhatsApp; il testo più lungo viene tagliato.

https only

Gli URL del webhook devono essere HTTPS pubblici; http e indirizzi privati vengono rifiutati e i reindirizzamenti non vengono seguiti.

24 hours

Finestra dopo l'ultimo messaggio del cliente in cui Meta accetta risposte a testo libero; una nuova domanda la riapre.

Come funziona una risposta con dati in tempo reale?

Un'automazione prende il messaggio, di solito un'automazione a parola chiave per i termini di prezzo o di scorta. Il passaggio Chiama il mio webhook invia in POST il messaggio, il numero del cliente e la chat recente al tuo URL, firmati con il segreto dell'automazione. Il tuo codice legge il valore, poi risponde HTTP 200 con un corpo JSON come {"reply": "Pane di lievito madre: US$ 6,50, oggi ne restano 14."}. easyCoexistence verifica la finestra di 24 ore e invia quel testo dal tuo numero.

Prima che il tuo sistema venga chiamato, l'esecuzione ha superato i controlli integrati: le consegne ripetute di Meta non avviano mai una seconda esecuzione, e una chat a cui hai risposto dal telefono viene lasciata in pace per 4 ore per impostazione predefinita. La risposta compare anche nel thread della chat nell'app, così chi ha il telefono vede che cosa è stato detto al 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

Perché non tenere prezzi e scorte in una risposta fissa o nelle Istruzioni dell'IA?

Una risposta fissa viene scritta una volta sola, e il passaggio Rispondi con IA scrive partendo solo da due fonti: le sue Istruzioni e la chat recente. Nessuna delle due cambia quando un prodotto esaurisce le scorte o uno slot viene prenotato. Il passaggio IA riceve anche l'indicazione, all'interno delle tue istruzioni, di non inventare mai prezzi, scorte, date o politiche che non può vedere, quindi una domanda sulla disponibilità di oggi riceve una risposta cortese che rimanda a un operatore invece di un numero.

I valori che cambiano durante la giornata appartengono al sistema che già li contiene: il negozio, il foglio di calcolo, il calendario delle prenotazioni o l'ERP. Il passaggio Chiama il mio webhook permette a quel sistema di rispondere direttamente al cliente, con il valore che ha in quel preciso istante, dal numero WhatsApp Business che il team continua a usare nell'app.

Quali domande dovrebbero andare al tuo sistema?

Quelle la cui risposta cambia più in fretta di quanto tu riesca a modificare un testo. Instradale con un trigger «Ha parola chiave» in modalità Contiene, fino a 30 parole, in ciascuna lingua che servi. Le automazioni a parola chiave vengono controllate prima di Primo messaggio, Fuori orario e del catch-all, e una sola automazione risponde a ogni messaggio, quindi un assistente IA sul catch-all lascia alle altre domande il loro spazio. Contiene trova corrispondenze dentro le parole, quindi preferisci termini interi a frammenti brevi:

  • Prezzi: prezzo, quanto costa, listino, preço, quanto custa, precio, cuánto cuesta.
  • Scorte: disponibilità, disponibile, in magazzino, estoque, disponível, disponible.
  • Orari liberi: appuntamento, orario libero, tavolo per, horário, vaga, una cita, mesa para.
  • Costo o zona di consegna per CAP: costo di consegna, frete, taxa de entrega, envío, CAP.
  • Stato di oggi: aperto oggi, festivo, aberto hoje, feriado, abierto hoy.

Che cosa riceve e restituisce il tuo sistema?

Una POST JSON con l'intestazione X-EC-Event impostata su automation.step. I campi che una ricerca richiede sono message.text, dove compaiono il nome o il codice del prodotto, e contact.wa_id, il numero del cliente in cifre internazionali senza il segno più, utile per prezzi per gruppo di clienti o per un carrello salvato. history contiene fino a 10 messaggi recenti, così «e in rosso?» può essere letto in relazione alla domanda precedente. Un test da Prova invia dry_run true con una history vuota.

Rispondi HTTP 200 con una stringa di primo livello chiamata reply. Un reply vuoto o assente non invia nulla e l'esecuzione prosegue con eventuali passaggi successivi. Uno stato fuori dal 2xx, un reindirizzamento o un silenzio oltre 20 secondi fanno fallire il passaggio. La pagina dell'agente n8n mostra il 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?" }

Come si scrive l'endpoint in Node.js?

Leggi il corpo come testo grezzo, verifica X-EC-Signature su di esso, poi fai il parse. L'intestazione è t=<secondi unix>,v1=<hex>, dove v1 è un HMAC-SHA256 di t, un punto e il corpo, con chiave il segreto di firma whsec_ completo dell'automazione. Rifiuta un t che differisce di oltre 5 minuti dal tuo orologio e confronta in tempo costante.

Poi esegui una ricerca veloce: una query al database, una chiamata in cache all'API del tuo negozio, o una lettura da un listino tenuto in memoria. Falla correre contro un timer, così un database lento produce comunque una riga cortese prima del limite di 20 secondi invece di un'esecuzione fallita. Quando nulla corrisponde, chiedi il nome o il codice del prodotto invece di indovinare.

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);

Un modello può scrivere la risposta a partire dai dati in tempo reale?

Sì, dietro il webhook. Il tuo endpoint, oppure un workflow n8n con un nodo AI Agent, recupera prima i valori, tramite una query o uno strumento, e chiede al modello di formulare la risposta con quei dati: «Il cliente ha chiesto X. Scorta attuale: Y. Rispondi in una o due frasi, nella lingua del cliente.» Il campo reply porta poi il testo del modello. Il passaggio Rispondi con IA da solo non ha strumenti né navigazione, quindi questa è la strada per le risposte che mescolano formulazione e dati.

Tieni l'intero giro, ricerca più chiamata al modello, ben al di sotto dei 20 secondi. Chiedi al modello una risposta breve, scegli un modello veloce e mantieni il timer di riserva per il giorno in cui il provider è lento.

Quali sono i limiti di una risposta via webhook?

La risposta via webhook è testo semplice inviato una sola volta, e copre la maggior parte delle risposte su prezzi, scorte e disponibilità. Tutto ciò che è più ricco passa dalla Cloud API di Meta, inviato dal tuo sistema. I punti da pianificare:

  • Solo testo, fino a 4.096 caratteri, senza markdown. Immagini, pulsanti o template: inviali dal tuo sistema con l'endpoint di invio ottenuto da get_api_credentials e non restituire reply.
  • Un solo tentativo, senza nuovi tentativi. Un timeout o un errore marca l'esecuzione come Fallita e ti invia un'e-mail, al massimo una volta ogni 6 ore per automazione.
  • Un passaggio di risposta posizionato dopo il webhook invia comunque, quindi il cliente riceverebbe due messaggi.
  • Le risposte a testo libero partono solo entro 24 ore dall'ultimo messaggio del cliente; un passaggio Attesa prima del webhook può superare questo limite.

Come configurarlo

  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.

Errori comuni

  • Incollare i prezzi nelle Istruzioni dell'IA e dimenticarli. Il modello cita i dati del mese scorso con sicurezza; tieni i numeri che cambiano nel tuo sistema e lascia che il webhook li legga.
  • Eseguire un report lento dentro la richiesta. Oltre 20 secondi il passaggio fallisce e non viene inviato nulla; interroga un indice o una cache e rispondi con una riga di riserva a 15 secondi.
  • Aggiungere un passaggio Rispondi con testo dopo il webhook come rete di sicurezza. Viene eseguito anche dopo una risposta riuscita, quindi i clienti ricevono due messaggi; metti i testi di riserva nel tuo endpoint.
  • Usare frammenti brevi di parole chiave come «tem» o «cos». Contiene trova corrispondenze dentro le parole, quindi tempo, temperatura o costume avviano la ricerca; usa termini interi e provali in Prova.
Farlo con EasyCoexistence

Un passaggio Chiama il mio webhook porta il tuo sistema nella chat: invia la domanda, firmata, e consegna la risposta che il tuo sistema restituisce, con deduplicazione, pausa quando rispondi dal telefono e controllo delle 24 ore integrati, senza costi extra per esecuzione. US$ 9 fino a US$ 0,75 per numero al mese, in calo man mano che aggiungi numeri, con i primi 3 giorni gratuiti.

Domande frequenti

Un foglio Google può essere il listino prezzi?

Sì. Un workflow n8n può cercare il prodotto nel foglio con un nodo Google Sheets, poi restituire prezzo e scorta della riga come risposta. Google limita le letture al minuto per utente, quindi per numeri molto attivi metti il foglio in cache nel workflow o nel tuo backend e aggiornalo ogni pochi minuti.

Il mio sistema deve essere online tutto il giorno?

Per questa automazione, sì: una richiesta che fallisce o va in timeout marca l'esecuzione come Fallita, non invia nulla e ti manda un'e-mail. Affida le altre domande a una seconda automazione a priorità più bassa, come un assistente IA sul catch-all, e tieni la riga di riserva dell'endpoint per i momenti lenti.

ChatGPT o Claude possono configurare questa automazione per me?

Sì. Con il connettore easyCoexistence, chiedi un'automazione a parola chiave sul tuo numero che chiami il tuo URL; l'IA usa create_automation con un passaggio call_webhook, poi test_automation. Il segreto di firma non viene restituito tramite MCP, quindi copialo dalla pagina dell'automazione nella dashboard.

Le risposte con dati in tempo reale costano di più?

Non da easyCoexistence: le automazioni non hanno costi per esecuzione né tetto alle esecuzioni. Meta addebita i messaggi sull'account WhatsApp Business dell'azienda, per messaggio, per categoria e paese, e easyCoexistence non applica alcun ricarico. Il tuo server o lo strumento di workflow costa quanto costa oggi.

Continua a leggere

Pronto per iniziare?

Configura WhatsApp Coexistence in pochi minuti, non in mesi. L'app continua a funzionare sul telefono.

Inizia la prova gratuita

Verificato il