واجهة برمجة تطبيقات Wati
واجهة برمجة تطبيقات Wati: واجهة برمجة تطبيقات واحدة لـ WhatsApp وInstagram ووكيل الذكاء الاصطناعي الخاص بك.
راسل العملاء على WhatsApp وInstagram من منتجك الخاص، أو دع مساعد الذكاء الاصطناعي يقوم بذلك من خلال خادم Wati MCP.
- وكلاء الذكاء الاصطناعي (MCP)
- TikTok قريباً
- Messenger قريباً
آخر تحديث
- 16,000+شركة في أكثر من 190 دولة
- 4.6/5متوسط التقييم على G2
- رسميشريك أعمال Meta ومرخص من WhatsApp BSP
واجهة برمجة تطبيقات واحدة. WhatsApp وInstagram ومساعد الذكاء الاصطناعي الخاص بك.
الوصول إلى العملاء على التطبيقات التي يستخدمونها بالفعل. قم ببنائها في التعليمات البرمجية الخاصة بك، أو سلمها إلى وكيل ذكاء اصطناعي.
- قناتان مباشرتانWhatsApp وInstagram اليوم. TikTok وMessenger قريباً.
- برمجة أو بدون برمجةاستدعِ REST API من منتجك، أو اربط مساعد ذكاء اصطناعي عبر خادم MCP.
- فريقك يبقى على اطلاع دائمتظهر المحادثات في صندوق وارد فريق Wati، بحيث يمكن لأي شخص التدخل.
ما تغطيه واجهة برمجة تطبيقات Wati
قناتا مراسلات وخادم MCP لوكلاء الذكاء الاصطناعي متاحان الآن. TikTok وMessenger هما التاليان.
- مباشر
WhatsApp
أرسل قوالب معتمدة إلى عميل واحد أو 10,000 عميل، رد في الدردشة، ابدأ روبوتات المحادثة واحصل على الروابط التقنية (webhooks).
واجهة برمجة تطبيقات WhatsApp - مباشر
Instagram
الرد على التعليقات علناً أو سرا باستخدام REST API. الإجابة على الرسائل المباشرة من خلال خادم MCP.
واجهة برمجة تطبيقات Instagram - مباشر
وكلاء الذكاء الاصطناعي (MCP)
اربط مساعد ذكاء اصطناعي باستخدام OAuth. اطلب بلغة بسيطة إرسال القوالب، والرد على الدردشات وتحديث جهات الاتصال.
خادم MCP - قريباً
TikTok
محادثات TikTok في نفس واجهة برمجة تطبيقات Wati.
- قريباً
Messenger
محادثات Messenger في نفس واجهة برمجة تطبيقات Wati. يستطيع وكلاء الذكاء الاصطناعي بالفعل الرد بالنصوص من خلال خادم MCP.
اختر واجهة برمجة التطبيقات (API) المناسبة لعملك
- WhatsApp APIنظرة عامة: القوالب، والردود، وwebhooks، ومكالمتك الأولى.
- WhatsApp Messagingإرسال النصوص، والوسائط، والأزرار من الكود البرمجي الخاص بك.
- WhatsApp Broadcastإرسال قالب معتمد واحد إلى العديد من جهات الاتصال دفعة واحدة.
- WhatsApp Chatbot APIابدأ تشغيل روبوت محادثة Wati لجهة اتصال من نظامك.
- WhatsApp Webhooksاحصل على الرسائل الجديدة وحالة التسليم في الوقت الفعلي.
- MCP Serverاربط وكيل الذكاء الاصطناعي الخاص بك بـ Wati.
- Instagram APIالتعليقات عبر REST API، والرسائل المباشرة (DMs) من خلال MCP.
- WhatsApp Flows قريباًنماذج يملؤها العملاء داخل المحادثة.
- WhatsApp Calling قريباًالمكالمات الصوتيّة على WhatsApp.
- WhatsApp Groups API قريباًمجموعات WhatsApp تُدار من نظامك.
ما يعمل وأين يعمل
ما يمكنك القيام به على كل قناة من خلال واجهة برمجة تطبيقات Wati اليوم، مقارنة بالوثائق العامة.
| القدرة | Messenger | TikTok | ||
|---|---|---|---|---|
| بدء محادثة باستخدام قالب معتمد، لشخص واحد أو ما يصل إلى 10,000 شخص | REST API و MCP | – | قريباًيمكن لوكلاء الذكاء الاصطناعي الرد بالنصوص مسبقاً عبر MCP. | قريباً |
| الرد في محادثة مفتوحة | النصوص والوسائط والأزرار. REST API و MCP | MCPردود نصية عبر الرسائل المباشرة (DMs) | ||
| الرد على التعليقات، علناً أو سراََ | – | REST API و MCP | ||
| Webhooks للرسائل الجديدة وحالة التسليم | REST API | – | ||
| بدء تشغيل روبوت محادثة Wati لجهة اتصال | REST API، وخطط Pro و Business | – |
REST API: قم باستدعائها من الكود البرمجي الخاص بك باستخدام رمز API (API token). MCP: يقوم مساعد ذكاء اصطناعي بذلك نيابة عنك من خلال خادم Wati MCP. –: غير متوفرة في واجهة برمجة التطبيقات اليوم. القائمة الكاملة موجودة في مرجع واجهة برمجة التطبيقات.
ابدأ في ثلاث خطوات بسيطة.
- التسجيل
أنشئ حسابك
سجّل في Wati على صفحة تسجيل واجهة برمجة التطبيقات (API)، ثم اربط رقم WhatsApp أو حساب Instagram الخاص بك.
- احصل على مفتاحك
افتح وحدة تحكم المطور
أنشئ رمز API وامنحه الصلاحيات التي تحتاجها فقط. احتفظ به على الخادم الخاص بك.
- إرسال
أرسل طلبك الأول
استدعاء واحد يرسل قالباً معتمداً. تصل تحديثات التسليم والقراءة عبر الـ Webhook.
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/messageTemplates/send" \
-H "Authorization: Bearer $WATI_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"template_name": "order_update",
"broadcast_name": "my_first_call",
"recipients": [{ "phone_number": "14155552671",
"custom_params": [{ "name": "name", "value": "Maya" }] }]
}'استخدم اسم قالب وافقت عليه Meta في حسابك. المزيد من الأمثلة على صفحة WhatsApp API.
curl -X POST "https://live-mt-server.wati.io/api/ext/v3/comments/$COMMENT_ID/privateReply" \
-H "Authorization: Bearer $WATI_API_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"channel": "yourbrand", "userId": "17841400000000000", "userName": "maya",
"type": "text", "text": "Hi Maya, yes we do."
}'احصل على معرف التعليق وتفاصيل المعلق من قائمة تعليقات المنشور. المزيد على صفحة Instagram API.
آمن بشكل افتراضي. والحدود منشورة.
القوالب أولاً على WhatsApp
الردود الحرة تحتاج إلى نافذة خدمة عملاء مفتوحة لمدة 24 ساعة. خارجها، ابدأ بقالب وافقت عليه Meta.
لا توجد مفاتيح في أداة الذكاء الاصطناعي الخاصة بك
تسجيل الدخول لعملاء الذكاء الاصطناعي إلى خادم Wati MCP يتم عبر المتصفح. لست بحاجة للضغط أو لصق مفتاح API في الأداة.
فقط الوصول الذي تمنحه
كل رمز API يحمل النطاق الذي تحدده ويمكن أن يكون له تاريخ انتهاء صلاحية. يتم عرضه مرة واحدة، لذا احفظه على الخادم الخاص بك.
إرسال القوالب
يعتمد على خطتك. إذا تجاوزت السرعة المطلوبة، ستتلقى رمز الخطأ HTTP 429 مع ترويسة Retry-After.
حدود المعدل وتوافر الخطط بالتفصيل
| نقطة النهاية | Growth | Pro | Business |
|---|---|---|---|
/addContact, /getContacts | 10 / 10 ثوانٍ | 10 / 10 ثوانٍ | 10 / 10 ثوانٍ |
/getMessages | 10 / 10 ثوانٍ | 10 / 10 ثوانٍ | 10 / 10 ثوانٍ |
/sendTemplateMessage | 30 / 10 ثوانٍ | 60 / 10 ثوانٍ | 100 / 10 ثوانٍ |
/sendTemplateMessages | 30 / 10 ثوانٍ | 60 / 10 ثوانٍ | 100 / 10 ثوانٍ |
الحدود كما هي منشورة في الأخطاء وحدود المعدل. نقاط نهاية المراسلة الأساسية والقوالب وجهات الاتصال متوفرة في كل خطة. تعيين الفريق، وحالة الدردشة، وروبوتات المحادثة، والشرائح المخصصة تتطلب خطة Pro أو Business. توافر نقاط النهاية حسب الخطة. للحصول على حدود أعلى، تحدث مع Wati بخصوص حالة استخدامك.
الأسئلة المتكررة من المستخدمين
مرجع واجهة برمجة التطبيقات الكامل عام ومتاح للجميع. قراءة المستندات
ما هي واجهة برمجة تطبيقات Wati؟
تتيح لك واجهة برمجة تطبيقات Wati إرسال واستقبال رسائل العملاء من خلال منتجك عبر Wati. وهي تغطي اليوم WhatsApp وInstagram، بالإضافة إلى خادم MCP لتمكين مساعد الذكاء الاصطناعي من أداء المهام ذاتها عبر الدردشة. ويمكن لفريقك متابعة كل محادثة من خلال صندوق الوارد لفريق Wati.
ما هي القنوات التي تدعمها واجهة برمجة تطبيقات Wati؟
WhatsApp وInstagram. على WhatsApp يمكنك إرسال قوالب معتمدة، والرد في الدردشة، وبدء تشغيل روبوتات الدردشة، واستلام إشعارات الـ Webhooks. أما على Instagram فتغطي واجهة برمجة تطبيقات REST التعليقات: عرض المنشورات والتعليقات، والرد علناً، وإرسال رد خاص. وتعمل رسائل Instagram المباشرة من خلال خادم Wati MCP.
ستتوفر قنوات TikTok وMessenger قريباً.
هل يتم دعم TikTok أو Messenger؟
ليس عبر واجهة برمجة التطبيقات بعد. كلاهما قادم قريباً. يمكن لوكيل ذكاء اصطناعي متصل بخادم Wati MCP الرد على محادثات Messenger بالنص بالفعل، وذلك بعد تسجيل الدخول باستخدام حساب Wati.
هل أُحتاج إلى كتابة أكواد برمجية؟
لا. قم بتوصيل مساعد ذكاء اصطناعي يدعم بروتوكول MCP عن بُعد، وسجل الدخول باستخدام OAuth واطلب ما تريد بلغة بسيطة، مثل عرض قوالب الرسائل الخاصة بك أو الرد على محادثة.
إذا كنت تفضل استخدام الأكواد البرمجية، تستخدم واجهة برمجة تطبيقات REST عنوان URL أساسياً واحداً ورمز توثيق (Bearer token)، ويمكن لأدوات بناء تطبيقات الذكاء الاصطناعي كتابة هذه الاستدعاءات نيابةً عنك.
أين أجد المستندات؟
المرجع الكامل متاح للعامة على docs.wati.io: ويشمل مرجع واجهة برمجة التطبيقات، ودليل خادم MCP، وحدود الاستخدام (Rate limits)، وتوفر نقاط النهاية بحسب الباقة. ويمكن لأدوات البرمجة المعتمدة على الذكاء الاصطناعي قراءة الفهرس بالكامل عبر docs.wati.io/llms.txt.
كيف أحصل على مفتاح واجهة برمجة التطبيقات (API key)؟
قم بالتسجيل في live.wati.io/start/api، ثم افتح وحدة تحكم المطورين في Wati وقم بإنشاء رمز توثيق لواجهة برمجة التطبيقات بالصلاحيات التي تحتاجها فقط. يُعرض رمز التوثيق مرة واحدة فقط، لذا احرص على تخزينه على الخادم الخاص بك وليس في المتصفح أو تطبيق الهاتف المحمول مطلقاً.
ما الفرق بين هذه الصفحة وصفحة واجهة برمجة تطبيقات WhatsApp؟
هذه الصفحة هي نظرة عامة على جميع واجهات برمجة تطبيقات Wati: القنوات، وما يعمل في كل مكان، وكيفية البدء. أما صفحة واجهة برمجة تطبيقات WhatsApp فتتعمق بشكل أكبر في WhatsApp، وتستعرض كل مجموعة من نقاط النهاية، وأمثلة على الأكواد البرمجية بلغات متعددة، والحدود الكاملة للاستخدام.
ما هي حدود معدل طلبات واجهة برمجة التطبيقات (API rate limits)؟
تقتصر مكالمات جهات الاتصال وسجل الرسائل على 10 طلبات لكل 10 ثوانٍ في جميع الباقات. بينما يقتصر إرسال القوالب على 30 أو 60 أو 100 طلب لكل 10 ثوانٍ في باقات النمو (Growth) والمحترفين (Pro) والأعمال (Business) على التوالي. عندما تتجاوز الحد المسموح به، ستتلقى استجابة HTTP 429 مع رأس Retry-After. للحصول على حدود أعلى، يرجى الاتصال بفريق Wati.
ابنِ مشاريعك على WhatsApp وInstagram اليوم.
ابدأ مجاناً وقم بإجراء مكالمتك الأولى، أو أخبرنا بما ترغب في بنائه.