Composio + واتساب
واتساب مستخدميكم الشخصي، داخل وكيل مبني على Composio
يعطي Composio الوكيل أكثر من 1,500 أداة عبر جلسة واحدة. ويضيف Circles إليها واتساب الشخص نفسه، كمجموعة أدوات Custom MCP: المحادثات التي يفتحها، جاهزة للقراءة، وللكتابة حيث يسمح.
لإعطاء وكيل Composio واتساب شخصيا: أنشئوا مجموعة أدوات Custom MCP بالعنوان https://app.usecircles.app/api/mcp والترويسة Authorization: Bearer {{generic_api_key}}، ويتصل كل مستخدم برمز الوصول الخاص به من Circles. بعدها يقرأ الوكيل المحادثات التي فتحها ذلك المستخدم في Circles، وCircles مجاني لـ2 محادثات لمدة تصل إلى 3 أشهر، أو $14.90 شهريا في Plus، أو $29.90 شهريا في Pro لكل رقم، مع 14 يوما من Pro مجانا، بتاريخ نوفمبر 2026.
آخر تحديث
مجموعة أدوات واتساب في Composio، أم Circles؟
تعمل مجموعة أدوات واتساب الخاصة بـComposio عبر WhatsApp Business API، وتقول صفحتها إنها لا تدعم الحسابات الشخصية (حتى نوفمبر 2026). وهي الخيار الصحيح لرقم أعمال: القوالب، ومراسلة العملاء على نطاق واسع، والواجهة الرسمية. وCircles مخصص لرقم الشخص نفسه: المجموعات ومحادثات العائلة والرسائل الصوتية على الهاتف الذي يستخدمه، تصل إلى وكيله محادثة بعد محادثة.
أربع خطوات: اثنتان لكل مستخدم، واثنتان لكم
يربط كل مستخدم واتسابه في Circles
يبدأ المستخدم تجربته في usecircles.app ويربط رقمه كجهاز مرتبط: رمز يكتبه في هاتفه، أو QR على حاسوبه. ويختار المحادثات التي يمكن للوكلاء قراءتها، وتلك التي يمكنهم الإرسال فيها.
ينشئ رمز وصول
في صفحة Agents في Circles، يختار New token، ثم Other، ويبقي MCP، ويحدد ما يسمح به. يبدأ رمز الوصول بـ
circ_ويُعرض مرة واحدة.تضيفون Circles كمجموعة أدوات Custom MCP، مرة واحدة
في مشروعكم على Composio، أنشئوا مجموعة أدوات بعنوان Circles والترويسة
Authorization: Bearer {{generic_api_key}}، مشتركة معuser_id="all". يضع Composio رمز وصول كل مستخدم عندما يتصل بـCircles.يتصل كل مستخدم، ويسأل وكيلكم
يطلب Composio من كل مستخدم رمز وصوله عبر رابط الاتصال، وتتزامن الأدوات عند أول اتصال. أضيفوا معرّف مجموعة الأدوات (slug) إلى الجلسة، ويجد وكيلكم الأدوات عبر
COMPOSIO_SEARCH_TOOLS.
الكود
بلغة Python مع SDK الخاص بـComposio. وفي TypeScript الاستدعاءات نفسها تحت composio.experimental.customToolkits.
اكتبوا mcp_url مطابقا للعنوان تماما، من دون أي مفتاح فيه. يثبّت Composio العنوان وطريقة المصادقة وuser_id عند الإنشاء، فلتغيير أحدها احذفوا مجموعة الأدوات وأنشئوها من جديد. وعندما يضيف Circles أداة، زامنوا مجموعة الأدوات مرة أخرى.
from composio import Composio
composio = Composio() # reads COMPOSIO_API_KEY
# Once per project: Circles as a shared Custom MCP toolkit
toolkit = composio.experimental.custom_toolkits.create(
name="Circles (personal WhatsApp)",
mcp_url="https://app.usecircles.app/api/mcp",
auth_schemes=[{
"mode": "API_KEY",
"headers": {"Authorization": "Bearer {{generic_api_key}}"},
}],
user_id="all",
)
print(toolkit.slug) # keep it: CUSTOM_CIRCLES...
# Per user: a session with Circles beside your other toolkits
session = composio.sessions.create(user_id="user_123", toolkits=[toolkit.slug])
tools = session.tools()تسجيل الدخول بالعنوان بدلا من رمز الوصول
يقبل Custom MCP في Composio أيضا OAuth مع التسجيل الديناميكي للعميل: "mode": "DCR_OAUTH" مع "discovery_url": "https://app.usecircles.app/.well-known/oauth-authorization-server". يسجّل Circles العملاء بهذه الطريقة، ويوافق كل شخص في صفحة Circles نفسها ويختار إن كان الوكيل يستطيع الإرسال. لم نجرّب هذا الربط بعد، فاستخدموا رمز وصول إلى أن نجربه.
ما يمكن لمستخدميكم أن يسألوه
أمثلة متخيلة، بأشكال حقيقية.
"ماذا فاتني في مجموعة لجنة العمارة؟"
catch_up على مجموعة واحدة منذ وقت معين، والرسائل الصوتية نصوص جاهزة.
"أضف مواعيد مجموعة المدرسة إلى تقويمي"
يقرأ Circles المجموعة، وتكتب مجموعة أدوات Google Calendar المواعيد.
"جد الفاتورة التي أرسلها المحاسب واحفظها في Drive"
documents يجدها، وget_media يجلبها، ومجموعة أدوات أخرى تحفظها.
"أخبر مجموعة الجري أنني لن أحضر يوم الخميس"
فقط إذا كان رمز الوصول يسمح بالإرسال وكانت المجموعة مفتوحة للإرسال.
ما يستطيعه وكيل Composio هنا وما لا يستطيعه
ما يستطيعه الوكيل:
- أن يرى المحادثات التي فتحتموها، وأيها تحرّك منذ وقت معيّن، بالأعداد ومن دون نص (
allowed_chats،activity). - أن يلخّص ما فاتكم ويبحث، في محادثة واحدة أو في جميعها، مع أسماء المرسلين والرسائل الصوتية مفرّغة نصيا مسبقا (
catch_up،search). - أن يرى من تتحدثون معهم ومن في المجموعة، بالأسماء التي حفظتموها، مع أرقامهم حيثما يُظهرها واتساب (
people،group_members). - أن يعرض المستندات المرسلة في محادثاتكم ويفتح صورة أو ملف PDF أو أي ملف، حتى 50 MB (
documents،get_media). الوكيل يفتح الملف ويقرؤه بنفسه. - أن يرسل رسالة أو ملفا في المحادثات المفتوحة للإرسال، وهي كل المحادثات في رقم مرتبط حديثا (
send).
ما لا يستطيعه الوكيل:
- أن يرى محادثة مخفية. فهي لا تظهر في القائمة، ولا يمكن البحث فيها، ولا يُذكر اسمها أبدا، حتى في رسالة رفض.
- أن يرسل في محادثة جعلتموها للقراءة فقط، أو يصل إلى محادثة أخفيتموها، أو أن تُعاد محاولة إرسال تلقائيا.
- أن يردّ مع اقتباس أو يتفاعل برمز تعبيري. هذا موجود فقط في HTTP API.
- أن يحتفظ بالوصول بعد أن تفصلوه. الفصل ينهي الوصول فورا، وكل طلب قدّمه يبقى في سجل النشاط لديكم.
تغيير الصلاحيات، الباقات والدعوات
تغيير ما يمكن للوكلاء فعله. كل وكيل تربطونه يقرأ ويكتب افتراضياً في المحادثات التي تبقى مفتوحة، منذ البداية. للتقليل من ذلك، اجعلوا المحادثة للقراءة فقط أو أخفوها في صفحة المحادثات في تطبيق Circles، أو اكتبوا إلى خدمة عملاء Circles، الخدمة الافتراضية على رقم Circles: wa.me/972553091640. اكتبوا إليها من واتساب الخاص بكم. يمكن للوكيل أن يصيغ لكم الرسالة. لا يمكنه فتح تلك المحادثة أو القراءة فيها أو الإرسال فيها، لأنها تحتوي على روابط تسجيل الدخول الخاصة بكم.
الباقات. كل باقة تقرأ وتكتب وترى كل السجل المتاح: 2 محادثات في Free، لمدة تصل إلى 3 أشهر من الربط، و10 في Plus، وكل المحادثات التي تسمحون بها في Pro. كل تسجيل يبدأ بـ 14 يوماً من Pro، من دون بطاقة. لا يُدفع أي مبلغ من دون أن تختاروا باقة. الباقات والأسعار.
الدعوات. الصديق الذي تدعونه يحصل على 28 يوماً من Pro بدلاً من 14، من يوم ربطه لواتساب. وتحصلون أنتم على 14 يوماً عندما يقرأ وكيله لأول مرة عبر Circles، لما يصل إلى 10 أصدقاء في الأسبوع. اطلبوا رابط الدعوة من خدمة عملاء Circles.
أسئلة وأجوبة
هل لدى Composio مجموعة أدوات لواتساب؟
نعم، لحسابات WhatsApp Business عبر Business API، وتقول صفحتها إن الحسابات الشخصية غير مدعومة (حتى نوفمبر 2026). يضيف Circles رقما شخصيا إلى Composio كمجموعة أدوات Custom MCP.
هل يستطيع كل مستخدم ربط واتسابه الخاص؟
نعم. شاركوا مجموعة أدوات Circles واحدة مع user_id="all"؛ يتصل كل مستخدم برمز وصوله من Circles، ولا يرى وكيله إلا المحادثات التي فتحها في Circles.
هل Circles موجود في كتالوج Composio؟
ليس بعد، حتى نوفمبر 2026. أضيفوه كمجموعة أدوات Custom MCP؛ وتقول وثائق Composio إن مجموعات الأدوات المشتركة تعمل في كل باقاتها.
هل يمكن تسجيل الدخول بـOAuth بدلا من رمز الوصول؟
يدعم Composio بروتوكول OAuth مع التسجيل الديناميكي، وكذلك Circles، لكننا لم نجربهما معا بعد. استخدموا رمز وصول حتى ذلك الحين.
هل يستطيع الوكيل إرسال رسائل واتساب؟
فقط إذا كان رمز وصول المستخدم يسمح بالإرسال، وفقط في المحادثات المفتوحة للإرسال (كل المحادثات افتراضيا). ولا يُعاد أي إرسال تلقائيا.
كم التكلفة؟
يُسعَّر Circles لكل رقم واتساب: مجاني لـ2 محادثات لمدة تصل إلى 3 أشهر، أو $14.90 شهريا في Plus، أو $29.90 شهريا في Pro، مع 14 يوما من Pro مجانا. باقة Composio منفصلة.
بريدكم الإلكتروني متصل بالذكاء الاصطناعي. الآن اربطوا واتساب.
14 يوماً لتجربة كل شيء، مجاناً ومن دون بطاقة ائتمان. بعدها تختارون الباقة حسب ما استخدمتموه فعلاً.