కస్టమర్ల WhatsApp, Instagram మరియు TikTok పై AI ఏజెంట్ ఉత్పత్తిని ఎలా నిర్మించాలి
కస్టమర్ల ఛానెళ్లపై పనిచేసే AI ఏజెంట్ ఉత్పత్తి మూడు భాగాలపై ఆధారపడి ఉంటుంది: ప్రతి కస్టమర్ WhatsApp నంబర్ లేదా సోషల్ ఖాతా కోసం హోస్ట్ చేసిన కనెక్ట్ లింక్; వారి మెసేజ్లు మరియు కామెంట్లను మీ బ్యాకెండ్కు తీసుకువచ్చే వెబ్హుక్లు, అక్కడ మీ స్వంత మోడల్ ప్రతి నెట్వర్క్ అధికారిక API ద్వారా కస్టమర్ టోకెన్తో పంపే సమాధానాలు రాస్తుంది; మరియు కనెక్షన్లు ఆగిపోయినప్పుడు స్టేటస్ ఈవెంట్లు. ఏజెంట్ ప్రతి నెట్వర్క్ నియమాలను పాటిస్తుంది, ఉదాహరణకు WhatsApp యొక్క 24 గంటల విండో.
easyCoexistence మీ ఉత్పత్తి AI ఏజెంట్లకు మీ కస్టమర్ల WhatsApp నంబర్లపై మరియు వారి Instagram, Facebook, TikTok, YouTube మరియు LinkedIn ఖాతాలపై స్వరం ఇస్తుంది, మరియు మరిన్ని ఛానెళ్లు వస్తున్నాయి: హోస్ట్ చేసిన కనెక్ట్ లింక్లు, తాజా ఆధారాలు, వెబ్హుక్లు మరియు సంతకం చేసిన స్టేటస్ ఈవెంట్లు, ప్రతి నెట్వర్క్ అధికారిక API ద్వారా, ప్రతి కనెక్షన్ 24/7 పర్యవేక్షణలో.
WhatsApp కస్టమర్ సర్వీస్ విండో: వినియోగదారు మెసేజ్ లేదా కాల్ తర్వాత; ప్రతి కొత్త మెసేజ్ దాన్ని రీసెట్ చేస్తుంది.
కస్టమర్ సర్వీస్ విండో ముగిసిన తర్వాత WhatsApp వ్యాపారం పంపగలిగేది: ముందుగా ఆమోదించిన టెంప్లేట్ మెసేజ్లు.
Meta నిబంధనలు AI ప్రొవైడర్లు WhatsApp ను అనుబంధ కార్యాచరణ కాకుండా ప్రధాన కార్యాచరణగా AI అందించడానికి ఉపయోగించడాన్ని నిషేధిస్తాయి.
Instagram ఖాతా కామెంట్కు ఒకే ప్రైవేట్ సమాధానం ఇవ్వడానికి విండో; కామెంట్ చేసినప్పటి నుంచి లెక్కిస్తారు.
WhatsApp Business యాప్ మరియు Cloud API రెండింటితో ఉపయోగించే నంబర్కు స్థిర థ్రూపుట్.
AI ఏజెంట్ ఉత్పత్తికి ప్రతి కస్టమర్ ఛానెల్ నుండి ఏమి కావాలి?
నాలుగు విషయాలు: కస్టమర్ దాన్ని కనెక్ట్ చేయడానికి ఒక మార్గం, వారి మెసేజ్లు మీ బ్యాకెండ్కు చేరడం, సమాధానం ఇవ్వడానికి టోకెన్, మరియు కనెక్షన్ పనిచేయడం ఆగిపోయినప్పుడు తెలియజేత. Partner API ఈ నాలుగింటినీ కవర్ చేస్తుంది, అయితే మోడల్, ప్రాంప్ట్లు మరియు సంభాషణ తర్కం మీ చేతుల్లోనే ఉంటాయి. easyCoexistence ఖాతాను కనెక్ట్ చేస్తుంది, దాని యాక్సెస్ను రీన్యూ చేస్తుంది మరియు పర్యవేక్షిస్తుంది, మరియు మీ సమాధానాలు మీ బ్యాకెండ్ నుండి నేరుగా నెట్వర్క్ APIకి వెళ్తాయి.
ప్రతి కస్టమర్ ఎలా కనెక్ట్ అవుతారు?
మీ బ్యాకెండ్ POST /connect-sessions తో కనెక్ట్ సెషన్ సృష్టిస్తుంది, ఛానెల్, redirect_url, మరియు మీ కస్టమర్ కోసం external_ref పేర్కొంటూ; నంబర్ అయితే webhook_url మరియు webhook_verify_token కూడా. కస్టమర్ హోస్ట్ చేసిన లింక్ను తెరుస్తారు, Meta, TikTok, Google లేదా LinkedIn తో సైన్ ఇన్ చేస్తారు, మరియు connection_id లేదా channel_id తో మీ యాప్కు తిరిగి వస్తారు. వారికి easyCoexistence ఖాతా, ఇమెయిల్ లేదా కార్డు అవసరం లేదు, మరియు మీ కీ ద్వారా చేసిన ప్రతి కనెక్షన్ మీ ఖాతాకే చెందుతుంది.
కస్టమర్ మెసేజ్లు మరియు కామెంట్లు మీ మోడల్కు ఎలా చేరతాయి?
వెబ్హుక్ ద్వారా, వాటిని పంపే నెట్వర్క్లలో. Meta ఒక నంబర్ మెసేజ్లను నేరుగా దాని webhook_url కు పంపుతుంది, మరియు వ్యాపార సిబ్బంది WhatsApp Business యాప్ నుండి పంపిన మెసేజ్లు smb_message_echoes గా అక్కడికి చేరతాయి. Instagram మరియు Facebook కామెంట్లు, మెన్షన్లు మరియు DMలు, అలాగే TikTok కామెంట్లు, ప్రతి ఛానెల్ గమ్యస్థానానికి, దాని సీక్రెట్తో సంతకం చేసి ఫార్వర్డ్ అవుతాయి. YouTube మరియు LinkedIn కామెంట్ ఈవెంట్లు పంపవు, కాబట్టి ఏజెంట్ షెడ్యూల్ ప్రకారం వారి APIల ద్వారా కొత్త కామెంట్లను చదువుతుంది. ప్రతి డెలివరీకి వెంటనే 2xx తో సమాధానం ఇవ్వండి, మోడల్ను వర్కర్ పిలవనివ్వండి.
ఏజెంట్ ఎలా సమాధానం ఇస్తుంది?
నెట్వర్క్ స్వంత API ద్వారా, మీ బ్యాకెండ్ పొందిన ఆధారాలతో. WhatsApp సమాధానం కస్టమర్ టోకెన్తో నంబర్ యొక్క send_endpoint కు POST; Instagram లేదా Facebook DM ఖాతా యొక్క messages edge కు వెళ్తుంది; TikTok సమాధానం business/comment/reply/create/ ద్వారా కామెంట్ కింద వెళ్తుంది. క్రింది నమూనా WhatsApp మెసేజ్లకు సమాధానం ఇస్తుంది: URL పాత్లోని సీక్రెట్ను తనిఖీ చేస్తుంది, ప్రతి వచ్చే మెసేజ్ను క్యూలో ఉంచుతుంది, మరియు మీ మోడల్ ఇచ్చినదాన్ని సమాధానంగా పంపుతుంది.
import hmac, os, queue, threading
import requests
from flask import Flask, abort, request
EC = "https://easycoexistence.com/api/v1"
KEY = {"Authorization": f"Bearer {os.environ['EC_API_KEY']}"} # ec_live_...
PATH_SECRET = os.environ["WA_PATH_SECRET"] # the random part of each webhook_url
CONNECTIONS: dict[str, str] = {} # phone_number_id -> connection id, from your database
jobs: queue.Queue = queue.Queue()
app = Flask(__name__)
@app.route("/wa/<secret>", methods=["GET", "POST"])
def whatsapp(secret: str):
if not hmac.compare_digest(secret, PATH_SECRET):
abort(404)
if request.method == "GET": # Meta's handshake when the destination is set
if request.args.get("hub.verify_token") != os.environ["WA_VERIFY_TOKEN"]:
abort(403)
return request.args.get("hub.challenge", "")
for entry in request.get_json().get("entry", []):
for change in entry.get("changes", []):
if change.get("field") == "messages": # echoes and history are context, not prompts
value = change["value"]
for msg in value.get("messages", []):
jobs.put((value["metadata"]["phone_number_id"], msg))
return "", 200 # answer at once; dedupe on msg["id"], since Meta can deliver twice
def worker() -> None:
while True:
phone_number_id, msg = jobs.get()
conn = requests.get(f"{EC}/connections/{CONNECTIONS[phone_number_id]}",
headers=KEY, params={"credentials": 1}).json()
creds = conn["credentials"]
if not creds["access_token"]: # token_ready is false: a new connect session issues one
continue
reply = my_model(conn["external_ref"], msg) # your model, your prompt, your memory
requests.post(creds["send_endpoint"], # a reply to a fresh message is inside the 24 hours
headers={"Authorization": f"Bearer {creds['access_token']}"},
json={"messaging_product": "whatsapp", "to": msg["from"],
"type": "text", "text": {"body": reply}})
threading.Thread(target=worker, daemon=True).start()MCP సర్వర్ లేదా Partner API: ఏజెంట్ ఏది ఉపయోగిస్తుంది?
Partner API, ఏజెంట్ మీ ఉత్పత్తి అయినప్పుడు మరియు మీ కస్టమర్లు ఛానెళ్లను తీసుకువచ్చినప్పుడు: మీ బ్యాకెండ్ కీని ఉంచుకుంటుంది, ఈవెంట్లను అందుకుంటుంది, మరియు మీరు ఎంచుకున్న ఏ మోడల్నైనా నడుపుతుంది. https://easycoexistence.com/api/mcp వద్ద ఉన్న MCP సర్వర్ Claude లేదా ChatGPT వంటి అసిస్టెంట్కు సరిపోతుంది, ఇది మీ స్వంత easyCoexistence ఖాతాపై పనిచేస్తుంది, OAuth సైన్ ఇన్ తర్వాత అభ్యర్థనపై పిలిచే టూల్స్ ద్వారా. మీ కీతో కనెక్ట్ చేసిన నంబర్లు మరియు ఛానెళ్లు కూడా ఆ ఖాతాలోనే ఉంటాయి, కాబట్టి MCP సెషన్ మీ స్వంత బృందం పనికి వాటిని చేరుకోగలదు.
| Partner API | MCP server | |
|---|---|---|
| Built for | Your product, serving your customers | An assistant working on your own account |
| Signs in with | An ec_live_ key, one per account | OAuth, from Claude, ChatGPT or another client |
| Incoming messages | Webhooks to your backend | Read when the assistant calls a tool |
| The model | Any model you run | The assistant's own |
| Replies | Your code calls each network's API | Tools such as send_message and reply_to_comment |
ఏజెన్సీలు అనేక క్లయింట్ల కోసం ఏజెంట్లను ఎలా నడుపుతాయి?
ఒకే ఖాతాలో, ప్రతి క్లయింట్ ట్యాగ్ చేయబడి. ప్రతి కనెక్ట్ సెషన్లో క్లయింట్ ID ను external_ref గా ఇవ్వండి, partner_name తో హోస్ట్ చేసిన పేజీలో మీ ఏజెన్సీ పేరు చూపండి, మరియు ఒక క్లయింట్ కనెక్షన్లను GET /connections?external_ref= మరియు GET /channels?external_ref= ద్వారా జాబితా చేయండి. ప్రతి కనెక్షన్కు ఏజెన్సీకి నెలకు US$ 9 నుండి US$ 0.75 వరకు బిల్ అవుతుంది, కనెక్షన్లు జోడించేకొద్దీ తగ్గుతుంది; WhatsApp సంభాషణ ఛార్జీలను Meta క్లయింట్ స్వంత WhatsApp Business ఖాతాకు బిల్ చేస్తుంది. Coexistence తో, క్లయింట్ సిబ్బంది ఏజెంట్తో పాటు WhatsApp Business యాప్లో సమాధానాలు ఇస్తూనే ఉంటారు.
ఏజెంట్ ఏ నియమాలను పాటించాలి?
నెట్వర్క్ల స్వంత నియమాలు, మోడల్ సమాధానం పంపే ముందు మీ కోడ్ వాటిని తనిఖీ చేయాలి. ప్లాట్ఫామ్లు వాటిని తమ కస్టమర్ల తరఫున పాటిస్తాయి, ఎందుకంటే Meta అమలు కస్టమర్ ఖాతాపై వర్తిస్తుంది:
- WhatsApp: స్వేచ్ఛా రూప సమాధానాలు కస్టమర్ చివరి మెసేజ్ నుండి 24 గంటలలోపు మాత్రమే; ఆ తర్వాత, ఆమోదించిన టెంప్లేట్, API ద్వారా పంపాలి, ఎందుకంటే Coexistence లో WhatsApp Business యాప్ టెంప్లేట్లు పంపలేదు.
- WhatsApp: Meta నిబంధనలు AI ను ప్రాథమిక కార్యాచరణగా అందించడాన్ని నిషేధిస్తాయి, Partner API రిఫరెన్స్ దీన్ని సాధారణ ప్రయోజన AI బాట్లు లేవు అని చెబుతుంది, మరియు WhatsApp డేటాపై ఫైన్-ట్యూనింగ్ను వ్యాపారం యొక్క ప్రత్యేక ఉపయోగం కోసం మాత్రమే అనుమతిస్తాయి.
- Instagram మరియు Facebook: వ్యక్తి చివరి మెసేజ్ నుండి 24 గంటలలోపు DMలు, మరియు ప్రతి కామెంట్కు ఒక ప్రైవేట్ సమాధానం దాని నుండి 7 రోజులలోపు.
- TikTok: కామెంట్లకు సమాధానాలు బహిరంగమే, ఎందుకంటే TikTok కనెక్షన్కు DMలు ఉండవు.
- వాల్యూమ్: ప్రతి Coexistence నంబర్కు సెకనుకు 20 మెసేజ్లు, మరియు మార్కెటింగ్ టెంప్లేట్లకు కస్టమర్ WhatsApp Business ఖాతాపై చెల్లింపు పద్ధతి అవసరం.
ఛానెల్ పనిచేయడం ఆగిపోయిందని ఏజెంట్కు ఎలా తెలుస్తుంది?
స్టేటస్ ఈవెంట్ల నుండి. connection.disconnected లేదా channel.disconnected అంటే కస్టమర్ తిరిగి కనెక్ట్ అయ్యే వరకు సమాధానాలు విఫలమవుతాయి, కాబట్టి ఆ కస్టమర్ ఏజెంట్ను పాజ్ చేయండి, వారికి తెలియజేయండి, మరియు కొత్త కనెక్ట్ లింక్ పంపండి; connection.token_missing అంటే నంబర్ మెసేజ్లు అందుకోగలదు కానీ ఇంకా పంపలేదు. connection.connected లేదా channel.connected మళ్లీ వచ్చినప్పుడు, తాజా ఆధారాలు తీసుకుని పునఃప్రారంభించండి. ప్రతి ఈవెంట్ X-EC-Signature తో సంతకం చేయబడి, సుమారు 33 గంటల పాటు మళ్లీ ప్రయత్నించబడుతుంది.
సాధారణ పొరపాట్లు
- 24 గంటల కంటే పాత WhatsApp మెసేజ్కు మోడల్ స్వేచ్ఛా రూప టెక్స్ట్తో సమాధానం ఇవ్వనివ్వడం. విండో ముగిసిపోయింది, కాబట్టి కస్టమర్ చివరి ఇన్బౌండ్ సమయాన్ని తనిఖీ చేసి, ఆమోదించిన టెంప్లేట్కు మారండి.
- కస్టమర్ల WhatsApp సంభాషణలపై ఉమ్మడి మోడల్కు శిక్షణ ఇవ్వడం. Meta నిబంధనలు WhatsApp Business Platform డేటాపై ఫైన్-ట్యూనింగ్ను వ్యాపారం యొక్క ప్రత్యేక ఉపయోగానికి మాత్రమే అనుమతిస్తాయి, ఇతర మోడల్లను మెరుగుపరచడానికి ఎప్పుడూ కాదు.
- smb_message_echoes ను కస్టమర్ మెసేజ్లుగా భావించడం. అవి వ్యాపార సిబ్బంది యాప్ నుండి పంపినవి, కాబట్టి వాటిని మోడల్కు సందర్భంగా ఇవ్వండి, సమాధానం ఇవ్వాల్సిన మెసేజ్లుగా కాదు.
- ఖాతా తన స్వంత సమాధానాలకే జవాబివ్వడం. అది పంపిన Instagram DMలు ఎకోలుగా తిరిగి వస్తాయి, TikTok సమాధానాలు కామెంట్ ఈవెంట్లుగా వస్తాయి, కాబట్టి ఖాతా స్వయంగా రాసినవాటిని దాటవేయండి, లేదంటే ఏజెంట్ తనకు తానే సమాధానం ఇస్తుంది.
ప్రతి కనెక్షన్కు నెలకు US$ 9 నుండి US$ 0.75 వరకు, కనెక్షన్లు జోడించేకొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం.
తరచుగా అడిగే ప్రశ్నలు
నా స్వంత AI మోడల్ను ఉపయోగించవచ్చా?
అవును. మీ బ్యాకెండ్ మెసేజ్లను అందుకుంటుంది, మీరు ఎంచుకున్న ఏ మోడల్నైనా పిలుస్తుంది, మరియు కస్టమర్ టోకెన్తో నెట్వర్క్ API ద్వారా సమాధానం ఇస్తుంది. WhatsApp నంబర్ మెసేజ్లు Meta నుండి నేరుగా మీ వెబ్హుక్కు వెళ్తాయి, easyCoexistence ద్వారా ఎప్పుడూ కాదు.
WhatsApp ఏజెంట్ కోసం Meta AI విధానం అంటే ఏమిటి?
Meta నిబంధనలు AI ప్రొవైడర్లు WhatsApp Business Platform ను AI సాంకేతికతను ప్రాథమిక కార్యాచరణగా అందించడానికి ఉపయోగించడాన్ని నిషేధిస్తాయి, అనుబంధ లేదా సహాయక కార్యాచరణ కాకుండా, Meta నిర్ణయించినట్లు. మీ కస్టమర్ల తరఫున దానికి కట్టుబడి ఉండండి, 24 గంటల విండో మరియు ఆమోదించిన టెంప్లేట్లతో పాటు.
ఏజెంట్ TikTok, YouTube లేదా LinkedIn లో DMలు పంపగలదా?
లేదు. ఆ నెట్వర్క్లలో ఏజెంట్ కామెంట్లలో పనిచేస్తుంది: TikTok సమాధానాలు బహిరంగంగా ఉంటాయి, మరియు YouTube మరియు LinkedIn కామెంట్లు వాటి APIల ద్వారా చదవబడి సమాధానం ఇవ్వబడతాయి.
AI ఏజెంట్ ఉత్పత్తికి easyCoexistence ఖర్చు ఎంత?
ప్రతి కనెక్షన్కు, ప్రతి నెట్వర్క్లో ఒకేలా: నెలకు US$ 9 నుండి US$ 0.75 వరకు, కనెక్షన్లు జోడించేకొద్దీ తగ్గుతుంది, మొదటి 3 రోజులు ఉచితం. WhatsApp సంభాషణ ఛార్జీలను Meta ప్రతి కస్టమర్ స్వంత WhatsApp Business ఖాతాకు బిల్ చేస్తుంది.
చదవడం కొనసాగించండి
మీ మొదటి ఛానెల్ను రెండు నిమిషాల్లో కనెక్ట్ చేయండి.
ప్లాట్ఫామ్ సమీక్షల కోసం ఎదురుచూడాల్సిన అవసరం లేదు. WhatsApp, Instagram, TikTok లేదా మరో ఛానెల్ను కనెక్ట్ చేయండి, ఆపై పోస్ట్ చేయమని, ప్రత్యుత్తరం ఇవ్వమని లేదా రిపోర్ట్ ఇవ్వమని మీ AIకి చెప్పండి, అది పని చేయడం చూడండి.
- 3 రోజులు ఉచితం
- ఎప్పుడైనా రద్దు చేయండి
- అధికారిక APIలు మాత్రమే
- 24/7 పర్యవేక్షణ
ధృవీకరించిన తేదీ