உங்கள் AI ஏஜென்டுக்கு நினைவகம் கொடுங்கள்: 6 மாத WhatsApp அரட்டைகளும் தொடர்புகளும்
Coexistence மூலம் இணைக்கப்பட்ட எண்ணில், இணைத்த 24 மணி நேரத்திற்குள் நேரடி வெப்ஹூக் இலக்கு சேமிக்கப்பட்டு, பயன்பாட்டில் வணிகம் ஒப்புக்கொண்டால், Meta ஒருமுறை தொடர்புகளையும் 180 நாள் வரையிலான தனிநபர் அரட்டைகளையும் உங்கள் சர்வருக்கு அனுப்பலாம். துண்டுகள் வரிசை தவறி வரலாம்; முன்னேற்றம் 100 என்பது முடிவைக் குறிக்கும். செய்திகளை id வாரியாகச் சேமியுங்கள், நபர்களை BSUID மூலம் அடையாளப்படுத்துங்கள், சமீபத்திய பதில்களை ஏஜென்டுக்கு வழங்குங்கள்.
easyCoexistence Meta-வின் Coexistence ஓட்டத்தின் மூலம் எண்ணை இணைக்கிறது; உங்கள் எண்ட்பாயிண்டை நேரடி வெப்ஹூக் இலக்காக 24 மணி நேரத்திற்குள் சேமித்தால், தொடர்புகளையும் 180 நாள் வரையிலான அரட்டைகளையும் ஒருமுறை Meta-விடம் கேட்கிறது; அவை நேராக உங்கள் சர்வருக்குச் செல்லும்.
ஆன்போர்டிங்கிலிருந்து வரலாற்று ஒத்திசைவு எவ்வளவு பின்னோக்கிச் செல்கிறது; Meta-வின் அம்சப் பட்டியல் இதை அண்மைய 6 மாதங்கள் என்கிறது.
ஆன்போர்டிங்குக்குப் பிறகு தொடர்புகளையும் வரலாற்றையும் கோருவதற்கான நேரம்; ஒவ்வொரு கோரிக்கையும் ஒருமுறை மட்டுமே செய்யலாம்.
வரலாற்று ஒத்திசைவு முடிந்ததைக் குறிக்கும் metadata.progress மதிப்பு; phase மட்டும் போதாது என்று Meta கூறுகிறது.
WhatsApp Business ஆப்பில் வணிகம் வரலாற்றுப் பகிர்வை நிறுத்தியிருந்தால், வரலாற்று வெப்ஹூக்கில் வரும் பிழைக் குறியீடு.
Phase 0 என்பது ஆன்போர்டிங்குக்கு முந்தைய 0 முதல் 1 நாள் வரை; phase 1 நாட்கள் 1 முதல் 90 வரை; phase 2 நாட்கள் 90 முதல் 180 வரை.
Meta அனுப்பும் மிகப் பெரிய வெப்ஹூக் பேலோட், உங்கள் எண்ட்பாயிண்டுக்குத் தேவைப்படும் உடல் அளவு வரம்பை நிர்ணயிக்கிறது.
இறக்குமதியில் என்ன வருகிறது, எது வராது?
இரண்டு ஓட்டங்கள், இரண்டும் தொலைபேசியில் உள்ள WhatsApp Business ஆப்பிலிருந்து. தொடர்புகள் smb_app_state_sync வெப்ஹூக்குகளாக வருகின்றன; ஒவ்வொரு தொடர்புக்கும் ஒரு பதிவு, action add அல்லது remove உடன். அதே புலம், வணிகம் பின்னர் ஆப்பில் சேர்க்கும், திருத்தும் அல்லது நீக்கும் தொடர்புகளையும் தெரிவிக்கிறது. அரட்டைகள் history வெப்ஹூக்குகளாக வருகின்றன: ஆன்போர்டிங்குக்கு முந்தைய 180 நாள் வரையிலான தனிநபர் உரையாடல்கள், இரு திசைகளிலும், அவற்றின் டெலிவரி ஸ்டேட்டஸுடன். கீழே பட்டியலிடப்பட்டுள்ளவை வராது; இறக்குமதியின் அடிப்படையில் கட்டப்பட்ட நினைவகம் அவற்றை எதிர்பார்க்கக்கூடாது.
இறக்குமதி உங்கள் சர்வரை அடைவதை எப்படி உறுதி செய்வது?
எண் இணைவதற்கு முன்பே எண்ட்பாயிண்ட் இயங்கும்படி வையுங்கள், பின்னர் எண் இணைந்த 24 மணி நேரத்திற்குள் அதை எண்ணின் நேரடி வெப்ஹூக் இலக்காகச் சேமியுங்கள்: எண்ணின் பக்கத்தில் Route incoming messages to your own வெப்ஹூக் என்பதன் கீழ், அல்லது உங்கள் AI-இலிருந்து set_webhook_destination மூலம், அல்லது Partner API connect session-இல் webhook_url ஆக. இதைச் சேமிப்பதுதான் easyCoexistence-ஐ Meta-விடம் ஒத்திசைவைக் கேட்கச் செய்கிறது: முதலில் தொடர்புகள், பின்னர் வரலாறு; ஆன்போர்டிங்குக்கு ஒருமுறை. கோரிக்கையும் Meta-வின் கோரிக்கை id-களும் எண்ணின் நிகழ்வுப் பதிவில் history_sync_requested ஆகத் தோன்றும்.
இணைப்பின் போது பயன்பாடு கேட்கும்போது வணிகம் வரலாற்றைப் பகிர ஒப்புக்கொள்ள வேண்டும். Forward URL இருந்தாலும், மெசேஜ்கள் easyCoexistence வழியாக வரும் எண்ணுக்கு (Where incoming messages go அட்டையில் Through easyCoexistence) இறக்குமதி கிடைக்காது, ஏனெனில் கோரிக்கை நேரடி இலக்குக்கு மட்டுமே அனுப்பப்படுகிறது. பின்னர் ஆட்டோமேஷன்கள் தேவைப்பட்டால், இறக்குமதி முடிந்த பிறகு மாற்றுங்கள்.
வரலாற்றுத் துண்டுகள் எப்படி வருகின்றன?
வரிசை தவறியும், புதிய செய்திகளிலிருந்து பின்னோக்கிய கட்டங்களில் வருகின்றன: phase 0 ஆன்போர்டிங்குக்கு முந்தைய கடைசி நாளை உள்ளடக்குகிறது, phase 1 90 நாள் வரையிலும், phase 2 180 நாள் வரையிலும். வரிசை முக்கியமெனில் metadata.chunk_order மூலம் வரிசைப்படுத்துங்கள். metadata.progress = 100-ஐ முடிவாக எடுத்துக்கொள்ளுங்கள், ஏனெனில் phase ஒரு கட்டம் முடிந்ததைச் சொல்லாது என்று Meta குறிப்பிடுகிறது. ஓர் உரையாடலின் id என்பது வாடிக்கையாளரின் தொலைபேசி எண்; அதைப் பகிர முடியாதபோது அது விடப்படும்; அதன் context-இல் wa_id, user_id மற்றும் username இருக்கும். வணிகம் அனுப்பிய செய்திக்கு from வணிக எண்ணாகவும், to புலமும் இருக்கும்.
{
"messaging_product": "whatsapp",
"metadata": { "display_phone_number": "16315550142", "phone_number_id": "106540352242922" },
"history": [{
"metadata": { "phase": 1, "chunk_order": 2, "progress": 55 },
"threads": [{
"id": "5511987654321",
"context": { "wa_id": "5511987654321", "user_id": "BR.13491208655302741918" },
"messages": [
{
"from": "5511987654321",
"from_user_id": "BR.13491208655302741918",
"id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABIYFDNBMDhFN0QxRjM2QTk4RTU2RTY0AA==",
"timestamp": "1789912800",
"type": "text",
"text": { "body": "Can I pick up the cake on Saturday?" },
"history_context": { "status": "read" }
},
{
"from": "16315550142",
"to": "5511987654321",
"id": "wamid.HBgNNTUxMTk4NzY1NDMyMRUCABEYEjQ2RDhGMkE3QjEwQzNFOTFBMgA=",
"timestamp": "1789913100",
"type": "text",
"text": { "body": "Yes, from 9 am. See you then!" },
"history_context": { "status": "read" }
}
]
}]
}]
}ஏஜென்டின் நினைவகத்தை எப்படிச் சேமிப்பது?
இரண்டு அட்டவணைகள் போதும். நபர்கள் BSUID மூலம் விசையிடப்படுகிறார்கள், அதாவது Meta தொடர்புகள், உரையாடல்கள், செய்திகளில் சேர்க்கும் user_id; அதனருகே தொலைபேசி எண்ணும் வைக்கப்படுகிறது, ஏனெனில் username கொண்ட பயனர் தொலைபேசி எண் இல்லாமல் வரக்கூடும். Meta-வின் சொந்தக் குறிப்பு ஒரு தொடர்பை அடையாளம் காண user_id பயன்படுத்தச் சொல்கிறது. செய்திகள் அவற்றின் wamid மூலம் விசையிடப்படுவதால், இறக்குமதி, நேரடி வெப்ஹூக்குகள், மீண்டும் அனுப்பப்பட்ட டெலிவரிகள் ஆகியவற்றிலிருந்து ஒரே செய்தி ஒரே வரிசையாகச் சுருங்கும்; from_business கொடி யார் பேசினார் என்பதைப் பதிவு செய்கிறது. நபர் மற்றும் நேரம் வாரியாக அட்டவணைப்படுத்துங்கள், ஏனெனில் ஏஜென்ட் ஒரு நபரின் சமீபத்திய பதில்களைக் கேட்கும்.
-- One row per person. Key on the BSUID (user_id); keep the phone number beside it.
create table wa_contacts (
user_key text primary key, -- user_id (BSUID) when present, else the phone number
wa_id text, -- phone number in digits, when Meta shares it
username text,
name text, -- full_name from the app's address book
removed boolean not null default false,
updated_at timestamptz not null default now()
);
-- One row per message. The wamid makes history, live events and retries collapse.
create table wa_messages (
id text primary key, -- messages[].id
user_key text not null,
from_business boolean not null,
type text not null, -- text, image, media_placeholder...
body text not null, -- the text, a caption, or a [type] placeholder
sent_at timestamptz not null,
source text not null -- history | live | echo
);
create index wa_messages_by_user on wa_messages (user_key, sent_at desc);துண்டுகளையும் தொடர்புகளையும் அதில் எப்படி ஏற்றுவது?
மீண்டும் செய்தாலும் ஒரே முடிவு தரும் செருகல்களால், வரிசையும் மீண்டும் வருகையும் முக்கியமில்லாமல் போகும். ingestHistory ஒரு history மாற்றத்தை வாசிக்கிறது: 2593109 நிராகரிப்பைப் பதிவு செய்துவிட்டுச் செல்கிறது, உரையாடலை context.user_id அல்லது அதன் id மூலம் விசையிடுகிறது, from என்பது metadata.display_phone_number உடன் சமமாக இருந்தால் அந்தச் செய்தியை வணிகத்தினுடையதாகக் குறிக்கிறது, உரை இல்லையெனில் [type] இடப்பிடிப்பானைச் சேமிக்கிறது. ingestContacts user_id அல்லது தொலைபேசி எண் மீது upsert செய்கிறது, நீக்கப்பட்ட தொடர்புகளைக் குறித்துவைக்கிறது, அவர்களின் செய்திகளை நீக்குவதில்லை. நேரடி இலக்கில் change.value உடனும், forward-இன் நிகழ்வு history அல்லது smb_app_state_sync ஆக இருக்கும்போது உடலின் value உடனும் அவற்றை அழையுங்கள்.
// memory.mjs: npm i pg. Feed it the value of a "history" or "smb_app_state_sync"
// change: change.value on a direct destination, delivery.value on a forward.
import pg from "pg";
const db = new pg.Pool(); // reads the PG* environment variables
export async function ingestHistory(value) {
const business = value.metadata?.display_phone_number; // digits, like messages[].from
for (const chunk of value.history ?? []) {
if (chunk.errors?.some((e) => e.code === 2593109)) {
console.log("The business turned off history sharing in the app"); // contacts still come
continue;
}
for (const thread of chunk.threads ?? []) {
const userKey = thread.context?.user_id ?? thread.id; // thread.id is the phone, when shared
for (const m of thread.messages ?? []) {
await db.query(
`insert into wa_messages (id, user_key, from_business, type, body, sent_at, source)
values ($1, $2, $3, $4, $5, to_timestamp($6), 'history')
on conflict (id) do nothing`,
[m.id, userKey, m.from === business, m.type,
m.text?.body ?? m[m.type]?.caption ?? `[${m.type}]`, Number(m.timestamp)]
);
}
}
const { phase, chunk_order, progress } = chunk.metadata ?? {};
console.log(`history: phase ${phase}, chunk ${chunk_order}, ${progress}%`);
if (Number(progress) === 100) console.log("Import complete; late chunks still insert safely");
}
}
export async function ingestContacts(value) {
for (const s of value.state_sync ?? []) {
const c = s.type === "contact" ? s.contact ?? {} : null;
const userKey = c && (c.user_id ?? c.phone_number);
if (!userKey) continue;
await db.query(
`insert into wa_contacts (user_key, wa_id, username, name, removed)
values ($1, $2, $3, $4, $5)
on conflict (user_key) do update set
wa_id = coalesce(excluded.wa_id, wa_contacts.wa_id),
username = coalesce(excluded.username, wa_contacts.username),
name = coalesce(excluded.name, wa_contacts.name),
removed = excluded.removed, updated_at = now()`,
[userKey, c.phone_number ?? null, c.username ?? null, c.full_name ?? c.first_name ?? null,
s.action === "remove"]
);
}
}
// A bounded memory for one person: who they are and their last turns, oldest first.
export async function memoryFor(userKey, turns = 20) {
const [{ rows: [contact] }, { rows }] = await Promise.all([
db.query("select name from wa_contacts where user_key = $1 and not removed", [userKey]),
db.query(
`select from_business, body from wa_messages
where user_key = $1 order by sent_at desc limit $2`, [userKey, turns]),
]);
const history = rows.reverse().map((r) => ({ role: r.from_business ? "assistant" : "user", content: r.body }));
while (history[0]?.role === "assistant") history.shift(); // open on the customer's turn
const who = contact?.name ? `The customer is ${contact.name}.` : "The customer is not in the address book.";
return { system: `${process.env.AI_INSTRUCTIONS ?? ""}\n${who}`.trim(), history };
}அந்த நினைவகத்தை ஏஜென்டுக்கு எப்படி வழங்குவது?
எப்போதும் வரம்புக்குட்பட்டதாக, ஒரேயடியாக அல்ல. memoryFor நபரின் பெயரை முகவரிப் புத்தகத்திலிருந்தும், அவர்களின் கடைசி 20 பதில்களை பழையதிலிருந்து புதியதாக, பெரும்பாலான chat API-கள் எதிர்பார்ப்பது போல் வாடிக்கையாளர் பதிலில் தொடங்கியும் திருப்பும்; ஏஜென்டுக்கு இன்னும் தேவைப்பட்டால், பழைய உரையாடல்களின் சேமிக்கப்பட்ட சுருக்கத்தைச் சேர்க்கவும். ஒவ்வொரு prompt-இலும் ஆறு மாத அரட்டைகள் வைத்தால், ஒவ்வொரு பதிலுக்கும் டோக்கன்கள் செலவாகும், கேட்கப்படும் கேள்வி புதைந்துபோகும்.
ஒப்பிட, உள்ளமைக்கப்பட்ட Reply with AI படி 20 முந்தைய செய்திகளை (இயல்பாக 10) மட்டுமே வாசிக்கிறது; Call my வெப்ஹூக் படி கடைசி 10-ஐ அனுப்புகிறது. இரண்டும் உரிமையாளர் தேர்ந்தெடுக்கும் வைப்புக்காலம், 30, 90 அல்லது 365 நாட்கள் (இயல்பாக 90), வைத்திருக்கும் உரையிலிருந்தே எடுக்கின்றன, அது ஆட்டோமேஷன்கள் on ஆன தருணத்திலிருந்து தொடங்குகிறது; அதனால்தான் இறக்குமதி செய்யப்பட்ட ஆறு மாத அரட்டைகள் உங்கள் சொந்த தரவுத்தளத்தில் இருக்க வேண்டும்.
import-க்குப் பிறகு நினைவகம் எப்படித் தற்போதைய நிலையில் இருக்கும்?
அதே இலக்கு நேரடி ட்ராஃபிக்கையும் தொடர்ந்து பெறும்: வாடிக்கையாளர்களின் செய்திகள், பயன்பாட்டில் தட்டச்சு செய்யப்பட்ட பதில்களுக்கு smb_message_echoes, வணிகம் தன் தொடர்புகளைத் திருத்தும்போது smb_app_state_sync. இவற்றை அதே அட்டவணைகளில் source live அல்லது echo உடன் செருகுங்கள். வாடிக்கையாளர் தொலைபேசி எண்ணை மாற்றும்போது, Meta user_changed_number அல்லது user_changed_user_id வகை சிஸ்டம் செய்தி அனுப்பும், அதில் previous_user_id இருக்கும்; அது அவர்களின் வரிசைகளைப் புதிய BSUID-க்கு நகர்த்த வேண்டிய சமிக்ஞை.
இறக்குமதிக்குப் பின் ஆட்டோமேஷன்களைப் பின்னர் on செய்தால் நேரடி இலக்கு நீக்கப்படும். அதே URL-ஐ Forward URL ஆகச் சேருங்கள், ஒவ்வொரு கையொப்பமிட்ட POST-இலிருந்தும் event மற்றும் value ஐ வாசியுங்கள், மாற்றுவதற்கு முன் progress 100 வரை காத்திருங்கள்; இல்லையெனில் மீதமுள்ள துண்டுகள் அந்த forward வழியாக மட்டுமே வரும்.
இதை எப்படி அமைப்பது
- Put the endpoint onlineIt must return hub.challenge as plain text on Meta's GET handshake when hub.verify_token matches, accept POST bodies of a few megabytes and answer 200 fast.
- Connect the numberRun the connection from the dashboard, and accept sharing chat history when the WhatsApp Business app asks.
- Save the destination within 24 hoursOn the number's page, under Route incoming messages to your own webhook, fill Webhook URL (with a long random path) and Verify token, then Save; or ask your AI to call set_webhook_destination.
- Store chunks until progress 100Insert contacts and messages as they come; the event log shows history_sync_requested once the request went to Meta.
- Switch modes only afterwardsIf you want automations, choose Through easyCoexistence in the card Where incoming messages go and add the same URL as the Forward URL.
பொதுவான தவறுகள்
- இரண்டாம் நாளில் இலக்கைச் சேமிப்பது. ஒத்திசைவு இணைத்த 24 மணி நேரத்திற்குள் மட்டுமே கோரப்படும்; பின்னர் சேமிக்கப்படும் எண்ட்பாயிண்ட் நேரடி செய்திகளிலிருந்து மட்டுமே தொடங்கும்.
- progress 100-ஐ அடைவதற்கு முன் ஆட்டோமேஷன்களை on செய்வது. நேரடி இலக்கு உடனே நீக்கப்படும்; Forward URL ஏற்கனவே அமைக்கப்பட்டிருந்தால் மட்டுமே பின்னைய துண்டுகள் உங்களை வந்தடையும்.
- phase 2-ஐ இறக்குமதியின் முடிவாக எடுத்துக்கொள்வது. metadata.progress = 100 மட்டுமே ஒத்திசைவு முடிந்ததைச் சொல்கிறது; துண்டுகள் வரிசையாக வருவதில்லை.
- நினைவகத்தைத் தொலைபேசி எண்ணை மட்டும் வைத்து விசையிடுவது. username கொண்ட பயனர் எண்ணைப் பகிர முடியாதபோது உரையாடல் id-களும் தொடர்புகளும் தொலைபேசி எண்ணை விட்டுவிடும்; user_id அப்போதும் இருக்கும்.
கோரிக்கை எண்ணின் நிகழ்வுப் பதிவில் பதிவாகும், அதன் பிறகு எண் 24/7 கண்காணிக்கப்படும். ஒரு எண்ணுக்கு மாதம் US$ 9 முதல் US$ 0.75 வரை, எண்கள் சேர்க்கும்போது குறைகிறது; முதல் 3 நாட்கள் இலவசம்.
அடிக்கடி கேட்கப்படும் கேள்விகள்
இறக்குமதி இரண்டாவது முறை ஓட முடியுமா?
புதிய ஆன்போர்டிங் மூலம் மட்டுமே. Meta ஒவ்வொரு ஆன்போர்டிங்குக்கும் ஒரு கோரிக்கையை அனுமதிக்கிறது, எனவே எண்ணைத் துண்டித்து மீண்டும் இணைக்க வேண்டும், அப்போது அரட்டைகள் மீண்டும் வரும்; செய்தி id மூலம் செருகுவதால் இரண்டாவது முறையில் எதுவும் இருமுறை சேராது.
easyCoexistence இறக்குமதி செய்யப்பட்ட அரட்டைகளின் நகலை வைத்திருக்கிறதா?
இல்லை. வரலாறும் தொடர்புகளும் Meta-விலிருந்து நேராக உங்கள் எண்ட்பாயிண்டுக்குச் செல்கின்றன; இயல்பாக சேமிக்கப்படுவதில்லை. ஆட்டோமேஷன்கள் on ஆக உள்ள எண்ணுக்கு, நீங்கள் தேர்ந்தெடுக்கும் காலத்துக்கு, 30, 90 அல்லது 365 நாட்கள் (இயல்பாக 90), easyCoexistence செய்தி உரையை வைத்திருக்கும், Conversations திரை அதைக் காட்டும்; அனுப்பப்பட்ட (forwarded) டெலிவரிகள் 7 நாட்கள் வரையும், ரன் பதிவுகள் 30 நாட்களும் வைக்கப்படும்.
பேலோட்கள் எவ்வளவு பெரியதாக இருக்கலாம்?
ஒரு Meta வெப்ஹூக்கில் 3 MB வரை இருக்கலாம், பரபரப்பான எண் பல வரலாற்றுத் துண்டுகளை அனுப்பும். framework-இன் body வரம்பை உயர்த்துங்கள் (Express இயல்பாக 100 kb), தரவுத்தளத்தில் எழுதுவதற்கு முன் ஒப்புகை அனுப்புங்கள்.
ஏஜென்டுக்கு இறக்குமதி அவசியமா?
இல்லை. அது இல்லாமல், இணைத்த பின் வரும் முதல் செய்தியிலிருந்து நினைவகம் தொடங்கி நேரடி ட்ராஃபிக்கிலிருந்து வளரும். கடந்த உரையாடல்கள் முதல் நாளிலிருந்தே பதில்களை வடிவமைக்க வேண்டும் என்றால் இறக்குமதி முக்கியமாகிறது, எடுத்துக்காட்டாக திரும்பி வரும் வாடிக்கையாளரின் கடைசி ஆர்டர்.
தொடர்ந்து படிக்கவும்
தொடங்கத் தயாரா?
மாதங்கள் ஆகாமல், சில நிமிடங்களில் WhatsApp Coexistence-ஐ அமைக்குங்கள். ஆப்ஸ் போனில் தொடர்ந்து இயங்கும்.
இலவச ட்ரையலைத் தொடங்குங்கள்இதில் சரிபார்க்கப்பட்டது: