خصم 50% بالرمز BLACKFRIDAY50خصم 20% بالرمز BLACKFRIDAY20
التكاملات وواجهة APIGrowth / Pro وما فوقها

API: عرض قوالب واتساب وإرسالها

تتيح نقطتا نهاية لبرنامجك استخدام قوالب واتساب الخاصة بك. تعرض GET /api/v1/whatsapp/templates قوالبك المعتمدة، وترسل POST /api/v1/whatsapp/send-template أحدها إلى عميل من رقمك الافتراضي. وكلتاهما تحتاج إلى مفتاح بصلاحية WhatsApp.

المكان
Ask Menuthere support for a key
الباقة
يحتاج إلى رقم WhatsApp Business مربوط، وهو يبدأ من Starter / Pro.
آخر تحديث

اعرض قوالبك

curl 'https://menuthere.com/api/v1/whatsapp/templates' -H 'Authorization: Bearer ck_live_YOUR_KEY'

تعيد القوالب المعتمدة على رقمك الافتراضي، فتعرف الاسم بدقة وعدد القيم التي يحتاجها كل قالب.

الحقلالمعنى
name, languageاسم القالب ورمز لغته.
category, statusالفئة مثل MARKETING أو UTILITY. والحالة APPROVED.
body_variablesعدد قيم {{n}} التي يحتاجها النص.
has_header, header_formatهل هناك ترويسة، ونوعها TEXT أو IMAGE أو VIDEO أو DOCUMENT.

أرسل قالبًا

POST /api/v1/whatsapp/send-template بمحتوى JSON. تخرج الرسالة من مرسِلك الافتراضي المحدد في عدة أرقام والرقم الأساسي. ولا يمكنك اختيار الرقم في الاستدعاء.

الحقلمطلوبما هو
toنعمرقم العميل مع رمز الدولة.
template_nameنعمالاسم من استدعاء العرض.
languageلايُبحث عنه من القالب المعتمد إذا تركته.
body_paramsلامصفوفة قيم لـ {{1}} و{{2}} وهكذا، بالترتيب.
header_paramsلامصفوفة قيم لترويسة نصية.
header_media_url, header_media_typeلارابط وimage أو video أو document لترويسة وسائط.
button_paramsلامصفوفة قيم لزر رابط ديناميكي.
idempotency_keyلامرجع تختاره. ويصلح أيضًا id وترويسة Idempotency-Key.

يعيد الإرسال الناجح ok: true وmessage_id ورقم to وstatus: "sent". وإذا أرسلت مفتاح idempotency نفسه مرة أخرى تحصل على النتيجة الأولى مع duplicate: true ولا يُرسل شيء مرتين. والإرسال الفاشل يحرّر المفتاح لتعيد المحاولة.

الأخطاء والحدود

الحالة`error`المعنى
400missing_fields, invalid_json, invalid_number, template_errorحقل مطلوب ناقص، أو الرقم يبدو خاطئًا، أو القالب لا يناسب القيم التي أرسلتها.
404template_not_foundلا قالب معتمد بهذا الاسم على رقمك الافتراضي.
409recipient_opted_outردّ العميل بـ STOP. لا تُرسل رسالة.
409in_progressما زال طلب بمفتاح idempotency نفسه قيد التنفيذ.
412no_whatsapp_numberلا يوجد رقم واتساب افتراضي مربوط.
429daily_limit_reached, rate_limitedاستُنفد حدّ واتساب اليومي لرقمك، أو تجاوز المفتاح حدّ معدّل الطلبات.
502send_failedتعذّر الوصول إلى واتساب. حاول مرة أخرى.
من الجيد أن تعرفكل إرسال عبر API هو رسالة واتساب عادية، فتحتسب Meta رسومها كأي رسالة أخرى. راجع تكلفة رسائل واتساب. ويجب اعتماد القالب قبل إرساله. راجع قوالب الرسائل.

أسئلة

هل أستطيع إرسال رسالة نصية عادية عبر API؟
لا. ترسل API القوالب المعتمدة فقط، وهي أيضًا تصل إلى العملاء خارج نافذة الـ 24 ساعة.
هل تراسل من ألغى اشتراكه؟
لا. العميل الذي ردّ بـ STOP يُتخطّى ويعيد الاستدعاء recipient_opted_out.

لم تجد ما تبحث عنه؟ راسلنا على help@mail.menuthere.com أو تحدّث معنا من 9 صباحًا حتى 9 مساءً.مركز المساعدةالأسعارmenuthere.com