لاگ اِن کریںفری ٹرائل شروع کریں
easyCoexistence آفیشل APIs

صارفین کے WhatsApp، Instagram اور TikTok پر AI ایجنٹ پروڈکٹ کیسے بنائیں

صارفین کے چینلز پر کام کرنے والا AI ایجنٹ پروڈکٹ تین حصوں پر کھڑا ہوتا ہے: ہر صارف کے WhatsApp نمبر یا سوشل اکاؤنٹ کے لیے ہوسٹڈ کنیکٹ لنک، ویب ہک جو ان کے پیغامات اور تبصرے آپ کے سرور تک پہنچاتے ہیں، جہاں آپ کا اپنا ماڈل جواب لکھتا ہے اور صارف کے ٹوکن کے ساتھ ہر نیٹ ورک کے سرکاری API کے ذریعے بھیجتا ہے، اور کنکشن ٹوٹنے پر آنے والے اسٹیٹس ایونٹس۔ ایجنٹ ہر نیٹ ورک کے قواعد کی پابندی کرتا ہے، جیسے WhatsApp کی 24 گھنٹے کی ونڈو۔

easyCoexistence آپ کی پروڈکٹ کے AI ایجنٹس کو آپ کے صارفین کے WhatsApp نمبروں اور ان کے Instagram، Facebook، TikTok، YouTube اور LinkedIn اکاؤنٹس پر آواز دیتا ہے، اور مزید چینلز بھی: ہوسٹڈ کنیکٹ لنکس، تازہ اسناد، ویب ہکس اور دستخط شدہ اسٹیٹس ایونٹس، ہر نیٹ ورک کے سرکاری API پر، ہر کنکشن 24/7 نگرانی میں۔

24 hours

WhatsApp کی کسٹمر سروس ونڈو صارف کے پیغام یا کال کے بعد شروع ہوتی ہے؛ ہر نیا پیغام اسے دوبارہ شروع کر دیتا ہے۔

Templates only

کسٹمر سروس ونڈو بند ہونے کے بعد WhatsApp کاروبار صرف پہلے سے منظور شدہ ٹیمپلیٹ پیغامات بھیج سکتا ہے۔

Section 4.7

Meta کی شرائط AI فراہم کنندگان کو WhatsApp کو اس طرح استعمال کرنے سے روکتی ہیں کہ AI ضمنی نہیں بلکہ بنیادی فعالیت بن جائے۔

7 days

Instagram اکاؤنٹ کے کسی تبصرے کے جواب میں ایک نجی جواب کی مدت تبصرہ کیے جانے کے وقت سے شمار ہوتی ہے۔

20 mps

وہ مقررہ تھرو پٹ جو ایک ایسے نمبر کے لیے ہے جو WhatsApp Business ایپ اور Cloud API دونوں کے ساتھ استعمال ہو۔

AI ایجنٹ پروڈکٹ کو ہر صارف کے چینل سے کیا چاہیے؟

چار چیزیں: صارف کے کنیکٹ کرنے کا ذریعہ، ان کے پیغامات کا آپ کے سرور تک پہنچنا، جواب دینے کے لیے ایک ٹوکن، اور کنکشن کام بند کرنے پر اطلاع۔ Partner API ان میں سے ہر ایک کو سنبھالتا ہے، جبکہ ماڈل، پرامپٹس اور گفتگو کی منطق آپ کے پاس رہتی ہے۔ easyCoexistence اکاؤنٹ کو کنیکٹ کرتا ہے، اس کی رسائی تازہ رکھتا ہے اور اس پر نظر رکھتا ہے، اور آپ کے جوابات آپ کے سرور سے براہِ راست نیٹ ورک کے API تک جاتے ہیں۔

1ConnectA hosted link per customer: POST /connect-sessions
2ReceiveMessages from Meta; comments and DMs forwarded, signed
3DecideYour model, your prompts, your memory
4ReplyThe network's API, with the customer's token
5Watchconnection.* and channel.* status events

ہر صارف کنکشن کیسے کرتا ہے؟

آپ کا بیک اینڈ 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 کے راستے میں راز کی جانچ کرتا ہے، ہر آنے والا پیغام قطار میں لگاتا ہے، اور آپ کے ماڈل کی واپس کی ہوئی چیز بھیجتا ہے۔

Python: a WhatsApp agent on your own model
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 APIMCP server
Built forYour product, serving your customersAn assistant working on your own account
Signs in withAn ec_live_ key, one per accountOAuth, from Claude, ChatGPT or another client
Incoming messagesWebhooks to your backendRead when the assistant calls a tool
The modelAny model you runThe assistant's own
RepliesYour code calls each network's APITools 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 جوابات تبصرے کے ایونٹس کے طور پر، اس لیے وہ ہر پیغام چھوڑ دیں جو اکاؤنٹ نے خود لکھا، ورنہ ایجنٹ خود کو جواب دے گا۔
EasyCoexistence کے ساتھ یہ کام کرنا

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 پر بل کرتا ہے۔

مزید پڑھیں

گاہک کے API ٹوکن کیسے حاصل کریں: WhatsApp، Instagram اور TikTok کے لیےWhatsApp نمبر اور ہر سوشل اکاؤنٹ کے کریڈینشلز کال کیا لوٹاتی ہے، فیلڈ بہ فیلڈ، اور ٹوکن کی تبدیلی اور token_ready کیسے کام کرتے ہیں۔گاہکوں کے WhatsApp میسجز اور سوشل کمنٹس ویب ہک کے ذریعے کیسے وصول کریںہر کنکشن کا اپنا ویب ہک: WhatsApp میسجز Meta سے براہ راست، URL کی خفیہ کلید سے تصدیق شدہ، اور سوشل کمنٹس اور DMs X-EC-Signature کے ساتھ دستخط شدہ۔کسٹمر کا WhatsApp یا سوشل کنکشن کب منقطع ہوتا ہے، یہ کیسے جانیںconnection.* اور channel.* اسٹیٹس ایونٹس: پے لوڈ، وجوہات، X-EC-Signature، تقریباً 33 گھنٹے تک دوبارہ کوشش اور id سے ڈپلیکیٹ روکنا۔AI ایجنٹس کے لیے سوشل میڈیا API: شائع کریں، شیڈول کریں، جواب دیں اور پیمائش کریںAI ایجنٹس کے لیے ایک API اور MCP سرور، جو سوشل نیٹ ورکس پر شائع کرنے، شیڈول کرنے، جواب دینے اور اینالیٹکس پڑھنے دیتا ہے، ہر نیٹ ورک کے سرکاری API سے۔ایجنسیوں اور کنسلٹنسیوں کے لیے WhatsApp Coexistenceکلائنٹ کے WhatsApp نمبرز بغیر منتقلی یا عملے کی دوبارہ تربیت کے جوڑیں۔ ایک اکاؤنٹ، کئی نمبرز، ہر نمبر اپنے Business Portfolio میں۔24 گھنٹے کی کسٹمر سروس ونڈوکسٹمر سروس ونڈو کیا ہے، کب کھلتی اور بند ہوتی ہے، اس میں کیا بھیج سکتے ہیں، اور اندر کے جوابات مفت کیوں ہیں۔

دو منٹ میں اپنا پہلا چینل کنیکٹ کریں۔

کسی پلیٹ فارم کے ریویو کا انتظار نہیں۔ WhatsApp، Instagram، TikTok یا کوئی اور چینل کنیکٹ کریں، پھر اپنے AI سے پوسٹ کرنے، جواب دینے یا رپورٹ بنانے کو کہیں اور اسے کام کرتے دیکھیں۔

  • 3 دن مفت
  • کسی بھی وقت منسوخ کریں
  • صرف آفیشل API
  • 24/7 نگرانی

تصدیق شدہ تاریخ