إرسال رسائل WhatsApp عبر API من WhatChimp — رسائل نصية مقابل رسائل قوالب
الخطأ الأكثر شيوعاً في API موضح: متى تستخدم الرسائل النصية مقابل رسائل القوالب، وكيف تعمل نافذة الـ 24 ساعة، وكيفية إرسال رسائل القوالب مع المتغيرات.
Updated 5 February 2026
تتيح لك API من WhatChimp إرسال نوعين من رسائل WhatsApp: رسائل نصية (رسائل الجلسة) و رسائل القوالب. استخدام النوع الخاطئ هو السبب الأكثر شيوعاً لفشل رسائل API — يشرح هذا الدليل الفرق.
الخطأ رقم 1: إرسال الإشعارات كرسائل نصية
يبدأ معظم المطورين بـ endpoint Send Message، ويجعلونه يعمل في الاختبار، ثم يحاولون استخدامه لإرسال الإشعارات أو المتابعات. سيفشل هذا.
يفرض WhatsApp نافذة جلسة مدتها 24 ساعة. يمكنك إرسال رسائل نصية فقط خلال 24 ساعة من آخر رسالة للعميل. بعد ذلك، تُرجع API خطأ.
إذا كنت تريد إرسال إشعارات أو تذكيرات أو تحديثات طلبات أو أكواد OTP — يجب عليك استخدام رسالة قالب.
الرسائل النصية مقابل رسائل القوالب
| رسالة نصية (جلسة) | رسالة قالب | |
|---|---|---|
| متى يمكنك إرسالها؟ | فقط خلال 24 ساعة من آخر رسالة للعميل | في أي وقت — لا توجد قيود زمنية |
| المحتوى | أي نص تريده | يجب استخدام قالب معتمد مسبقاً |
| حالة الاستخدام | الرد على استفسارات العملاء | الإشعارات والتذكيرات والتحديثات وأكواد OTP |
| هل تحتاج إلى موافقة؟ | لا | نعم — يجب الموافقة على القوالب من قبل Meta |
| API endpoint | POST /api/v1/whatsapp/send | POST /api/v1/whatsapp/send (نفس endpoint، معاملات مختلفة) |
| التكلفة | جزء من محادثة بدأها العميل | محادثة بدأها النشاط التجاري (مستوى تسعير مختلف) |
دليل القرار السريع
هل تحتاج لإرسال رسالة؟
│
├── هل يتحدث العميل معك حالياً (خلال 24 ساعة)؟
│ ├── نعم → استخدم رسالة نصية (رسالة جلسة)
│ └── لا → استخدم رسالة قالب
│
├── هل ترسل إشعاراً أو تذكيراً أو تحديثاً؟
│ └── استخدم دائماً رسالة قالب
│
├── هل ترسل OTP أو رمز تحقق؟
│ └── استخدم رسالة قالب (نوع Authentication)
│
└── هل أنت غير متأكد؟
└── استخدم رسالة قالب (تعمل دائماً)أدلة مفصلة
Video: https://www.youtube.com/watch?v=czd3S5cBHvY
لكل نوع رسالة دليله المفصل مع مرجع API كامل وأمثلة الكود ولقطات الشاشة:
- إرسال رسائل نصية لـ 24 ساعة عبر API من WhatChimp — كيف تعمل نافذة الجلسة، ومعاملات API، وأمثلة curl، ومعالجة الأخطاء
- إرسال رسائل القوالب عبر API من WhatChimp — كيفية إنشاء القوالب، واستخدام Template Message Generator، والإرسال مع المتغيرات، واستكشاف الأخطاء وإصلاحها
مقالات ذات صلة
- البدء مع واجهة برمجة التطبيقات Developer API من WhatChimp — إعداد API، والمصادقة، والبداية السريعة
- إنشاء Message Template لـ WhatsApp في WhatChimp — دليل إنشاء القالب خطوة بخطوة
- WhatChimp Messaging API — مرجع كامل لـ messaging API (جميع endpoints)