🚀 Wati AI هنا – طبقة الذكاء التحاوري للشركات الحديثة استكشاف🚀 Wati AI هنا →

واجهة برمجة تطبيقات Wati

واجهة برمجة تطبيقات Wati: واجهة برمجة تطبيقات واحدة لـ WhatsApp وInstagram ووكيل الذكاء الاصطناعي الخاص بك.

راسل العملاء على WhatsApp وInstagram من منتجك الخاص، أو دع مساعد الذكاء الاصطناعي يقوم بذلك من خلال خادم Wati MCP.

القنوات
  • WhatsApp
  • Instagram
  • وكلاء الذكاء الاصطناعي (MCP)
  • TikTok قريباً
  • Messenger قريباً

آخر تحديث

  • 16,000+شركة في أكثر من 190 دولة
  • 4.6/5متوسط التقييم على G2
  • رسميشريك أعمال Meta ومرخص من WhatsApp BSP
G2 Leader, ChatbotsG2 Leader Mid-Market, ChatbotsG2 Momentum Leader, ChatbotsG2 Most Implementable, WhatsApp MarketingISO 27001GDPR

واجهة برمجة تطبيقات واحدة. 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.

التغطية

ما يعمل وأين يعمل

ما يمكنك القيام به على كل قناة من خلال واجهة برمجة تطبيقات Wati اليوم، مقارنة بالوثائق العامة.

إمكانيات واجهة برمجة تطبيقات Wati حسب القناة
القدرةWhatsAppInstagramMessengerTikTok
بدء محادثة باستخدام قالب معتمد، لشخص واحد أو ما يصل إلى 10,000 شخصREST API و MCP–قريباًيمكن لوكلاء الذكاء الاصطناعي الرد بالنصوص مسبقاً عبر MCP.قريباً
الرد في محادثة مفتوحةالنصوص والوسائط والأزرار. REST API و MCPMCPردود نصية عبر الرسائل المباشرة (DMs)
الرد على التعليقات، علناً أو سراََ–REST API و MCP
Webhooks للرسائل الجديدة وحالة التسليمREST API–
بدء تشغيل روبوت محادثة Wati لجهة اتصالREST API، وخطط Pro و Business–

REST API: قم باستدعائها من الكود البرمجي الخاص بك باستخدام رمز API (API token). MCP: يقوم مساعد ذكاء اصطناعي بذلك نيابة عنك من خلال خادم Wati MCP. –: غير متوفرة في واجهة برمجة التطبيقات اليوم. القائمة الكاملة موجودة في مرجع واجهة برمجة التطبيقات.

البدء

ابدأ في ثلاث خطوات بسيطة.

  1. التسجيل

    أنشئ حسابك

    سجّل في Wati على صفحة تسجيل واجهة برمجة التطبيقات (API)، ثم اربط رقم WhatsApp أو حساب Instagram الخاص بك.

  2. احصل على مفتاحك

    افتح وحدة تحكم المطور

    أنشئ رمز API وامنحه الصلاحيات التي تحتاجها فقط. احتفظ به على الخادم الخاص بك.

  3. إرسال

    أرسل طلبك الأول

    استدعاء واحد يرسل قالباً معتمداً. تصل تحديثات التسليم والقراءة عبر الـ Webhook.

POST/api/ext/v3/messageTemplates/send
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.

الأمان والحدود

آمن بشكل افتراضي. والحدود منشورة.

24 ساعة نافذة

القوالب أولاً على WhatsApp

الردود الحرة تحتاج إلى نافذة خدمة عملاء مفتوحة لمدة 24 ساعة. خارجها، ابدأ بقالب وافقت عليه Meta.

OAuth لـ MCP

لا توجد مفاتيح في أداة الذكاء الاصطناعي الخاصة بك

تسجيل الدخول لعملاء الذكاء الاصطناعي إلى خادم Wati MCP يتم عبر المتصفح. لست بحاجة للضغط أو لصق مفتاح API في الأداة.

محدد الرموز

فقط الوصول الذي تمنحه

كل رمز API يحمل النطاق الذي تحدده ويمكن أن يكون له تاريخ انتهاء صلاحية. يتم عرضه مرة واحدة، لذا احفظه على الخادم الخاص بك.

30 إلى 100 لكل 10 ثوانٍ

إرسال القوالب

يعتمد على خطتك. إذا تجاوزت السرعة المطلوبة، ستتلقى رمز الخطأ HTTP 429 مع ترويسة Retry-After.

حدود المعدل وتوافر الخطط بالتفصيل
حدود المعدل الموثقة حسب الخطة
نقطة النهايةGrowthProBusiness
/addContact, /getContacts10 / 10 ثوانٍ10 / 10 ثوانٍ10 / 10 ثوانٍ
/getMessages10 / 10 ثوانٍ10 / 10 ثوانٍ10 / 10 ثوانٍ
/sendTemplateMessage30 / 10 ثوانٍ60 / 10 ثوانٍ100 / 10 ثوانٍ
/sendTemplateMessages30 / 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 اليوم.

ابدأ مجاناً وقم بإجراء مكالمتك الأولى، أو أخبرنا بما ترغب في بنائه.