API: عرض قوالب واتساب وإرسالها
تتيح نقطتا نهاية لبرنامجك استخدام قوالب واتساب الخاصة بك. تعرض GET /api/v1/whatsapp/templates قوالبك المعتمدة، وترسل POST /api/v1/whatsapp/send-template أحدها إلى عميل من رقمك الافتراضي. وكلتاهما تحتاج إلى مفتاح بصلاحية WhatsApp.
- المكان
- Ask Menuthere support for a key
- الباقة
- يحتاج إلى رقم WhatsApp Business مربوط، وهو يبدأ من 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` | المعنى |
|---|---|---|
| 400 | missing_fields, invalid_json, invalid_number, template_error | حقل مطلوب ناقص، أو الرقم يبدو خاطئًا، أو القالب لا يناسب القيم التي أرسلتها. |
| 404 | template_not_found | لا قالب معتمد بهذا الاسم على رقمك الافتراضي. |
| 409 | recipient_opted_out | ردّ العميل بـ STOP. لا تُرسل رسالة. |
| 409 | in_progress | ما زال طلب بمفتاح idempotency نفسه قيد التنفيذ. |
| 412 | no_whatsapp_number | لا يوجد رقم واتساب افتراضي مربوط. |
| 429 | daily_limit_reached, rate_limited | استُنفد حدّ واتساب اليومي لرقمك، أو تجاوز المفتاح حدّ معدّل الطلبات. |
| 502 | send_failed | تعذّر الوصول إلى واتساب. حاول مرة أخرى. |
أسئلة
هل أستطيع إرسال رسالة نصية عادية عبر API؟
هل تراسل من ألغى اشتراكه؟
ذات صلة
لم تجد ما تبحث عنه؟ راسلنا على [email protected] أو تحدّث معنا من 9 صباحًا حتى 9 مساءً.مركز المساعدةالأسعارmenuthere.com