رسائل شخصية، مُرسلة على نطاق واسع.
اختر قالباً معتمداً ومرره إلى ما يصل إلى 10,000 مستلم. يحصل كل شخص على متغيّراته الخاصة، ويصل كل رد برقم.
WhatsApp API
أرسل القوالب، وقم بالرد في المحادثة، وتلقَّ الإشعارات عبر webhook، وقم بتحويل المحادثة إلى فريقك. عنوان أساسي واحد، ورمز مصادقة واحد.
آخر تحديث
ابدأها بقالب، واصلها في المحادثة، تابعها عبر webhook وأنهِها في صندوق الوارد لفريقك.
اختر قالباً معتمداً ومرره إلى ما يصل إلى 10,000 مستلم. يحصل كل شخص على متغيّراته الخاصة، ويصل كل رد برقم.
داخل نافذة الـ 24 ساعة، أرسل نصوصاً، وصوراً، وملفات، وأزرار رد، ومحددات قائمة، مع مؤشر كتابة أثناء عملك.
يرسل متجرك، أو نظام الحجز، أو نظام الفوترة قالباً معتمداً عندما يتغير شيء ما. ينقر العملاء على زر أو يردون.
يجلب خطاف الويب للرسائل كل رسالة جديدة إلى خادمك. رد بنقاط نهاية الإرسال، أو ابدأ بوت دردشة Wati في باقتي Pro وBusiness.
تدفع خطافات الويب الرسائل الجديدة، وإيصالات القراءة، والنقرات، وحالات الفشل إلى عنوان URL الخاص بك. بدون أي استعلام دوري (polling).
تصل الردود إلى صندوق الوارد الخاص بفريق Wati. قم بتعيين موظف، وضبط الحالة، وإضافة العلامات عبر واجهة برمجة التطبيقات (API)، لكي يتولى الشخص المناسب الأمر.
قم بإنشاء وتحديث جهات الاتصال بسمات مخصصة، ثم عاين الشريحة قبل إرسال الرسالة إليها.
قائمة التعليقات على منشوراتك، الرد علناً أو إرسال رد خاص.
اربط رقم واتساب الخاص بك من خلال ميزة التسجيل المدمج من ميتا داخل Wati.
أنشئ رمز API في Wati واحه النطاقات التي تحتاجها فقط. احتفظ به على خادمك.
أرسل قوالب معتمدة بطلب واحد. ثم أضف خطاف الويب (Webhook) لتتبع التسليم.
إليك ما يتضمنه الطلب الواحد، وأين يظهر كل جزء في الرسالة.
رقم واتساب الخاص بالعميل، متبوعاً برمز الدولة.
phone_number14155552671اسم القالب الذي وافقت عليه ميتا في حسابك.
template_nameorder_updateالقيم الخاصة بالفراغات الموجودة في القالب، قيمة واحدة لكل شخص.
custom_paramsname = Mayaorder_id = 10482رمز API الخاص بك، يتم إرساله مع كل طلب. احتفظ به على خادمك.
Authorization: Bearer <token>يعني الرمز 200 أن Wati قبلت الرسالة، مع معرف البث broadcast_id. يتم استلام حالتي التسليم والقراءة لاحقاً عبر خطاف الويب.
200broadcast_idنص الرسالة و order_update هما مجرد أمثلة. القالب المعتمد الخاص بك هو ما يحدد الصياغة.
التعليق الذي ترد عليه. تحصل على معرفه عندما تعرض تعليقات المنشور.
comment_idin the URL pathحساب إنستغرام الخاص بك المتصل بـ Wati.
channelالشخص الذي كتب التعليق، مأخوذ من نفس التعليق.
userIduserNameنص عادي يصل إلى 1000 حرف، أو قالب مع أزرار.
type = texttexttype = templateرمز 200 مع ضبط القيمة ok على true يعني أن الرد الخاص قد تم بنجاح. استخدم نفس رأس المصادقة (Authorization header) كما في أي مكالمة أخرى.
ok: trueresult: successPOST /api/ext/v3/comments/{comment_id}/privateReply. التعليق ونصوص الرد هي أمثلة توضيحية. اطّلع على الطلب في المستندات
الاتصال من خلال ميزة التسجيل المدمج من Meta. يتم تسجيل حساب WhatsApp Business الخاص بشركتك.
تصل التغييرات الخاصة بالموافقة والجودة والفئات في صورة إشعارات ويب (Webhooks)، لتعلم بذلك قبل فشل عملية الإرسال.
تصل إلى 144 محاولة إعادة، كل 10 دقائق. وإذا استمر نقطة النهاية (Endpoint) الخاصة بك في الفشل، يقوم Wati بإرسال بريد إلكتروني إليك.
عند تجاوز السرعة المطلوبة، ستحصل على الرمز 429 مع ترويسة Retry-After. تنتظر الرسائل المقبولة في طابور الانتظار.
صندوق بريد فريق مشترك للمحادثات التي ينبغي ألا يجيب عليها الكود البرمجي بمفرده.
يدعم الإصدار v3 الرموز ذات النطاق المخصص، بحيث يحصل كل تكامل على الصلاحيات التي يحتاجها فقط.
قم جدولة إرسال قالب لوقت لاحق باتصال واحد. وسي يقوم Wati بإرساله في الموعد المحدد.
احسب التكلفة التقديرية للبث قبل إرسال أي شيء.
ابدأ المحادثات باستخدام القوالب الموافَق عليها، فوراً أو حسب جدول زمني.
المستندات ←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اعرض قائمة روبوتات محادثة Wati الخاصة بك وابدأ تشغيل أحدها لجهة اتصال.
المستندات ←GET/chatbotsPOST/chatbots/startإدارة الاشتراكات وعرض قائمة أنواع الأحداث التي يمكنك تلقيها.
المستندات ←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عرض المنشورات والتعليقات، الرد علناً أو خاصاً، والتحقق من الأذونات.
المستندات ←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 بالنصوص.
إصدارات BSUID لعدة أحداث متاحة أيضاً. مستندات إشعارات الويب
طلبات إرسال القوالب، بناءً على خطتك (Growth أو Pro أو Business).
قالب واحد، يصل إلى 10,000 شخص، لكل منهم متغراته الخاصة.
تتطلب النصوص والوسائط والأزرار نافذة خدمة عملاء مفتوحة. خارجها، أرسل قالبًا.
يخبرك Wati بالمدة التي يتعين عليك انتظارها. تتم معالجة الرسائل المقبولة في قائمة انتظار.
| نقطة النهاية (Endpoint) | 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 ثوانٍ |
الحدود كما تم نشرها على الأخطاء وحدود معدل الاستخدام (Errors & Rate Limits)، مصنفة حسب اسم نقطة النهاية. يقبل طلب الإرسال الجماعي في الإصدار v1 ما يصل إلى 1,000 جهة اتصال. تتوفر نقاط نهاية المراسلة الأساسية والقوالب وجهات الاتصال في جميع الخطط. بينما يتطلب تعيين الفريق، وحالة الدردشة، وروبوتات المحادثة، والشرائح المخصصة خطة Pro أو Business. يتطلب تحديث السمات لجهات اتصال متعددة دفعة واحدة خطة Business. توفر نقاط النهاية حسب الخطة. للحصول على حدود أعلى، تحدث إلى فريق Wati بشأن حالة الاستخدام الخاصة بك.
نعم. تغطي واجهة برمجة تطبيقات Wati قوالب WhatsApp، وعمليات البث، والرسائل، وجهات الاتصال، والشرائح، وإجراءات صندوق البريد الوارد للفريق، وخطافات الويب. يجب أن تستخدم عمليات التكامل الجديدة الإصدار v3 على https://live-mt-server.wati.io/api/ext/v3 مع رمز مصادقة (bearer token). المرجع الكامل متاح للعامة على docs.wati.io.
استخدم الإصدار v3 للأعمال الجديدة. تتميز نقاط نهاية الإصدار v3 بطلبات واستجابات محددة الأنواع، وأخطاء منظمة، ورموز مصادقة واجهة برمجة تطبيقات محددة النطاق. لا تزال نقاط نهاية الإصدار v1 القديمة، الواقعة ضمن /{tenantId}/api/v1، مدعومة.
يُعد 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.
تطبيق الأعمال مخصص للدردشات اليدوية على الهاتف، مع ما يصل إلى 5 أجهزة مرتبطة وقوائم بث تقتصر على 256 جهة اتصال. تربط واجهة برمجة التطبيقات WhatsApp بأنظمتك الخاصة. يمكنك إرسال القوالب المعتمدة بكميات كبيرة، وأتمتة الردود، وتلقي خطافات الويب، ومشاركة رقم واحد عبر صندوق بريد وارد للفريق.
نقاط نهاية المراسلة الأساسية، والقوالب، وجهات الاتصال متاحة في كل خطة. تتطلب تعيينات الفريق، وحالة الدردشة، وروبوتات المحادثة، والشرائح المخصصة خطة Pro أو Business. تسرد المستندات مدى توفر نقاط النهاية حسب الخطة.
ابدأ مجاناً، وقم بتوصيل رقم WhatsApp الخاص بك في Wati وقم بإجراء مكالمتك الأولى.