Vercel AI SDK ఉపయోగించి WhatsApp ఏజెంట్‌ను రూపొందించండి
వచ్చే మెసేజ్‌లు, నంబర్ వెబ్‌హుక్ గమ్యంగా సెట్ చేసిన రూట్ హ్యాండ్లర్‌కు చేరతాయి. హ్యాండ్లర్ generateText ను పిలిచి, జవాబును Cloud API ద్వారా పంపుతుంది. నంబర్‌పై చర్యలు తీసుకునే టూల్స్ కోసం, @ai-sdk/mcp లోని createMCPClient HTTP ద్వారా EasyCoexistence MCP సర్వర్‌కు కనెక్ట్ అవుతుంది, authProvider ద్వారా OAuth తో సైన్ ఇన్ చేస్తుంది.
AI SDK యొక్క MCP క్లయింట్ అయిన createMCPClient ను అందించే ప్యాకేజీ.
AI SDK యొక్క MCP HTTP ట్రాన్స్‌పోర్ట్‌లో authProvider ఇవ్వడం ద్వారా OAuth కు మద్దతు ఉంది.
WhatsApp Business యాప్, Cloud API రెండింటితో వాడే నంబర్‌కు స్థిరమైన థ్రూపుట్.
రూట్ హ్యాండ్లర్ WhatsApp మెసేజ్లను ఎలా అందుకుంటుంది?
ఒకే రూట్‌పై రెండు మెథడ్‌లతో. ఆ రూట్‌ను నంబర్ వెబ్‌హుక్ గమ్యంగా సెట్ చేయండి, పాత్‌లో పొడవైన యాదృచ్ఛిక సీక్రెట్ ఉంచండి.
GET, Meta ధృవీకరణకు జవాబిస్తుంది. క్వెరీ నుంచి hub.mode, hub.verify_token, hub.challenge చదివి, టోకెన్‌ను పోల్చి, challenge ను సాదా టెక్స్ట్‌గా తిరిగి ఇవ్వండి. దాన్ని JSON హెల్పర్ ద్వారా ఇవ్వడం సాధారణ తప్పు: బాడీ చుట్టూ కోట్స్‌తో చేరుతుంది, Meta డెలివరీ ప్రారంభించదు.
POST ఈవెంట్‌లను అందుకుంటుంది. 200 ను త్వరగా తిరిగి ఇచ్చి, మోడల్ కాల్‌ను ఆ తర్వాత చేయండి. ఎందుకంటే Meta నెమ్మదైన ప్రతిస్పందనలను మళ్లీ పంపుతుంది, మోడల్‌ను అక్కడే నడిపే కోల్డ్ స్టార్ట్ ఒకే మెసేజ్‌కు రెండుసార్లు జవాబివ్వవచ్చు. ప్రతిస్పందన పంపగానే ఫంక్షన్‌ను ముగించే ప్లాట్‌ఫామ్‌లలో, పనిని క్యూకు లేదా ప్రతిస్పందన తర్వాత పని చేసే ప్లాట్‌ఫామ్ మెకానిజంకు అప్పగించండి.
పాత్‌లోని సీక్రెట్టే ప్రమాణీకరణ. Meta ప్రతి డెలివరీపై Tech Provider యాప్ సీక్రెట్‌తో సంతకం చేస్తుంది, కాబట్టి X-Hub-Signature-256 హెడర్‌ను మీ వైపు తనిఖీ చేయలేరు.
AI SDK WhatsApp టూల్స్‌ను ఎలా లోడ్ చేస్తుంది?
@ai-sdk/mcp లోని createMCPClient, HTTP ట్రాన్స్‌పోర్ట్‌తో. ప్రొడక్షన్‌కు AI SDK డాక్యుమెంటేషన్ దీన్నే సిఫార్సు చేస్తుంది. ట్రాన్స్‌పోర్ట్ సర్వర్ URL, authProvider తీసుకుంటుంది. EasyCoexistence MCP సర్వర్‌కు అనుమతి authProvider ద్వారా OAuth తోనే లభిస్తుంది: అది OAuth మెటాడేటాను ప్రచురిస్తుంది, డైనమిక్ క్లయింట్ రిజిస్ట్రేషన్, PKCE లకు మద్దతిస్తుంది, సైన్ ఇన్ తర్వాత తన సొంత టోకెన్‌లను జారీ చేస్తుంది. హెడర్‌లో పెట్టాల్సిన API కీ ఏదీ లేదు.
క్లయింట్ టూల్స్ నేరుగా generateText లేదా streamText లోకి వెళ్తాయి. అప్పుడు మోడల్‌కు list_numbers, send_message, send_template, get_number_health వంటివి కనిపిస్తాయి, వాటి వివరణల్లో 24 గంటల విండో స్పష్టంగా ఉంటుంది. కాల్ ముగిశాక క్లయింట్‌ను మూసివేయండి: స్ట్రీమ్‌కు onEnd కాల్‌బ్యాక్‌లో, లేకపోతే finally బ్లాక్‌లో, AI SDK డాక్యుమెంటేషన్ చెప్పినట్లు.
మోడలే నిర్ణయించాల్సిన చోట దీన్ని వాడండి. ఇప్పుడే వచ్చిన మెసేజ్‌కు జవాబివ్వడానికి, హ్యాండ్లర్ నుంచి నేరుగా Cloud API కాల్ చేయడం చిన్న మార్గం.
import { createMCPClient } from "@ai-sdk/mcp";
const mcp = await createMCPClient({
transport: {
type: "http",
url: "https://easycoexistence.com/api/mcp",
authProvider, // your OAuthClientProvider implementation
},
});
try {
const tools = await mcp.tools();
// pass tools to generateText({ model, tools, prompt })
} finally {
await mcp.close();
}నంబర్ Coexistence లో ఉండటం వల్ల ఏం మారుతుంది?
కోడ్ తెలుసుకోవలసిన రెండు విషయాలు. మొదటిది, సంభాషణలో ఇప్పటికే ఒక వ్యక్తి ఉండవచ్చు. నంబర్‌పై WhatsApp Business యాప్ పనిచేస్తూనే ఉంటుంది, ఫోన్‌లో టైప్ చేసిన ప్రతి జవాబు రూట్కు ఎకో ఈవెంట్‌గా చేరుతుంది. ఎకో తర్వాత ఆ కాంటాక్ట్‌కు మోడల్‌ను ఆపే హ్యాండ్లర్, వ్యక్తి మాట్లాడుతున్నప్పుడు మోడల్ జవాబివ్వకుండా ఆపుతుంది.
రెండవది, నంబర్‌కు పంపడం సెకనుకు స్థిరంగా 20 మెసేజ్‌లకు పరిమితం. సంభాషణ ఏజెంట్ దాన్ని ఎప్పుడూ చేరదు, కానీ కాంటాక్ట్ జాబితాపై Promise.all తో రాసిన బ్రాడ్‌కాస్ట్ లూప్ చేరుతుంది, కాబట్టి బ్యాచ్‌లుగా పంపండి.
మిగతా అంతా సాధారణ Cloud API నే. కస్టమర్ చివరి మెసేజ్ నుంచి 24 గంటల లోపు స్వేచ్ఛా రూప టెక్స్ట్ అనుమతించబడుతుంది. ఆ తర్వాత ఆమోదం పొందిన టెంప్లేట్ మాత్రమే వెళ్తుంది, స్వేచ్ఛా రూప టెక్స్ట్ ఎర్రర్ కోడ్ 131047 ను ఇస్తుంది, కస్టమర్‌కు ఏమీ కనిపించదు.
సాధారణ పొరపాట్లు
- challenge ను JSON ప్రతిస్పందన హెల్పర్‌తో తిరిగి ఇవ్వడం. చుట్టూ ఉన్న కోట్స్ వల్ల Meta తనిఖీ విఫలమవుతుంది.
- Meta కు ప్రతిస్పందించే ముందు generateText నడపడం. కోల్డ్ స్టార్ట్‌లో రీట్రై రెండో జవాబును సృష్టిస్తుంది.
- MCP క్లయింట్‌ను మూసివేయడం మర్చిపోవడం. ప్లాట్‌ఫామ్ ఆపే వరకు ప్రతి అభ్యర్థనకు ఒక కనెక్షన్ తెరిచే ఉంటుంది.
easycoexistence.com లో నంబర్‌ను కనెక్ట్ చేయండి, వెబ్‌హుక్ గమ్యాన్ని మీ రూట్ హ్యాండ్లర్‌కు సెట్ చేయండి, ఒక్క OAuth సైన్ ఇన్‌తో MCP క్లయింట్‌ను జోడించండి. నంబర్‌కు నెలకు US$ 9 నుంచి, నంబర్లు జోడించే కొద్దీ US$ 1 వరకు తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
ఇది Vercel లో మాత్రమే పనిచేస్తుందా?
కాదు. AI SDK ఒక TypeScript లైబ్రరీ, HTTPS అందించి GET, POST లకు జవాబిచ్చే ఏ హోస్ట్‌లోనైనా రూట్ నడవగలదు.
నాకు MCP క్లయింట్ అసలు అవసరమా?
జవాబివ్వడానికి అవసరం లేదు. నంబర్ టోకెన్తో Cloud API మెసేజ్ల ఎండ్పాయింట్కు ఒక fetch చేస్తే సరిపోతుంది. ఏం చేయాలో మోడలే ఎంచుకోవలసినప్పుడు MCP విలువ చూపుతుంది.
మోడల్గా ఏ ప్రొవైడర్నైనా వాడవచ్చా?
AI SDK మద్దతిచ్చే ఏదైనా వాడవచ్చు. WhatsApp వైపు మోడల్తో సంబంధం లేనిది, కాబట్టి ప్రొవైడర్ను మార్చినా రూట్కు, Cloud API కాల్కు ఏమీ మారదు.
EasyCoexistence మెసేజ్లను చూస్తుందా?
లేదు. Meta నేరుగా మీ రూట్కు డెలివరీ చేస్తుంది, మెసేజ్ కంటెంట్ మా వైపు ఎప్పుడూ నిల్వ చేయబడదు.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్‌లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ