الانتقال إلى المحتوى الرئيسي
POST /send/interactive يرسل رسائل WhatsApp الأصلية-flow عبر الجهاز المحدد. استخدم المصادقة الأساسية، X-Device-Id، وجهاز JSON. هذه النقطة النهائية تدعم إرسال REST فورا. إرسال المجدولة ولا تكشف MCP عن ذلك.
نقطة النهاية التجريبية هذه تستخدم بروتوكول WhatsApp غير رسمي. التقديم المتلقي يختلف حسب العميل ويمكن أن يتغير بدون إشعار. اختبار على العملاء المستهدفين قبل الاستخدام. يؤكد نجاح استجابة API إرسال القبول، وليس التسليم أو التقديم.
عيّن عنوان URL للسيرفر ووثائق الاعتماد قبل تشغيل أمثلة الستريل. استخدم عنوان HTTPS العام للخادم البعيد وشمل APP_BASE_PATH عند تكوينه.

أزرار الإرسال

يقبل phone رقم هاتف أو معرّف JID كاملًا لمستخدم أو مجموعة. يتطلب الإرسال إلى المجموعة العضوية فيها وإذن النشر. لا يُدعم مستلمو النشرات الإخبارية وقوائم البث. قدّم إما buttons أو cards في المستوى الأعلى. يفشل التحقق من الصحة عند تقديم كليهما أو عدم تقديم أي منهما. بالنسبة لقائمة الاختيار، استخدم هذه البارامترات:

طلب موقع

أرسل هذا JSON إلى /send/interactive. يجب على المستلم أن يختار مشاركة الموقع. نقطة النهاية لا تسترجع الموقع بدون إجراءاتهم.

إرسال صورة مشابهة

استبدال العناصر النائبة للصور بالقاعدة القياسية 64، بدون بادئة عنوان URL للبيانات. الصور اختيارية على بطاقات فردية. تقوم GOWA بتغيير حجم الصور الموفرة لتناسب 1280 نقطة، وتحويلها إلى JPEG ، وإنشاء مصغرات ، وتحميلها إلى WhatsApp. عناوين URL للصور البعيدة غير مقبولة.

حدود الطلب

الحد الإجمالي لجسم طلب HTTP للسيرفر ينطبق أيضًا. استخدم الصور الصغيرة عند إرسال العديد من البطاقات. خيارات أو أحجام غير صالحة ترجع خطأ في التحقق قبل الإرسال.

التعامل مع الردود والإيصالات

يرسل بنجاح مظروف النجاح العادي مع results.message_id والوضع الذي يقول أن تقديم المستلم لا يمكن التحقق منه. استخدام webhooks للردود ولأحداث message.ack للإيصالات. إعادة المحاولة بعد مهلة غامضة يمكن تكرار الرسائل. أبلغ اختبارات اندرويد في أسفل الأندرويد عن إجراءات الرد على العمل، وعنوان URL، والنسخ، والمكالمة، والاختيار، والموقع، والرسوم المتحركة. هذه التقارير لا تثبت التوافق عبر الحسابات أو iOS أو WhatsApp Web. بطاقات العربات الفردية يمكن أن تظهر الأيقونات المعلقة حتى عندما تكون للرسالة الأم علامات فحص ويمكن للمستلم أن يرد. هذه المشكلة لا تزال بدون حل. نقطة النهاية لا تسجل القوالب الرسمية أو تدعم التدفقات الواردة، الكتالوجات، أو الدفعات الأصلية.