AI ఏజెంట్ల కోసం WhatsApp API: నిమిషాల్లో అధికారిక యాక్సెస్, Tech Provider అవ్వకుండానే
AI ఏజెంట్కు Meta యొక్క Cloud API ద్వారా అధికారిక WhatsApp యాక్సెస్ లభిస్తుంది. WhatsApp Business యాప్లోనే ఉండే నంబర్ Tech Provider లేదా Solution Partner ద్వారా దీనిలో చేరుతుంది. మీరు స్వయంగా అలా కావచ్చు: వ్యాపార ధృవీకరణ, App Review వీడియోలు, Embedded Signup అమలు అవసరం. లేదా ఇప్పటికే అలాంటి ప్రొవైడర్ ద్వారా కనెక్ట్ చేయవచ్చు: నంబర్ నిమిషాల్లో చేరుతుంది, AI ఏజెంట్కు MCP టూల్స్ లేదా API క్రెడెన్షియల్స్ లభిస్తాయి.
easyCoexistence స్వతంత్ర Meta Tech Provider: ఇది WhatsApp Business నంబర్ను Coexistence ద్వారా నిమిషాల్లో Cloud API కు కనెక్ట్ చేస్తుంది, కాబట్టి మీ ఏజెంట్కు అధికారిక యాక్సెస్ లభిస్తుంది, వ్యాపారం యాప్ను వాడుకుంటూనే ఉంటుంది.
WhatsApp Business యాప్లో ఉండే నంబర్ను ఆన్బోర్డ్ చేసే ఎవరికైనా Meta కోరేది: Tech Provider లేదా Solution Partner హోదా.
App Review రెండు వీడియోలు అడుగుతుంది: మీ యాప్ నుంచి పంపిన మెసేజ్ ఒకటి, యాప్ ద్వారా టెంప్లేట్ సృష్టించడం మరొకటి.
Tech Provider కావడానికి అవసరమైన whatsapp_business_messaging, whatsapp_business_management అనుమతులను App Review ఇస్తుంది.
Embedded Signup v2 మరియు v3 ను Meta నిలిపివేసి, ఇంటిగ్రేషన్లు v4 వైపు మారాలని చెప్పింది.
WhatsApp Business యాప్, Cloud API రెండింటితో వాడుకలో ఉన్న నంబర్కు స్థిర మెసేజ్ వేగ పరిమితి.
ప్లాట్ఫామ్ Partner API ద్వారా కస్టమర్ నంబర్ను చేర్చినప్పుడు, హోస్ట్ చేసిన కనెక్ట్ లింక్ ఎంత కాలం చెల్లుబాటులో ఉంటుంది.
AI ఏజెంట్కు అధికారికంగా WhatsApp వాడాలంటే ఏమేం కావాలి?
Meta యొక్క Cloud API నుంచి నాలుగు అంశాలు కావాలి. మొదటిది, whatsapp_business_messaging అనుమతి ఉన్న యాక్సెస్ టోకెన్తో పాటు ఫోన్ నంబర్ ID, తద్వారా ఏజెంట్ messages ఎండ్పాయింట్కు కాల్ చేయగలదు. రెండవది వెబ్హుక్ ఎండ్పాయింట్, అక్కడికి Meta ఇన్కమింగ్ మెసేజ్లను పంపుతుంది; యాప్తో పంచుకున్న నంబర్పై, ఫోన్లో వ్యక్తి టైప్ చేసిన సమాధానాల కోసం smb_message_echoes కూడా. మూడవది ఆమోదించిన టెంప్లేట్లు, ఎందుకంటే స్వేచ్ఛా రూప మెసేజ్ గత 24 గంటల్లో మెసేజ్ పంపిన కస్టమర్కు మాత్రమే చేరుతుంది. నాలుగవది కనెక్షన్ తెగిపోయినప్పుడు తెలుసుకునే మార్గం, ఎందుకంటే API వైపు ఆగిపోయినా ఫోన్లోని యాప్ పనిచేస్తూనే ఉంటుంది.
ప్రజలు మొదట కనుగొనే షార్ట్కట్ WhatsApp Web ఆటోమేషన్, అది లింక్ చేసిన డివైస్గా సైన్ ఇన్ అవుతుంది. అది WhatsApp నిబంధనలను ఉల్లంఘిస్తుంది, ఏజెంట్ ఏం చేసినా నంబర్ నిషేధానికి గురయ్యే ప్రమాదం ఉంటుంది.
Tech Provider మార్గంలో ఏమేం ఉంటాయి?
Meta సొంత క్రమం, ఈ క్రమంలోనే. ప్రతి దశ ఉచితం, దేన్నీ డబ్బు చెల్లించి వేగవంతం చేయలేరు: సమీక్షలు Meta షెడ్యూల్ ప్రకారం జరుగుతాయి, Meta ఎలాంటి టైమ్లైన్ ప్రచురించదు, కాబట్టి మొదటి కస్టమర్ నంబర్ కనెక్ట్ అయ్యే ముందు రోజులు కాదు వారాలు ప్లాన్ చేయండి. ఆ తర్వాత బ్యాకెండ్ నిరంతరం నడవాలి: ప్రతి సైన్అప్ తర్వాత టోకెన్ మార్పిడి, వెబ్హుక్ రిసీవర్, నంబర్ వారీగా రూటింగ్, మరియు Meta యొక్క 14 రోజుల నిష్క్రియత నియమం వంటి డిస్కనెక్షన్ల పర్యవేక్షణ.
చిన్న మార్గం ఏది?
ఆ ప్రక్రియను ఇప్పటికే పూర్తి చేసిన ప్రొవైడర్ ద్వారా నంబర్ను కనెక్ట్ చేయండి. easyCoexistence తో, వ్యాపారం Meta యొక్క Embedded Signup ను నడిపి, WhatsApp Business యాప్తో కోడ్ను స్కాన్ చేస్తుంది, దీనికి దాదాపు రెండు నిమిషాలు పడుతుంది. నంబర్ వ్యాపారం సొంత Business Portfolio లోని Cloud API లో చేరుతుంది, యాప్ పనిచేస్తూనే ఉంటుంది. ఆ తర్వాత ఏజెంట్కు అది మాట్లాడే రూపంలో యాక్సెస్ లభిస్తుంది: ChatGPT, Claude, Claude Code లేదా Codex వంటి అసిస్టెంట్ల కోసం MCP టూల్స్, లేదా మీరు నడిపే కోడ్ కోసం నంబర్ క్రెడెన్షియల్స్ మరియు వెబ్హుక్లు.
| 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 |
ఏజెంట్ నంబర్ క్రెడెన్షియల్స్ ఎలా పొందుతుంది?
get_api_credentials ద్వారా, లేదా డాష్బోర్డ్లోని నంబర్ పేజీ నుంచి. టూల్ Graph API బేస్ URL, WhatsApp Business Account ID, phone number ID, send endpoint, మరియు క్లయింట్ టోకెన్ జారీ అయి ఉంటే వ్యాపారం సొంత యాక్సెస్ టోకెన్ను తిరిగి ఇస్తుంది, అది దాని WhatsApp ఆస్తులకు మాత్రమే పరిమితమై ఉంటుంది. ఏ క్లయింట్ టోకెన్ జారీ కాకపోతే, టోకెన్ null గా వస్తుంది, దానితో పాటు డాష్బోర్డ్ నుంచి నంబర్ను రీకనెక్ట్ చేస్తే టోకెన్ జారీ అవుతుందనే సూచన వస్తుంది, పనిచేస్తున్న టోకెన్ను మార్చకుండానే. తీసుకోవాల్సిన యాప్ సీక్రెట్ లేదు, ఎందుకంటే Meta వెబ్హుక్లను easyCoexistence యొక్క యాప్ సీక్రెట్తో సంతకం చేస్తుంది, అది ఎప్పుడూ పంచుకోబడదు. టూల్కు యాక్టివ్ ప్లాన్ కావాలి, ఎందుకంటే టోకెన్ మెసేజ్లు పంపగలదు.
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." }
}'ఇన్కమింగ్ మెసేజ్లు ఏజెంట్కు ఎలా చేరతాయి?
ప్రతి నంబర్కు రెండు మోడ్లు ఉన్నాయి, వాటిని set_inbound_mode తో లేదా నంబర్ పేజీలో మార్చవచ్చు. మీ సర్వర్కు నేరుగా: set_webhook_destination Meta ను నేరుగా మీ HTTPS ఎండ్పాయింట్కు చూపుతుంది, అది Meta యొక్క GET హ్యాండ్షేక్కు స్పందించాలి, మరియు easyCoexistence మెసేజ్లను ఎప్పుడూ చూడదు, కాబట్టి ఆటోమేషన్లు ఆఫ్లో ఉంటాయి. Meta ఆ డెలివరీలపై మా యాప్ సీక్రెట్తో సంతకం చేస్తుంది కాబట్టి, URL పాత్లో ఒక పొడవైన యాదృచ్ఛిక సీక్రెట్ ఉంచి, అది లేని అభ్యర్థనలను తిరస్కరించండి.
ఆటోమేషన్లు ఆన్లో ఉంటే: Meta easyCoexistence కు డెలివరీ చేస్తుంది, ఆటోమేషన్లు సమాధానం ఇవ్వగలవు, మరియు ఐచ్ఛిక Forward URL, Meta యొక్క అసలు పేలోడ్ను "value" కింద అందుకుంటుంది, X-EC-Signature: t=<unix>,v1=<HMAC-SHA256 of "<t>.<body>"> తో సంతకం చేయబడి, ఒకసారి మాత్రమే చూపే సీక్రెట్ను ఉపయోగించి. ఆటోమేషన్ స్టెప్ Call my webhook కూడా మెసేజ్ను, చాట్ చివరి 10 మెసేజ్లను మీ ఏజెంట్కు ఇస్తుంది, మరియు మీ జవాబు 20 సెకన్లలోపు {"reply": "..."} అయితే దాని సమాధానాన్ని పంపుతుంది.
ఏజెంట్ ఏ పరిమితులను పాటించాలి?
అవి Meta యొక్కవి, ఏ ప్రొవైడర్ ద్వారా అయినా ఒకేలా ఉంటాయి. వీటిని ముందే తెలుసుకున్న ఏజెంట్ బగ్ల్లా కనిపించే వైఫల్యాలను తప్పించుకుంటుంది:
- WhatsApp Business యాప్తో పంచుకున్న నంబర్లకు Meta నిర్ణయించిన, ఒక్కో నంబర్కు సెకనుకు 20 మెసేజ్లు.
- స్వేచ్ఛా రూప మెసేజ్లు కస్టమర్ చివరి మెసేజ్ నుంచి 24 గంటల్లోపే; ఆ తర్వాత ఆమోదించిన టెంప్లేట్ మాత్రమే.
- టెంప్లేట్లు API ద్వారా మాత్రమే వెళ్తాయి, ఎందుకంటే Coexistence నంబర్లోని యాప్ వాటిని పంపలేవు.
- యాప్లో వ్యక్తి టైప్ చేసిన సమాధానాలు
smb_message_echoesగా వస్తాయి; ఆ చాట్పై ఏజెంట్ను ఆపండి, లేకపోతే కస్టమర్కు రెండు సమాధానాలు వస్తాయి. - గ్రూప్ చాట్లు API తో సింక్ కావు, కాబట్టి ఏజెంట్ ఒకరితో ఒకరు జరిగే చాట్లలో పనిచేస్తుంది.
- కాంటాక్ట్లు, మరియు ఒకరితో ఒకరు జరిగే చాట్ల గరిష్టంగా 6 నెలల చరిత్ర ఒక్కసారి మాత్రమే దిగుమతి అవుతుంది, కనెక్ట్ చేసిన 24 గంటల్లోపు నేరుగా వెబ్హుక్ డెస్టినేషన్ సేవ్ అయితేనే; ఆటోమేషన్లు ఆన్ ఉన్న నంబర్కు దిగుమతి జరగదు.
- వాయిస్ మరియు వీడియో కాల్లు యాప్లో పనిచేస్తూనే ఉంటాయి, కానీ Coexistence నంబర్పై Cloud API కాల్లను అందించదు, కాబట్టి ఏజెంట్ టెక్స్ట్లో పనిచేస్తుంది.
ఒక ప్లాట్ఫామ్ ఈ విధంగా తన కస్టమర్ల నంబర్లను కనెక్ట్ చేయగలదా?
అవును, Partner API ద్వారా. ఇది SaaS లేదా ఏజెన్సీ తన సొంత Tech Provider హోదా లేకుండానే కస్టమర్లను ఆన్బోర్డ్ చేసే పద్ధతి. create_api_key తో కీ సృష్టించండి (ఇది ec_live_ తో మొదలవుతుంది, ఒకసారి మాత్రమే చూపుతుంది), తర్వాత మీ బ్యాకెండ్ నుంచి POST /api/v1/connect-sessions కాల్ చేయండి, లేదా అసిస్టెంట్ నుంచి create_connect_link ద్వారా 1 గంట చెల్లుబాటయ్యే హోస్ట్ చేసిన లింక్ పొందండి. కస్టమర్ అక్కడ Meta పాప్అప్ మరియు QR స్కాన్ నడిపి, connection_id తో మీ redirect_url కు తిరిగి వస్తారు. GET /api/v1/connections/:id?credentials=1 అప్పుడు కస్టమర్ సొంత టోకెన్ను తిరిగి ఇస్తుంది, మరియు connection.disconnected వంటి స్టేటస్ ఈవెంట్లు X-EC-Signature తో సంతకం చేయబడి వస్తాయి. ప్రతి నంబర్ మీ ఖాతాకు అదే ప్రతి-నంబర్ బ్యాండ్లలో బిల్ చేయబడుతుంది.
సాధారణ పొరపాట్లు
- నేరుగా డెస్టినేషన్పై X-Hub-Signature-256 ధృవీకరించడం. Meta easyCoexistence యొక్క యాప్ సీక్రెట్తో సంతకం చేస్తుంది, అది ఎప్పుడూ పంచుకోబడదు, కాబట్టి నిజమైన డెలివరీలు ఆ తనిఖీలో విఫలమవుతాయి; URL లోని పొడవైన యాదృచ్ఛిక సీక్రెట్ను నమ్మండి, లేదా X-EC-Signature తో ఫార్వర్డింగ్ వాడండి.
- n8n యొక్క WhatsApp Trigger నోడ్తో స్వీకరించడం. అది మీ సొంత Meta యాప్ను ఆశిస్తుంది; బదులుగా URL లో సీక్రెట్తో సాధారణ Webhook నోడ్ వాడండి.
- smb_message_echoes ను పట్టించుకోకపోవడం. అప్పుడు ఏజెంట్ ఫోన్ నుంచి ఇప్పటికే సమాధానమిచ్చిన వ్యక్తికి మళ్లీ సమాధానమిస్తుంది, మరియు కస్టమర్ రెండు సమాధానాలు చదువుతారు.
- కనెక్షన్ తర్వాత రోజులు ఆలస్యంగా నేరుగా వెబ్హుక్ డెస్టినేషన్ సేవ్ చేయడం, లేదా నంబర్ను ఆటోమేషన్లలోనే ఉంచడం. కాంటాక్ట్లు మరియు గరిష్టంగా 6 నెలల చాట్ల Meta ఒకసారి దిగుమతికి, కనెక్షన్ నుంచి 24 గంటల్లోపు నేరుగా డెస్టినేషన్ సేవ్ కావాలి.
ఏజెంట్ 30 కంటే ఎక్కువ MCP టూల్స్ ద్వారా, లేదా ప్రతి నంబర్ క్రెడెన్షియల్స్ మరియు వెబ్హుక్ల ద్వారా పనిచేస్తుంది, మరియు ప్రతి నంబర్ను 24/7 పర్యవేక్షిస్తూ అలర్ట్లు ఇస్తుంది. ప్రతి నంబర్కు నెలకు US$ 9 నుంచి US$ 0.75 వరకు, నంబర్లు జోడించేకొద్దీ తగ్గుతూ, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
నాకు సొంత Meta యాప్ అవసరమా?
లేదు. నంబర్ easyCoexistence యొక్క Meta యాప్ ద్వారా ఆన్బోర్డ్ అవుతుంది, మరియు వ్యాపారం సొంత Business Portfolio మరియు WhatsApp Business Account లోనే ఉంటుంది. మీ కోడ్ get_api_credentials నుంచి వచ్చిన వ్యాపారం సొంత టోకెన్తో పంపుతుంది, కాబట్టి మీరు తర్వాత ఒకటి నిర్మించే వరకు మీ సొంత యాప్ అవసరం లేదు.
ఏజెంట్, టీమ్ ఒకే సమయంలో నంబర్ను వాడగలరా?
అవును. Meta Cloud API మరియు WhatsApp Business యాప్ మధ్య మెసేజ్లను ప్రతిబింబిస్తుంది, కాబట్టి ఏజెంట్ పంపినది ఫోన్లోని యాప్ చాట్ థ్రెడ్లో కనిపిస్తుంది, మరియు టీమ్ యాప్లో టైప్ చేసినది smb_message_echoes గా మీ సిస్టమ్కు చేరుతుంది.
ఏ ఏజెంట్ ఫ్రేమ్వర్క్లు పనిచేస్తాయి?
HTTP పై OAuth తో MCP మాట్లాడే ఏ క్లయింట్ అయినా, ఉదాహరణకు ChatGPT, Claude, Claude Code, Codex మరియు Cursor, మరియు Meta Graph API ను కాల్ చేసే ఏ కోడ్ అయినా: Node.js, Python, n8n, LangChain, OpenAI Agents SDK లేదా Vercel AI SDK. దాని కింద ఉన్న API Meta సొంతది, కాబట్టి ఏజెంట్ లోపల యాజమాన్య భాగమేదీ లేదు.
సాధారణ ప్రయోజన AI అసిస్టెంట్ WhatsApp పై అనుమతించబడుతుందా?
Meta యొక్క Business Solution Terms, సెక్షన్ 4.7, సాధారణ ప్రయోజన AI అసిస్టెంట్ ప్రొవైడర్లను, AI ప్రధాన పనిగా ఉన్న చోట WhatsApp Business Platform పై అందించకుండా నిషేధిస్తుంది; Meta నిర్ణయించినట్లు, జనవరి 15, 2026 నుంచి అమల్లో ఉంది. తమ కస్టమర్ల కోసం, సపోర్ట్, సేల్స్ లేదా బుకింగ్ కోసం AI వాడే వ్యాపారం లక్ష్యం కాదు, మరియు EU మరియు బ్రెజిల్ నియంత్రణాధికారులు పోటీ అసిస్టెంట్ల కోసం ఆ నియమాన్ని నిలిపివేయాలని లేదా వెనక్కి తీసుకోవాలని Meta ను ఆదేశించారు.
చదవడం కొనసాగించండి
ప్రారంభించడానికి సిద్ధంగా ఉన్నారా?
నెలల్లో కాదు, నిమిషాల్లో WhatsApp Coexistence సెటప్ చేయండి. యాప్ ఫోన్లో పనిచేస్తూనే ఉంటుంది.
ఉచిత ట్రయల్ ప్రారంభించండిధృవీకరించిన తేదీ