Jibu wateja wa WhatsApp kwa data ya moja kwa moja: bei, hisa na upatikanaji kutoka kwenye mfumo wako
Ili kujibu maswali ya WhatsApp kuhusu bei, hisa au upatikanaji kwa takwimu za sasa, peleka ujumbe wa mteja kwenye mfumo wako mara unapofika, tafuta thamani huko, kisha rudisha maandishi ya jibu. Hatua ya webhook ya otomatiki hufanya hivyo: hutuma POST yenye ujumbe na nambari ya mteja, na jibu la JSON lenye sehemu ya `reply`, lililorudishwa ndani ya sekunde 20, hutumwa kama jibu la WhatsApp.
easyCoexistence huunganisha nambari yako ya WhatsApp Business unayoshikilia kwenye programu na Cloud API ya Meta kupitia Coexistence, kisha huendesha otomatiki juu yake.
Muda ambao hatua ya Piga webhook yangu husubiri jibu la mfumo wako kabla ya hatua kushindwa.
Jumbe za hivi karibuni za mazungumzo hutumwa na ombi, za zamani kwanza, ili swali la ufuatiliaji lihifadhi muktadha wake.
Herufi za jibu linalotumwa kama maandishi moja ya WhatsApp; maandishi marefu hukatwa.
URL za webhook lazima ziwe HTTPS za umma; http na anwani za faragha hukataliwa, na uelekezaji upya haufuatwi.
Dirisha baada ya ujumbe wa mwisho wa mteja ambapo Meta hukubali maandishi huru; swali jipya hufungua dirisha hilo.
Jibu la takwimu za moja kwa moja hufanyaje kazi?
Otomatiki moja huchukua ujumbe, mara nyingi otomatiki ya neno kuu kwa maneno ya bei au hisa. Hatua yake ya Piga webhook yangu hutuma POST yenye ujumbe, nambari ya mteja na mazungumzo ya hivi karibuni kwenye URL yako, ikitiwa sahihi kwa siri ya otomatiki yenyewe. Msimbo wako husoma thamani, kisha hujibu HTTP 200 yenye mwili wa JSON, kwa mfano {"reply": "Mkate wa sourdough: US$ 6.50, zimebaki 14 leo."}. easyCoexistence huangalia dirisha la saa 24 na kutuma maandishi hayo kutoka nambari yako.
Kabla ya mfumo wako kuitwa, mchakato umepitia walinzi wa ndani: uwasilishaji unaorudiwa wa Meta haujawahi kuanzisha mchakato wa pili, na mazungumzo uliyojibu kutoka simuni hubaki bila kuguswa kwa saa 4 kwa chaguo-msingi. Jibu pia huonekana kwenye mfululizo wa mazungumzo ya programu, kwa hiyo yeyote mwenye simu anaona alichoambiwa mteja.
Kwa nini usiweke bei na hisa kwenye jibu lisilobadilika au Maelekezo ya AI?
Jibu lisilobadilika huandikwa mara moja, na hatua ya Jibu kwa AI huandika kutoka vyanzo viwili tu: Maelekezo yake na mazungumzo ya hivi karibuni. Hakuna kati yake hubadilika bidhaa ikiisha au nafasi ikiwekwa. Hatua ya AI pia huelekezwa, chini ya maelekezo yako, kamwe kubuni bei, hisa, tarehe au sera isiyoweza kuiona, kwa hiyo swali kuhusu hisa ya leo hupata makabidhiano ya adabu badala ya nambari.
Takwimu zinazobadilika wakati wa siku zinapaswa kukaa kwenye mfumo ambao tayari unazishikilia: duka, lahajedwali, kalenda ya nafasi au ERP. Hatua ya Piga webhook yangu huuruhusu mfumo huo kumjibu mteja moja kwa moja, kwa thamani uliyonayo kwa sekunde hiyo, kutoka nambari ya WhatsApp Business ambayo timu inaendelea kuitumia kwenye programu.
Ni maswali gani yapelekwe kwa mfumo wako?
Yale ambayo jibu lake hubadilika haraka kuliko unavyoweza kuhariri maandishi. Yapeleke kwa kichocheo cha neno kuu katika hali ya Ina, hadi maneno 30, katika kila lugha unayohudumia. Otomatiki za neno kuu hukaguliwa kabla ya Ujumbe wa kwanza, Nje ya saa za kazi na kwa yote yaliyobaki, na otomatiki moja tu hujibu kila ujumbe, kwa hiyo msaidizi wa AI kwa yote yaliyobaki huacha maswali mengine kwa otomatiki hizi. Ina hulinganisha ndani ya maneno, kwa hiyo pendelea maneno kamili kuliko vipande vifupi:
- Bei: bei, kiasi gani, orodha ya bei, preço, quanto custa, precio, cuánto cuesta.
- Hisa: hisa, inapatikana, dukani, estoque, disponível, disponible.
- Nafasi wazi: miadi, nafasi, meza kwa watu, horário, vaga, una cita, mesa para.
- Ada ya usafirishaji au eneo kwa msimbo wa posta: ada ya usafirishaji, frete, taxa de entrega, envío, código postal.
- Hali ya leo: wazi leo, likizo, aberto hoje, feriado, abierto hoy.
Mfumo wako hupokea na kurudisha nini?
POST ya JSON yenye kichwa X-EC-Event kilichowekwa automation.step. Sehemu ambazo utafutaji unahitaji ni message.text, ambapo jina au msimbo wa bidhaa huonekana, na contact.wa_id, nambari ya mteja kwa tarakimu za kimataifa bila alama ya plus, muhimu kwa bei kwa kila kikundi cha wateja au kikapu kilichohifadhiwa. history hushikilia hadi jumbe 10 za hivi karibuni, kwa hiyo "na kwa rangi nyekundu?" inaweza kusomwa ikilinganishwa na swali lililotangulia. Jaribio la Jaribu hutuma dry_run true na history tupu.
Jibu kwa HTTP 200 lenye thamani ya aina ya `string` iliyo na jina la `reply` kwenye kiwango cha juu. Jibu tupu au lisilokuwepo halituma chochote na mchakato unaendelea hadi hatua yoyote ya baadaye. Hali nje ya 2xx, uelekezaji upya au kimya zaidi ya sekunde 20 hushindwa hatua. Ukurasa wa wakala wa n8n unaonyesha mwili kamili.
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?" }Unajengaje endpoint kwa Node.js?
Soma mwili kama maandishi ghafi, thibitisha X-EC-Signature dhidi yake, kisha changanua. Kichwa ni t=<sekunde za unix>,v1=<hex>, ambapo v1 ni HMAC-SHA256 ya t, nukta na mwili, ikitumia siri yote ya whsec_ Signing ya otomatiki. Kataa t inayozidi dakika 5 na saa yako, kisha linganisha kwa muda usiobadilika.
Kisha fanya utafutaji mmoja wa haraka: swali la hifadhidata, wito uliohifadhiwa kwa API ya duka lako, au usomaji kutoka orodha ya bei iliyo kwenye kumbukumbu. Ishindanishe na kipima muda, ili hifadhidata inayochelewa bado itoe mstari wa kirafiki kabla ya kikomo cha sekunde 20 badala ya mchakato kushindwa. Lisipopatikana chochote, uliza jina au msimbo wa bidhaa badala ya kubahatisha.
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);Je, modeli inaweza kuandika jibu kutoka data ya moja kwa moja?
Ndiyo, nyuma ya webhook. Endpoint yako, au mtiririko wa n8n wenye nodi ya AI Agent, kwanza huchukua takwimu, kupitia swali au zana, kisha huomba modeli yako ipange jibu kwa takwimu hizo: "Mteja aliuliza X. Hisa ya sasa: Y. Jibu kwa sentensi moja au mbili, kwa lugha ya mteja." Sehemu ya reply sasa hubeba maandishi ya modeli. Hatua ya Jibu kwa AI yenyewe haina zana wala kuvinjari, kwa hiyo hii ni njia ya majibu yanayochanganya maneno na data.
Weka mzunguko mzima, utafutaji pamoja na wito wa modeli, chini ya sekunde 20 kwa kiasi kikubwa. Omba jibu fupi, chagua modeli ya haraka, na uweke mbadala wa kipima muda tayari kwa siku ambayo mtoa huduma anachelewa.
Jibu la webhook lina mipaka gani?
Jibu la webhook ni maandishi matupu yanayotumwa mara moja, ambayo yanatosha majibu mengi ya bei, hisa na upatikanaji. Chochote chenye utajiri zaidi hutoka kupitia Cloud API ya Meta, kikitumwa na mfumo wako. Mambo ya kupanga:
- Maandishi pekee, hadi herufi 4,096, bila markdown. Picha, vitufe au template: vitume kutoka mfumo wako kwa endpoint ya kutuma kutoka
get_api_credentials, kisha usirudishe jibu lolote. - Jaribio moja, bila kujaribu tena. Muda au hitilafu huweka mchakato kuwa Umeshindwa na kukutumia barua pepe, mara moja tu kwa kila otomatiki kila saa 6.
- Hatua ya jibu iliyowekwa baada ya webhook nayo hutuma, kwa hiyo mteja atapata ujumbe mbili.
- Maandishi huru hutumwa tu ndani ya saa 24 tangu ujumbe wa mwisho wa mteja; hatua ya Subiri kabla ya webhook inaweza kuvuka muda huo.
Jinsi ya kuisanidi
- 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.
Makosa ya kawaida
- Kubandika bei kwenye Maelekezo ya AI na kusahau. Modeli hunukuu bei za mwezi uliopita kwa kujiamini; weka namba zinazobadilika kwenye mfumo wako na acha webhook izisome.
- Kuendesha ripoti ya polepole ndani ya ombi. Zaidi ya sekunde 20 hatua inashindwa na hakuna kinachotumwa; tumia faharasa au cache, na ujibu mstari wa akiba sekunde 15.
- Kuweka hatua ya Jibu lenye maandishi baada ya webhook kama wavu wa usalama. Huendesha pia baada ya jibu lenye mafanikio, kwa hiyo wateja hupata ujumbe mbili; weka maandishi ya akiba ndani ya endpoint yako.
- Kutumia vipande vifupi vya neno kuu kama "tem" au "cost". Ina hulinganisha ndani ya maneno, kwa hiyo item, temperature au costume huanzisha utafutaji; tumia maneno kamili na uyajaribu kwenye Jaribu.
Hatua ya Piga webhook yangu huleta mfumo wako mwenyewe kwenye mazungumzo: hutuma swali, lililotiwa sahihi, na kutoa jibu ambalo mfumo wako unarudisha, pamoja na kuondoa marudio, kusitisha unapojibu kutoka simuni na ukaguzi wa saa 24 vilivyojengwa ndani, bila malipo ya ziada kwa kila mchakato. Kuanzia US$ 9 kwa kila nambari iliyounganishwa kwa mwezi, hadi US$ 0.75 kadri unavyoongeza nambari, na kipindi cha majaribio bila malipo cha siku 3 za kwanza.
Maswali yanayoulizwa mara kwa mara
Je, Google Sheet inaweza kuwa orodha ya bei?
Ndiyo. Mtiririko wa n8n unaweza kutafuta bidhaa kwenye lahajedwali kwa nodi ya Google Sheets, kisha kurudisha bei na hisa za mstari huo kama jibu. Google hupunguza usomaji kwa dakika kwa kila mtumiaji, kwa hiyo kwa nambari zenye shughuli nyingi, hifadhi lahajedwali kwenye cache ya mtiririko au backend yako na uiburudishe kila dakika chache.
Je, mfumo wangu unahitaji kuwa mtandaoni saa zote?
Kwa otomatiki hii, ndiyo: ombi lililoshindwa au lililokwisha muda huweka mchakato kuwa Umeshindwa, halituma chochote na hukutumia barua pepe. Elekeza otomatiki ya pili, yenye kipaumbele cha chini, kama msaidizi wa AI kwa yote yaliyobaki, kwa maswali mengine, na weka mstari wa akiba wa endpoint kwa nyakati za polepole.
Je, ChatGPT au Claude wanaweza kuniwekea otomatiki hii?
Ndiyo. Kwa kiunganishi cha easyCoexistence, omba otomatiki ya neno kuu kwenye nambari yako inayoita URL yako. AI hutumia create_automation yenye hatua ya call_webhook, kisha test_automation. Siri ya Signing hairudishwi kupitia MCP, kwa hiyo nakili kutoka ukurasa wa otomatiki kwenye dashboard.
Je, majibu ya data ya moja kwa moja yanagharimu zaidi?
Si kutoka easyCoexistence: otomatiki hazitozi kwa kila mchakato, wala hazina kikomo cha idadi ya michakato, na easyCoexistence haiongezi nyongeza ya bei juu ya ujumbe wowote. Meta hutoza ujumbe kwenye Akaunti ya WhatsApp Business ya biashara yenyewe, kwa kila ujumbe, kulingana na aina na nchi. Seva yako au zana yako ya mtiririko hugharimu kile inachogharimu leo.
Endelea kusoma
Uko tayari kuanza?
Sanidi WhatsApp Coexistence kwa dakika chache, si miezi. Programu inaendelea kufanya kazi kwenye simu.
Anza kipindi cha majaribio bila malipoImethibitishwa kwenye