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

WhatsApp API

واجهة برمجة تطبيقات مطوري WhatsApp، مُصممة داخل منتجك.

أرسل القوالب، وقم بالرد في المحادثة، وتلقَّ الإشعارات عبر webhook، وقم بتحويل المحادثة إلى فريقك. عنوان أساسي واحد، ورمز مصادقة واحد.

آخر تحديث

  • 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.

ابدأها بقالب، واصلها في المحادثة، تابعها عبر webhook وأنهِها في صندوق الوارد لفريقك.

  • تبدأ بقالبقالب معتمد يفتح المحادثة، لعميل واحد أو 10,000 عميل.
  • تستمر في المحادثةالنصوص، والوسائط، والأزرار بمجرد أن يرد العميل.
  • تنتهي مع فريقكتخبر الـ webhooks الكود الخاص بك. ويخبر صندوق الوارد لفريقك أفراد فريقك.
المنتج

أرسل. رد. استقبل. سلِّم.

البثوث

رسائل شخصية، مُرسلة على نطاق واسع.

اختر قالباً معتمداً ومرره إلى ما يصل إلى 10,000 مستلم. يحصل كل شخص على متغيّراته الخاصة، ويصل كل رد برقم.

المراسلة

رد بأكثر من مجرد نص.

داخل نافذة الـ 24 ساعة، أرسل نصوصاً، وصوراً، وملفات، وأزرار رد، ومحددات قائمة، مع مؤشر كتابة أثناء عملك.

تحديثات الطلبات والتنبيهات

التحديث المناسب، في لحظة وقوعه.

يرسل متجرك، أو نظام الحجز، أو نظام الفوترة قالباً معتمداً عندما يتغير شيء ما. ينقر العملاء على زر أو يردون.

الرد الآلي والروبوتات المحادثة

الكود الخاص بك يجيب.

يجلب خطاف الويب للرسائل كل رسالة جديدة إلى خادمك. رد بنقاط نهاية الإرسال، أو ابدأ بوت دردشة Wati في باقتي Pro وBusiness.

خطافات الويب (Webhooks)

كل رد، في لحظة وصوله.

تدفع خطافات الويب الرسائل الجديدة، وإيصالات القراءة، والنقرات، وحالات الفشل إلى عنوان URL الخاص بك. بدون أي استعلام دوري (polling).

صندوق الوارد للفريق

الكود يبدأه. والشر بشر ينهونه.

تصل الردود إلى صندوق الوارد الخاص بفريق Wati. قم بتعيين موظف، وضبط الحالة، وإضافة العلامات عبر واجهة برمجة التطبيقات (API)، لكي يتولى الشخص المناسب الأمر.

جهات الاتصال والشرائح

نظام إدارة علاقات العملاء (CRM) الخاص بك، من عكسه في Wati.

قم بإنشاء وتحديث جهات الاتصال بسمات مخصصة، ثم عاين الشريحة قبل إرسال الرسالة إليها.

Instagramتعليقات ورسائل إنستغرام المباشرة

قم بإنشاء أتمتة إنستغرام أيضاً.

قائمة التعليقات على منشوراتك، الرد علناً أو إرسال رد خاص.

ابدأ الآن

جاهز في ثلاث خطوات.

  1. الاتصال

    ربط رقمك

    اربط رقم واتساب الخاص بك من خلال ميزة التسجيل المدمج من ميتا داخل Wati.

  2. المصادقة

    الحصول على رمز

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

  3. الإرسال

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

    أرسل قوالب معتمدة بطلب واحد. ثم أضف خطاف الويب (Webhook) لتتبع التسليم.

طلبك الأول، مشروحاً

إليك ما يتضمنه الطلب الواحد، وأين يظهر كل جزء في الرسالة.

  1. من

    رقم واتساب الخاص بالعميل، متبوعاً برمز الدولة.

    phone_number14155552671
  2. أي رسالة

    اسم القالب الذي وافقت عليه ميتا في حسابك.

    template_nameorder_update
  3. ما الذي يجب تعبئته

    القيم الخاصة بالفراغات الموجودة في القالب، قيمة واحدة لكل شخص.

    custom_paramsname = Mayaorder_id = 10482
  4. مفتاحك الخاص

    رمز API الخاص بك، يتم إرساله مع كل طلب. احتفظ به على خادمك.

    Authorization: Bearer <token>
  5. ما تتلقاه بالمقابل

    يعني الرمز 200 أن Wati قبلت الرسالة، مع معرف البث broadcast_id. يتم استلام حالتي التسليم والقراءة لاحقاً عبر خطاف الويب.

    200broadcast_id

نص الرسالة و order_update هما مجرد أمثلة. القالب المعتمد الخاص بك هو ما يحدد الصياغة.

رمز جاهز للنسخإخفاء الرمز
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": "order_update_api",
    "recipients": [
      {
        "phone_number": "14155552671",
        "custom_params": [
          { "name": "name", "value": "Maya" },
          { "name": "order_id", "value": "10482" }
        ]
      }
    ]
  }'
200 مثال الاستجابةشكل من مثال التوثيق
{
  "success": true,
  "broadcast_id": "broadcast_123456",
  "recipients": [
    {
      "local_message_id": "local-msg-123",
      "phone_number": "14155552671",
      "errors": []
    }
  ]
}
الميزات المدمجة

ما يتولاه Wati نيابةً عنك لتوفير عناء القيام به.

تسجيل الأرقام

الاتصال من خلال ميزة التسجيل المدمج من Meta. يتم تسجيل حساب WhatsApp Business الخاص بشركتك.

حالة القوالب

تصل التغييرات الخاصة بالموافقة والجودة والفئات في صورة إشعارات ويب (Webhooks)، لتعلم بذلك قبل فشل عملية الإرسال.

إعادة محاولات إشعارات الويب

تصل إلى 144 محاولة إعادة، كل 10 دقائق. وإذا استمر نقطة النهاية (Endpoint) الخاصة بك في الفشل، يقوم Wati بإرسال بريد إلكتروني إليك.

حدود معدل الاستخدام ووضع قائمة الانتظار

عند تجاوز السرعة المطلوبة، ستحصل على الرمز 429 مع ترويسة Retry-After. تنتظر الرسائل المقبولة في طابور الانتظار.

التحويل البشري

صندوق بريد فريق مشترك للمحادثات التي ينبغي ألا يجيب عليها الكود البرمجي بمفرده.

رموز API محددة النطاق

يدعم الإصدار v3 الرموز ذات النطاق المخصص، بحيث يحصل كل تكامل على الصلاحيات التي يحتاجها فقط.

الإرسال المجدول

قم جدولة إرسال قالب لوقت لاحق باتصال واحد. وسي يقوم Wati بإرساله في الموعد المحدد.

تقدير التكلفة أولاً

احسب التكلفة التقديرية للبث قبل إرسال أي شيء.

من الداخل

نقاط النهاية (Endpoints)، مقسمة حسب القدرة.

القوالب

ابدأ المحادثات باستخدام القوالب الموافَق عليها، فوراً أو حسب جدول زمني.

المستندات ←
GET/messageTemplatesPOST/messageTemplates/sendPOST/messageTemplates/schedule

البث

قراءة نتائج الحملات وحالة كل مستلم، وتقدير التكلفة أولاً.

المستندات ←
GET/broadcastsGET/broadcasts/{broadcast_id}/recipientsPOST/broadcasts/estimate-cost

المراسلة

الرد بالنصوص، أو الوسائط، أو الأزرار خلال نافذة الـ 24 ساعة.

المستندات ←
POST/conversations/messages/textPOST/conversations/messages/fileViaUrlPOST/conversations/messages/interactivePOST/conversations/typingIndicator

روبوتات المحادثة (Chatbots) Pro+

اعرض قائمة روبوتات محادثة Wati الخاصة بك وابدأ تشغيل أحدها لجهة اتصال.

المستندات ←
GET/chatbotsPOST/chatbots/start

إشعارات الويب (Webhooks)

إدارة الاشتراكات وعرض قائمة أنواع الأحداث التي يمكنك تلقيها.

المستندات ←
GET/webhooksGET/webhooks/event-typesPUT/webhooks/{id}

جهات الاتصال وشرائح الجمهور

مزامنة جهات الاتصال والسمات من نظام إدارة علاقات العملاء (CRM) الخاص بك، ثم استهداف الشرائح.

المستندات ←
POST/contactsPUT/contactsPOST/segments/evaluate

صندوق بريد الفريق

تعيين موظف، تغيير الحالة، إضافة أو إزالة العلامات (Tags).

المستندات ←
PUT/conversations/{target}/operatorPUT/conversations/{target}/statusPOST/conversations/{target_conv}/tags

Instagram

عرض المنشورات والتعليقات، الرد علناً أو خاصاً، والتحقق من الأذونات.

المستندات ←
GET/posts/{post_id}/commentsPOST/comments/{comment_id}/repliesPOST/comments/{comment_id}/privateReplyGET/channels/{channel}/permissions

المسارات نسبية لـ https://live-mt-server.wati.io/api/ext/v3. يتطلب إنشاء إشعار ويب استخدام المسار القديم POST /{tenantId}/api/v2/webhookEndpoints.

بالنسبة لوكلاء الذكاء الاصطناعي، يغطي خادم Wati MCP نفس إجراءات WhatsApp، ويمكنه الرد على رسائل Instagram المباشرة ومحادثات Messenger بالنصوص.

عرض جميع أنواع الأحداث الـ 19 لإشعارات ويب WhatsApp

الرسائل

  • message
  • newContactMessageReceived
  • sessionMessageSent_v2
  • templateMessageSent_v2

حالة التسليم

  • sentMessageDELIVERED_v2
  • sentMessageREAD_v2
  • sentMessageREPLIED_v2
  • templateMessageFailed

القوالب والحساب

  • templateReviewed
  • templateQualityUpdated
  • templateCategoryUpdated
  • wabaStatusReviewUpdate
  • PhoneNumberQualityUpdatedEvent
  • accountUpdated
  • accountDeleted
  • phoneNumberDeleted

التفاعل والمكالمات

  • chatbotTriggered
  • ctaUrlClicked
  • call.status

إصدارات BSUID لعدة أحداث متاحة أيضاً. مستندات إشعارات الويب

الحدود والخطط

حدود واضحة ومُعلنة.

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

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

طلبات إرسال القوالب، بناءً على خطتك (Growth أو Pro أو Business).

10,000 مستلم

لكل طلب إرسال عبر v3

قالب واحد، يصل إلى 10,000 شخص، لكل منهم متغراته الخاصة.

24 ساعة نافذة

الردود الحرة

تتطلب النصوص والوسائط والأزرار نافذة خدمة عملاء مفتوحة. خارجها، أرسل قالبًا.

429 Retry-After

عند تجاوز السرعة المسموحة

يخبرك Wati بالمدة التي يتعين عليك انتظارها. تتم معالجة الرسائل المقبولة في قائمة انتظار.

تفاصيل حدود معدل الاستخدام وتوفر الخطط
حدود معدل الاستخدام الموثقة حسب الخطة
نقطة النهاية (Endpoint)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 ثوانٍ

الحدود كما تم نشرها على الأخطاء وحدود معدل الاستخدام (Errors & Rate Limits)، مصنفة حسب اسم نقطة النهاية. يقبل طلب الإرسال الجماعي في الإصدار v1 ما يصل إلى 1,000 جهة اتصال. تتوفر نقاط نهاية المراسلة الأساسية والقوالب وجهات الاتصال في جميع الخطط. بينما يتطلب تعيين الفريق، وحالة الدردشة، وروبوتات المحادثة، والشرائح المخصصة خطة Pro أو Business. يتطلب تحديث السمات لجهات اتصال متعددة دفعة واحدة خطة Business. توفر نقاط النهاية حسب الخطة. للحصول على حدود أعلى، تحدث إلى فريق Wati بشأن حالة الاستخدام الخاصة بك.

الأسئلة الشائعة

الأسئلة المتكررة

مرجع واجهة برمجة التطبيقات الكامل متاح للعامة. اقرأ المستندات

هل تمتلك Wati واجهة برمجة تطبيقات لـ WhatsApp؟

نعم. تغطي واجهة برمجة تطبيقات Wati قوالب WhatsApp، وعمليات البث، والرسائل، وجهات الاتصال، والشرائح، وإجراءات صندوق البريد الوارد للفريق، وخطافات الويب. يجب أن تستخدم عمليات التكامل الجديدة الإصدار v3 على https://live-mt-server.wati.io/api/ext/v3 مع رمز مصادقة (bearer token). المرجع الكامل متاح للعامة على docs.wati.io.

هل يجب علي استخدام الإصدار v3 أم الإصدار v1 القديم؟

استخدم الإصدار v3 للأعمال الجديدة. تتميز نقاط نهاية الإصدار v3 بطلبات واستجابات محددة الأنواع، وأخطاء منظمة، ورموز مصادقة واجهة برمجة تطبيقات محددة النطاق. لا تزال نقاط نهاية الإصدار v1 القديمة، الواقعة ضمن /{tenantId}/api/v1، مدعومة.

هل تعمل واجهة برمجة تطبيقات Wati مع Instagram أو Messenger؟

يُعد WhatsApp جوهر واجهة برمجة التطبيقات. بالنسبة لـ Instagram، تغطي واجهة برمجة التطبيقات التعليقات: سرد المنشورات والتعليقات، والرد علناً، وإرسال رد خاص، والتحقق من الأذونات. من خلال خادم Wati MCP، يمكن لوكيل الذكاء الاصطناعي أيضاً الرد على رسائل Instagram المباشرة ودردشات Messenger باستخدام النصوص.

هل أحتاج إلى معرفة كيفية البرمجة؟

أقل مما اعتصتد في السابق. يمكن لمنشئي تطبيقات الذكاء الاصطناعي كتابة استدعاءات واجهة برمجة التطبيقات بناءً على تعليمات باللغة العادية، وتُظهر الأمثلة الموجودة في هذه الصفحة كل استدعاء.

لا تزال بحاجة إلى رقم WhatsApp متصل بـ Wati، ورمز مصادقة لواجهة برمجة التطبيقات، وقالب معتمد من Meta قبل أن تتمكن من بدء محادثة. إذا كتب أداة ذكاء اصطناعي الكود، فتأكد من بقاء الرمز المميز الخاص بك على الخادم.

ما هي حدود معدل طلبات واجهة برمجة التطبيقات؟

تقتصر مكالمات جهات الاتصال وسجل الرسائل على 10 طلبات لكل 10 ثوانٍ في كل خطة. وتقتصر إرسالات القوالب على 30 أو 60 أو 100 طلب لكل 10 ثوانٍ في خطط النمو (Growth) والاحترافية (Pro) والأعمال (Business). عندما تتجاوز الحد، ستحصل على رمز الاستجابة HTTP 429 مع رأس Retry-After. للحصول على حدود أعلى، اتصل بـ Wati.

هل يمكنني مراسلة العميل في أي وقت؟

على WhatsApp، تتطلب النصوص حرة الشكل، والوسائط، والرسائل التفاعلية نافذة خدمة عملاء مفتوحة مدتها 24 ساعة. خارج تلك النافذة، ابدأ المحادثة باستخدام قالب وافقت عليه Meta.

ما الفرق بين تطبيق WhatsApp Business وواجهة برمجة التطبيقات؟

تطبيق الأعمال مخصص للدردشات اليدوية على الهاتف، مع ما يصل إلى 5 أجهزة مرتبطة وقوائم بث تقتصر على 256 جهة اتصال. تربط واجهة برمجة التطبيقات WhatsApp بأنظمتك الخاصة. يمكنك إرسال القوالب المعتمدة بكميات كبيرة، وأتمتة الردود، وتلقي خطافات الويب، ومشاركة رقم واحد عبر صندوق بريد وارد للفريق.

ما هي نقاط النهاية الموجودة في خطتي؟

نقاط نهاية المراسلة الأساسية، والقوالب، وجهات الاتصال متاحة في كل خطة. تتطلب تعيينات الفريق، وحالة الدردشة، وروبوتات المحادثة، والشرائح المخصصة خطة Pro أو Business. تسرد المستندات مدى توفر نقاط النهاية حسب الخطة.

رسالتك الأولى على بعد طلب واحد.

ابدأ مجاناً، وقم بتوصيل رقم WhatsApp الخاص بك في Wati وقم بإجراء مكالمتك الأولى.