الإجابة المختصرة
لإرسال رسالة WhatsApp عبر API، اربط حساب WhatsApp Business من خلال شريك لدى Meta أو عبر Cloud API من Meta، واحصل على موافقة المستلمين، واعتمد قالب رسالة. أرسل القالب لبدء المحادثة، وبعد ردّ العميل يمكنك إرسال نصوص حرة أو وسائط أو رسائل تفاعلية خلال نافذة خدمة العملاء البالغة 24 ساعة.
ما تحتاجه قبل أول إرسال
- حساب WhatsApp Business (WABA)، يُنشأ عادةً عبر مسار Embedded Signup من Meta لدى أحد الشركاء، مع رقم هاتف تجاري موثّق واسم عرض.
- قالب رسالة معتمد واحد على الأقل ضمن فئة التسويق أو الخدمات أو المصادقة.
- موافقة مسبقة (opt-in) من كل مستلم، كما تشترط سياسات Meta.
- ترتيب للفوترة. فمنذ 1 يوليو 2025 تحتسب Meta الرسوم لكل رسالة مسلَّمة بحسب الفئة وسوق المستلم؛ راجع قائمة أسعار Meta الحالية.
قالب أم رسالة حرة؟
اعتباراً من 1 أكتوبر 2026 تحتسب Meta أيضاً رسوماً على رسائل خدمة العملاء وقوالب تحديثات المعاملات المرسلة داخل النافذة، بعد 1,000 رسالة خدمة عملاء مجانية لكل رقم هاتف تجاري شهرياً.
| الحالة | ما يمكنك إرساله |
|---|---|
| أنت من يبدأ المحادثة | قالب معتمد فقط |
| راسلك العميل خلال آخر 24 ساعة | أي نوع من الرسائل: نص أو وسائط أو رسالة تفاعلية أو قالب |
| انتهت نافذة الـ 24 ساعة | قالب معتمد فقط |
| إرسال رمز تحقق لمرة واحدة | قالب مصادقة |
خطوات الإرسال
- أنشئ القالب باسمه ولغته وفئته وقيم أمثلة للمتغيرات، وقدّمه إلى Meta للمراجعة.
- انتظر حتى تصبح حالة القالب معتمدة.
- استدعِ نقطة الإرسال مع المستلم واسم القالب واللغة وقيم المتغيرات.
- احفظ المعرّف العائد، ثم تابع حالات SENT وDELIVERED وREAD وFAILED على الـ Webhook.
مثال: إرسال قالب
على OmniChannels.ai تمر كل رسائل WhatsApp عبر POST https://api.broadnet.me/whatsapp/message/sendbulk بصيغة multipart form data مع رمز Bearer. اضبط messageType على TEMPLATE ومرّر destinationNo وtemplateName وtemplateLanguage وbodyTemplateVariables. يعيد الاستدعاء batchId، وتصل حالات كل مستلم إلى الـ Webhook أو عبر GET /whatsapp/message/bulk-insights.