Vercel AI SDK மூலம் WhatsApp ஏஜென்ட்டை உருவாக்குங்கள்

ரூட் ஹேண்ட்லர் WhatsApp மெசேஜ்களை எப்படிப் பெறுகிறது?

ஒரே ரூட்டில் இரண்டு மெதட்களுடன். அந்த ரூட், பாதையில் நீளமான ரேண்டம் ரகசியத்துடன் எண்ணின் வெப்ஹூக் இலக்காக அமைக்கப்படுகிறது.

GET, Meta-வின் சரிபார்ப்புக்குப் பதில் அளிக்கிறது. query-யிலிருந்து hub.mode, hub.verify_token, hub.challenge ஆகியவற்றைப் படித்து, டோக்கனை ஒப்பிட்டு, challenge-ஐச் சாதாரண டெக்ஸ்ட்டாகத் திருப்பி அனுப்புங்கள். அதை JSON ஹெல்பர் வழியாகத் திருப்புவது வழக்கமான தவறு: உள்ளடக்கத்தைச் சுற்றி மேற்கோள் குறிகள் வந்துவிடும், Meta டெலிவரியைத் தொடங்கவே தொடங்காது.

POST நிகழ்வுகளைப் பெறுகிறது. உடனே 200 திருப்பி அனுப்பி, மாடல் அழைப்பைப் பிறகு செய்யுங்கள். ஏனெனில் மெதுவான பதில்களை Meta மீண்டும் முயல்கிறது, மேலும் மாடலை அதே இடத்தில் இயக்கும் கோல்ட் ஸ்டார்ட் ஒரே மெசேஜுக்கு இருமுறை பதில் அளித்துவிடலாம். பதில் அனுப்பியவுடன் ஃபங்ஷனை முடிக்கும் தளங்களில், வேலையை க்யூவுக்கு அல்லது பதிலுக்குப் பிறகு வேலை செய்ய அந்தத் தளம் வழங்கும் வழிமுறைக்கு ஒப்படையுங்கள்.

பாதையில் உள்ள ரகசியமே அங்கீகாரம். Meta ஒவ்வொரு டெலிவரியையும் Tech Provider-இன் app secret கொண்டு கையொப்பமிடுவதால், X-Hub-Signature-256 ஹெடரை உங்கள் பக்கத்தில் சரிபார்க்க முடியாது.

AI SDK, WhatsApp கருவிகளை எப்படி ஏற்றுகிறது?

@ai-sdk/mcp-இலிருந்து createMCPClient மற்றும் HTTP டிரான்ஸ்போர்ட் மூலம். இதையே AI SDK ஆவணங்கள் production-க்குப் பரிந்துரைக்கின்றன. டிரான்ஸ்போர்ட் சர்வர் URL-ஐயும் authProvider-ஐயும் எடுத்துக்கொள்கிறது. authProvider வழியாக OAuth என்பதே EasyCoexistence MCP சர்வருக்கு அங்கீகாரம் பெறும் முறை: அது OAuth மெட்டாடேட்டாவை வெளியிடுகிறது, dynamic client registration மற்றும் PKCE-ஐ ஆதரிக்கிறது, உள்நுழைவுக்குப் பிறகு தனது சொந்த டோக்கன்களை வழங்குகிறது. ஹெடரில் வைக்க API key எதுவும் இல்லை.

கிளையன்ட்டின் கருவிகள் நேரடியாக generateText அல்லது streamText-க்குள் செல்கின்றன. அப்போது மாடல் list_numbers, send_message, send_template, get_number_health மற்றும் பிறவற்றைப் பார்க்கிறது. அவற்றின் விளக்கங்களில் 24 மணி நேர சாளரம் குறிப்பிடப்பட்டிருக்கும். அழைப்பு முடிந்ததும் கிளையன்ட்டை மூடுங்கள்: stream என்றால் 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 ஆப் அந்த எண்ணில் தொடர்ந்து செயல்படுகிறது, ஃபோனில் தட்டச்சு செய்யும் ஒவ்வொரு பதிலும் echo நிகழ்வாக ரூட்டுக்கு வந்து சேரும். echo-க்குப் பிறகு அந்தத் தொடர்புக்கு மாடலை இடைநிறுத்தும் ஹேண்ட்லர், ஒரு நபருக்கு மேலாக மாடல் பதில் சொல்வதைத் தடுக்கிறது.

இரண்டாவது, அனுப்புதல் எண்ணுக்கு வினாடிக்கு 20 மெசேஜ்கள் என்ற நிலையான வரம்புக்கு உட்பட்டது. உரையாடல் ஏஜென்ட் அதன் அருகில் கூட வராது, ஆனால் தொடர்புப் பட்டியலின் மீது Promise.all கொண்டு எழுதப்பட்ட ப்ராட்காஸ்ட் லூப் வந்துவிடும், எனவே அதைத் தொகுப்புகளாகப் பிரியுங்கள்.

மற்ற அனைத்தும் வழக்கமான Cloud API தான். வாடிக்கையாளரின் கடைசி மெசேஜிலிருந்து 24 மணி நேரத்துக்குள் ஃப்ரீ டெக்ஸ்ட் அனுமதிக்கப்படும். அதற்குப் பிறகு, அங்கீகரிக்கப்பட்ட டெம்ப்ளேட் மட்டுமே செல்லும். ஃப்ரீ டெக்ஸ்ட் அனுப்பினால் பிழை 131047 திரும்பும், வாடிக்கையாளருக்கு எதுவும் தெரியாது.

பொதுவான தவறுகள்

• challenge-ஐ JSON பதில் ஹெல்பர் வழியாகத் திருப்புவது. அதைச் சுற்றியுள்ள மேற்கோள் குறிகள் Meta-வின் சரிபார்ப்பைத் தோல்வியடையச் செய்யும்.
• Meta-வுக்குப் பதில் அளிக்கும் முன் generateText-ஐ இயக்குவது. கோல்ட் ஸ்டார்ட்டில், மறுமுயற்சி இரண்டாவது பதிலை உருவாக்கும்.
• MCP கிளையன்ட்டை மூட மறப்பது. தளம் அதை நிறுத்தும் வரை, ஒவ்வொரு கோரிக்கையும் ஓர் இணைப்பைத் திறந்தே விட்டுவிடும்.

அடிக்கடி கேட்கப்படும் கேள்விகள்

தொடர்ந்து படிக்கவும்