صارفین کے 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 کے تبصرے، ذکر اور DMs، اور TikTok کے تبصرے، ہر چینل کی منزل پر اس کے راز سے دستخط شدہ بھیجے جاتے ہیں۔ YouTube اور LinkedIn تبصروں کے ایونٹ نہیں بھیجتے، اس لیے ایجنٹ ان کے تبصرے ان کے APIs کے ذریعے شیڈول پر پڑھتا ہے۔ ہر ڈیلیوری کا فوراً 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 فی کنکشن ماہانہ کے حساب سے، جو کنکشن بڑھنے کے ساتھ کم ہوتا ہے، جبکہ Meta WhatsApp گفتگو کے چارجز کلائنٹ کے اپنے WhatsApp Business Account پر بل کرتا ہے۔ Coexistence کے ساتھ کلائنٹ کا عملہ ایجنٹ کے ساتھ ساتھ WhatsApp Business ایپ میں جواب دیتا رہتا ہے۔
ایجنٹ کن قواعد کی پابندی کرے؟
نیٹ ورکس کے اپنے قواعد، جن کی جانچ آپ کے کوڈ کو ماڈل کا جواب جانے سے پہلے کرنی چاہیے۔ پلیٹ فارم انہیں اپنے صارفین کی طرف سے نافذ کرتے ہیں، کیونکہ Meta کی پابندی صارف کے اکاؤنٹ پر لاگو ہوتی ہے:
- WhatsApp: آزاد متن کے جوابات صرف صارف کے آخری پیغام کے 24 گھنٹوں کے اندر ہو سکتے ہیں؛ اس کے بعد ایک منظور شدہ ٹیمپلیٹ، جو API کے ذریعے بھیجا جاتا ہے کیونکہ Coexistence میں WhatsApp Business ایپ ٹیمپلیٹ نہیں بھیج سکتی۔
- WhatsApp: Meta کی شرائط AI کو بنیادی فعالیت کے طور پر پیش کرنے سے منع کرتی ہیں، جسے Partner API کا حوالہ عام مقصد کے AI بوٹس کی ممانعت کے طور پر بیان کرتا ہے، اور WhatsApp کے ڈیٹا پر فائن ٹیوننگ صرف کاروبار کے خصوصی استعمال کے لیے اجازت دیتی ہیں۔
- Instagram اور Facebook: DMs صارف کے آخری پیغام کے 24 گھنٹوں کے اندر، اور ہر تبصرے کا ایک نجی جواب اس کے 7 دنوں کے اندر۔
- TikTok: تبصروں کے جواب عوامی ہوتے ہیں، کیونکہ TikTok کنکشن کے پاس DMs نہیں ہوتے۔
- حجم: ہر Coexistence نمبر کے لیے 20 پیغامات فی سیکنڈ، اور مارکیٹنگ ٹیمپلیٹس کے لیے صارف کے WhatsApp Business Account پر ادائیگی کا طریقہ درکار ہے۔
ایجنٹ کو کیسے پتا چلے کہ کوئی چینل کام کرنا بند کر گیا؟
اسٹیٹس ایونٹس سے۔ 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 DMs echoes کے طور پر واپس آتے ہیں اور 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 پر DMs بھیج سکتا ہے؟
نہیں۔ ان نیٹ ورکس پر ایجنٹ تبصروں میں کام کرتا ہے: TikTok کے جوابات عوامی ہوتے ہیں، اور YouTube اور LinkedIn کے تبصرے ان کے APIs کے ذریعے پڑھے اور ان کا جواب دیے جاتے ہیں۔
AI ایجنٹ پروڈکٹ کے لیے easyCoexistence کی قیمت کتنی ہے؟
فی کنکشن، ہر نیٹ ورک پر یکساں: ماہانہ US$ 9 سے US$ 0.75 فی کنکشن، جیسے جیسے کنکشن بڑھتے ہیں کم ہوتا ہوا، پہلے 3 دن فری۔ Meta WhatsApp گفتگو کے چارجز ہر صارف کے اپنے WhatsApp Business Account پر بل کرتا ہے۔
مزید پڑھیں
دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔
کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔
- 3 دن مفت
- کسی بھی وقت منسوخ کریں
- صرف آفیشل API
- 24/7 نگرانی
تصدیق شدہ تاریخ