في المطورون > بيانات الاعتماد، أنشئ رمزًا للاشتراك messages:write. انسخه عند الإنشاء، خزنه في الـ backend، وقم بتكوين اتصال WhatsApp في لوحة التحكم قبل الإرسال.
مطور API
واجهة برمجة تطبيقات (API) لربط WhatsApp بأنظمتك وتطبيقاتك.
ادمج CRM وERP والتطبيقات والأنظمة الداخلية مع WhatsApp باستخدام REST API من WPP Marketing. أرسل نصًا ووسائط، استعلم عن الرسائل وتابع التسليمات عبر webhooks. استخدم أيضًا MCP لربط تدفقاتك بواجهة برمجة التطبيقات الرسمية. التعرّف على MCP.
متى تستخدم
استخدم واجهة برمجة تطبيقات المراسلة عندما يحتاج نظامك إلى إرسال رسائل WhatsApp.
استخدم CRM الخاص بك لبدء تواصل، وERP لإرسال تحديث، أو تطبيقك لإخطار عميل. تبقى منطق متى يتم الإرسال في نظامك؛ تقوم واجهة الـ API بتنفيذ الإرسال عبر الاتصال المُكوّن في الحساب. للحصول على أتمتة تجارية جاهزة, استخدم Events API.
استخدم POST /send-text للنص أو POST /send-media للوسائط. في الاتصال الرسمي، النص والصورة يستخدمان القوالب المُعدة؛ الصوت، الفيديو والمستندات تتطلب رسالة واردة من العميل خلال الـ 24 ساعة الماضية.
HTTP 200 تشير إلى القبول، وليس التسليم. مع messages:read، استخدم GET /messages وتحقق من الحالات المتاحة للقناة.
سجل عنوان URL بتنسيق HTTPS وقم بتمكين الأحداث في لوحة التحكم. استخدم webhooks:read لاستعلام المحاولات عبر GET /webhooks؛ هذه النقطة النهائية تعرض عمليات التسليم، ولا تسجل الاشتراكات.
من التوكن وحتى الشحنة الأولى المتضمنة.
على خادمك، استبدل SEU_TOKEN بالمُعطى وبدّل الرقم بالمستلم المخول للاختبار. استخدم مفتاحًا فريدًا لكل عملية إرسال وأعد استخدام نفس المفتاح فقط عند تكرار نفس الطلب.
تحقق من حالة HTTP ومحتوى الاستجابة. بالنسبة لـ401، راجع التوكن وصلاحيته؛ بالنسبة لـ403، تحقق من الصلاحيات (scopes) وحالة الحساب. بالنسبة لـ409، تحقق مما إذا تم استخدام المفتاح بالفعل مع محتوى آخر. بالنسبة لـ429، احترم قيمة Retry-After قبل إعادة المحاولة.
بعد ذلك، تحقق من GET /messages مع messages:read أو راقب webhooks المُكوّنة. تأكيد التسليم يعتمد على رد القناة.
cURLPOST /send-text
curl --request POST 'https://api.wppmarketing.com/send-text' \
--header 'Authorization: Bearer SEU_TOKEN' \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: pedido-10231-aviso-1' \
--data '{"number":"5511999999999","body":"Olá! Seu pedido foi atualizado."}'نصوص، وسائط، السجل وتتبع الإرسالات.
استخدم نقاط النهاية REST لدمج WhatsApp مع تطبيقك. تستخدم واجهة برمجة التطبيقات WPP Marketing الاتصال المُعد في الحساب؛ للعمل مع واجهة WhatsApp الرسمية، قم بتكوين ذلك الاتصال في لوحة التحكم. راجع OpenAPI للاطلاع على الصيغ والنطاقات والحدود والاستجابات لكل عملية.
POST
/send-text
يرسل رسالة نصية إلى رقم WhatsApp.
Texto
POST
/send-media
أرسل صورة أو صوتًا أو فيديو أو مستندًا عبر رابط HTTPS عام، وفقًا للتنسيق وشروط الاتصال. يستخدم الصوت نفس نقطة النهاية.
Mídia
GET
/messages
استعرض سجل الرسائل المرسلة مع الحالة والترقيم الصفحات.
Histórico
GET
/webhooks
عرض تسليمات الويب هوكس مع الحدث، نتيجة HTTP، المحاولات والترقيم الصفحي.
Webhooks
DOC
Swagger / OpenAPI
توثيق تفاعلي يتضمن العقود، الأمثلة، الحقول الإلزامية، والاستجابات المتوقعة.
Docs
فصل تقني
اختر الميزة المناسبة لكل مرحلة من مراحل التكامل.
أرسل رسائل عبر Messaging API، وفعّل أتمتة الأعمال عبر Events API، وتلقَّ ردودًا عبر webhooks. يمكن لتطبيقك دمج هذه الميزات حسب التدفق المطلوب.
الاتصال الرسمي هو قناة الاتصال؛ واجهة برمجة تطبيقات WPP Marketing هي الواجهة التي يستخدمها نظامكم. راجع المتطلبات على واجهة برمجة تطبيقات WhatsApp الرسمية والتعايش.
يقوم نظامك باستدعاء WPP Marketing لإرسال رسائل نصية أو وسائط وللاستعلام عن سجلات الرسائل وتسليمات الويب هوكس.
يُرسل نظامك أحداثًا تجارية مثل إنشاء طلب، موافقة الدفع، الشحن أو سلة متروكة.
افهم الأحداث والأتمتة المتاحةترسل WPP Marketing أحداثًا موحدة للإنشاء والتسليم والقراءة والأخطاء إلى عنوان URL تقوم بتزويده.
اطلع على أحداث الإرجاع وتتبع التسليماتاستخدم الوثائق التفاعلية للتحقق من صحة payloads والمصادقة والاستجابات قبل طرحها في بيئة الإنتاج.
يجب إبقاء الرموز (tokens) في الـ backend. لا تكشف عن بيانات الاعتماد في صفحات عامة أو تطبيقات الواجهة الأمامية أو المستودعات.
في /send-text و /send-media، يتيح Idempotency-Key تكرار نفس الطلب مع استجابة ناجحة لمدة تصل إلى 48 ساعة. إعادة استخدام المفتاح مع محتوى مختلف تُعيد 409. بدون المفتاح، قد تؤدي إعادة الاتصال إلى تكرار الإرسال. احترم رؤوس RateLimit و Retry-After؛ حدود الطلبات تختلف عن حصة الخطة.
بيانات اعتماد واحدة لكل تكامل، مع الأذونات اللازمة.
في اللوحة، امنح اسمًا للرمز (token)، حدد الصلاحيات (scopes) وحدد انتهاء صلاحية اختياريًا. يظهر الرمز الكامل مرة واحدة فقط عند الإنشاء. تتيح القائمة التحقق من آخر استخدام وتاريخ الانتهاء وإلغاء الوصول عند الحاجة.
عند تدوير بيانات الاعتماد، حدّث السر على خادمك وارجع عن الاعتماد السابق. لا تستخدم أبدًا رمز مزود WhatsApp بدلاً من اعتماد واجهة برمجة التطبيقات (API).
يسمح بإرسال نص ووسائط. امنحه فقط للتكاملات التي تحتاج إلى بدء الإرسال.
تتيح الاستعلام عن سجل الرسائل وتسليمات الويبهوكس على التوالي. لا تحصل بيانات اعتماد الإرسال على هذه الأذونات تلقائيًا.
يتيح إبلاغ العملاء والعربات والطلبات عبر Events API إلى الأتمتة المُكوَّنة في الحساب.
يفحص الإعدادات المخزنة، الأتمتة، العدّادات والسجلات الأخيرة للتشخيص. قد يتضمن بيانات شخصية ومحتوى الرسائل: امنح الإذن فقط للتكاملات والدعم المصرح لهم. هذا الاستعلام لا يتحقق من اتصال الموفر بشكل مباشر.
MCP وواجهة برمجة التطبيقات الرسمية لواتساب.
وصل أدوات الذكاء الاصطناعي إلى عملية WhatsApp الخاصة بك عبر MCP من WPP Marketing. قم بدمج WhatsApp في تدفقات عمل مساعديك ووكلائك، باستخدام الـAPI الرسمية كاتصال للرسائل.
يقوم MCP بربط مسارات وكلائك بالتكامل؛ تقوم واجهة برمجة تطبيقات المراسلة بتنفيذ الإرسالات ويتبع الاتصال الرسمي قواعد WhatsApp. هذا لا يحول MCP إلى روبوت دردشة محلي ولا يحل محل إعداد الحساب. يوجّه الفريق الإجراءات ومتطلبات التكامل لحالة الاستخدام الخاصة بك.
استخدم MCP كمسار تكامل بين أدوات الذكاء الاصطناعي وWhatsApp، مكملاً لتدفقات أنظمتك وفريقك.
تحدث مع فريقنا حول أداة الـIA التي تستخدمها والإجراءات التي ترغب في توصيلها إلى WhatsApp. اطلع على المتطلبات والنطاق المناسب لعمليتك.
التحدث عن تكامل MCPهل أنت مستعد لدمج نظامك مع WPP Marketing؟
افتح Swagger لاستعراض نقاط النهاية (endpoints) الخاصة بـ Messaging API، أمثلة على payload، مصادقة bearer token، والردود المتوقعة. لأحداث المتجر وملاحظات تسليم الطلبات، راجع أيضًا Events API و Webhooks de status.