AI agents සඳහා WhatsApp API: Tech Provider කෙනෙක් වීමෙන් තොරව, මිනිත්තු කිහිපයකින් නිල ප්රවේශය
AI agent එකකට Meta හි Cloud API හරහා නිල WhatsApp ප්රවේශය ලැබේ, සහ WhatsApp Business යෙදුමේ ඇති අංකයක් Tech Provider හෝ Solution Partner එකක් හරහා එයට සම්බන්ධ වේ. ඔබට ව්යාපාරයේ සත්යාපනය, App Review වීඩියෝ සහ Embedded Signup build එකක් සමඟ එවැන්නෙක් වීමට හැකිය, නැත්නම් දැනටමත් එවැන්නෙක් වන provider එකක් හරහා සම්බන්ධ විය හැකිය: අංකය මිනිත්තු කිහිපයකින් එකතු වේ, agent එකට MCP tools හෝ API credentials ලැබේ.
easyCoexistence ස්වාධීන Meta Tech Provider එකකි: එය WhatsApp Business අංකයක් Coexistence හරහා Cloud API වෙත මිනිත්තු කිහිපයකින් සම්බන්ධ කරයි, එබැවින් ඔබේ agent එකට නිල ප්රවේශය ලැබෙන අතර ව්යාපාරය යෙදුම තබාගනී.
WhatsApp Business යෙදුමේ ඇති අංකයක් සම්බන්ධ කරන ඕනෑම අයෙකුගෙන් Meta ඉල්ලන්නේ: Tech Provider හෝ Solution Partner තත්ත්වයයි.
App Review ඉල්ලන්නේ ඔබේ යෙදුමෙන් යවන පණිවිඩයක වීඩියෝ එකක් සහ ඔබේ යෙදුම template එකක් සාදන වීඩියෝ එකක්.
App Review මඟින් whatsapp_business_messaging සහ whatsapp_business_management සඳහා ලබා දෙන දේ, Tech Provider වීමට අවශ්ය දෙකම.
Meta Embedded Signup v2 සහ v3 deprecate කළ විට, integrations වලට v4 වෙත යන ලෙස දැනුම් දුන්නේය.
WhatsApp Business යෙදුම සහ Cloud API යන දෙකම භාවිත වන අංකයක නියත throughput.
Platform එකක් Partner API හරහා පාරිභෝගිකයාගේ අංකය සම්බන්ධ කරන විට, hosted connect link එක වලංගු වන කාලය.
AI agent එකකට WhatsApp නිලව භාවිත කිරීමට අවශ්ය වන්නේ කුමක්ද?
Meta හි Cloud API වෙතින් අවශ්ය වන්නේ දේවල් හතරකි. phone number ID එකක් සහ whatsapp_business_messaging permission එක සහිත access token එකක්, එවිට agent එකට messages endpoint එක call කළ හැකිය. Meta විසින් එන පණිවිඩ ලබා දෙන webhook endpoint එකක්, සහ යෙදුම සමඟ බෙදාගත් අංකයක නම්, දුරකථනයේ පුද්ගලයෙකු ටයිප් කරන පිළිතුරු සඳහා smb_message_echoes. අනුමත templates, මන්ද ටයිප් කළ පණිවිඩයක් ළඟා වන්නේ පැය 24 තුළ ලිවූ අයෙකුට පමණි. සහ සම්බන්ධතාවය බිඳ වැටෙන විට දැන ගැනීමේ ක්රමයක්, මන්ද දුරකථනයේ යෙදුම API පැත්ත නතර වූ පසුත් ක්රියා කරයි.
මිනිසුන් ප්රථමයෙන් සොයා ගන්නා කෙටි මාර්ගය WhatsApp Web automation වන අතර, එය සම්බන්ධිත උපාංගයක් ලෙස පුරනය වේ. එය WhatsApp හි නියමවලට පටහැනි වන අතර, ඒ මත ක්රියා කරන agent එක කුමක් කළ ද, අංකය තහනම් වීමේ අවදානමට ලක් කරයි.
Tech Provider මාර්ගයට ඇතුළත් වන්නේ කුමක්ද?
Meta හි තමන්ගේම අනුපිළිවෙල, මේ අනුපිළිවෙලින්. සෑම පියවරක්ම නොමිලේ ය, සහ කිසිවක් වේගවත් කර ගැනීමට නොහැක: සමාලෝචන දිවෙන්නේ Meta හි කාලසටහනට අනුවය, සහ Meta කිසිම කාලරේඛාවක් ප්රකාශ නොකරයි, එබැවින් පළමු පාරිභෝගිකයාගේ අංකය සම්බන්ධ වීමට පෙර දින කිහිපයකට නොව සති ගණනකට සැලසුම් කරන්න. ඉන් පසු backend එක දිගටම ධාවනය විය යුතුය: සෑම signup එකකින් පසු token exchange එක, webhook receiver එක, අංකය අනුව routing, සහ Meta හි 14-දින අක්රියතා රීතිය වැනි විසන්ධි වීම් සඳහා monitoring.
කෙටි මාර්ගය කුමක්ද?
දැනටමත් එම ක්රියාවලිය පසු කළ provider එකක් හරහා අංකය සම්බන්ධ කරන්න. easyCoexistence සමඟ, ව්යාපාරය Meta හි Embedded Signup ධාවනය කර WhatsApp Business යෙදුමෙන් කේතයක් scan කරයි, එයට මිනිත්තු දෙකක් පමණ ගත වන අතර, අංකය ව්යාපාරයේම Business Portfolio හි Cloud API වෙත එකතු වන අතර යෙදුම දිගටම ක්රියා කරයි. ඉන් පසු agent එකට එය කථා කරන ආකාරයට ප්රවේශය ලැබේ: ChatGPT, Claude, Claude Code හෝ Codex වැනි සහායකයෙකු සඳහා MCP tools, නැත්නම් ඔබ ධාවනය කරන කේතය සඳහා අංකයේ credentials සහ webhooks.
| Connect through easyCoexistence | Become a Tech Provider | |
|---|---|---|
| Meta app and App Review | Not needed: the number joins through ours | Yours to build and pass |
| Embedded Signup | Hosted, with the QR scan in the app | You integrate version 4 and host the flow |
| First number connected | Minutes after signing up | After verification and review |
| Webhook trust | A secret in your URL, or X-EC-Signature on forwarded messages | Your app secret signs Meta's deliveries |
| Disconnection alerts | Every number watched 24/7, 14-day rule included | Monitoring you build and run |
| Who owns the WhatsApp Business Account | The business, in its own portfolio | The business |
Agent එකට අංකයේ credentials ලැබෙන්නේ කෙසේද?
get_api_credentials හරහා, හෝ dashboard එකේ අංකයේ පිටුවෙන්. tool එක Graph API base URL, WhatsApp Business Account ID, phone number ID, send endpoint, සහ යම් විට පවතී නම්, ව්යාපාරයේම access token එක, එහි WhatsApp assets වලට සීමා කර, ලබා දෙයි. client token එකක් නිකුත් නොවූ විට, token එක null ලෙස ආපසු ලැබෙන අතර, dashboard එකෙන් අංකය නැවත සම්බන්ධ කිරීම ක්රියා කරන token එකක් ප්රතිස්ථාපනය නොකර නව එකක් නිකුත් කරන බවට සටහනක් සමඟ. ලබා ගැනීමට secret එකක් නැත, මන්ද Meta webhooks sign කරන්නේ easyCoexistence හි යෙදුමේ secret එකෙනි, එය කිසිදා බෙදා නොගනී. tool එකට සක්රිය plan එකක් අවශ්යය, මන්ද token එකට යැවිය හැකි නිසා.
curl -X POST "$SEND_ENDPOINT" \
-H "Authorization: Bearer $ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"messaging_product": "whatsapp",
"to": "5511999998888",
"type": "text",
"text": { "body": "Your order #1042 is ready for pickup." }
}'එන පණිවිඩ agent එකට ළඟා වන්නේ කෙසේද?
සෑම අංකයකටම ආකාර දෙකක් ඇත, set_inbound_mode හරහා හෝ අංකයේ පිටුවෙන් මාරු කරයි. ඔබේ server එක වෙත සෘජුව: set_webhook_destination මඟින් Meta ඔබේ HTTPS endpoint එක වෙත සෘජුව යොමු කරයි, එය Meta හි GET handshake එකට පිළිතුරු දිය යුතුය, සහ easyCoexistence කිසිදා පණිවිඩ නොදකී, එබැවින් automations ක්රියාවිරහිතය. Meta එම deliveries අපේ යෙදුමේ secret එකෙන් sign කරන බැවින්, URL path එකේ දිගු, අහඹු secret එකක් තබා, එය නැති ඉල්ලීම් ප්රතික්ෂේප කරන්න.
Automations ක්රියාත්මකයි: Meta easyCoexistence වෙත යවයි, automations වලට පිළිතුරු දිය හැකිය, සහ විකල්ප Forward URL එකට Meta හි මුල් payload එක "value" යටතේ ලැබේ, X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> මඟින් sign කර, එක් වරක් පෙන්වන secret එකක් භාවිතයෙන්. automation හි Call my webhook පියවර ද පණිවිඩය සහ චැට් එකේ අවසන් පණිවිඩ 10 ඔබේ agent වෙත ලබා දෙන අතර, තත්පර 20ක් ඇතුළත ඔබේ පිළිතුර {"reply": "..."} ලෙස පැමිණියහොත් එහි පිළිතුර යවයි.
Agent එක ගරු කළ යුතු සීමා මොනවාද?
Meta හි ඒවාය, සහ ඒවා ඕනෑම provider එකක් හරහා එකම ය. සීමා කලින් දන්නා agent එකක්, දෝෂ ලෙස පෙනෙන අසාර්ථකතා වළක්වා ගනී:
- අංකයකට තත්පරයට පණිවිඩ 20, WhatsApp Business යෙදුම සමඟ බෙදාගත් අංක සඳහා Meta විසින් නියම කර ඇත.
- ටයිප් කළ පණිවිඩ පාරිභෝගිකයාගේ අවසන් පණිවිඩයෙන් පැය 24 ඇතුළත පමණි; ඉන් පසු, අනුමත template එකක්.
- Templates යවන්නේ API හරහා පමණි, මන්ද Coexistence අංකයේ යෙදුමට ඒවා යැවිය නොහැක.
- යෙදුමේ පුද්ගලයෙකු ටයිප් කරන පිළිතුරු
smb_message_echoesලෙස පැමිණේ; එම චැට් එකේ agent එක විරාම කරන්න, නැත්නම් පාරිභෝගිකයාට පිළිතුරු දෙකක් ලැබේ. - Group chats API වෙත සමමුහුර්ත නොවන බැවින්, agent එක එක් අයෙකු සමඟ වන චැට් වල ක්රියා කරයි.
- සම්බන්ධ කිරීමෙන් පැය 24 ඇතුළත සෘජු webhook destination එකක් සුරකින්නේ නම් පමණක්, සම්බන්ධතා සහ මාස 6ක් දක්වා එක් අයෙකු සමඟ චැට් එක වරක් ආයාත වේ; automations ක්රියාත්මක අංකයකට ආයාතය ලැබෙන්නේ නැත.
- හඬ සහ වීඩියෝ ඇමතුම් යෙදුමේ දිගටම ක්රියා කරයි, නමුත් Cloud API මඟින් Coexistence අංකයක ඇමතුම් රැගෙන නොයන බැවින්, agent එක text හරහා ක්රියා කරයි.
Platform එකකට තමන්ගේම පාරිභෝගිකයින්ගේ අංක මෙලෙස සම්බන්ධ කළ හැකිද?
ඔව්, Partner API හරහා. SaaS එකක් හෝ agency එකක් තමන්ගේම Tech Provider තත්ත්වයක් නොමැතිව පාරිභෝගිකයින් සම්බන්ධ කරන්නේ එලෙසිනි. create_api_key (ec_live_ වලින් ආරම්භ වන අතර එක් වරක් පෙන්වයි) සමඟ යතුර සාදන්න, ඉන්පසු ඔබේ backend එකෙන් POST /api/v1/connect-sessions call කරන්න, නැත්නම් assistant එකෙන් create_connect_link, පැය 1ක් වලංගු hosted connect link එකක් සඳහා. පාරිභෝගිකයා එහිදී Meta popup එක සහ QR scan එක ධාවනය කර connection_id සමඟ ඔබේ redirect_url වෙත ආපසු පැමිණේ. GET /api/v1/connections/:id?credentials=1 එවිට පාරිභෝගිකයාගේම token එක ලබා දෙයි, සහ connection.disconnected වැනි status events X-EC-Signature සමඟ sign කර පැමිණේ. සෑම අංකයක්ම එකම එක් අංකයකට මිල පරාසවලට අනුව ඔබේ ගිණුමට බිල් කරනු ලැබේ.
සාමාන්ය වැරදි
- සෘජු destination එකක X-Hub-Signature-256 වලංගු කිරීම. Meta sign කරන්නේ easyCoexistence හි යෙදුමේ secret එකෙනි, එය කිසිදා බෙදා නොගනී, එබැවින් සැබෑ deliveries පරීක්ෂාව අසමත් වේ; URL එකේ දිගු අහඹු secret එකක් විශ්වාස කරන්න, නැත්නම් X-EC-Signature සමඟ forwarding භාවිත කරන්න.
- n8n හි WhatsApp Trigger node එකෙන් ලබා ගැනීම. එය ඔබේම Meta යෙදුමක් බලාපොරොත්තු වේ; ඒ වෙනුවට URL එකේ secret එකක් සහිත සාමාන්ය Webhook node එක භාවිත කරන්න.
- smb_message_echoes නොසලකා හැරීම. එවිට agent එක දුරකථනයෙන් දැනටමත් පිළිතුරු දී ඇති පුද්ගලයෙකු උඩින් පිළිතුරු දෙයි, පාරිභෝගිකයා පිළිතුරු දෙකක් කියවයි.
- සම්බන්ධ කිරීමෙන් දින කිහිපයකට පසු සෘජු webhook destination එක සුරැකීම, හෝ අංකය automations මත තැබීම. Meta හි සම්බන්ධතා සහ මාස 6ක් දක්වා චැට් එක වරක් ආයාත කිරීමට සම්බන්ධතාවයෙන් පැය 24 ඇතුළත සුරකින ලද සෘජු destination එකක් අවශ්යයි.
agent එක MCP tools 30කට වැඩි ගණනකින් හෝ සෑම අංකයේම credentials සහ webhooks හරහා ක්රියා කරයි, සහ සෑම අංකයක්ම 24/7 නිරීක්ෂණය කර alerts ඇත. එක් අංකයකට මාසිකව US$ 9 සිට US$ 0.75 දක්වා, අංක එකතු කරන විට අඩු වේ, පළමු දින 3 නොමිලේ.
නිතර අසන ප්රශ්න
මට තමන්ගේම Meta යෙදුමක් අවශ්යද?
නැත. අංකය easyCoexistence හි Meta යෙදුම හරහා සම්බන්ධ කරන අතර ව්යාපාරයේම Business Portfolio සහ WhatsApp Business Account එකේ පවතී. ඔබේ කේතය get_api_credentials වෙතින් ලැබෙන ව්යාපාරයේම token එකෙන් යවයි, එබැවින් ඔබ පසුව යෙදුමක් ගොඩනඟන්නේ නැත්නම්, ඔබේ යෙදුමක් මෙහි සම්බන්ධ නොවේ.
Agent එකට සහ කණ්ඩායමට එකවර අංකය භාවිත කළ හැකිද?
ඔව්. Meta පණිවිඩ Cloud API සහ WhatsApp Business යෙදුම අතර පිළිබිඹු කරයි, එබැවින් agent එක යවන දේ දුරකථනයේ යෙදුමේ චැට් නූල තුළ දිස් වන අතර, කණ්ඩායම යෙදුමේ ටයිප් කරන දේ smb_message_echoes ලෙස ඔබේ පද්ධතියට ළඟා වේ.
කුමන agent රාමු මෙය සමඟ ක්රියා කරයිද?
OAuth සහිත HTTP මත MCP කතා කරන ඕනෑම client එකක්, ChatGPT, Claude, Claude Code, Codex සහ Cursor වැනි, සහ Meta හි Graph API call කරන ඕනෑම කේතයක්: Node.js, Python, n8n, LangChain, OpenAI Agents SDK හෝ Vercel AI SDK. යට ඇති API එක Meta හිම ය, එබැවින් agent එක තුළ හිමිකාර කිසිවක් නොමැත.
සාමාන්ය අරමුණු AI සහායකයෙකුට WhatsApp මත ඉඩ දෙනවාද?
Meta හි Business Solution Terms, section 4.7, 2026 ජනවාරි 15 සිට බලාත්මක, සාමාන්ය අරමුණු AI සහායකයින් ප්රධාන ක්රියාකාරිත්වය AI වන විට WhatsApp Business Platform මත ඒවා ඉදිරිපත් කිරීම වළක්වයි, Meta විසින් තීරණය කරන පරිදි. තම පාරිභෝගිකයින් සඳහා, සහාය, විකුණුම් හෝ වෙන්කිරීම් සඳහා AI භාවිත කරන ව්යාපාරයක් ඉලක්කය නොවේ, සහ EU සහ බ්රසීලයේ නියාමකයින් තරග කරන සහායකයින් සඳහා රීතිය අත්හිටුවීමට හෝ ආපසු හැරවීමට Meta ට නියෝග කර ඇත.
තවදුරටත් කියවන්න
ආරම්භ කිරීමට සූදානම්ද?
WhatsApp Coexistence මිනිත්තු කිහිපයකින් සකසන්න, මාස ගණනකින් නොව. යෙදුම දුරකථනයේ දිගටම ක්රියා කරයි.
නොමිලේ trial කාලය ආරම්භ කරන්නසත්යාපනය කළේ