كيف تبني منتج وكيل ذكاء اصطناعي على WhatsApp وInstagram وTikTok لعملائك
يقوم منتج وكيل الذكاء الاصطناعي على قنوات العملاء على ثلاثة عناصر: رابط ربط مستضاف لكل رقم WhatsApp أو حساب اجتماعي لكل عميل، وخطافات ويب (webhooks) توصل رسائل العملاء وتعليقاتهم إلى خادمك الخلفي، حيث يكتب نموذجك الخاص الردود التي تُرسل عبر واجهة برمجة التطبيقات (API) الرسمية لكل شبكة باستخدام رمز الوصول (token) الخاص بالعميل، وأحداث حالة للاتصالات التي تنقطع. ويلتزم الوكيل بقواعد كل شبكة، ومنها نافذة الـ 24 ساعة في WhatsApp لدى كل عميل.
يمنح easyCoexistence وكلاء الذكاء الاصطناعي في منتجك صوتاً على أرقام WhatsApp لعملائك وحساباتهم في Instagram وFacebook وTikTok وYouTube وLinkedIn، وقنوات أخرى كذلك: روابط ربط مستضافة، وبيانات اعتماد متجددة، وwebhooks وأحداث حالة موقّعة عبر واجهة برمجة كل شبكة الرسمية، مع مراقبة كل اتصال على مدار الساعة.
نافذة خدمة العملاء في WhatsApp تبدأ بعد رسالة المستخدم أو مكالمته، وكل رسالة جديدة تعيد ضبطها.
ما يمكن لنشاط تجاري على WhatsApp إرساله بعد إغلاق نافذة خدمة العملاء: رسائل القوالب المعتمدة مسبقاً.
تحظر شروط Meta على مزودي الذكاء الاصطناعي استخدام WhatsApp لتقديم الذكاء الاصطناعي كوظيفة أساسية، لا كوظيفة ثانوية.
نافذة الرد الخاص الواحد على تعليق في حساب Instagram، وتُحسب من وقت كتابة التعليق.
معدل الإرسال الثابت لرقم يُستخدم مع تطبيق WhatsApp Business وواجهة Cloud API معاً.
ما الذي يحتاجه منتج وكيل الذكاء الاصطناعي من قناة كل عميل؟
أربعة أمور: طريقة يربط بها العميل قناته، ووصول رسائله إلى خادمك الخلفي، ورمز وصول للرد به، وإشعار عند توقف الاتصال عن العمل. تغطي Partner API كل واحد منها، بينما يبقى النموذج والتعليمات ومنطق المحادثة بيدك. يربط easyCoexistence الحساب ويجدد وصوله باستمرار ويراقبه، وتنتقل ردودك من خادمك الخلفي مباشرة إلى واجهة برمجة الشبكة.
كيف يتصل كل عميل؟
ينشئ خادمك الخلفي جلسة ربط عبر POST /connect-sessions، يحدد فيها القناة وredirect_url وexternal_ref للعميل، وفي حالة الرقم webhook_url وwebhook_verify_token. يفتح العميل الرابط المستضاف، ويسجل الدخول عبر Meta أو TikTok أو Google أو LinkedIn، ثم يعود إلى تطبيقك ومعه connection_id أو channel_id. لا يحتاج إلى حساب في easyCoexistence أو بريد إلكتروني أو بطاقة، وكل اتصال يُنشأ بمفتاحك يتبع حسابك أنت.
كيف تصل الرسائل والتعليقات إلى نموذجك؟
عبر webhook في الشبكات التي ترسلها. ترسل Meta رسائل الرقم مباشرة إلى webhook_url، وما يرسله موظفو النشاط من تطبيق WhatsApp Business يصل إليه بوصفه smb_message_echoes. وتُوجَّه تعليقات Instagram وFacebook والإشارات والرسائل الخاصة، وتعليقات TikTok، إلى وجهة كل قناة موقّعة بسرها. لا ترسل YouTube وLinkedIn أحداث تعليقات، لذا يقرأ الوكيل التعليقات الجديدة عبر واجهاتهما البرمجية وفق جدول زمني. أجب على كل تسليم برمز 2xx فوراً، ودع عاملاً خلفياً يستدعي النموذج.
كيف يرد الوكيل؟
عبر واجهة برمجة الشبكة نفسها، باستخدام بيانات الاعتماد التي جلبها خادمك الخلفي. يُرسل رد WhatsApp بطلب POST إلى send_endpoint الخاصة بالرقم مع رمز وصول العميل، وتُرسل رسالة Instagram أو Facebook الخاصة إلى 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، حين يكون الوكيل منتجك ويجلب عملاؤك القنوات: يحتفظ خادمك الخلفي بالمفتاح، ويستقبل الأحداث، ويشغّل أي نموذج تختاره. أما خادم MCP على https://easycoexistence.com/api/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 |
كيف تدير الوكالات وكلاء لعدد من العملاء؟
على حساب واحد، مع وسم كل عميل. مرّر معرّف العميل بوصفه external_ref في كل جلسة ربط، واعرض اسم وكالتك في الصفحة المستضافة عبر partner_name، واسرد اتصالات عميل بعينه عبر GET /connections?external_ref= وGET /channels?external_ref=. تُحتسب كل وكالة بسعر من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، بينما تحتسب Meta رسوم محادثات WhatsApp على حساب WhatsApp Business الخاص بالعميل. ومع Coexistence يواصل موظفو العميل الرد من تطبيق WhatsApp Business إلى جانب الوكيل.
ما القواعد التي يجب على الوكيل التزام بها؟
قواعد الشبكات نفسها، التي ينبغي لكودك أن يتحقق منها قبل إرسال رد النموذج. تفرض المنصات هذه القواعد نيابةً عن عملائها، لأن إنفاذ Meta يقع على حساب العميل:
- WhatsApp: الردود الحرة مسموحة فقط خلال 24 ساعة من آخر رسالة للعميل؛ وبعد ذلك يُرسل قالب معتمد عبر API، لأن تطبيق WhatsApp Business لا يستطيع إرسال القوالب في Coexistence.
- WhatsApp: تحظر شروط Meta تقديم الذكاء الاصطناعي كوظيفة أساسية، وترى مرجعية Partner API أن ذلك يعني عدم تشغيل روبوتات ذكاء اصطناعي عامة الغرض، وتسمح بالضبط الدقيق (fine-tuning) على بيانات WhatsApp لاستخدام النشاط التجاري الحصري فقط.
- Instagram وFacebook: الرسائل الخاصة خلال 24 ساعة من آخر رسالة للشخص، ورد خاص واحد لكل تعليق خلال 7 أيام من كتابته.
- TikTok: الردود على التعليقات علنية، إذ لا تملك قناة TikTok رسائل خاصة.
- الحجم: 20 رسالة في الثانية لكل رقم Coexistence، وتحتاج قوالب التسويق إلى طريقة دفع في حساب WhatsApp Business الخاص بالعميل.
كيف يعرف الوكيل أن قناة توقفت عن العمل؟
من أحداث الحالة. يعني connection.disconnected أو channel.disconnected أن الردود تفشل حتى يعيد العميل الربط، فأوقف وكيل ذلك العميل، وأبلغه، وأرسل له رابط ربط جديداً. ويعني connection.token_missing أن الرقم يستقبل لكنه لا يستطيع الإرسال بعد. وعند وصول connection.connected أو channel.connected مرة أخرى، اجلب بيانات اعتماد جديدة واستأنف العمل. يُوقَّع كل حدث بالترويسة X-EC-Signature، وتُعاد محاولته لمدة 33 ساعة تقريباً.
الأخطاء الشائعة
- إرسال رد نصي حر على رسالة WhatsApp عمرها أكثر من 24 ساعة يتجاوز النافذة المغلقة. تحقق من وقت آخر رسالة واردة من العميل، وانتقل إلى قالب معتمد.
- تدريب نموذج مشترك على محادثات WhatsApp لعملائك. تسمح شروط Meta بالضبط الدقيق على بيانات WhatsApp Business Platform لاستخدام النشاط التجاري الحصري فقط، لا لتحسين نماذج أخرى أبداً.
- معاملة smb_message_echoes كرسائل عميل. هي ما أرسله موظفو النشاط من التطبيق، فامنح النموذج إياها بوصفها سياقاً، لا بوصفها رسائل يجب الرد عليها.
- الرد على ردود الحساب نفسه. تعود رسائل Instagram الخاصة التي يرسلها الحساب على هيئة echoes، وتعود ردود TikTok بوصفها أحداث تعليقات، فتخطَّ كل ما كتبه الحساب بنفسه، وإلا رد الوكيل على نفسه.
بسعر يتراوح من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع أول 3 أيام مجانية.
الأسئلة الشائعة
هل يمكنني استخدام نموذج الذكاء الاصطناعي الخاص بي؟
نعم. يستقبل خادمك الخلفي الرسائل، ويستدعي أي نموذج تختاره، ويرد عبر واجهة برمجة الشبكة باستخدام رمز وصول العميل. تنتقل رسائل رقم WhatsApp من Meta مباشرة إلى webhook الخاص بك، ولا تمر أبداً عبر easyCoexistence.
ماذا تعني سياسة Meta للذكاء الاصطناعي بالنسبة لوكيل WhatsApp؟
تحظر شروط Meta على مزودي الذكاء الاصطناعي استخدام منصة WhatsApp Business لتقديم تقنية الذكاء الاصطناعي كوظيفة أساسية، لا ثانوية أو مساندة، كما تحددها Meta. التزم بها نيابةً عن عملائك، إلى جانب نافذة الـ 24 ساعة والقوالب المعتمدة.
هل يستطيع الوكيل إرسال رسائل خاصة على TikTok أو YouTube أو LinkedIn؟
لا. يعمل الوكيل على هذه الشبكات في التعليقات: ردود TikTok علنية، وتُقرأ تعليقات YouTube وLinkedIn وتُرد عبر واجهاتهما البرمجية.
كم تكلف easyCoexistence لمنتج وكيل ذكاء اصطناعي؟
لكل اتصال، بالسعر نفسه على كل شبكة: بسعر يتراوح من US$ 9 إلى US$ 0.75 لكل اتصال شهرياً، ويقل السعر كلما أضفت اتصالات، مع أول 3 أيام مجانية. تحتسب Meta رسوم محادثات WhatsApp على حساب WhatsApp Business الخاص بكل عميل.
تابع القراءة
اربط قناتك الأولى في دقيقتين.
لا حاجة لانتظار مراجعات المنصات. اربط WhatsApp أو Instagram أو TikTok أو أي قناة أخرى، ثم اطلب من الذكاء الاصطناعي النشر أو الرد أو إعداد التقارير، وشاهده يعمل.
- 3 أيام مجانًا
- إلغاء في أي وقت
- واجهات API الرسمية فقط
- مراقبة على مدار الساعة 24/7
تم التحقق في