أنواع الرسائل
تسعة أنواع من الرسائل بنص طلب واحد
يحدد طلب الإرسال قناة ومستلمًا ونوعًا، ويوضع المحتوى تحت مفتاح يحمل اسم النوع. تعرض هذه الصفحة كل نوع، ونص الطلب الذي ينتجه، والقنوات التي تدعمه.
جدول الدعم
أي قناة تقبل أي نوع
تُعلن كل قناة ما تقبله في capabilities. إرسال نوع لا تدعمه القناة يعيد 400 unsupported_message_type ولا يُخصم شيء.
| النوع | SMS | SMS OTP | Telegram | Messenger | TikTok | ||
|---|---|---|---|---|---|---|---|
نصtext | مدعوم | مدعوم | مدعوم | مدعوم | مدعوم | مدعوم | مدعوم |
مرفقاتattachments | مدعوم | مدعوم | غير مدعوم | مدعوم | مدعوم | مدعوم | مدعوم |
قالبtemplate | مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم |
أزرار الردbutton | مدعوم | غير مدعوم | غير مدعوم | مدعوم | مدعوم | مدعوم | مدعوم |
قائمةlist | مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم |
زر رابطcta_url | مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم | غير مدعوم |
موقعlocation | مدعوم | غير مدعوم | غير مدعوم | مدعوم | غير مدعوم | غير مدعوم | غير مدعوم |
جهات اتصالcontacts | مدعوم | غير مدعوم | غير مدعوم | مدعوم | غير مدعوم | غير مدعوم | غير مدعوم |
استطلاعpoll | غير مدعوم | غير مدعوم | غير مدعوم | مدعوم | غير مدعوم | غير مدعوم | غير مدعوم |
type: "text"نص
نص عادي تقبله كل أنواع القنوات. فعّل preview_url لتعرض القناة معاينة للرابط.
body: من 1 إلى 4,096 حرفًا.
- WhatsApp Business
- SMS
- SMS OTP
- Telegram
- Messenger
- TikTok
{
"channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
"to": "+971501234567",
"type": "text",
"text": {
"body": "تم شحن طلبك رقم #1042. تتبّعه عبر https://example.com/t/1042",
"preview_url": true
},
"reference": "order-1042"
}type: "attachments"مرفقات
عنصر وسائط واحد لكل رسالة، يُشار إليه برابط https: صورة أو فيديو أو مستند أو ملف صوتي أو رسالة صوتية أو ملصق، مع تعليق اختياري.
عنصر واحد بالضبط. caption: حتى 1,024 حرفًا.
- WhatsApp Business
- SMS
- Telegram
- Messenger
- TikTok
{
"channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
"to": "+971501234567",
"type": "attachments",
"attachments": [
{
"type": "image",
"url": "https://example.com/receipts/1042.jpg",
"caption": "إيصال طلبك رقم #1042."
}
]
}type: "template"قالب
قالب WhatsApp معتمد بمتغيرات. القوالب هي الرسائل الوحيدة التي يقبلها WhatsApp خارج نافذة خدمة العملاء البالغة 24 ساعة.
يجب أن يطابق name وlanguage قالبًا معتمدًا للقناة.
- WhatsApp Business
{
"channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
"to": "+971501234567",
"type": "template",
"template": {
"name": "order_out_for_delivery",
"language": {
"code": "en"
},
"components": [
{
"type": "body",
"parameters": [
{
"type": "text",
"text": "ليلى"
},
{
"type": "text",
"text": "#1042"
},
{
"type": "text",
"text": "18:00"
}
]
}
]
}
}type: "list"قائمة
قائمة تُفتح من زر واحد، بصفوف مجمّعة في أقسام معنونة.
action.button: حتى 20 حرفًا.
- WhatsApp Business
{
"channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
"to": "+971501234567",
"type": "list",
"list": {
"body": {
"text": "أي فريق يمكنه مساعدتك اليوم؟"
},
"action": {
"button": "اختر فريقًا",
"sections": [
{
"title": "الفرق",
"rows": [
{
"id": "orders",
"title": "الطلبات",
"description": "التوصيل والإرجاع والاسترداد"
},
{
"id": "billing",
"title": "الفوترة",
"description": "الفواتير وطرق الدفع"
},
{
"id": "technical",
"title": "الدعم الفني",
"description": "الإعداد وحل المشكلات"
}
]
}
]
}
}
}type: "cta_url"زر رابط
رسالة بزر واحد يفتح رابطًا، لصفحات التتبّع والمدفوعات وروابط تسجيل الدخول.
زر واحد لكل رسالة.
- WhatsApp Business
{
"channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
"to": "+971501234567",
"type": "cta_url",
"cta_url": {
"body": {
"text": "شحنتك في الطريق. تابعها لحظة بلحظة."
},
"action": {
"parameters": {
"display_text": "تتبّع الطلب",
"url": "https://example.com/t/1042"
}
}
}
}type: "location"موقع
دبوس باسم وعنوان يُفتح في تطبيق الخرائط لدى المستلم.
latitude وlongitude بالدرجات العشرية.
- WhatsApp Business
- Telegram
{
"channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
"to": "+971501234567",
"type": "location",
"location": {
"latitude": 25.2048,
"longitude": 55.2708,
"name": "نقطة الاستلام",
"address": "شارع الشيخ زايد، دبي"
}
}type: "contacts"جهات اتصال
بطاقة جهة اتصال واحدة أو أكثر. تُمرَّر المصفوفة إلى القناة كما هي، فهي تستخدم صيغة جهات الاتصال الخاصة بالمزوّد.
يعرض المثال صيغة جهات الاتصال في WhatsApp.
- WhatsApp Business
- Telegram
{
"channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
"to": "+971501234567",
"type": "contacts",
"contacts": [
{
"name": {
"formatted_name": "مكتب الدعم",
"first_name": "الدعم"
},
"phones": [
{
"phone": "+971800123456",
"type": "WORK"
}
]
}
]
}type: "poll"استطلاع
استطلاع أصلي في Telegram بسؤال ومجموعة خيارات.
Telegram فقط.
- Telegram
{
"channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
"to": "584201337",
"type": "poll",
"poll": {
"question": "متى تفضّل أن نوصل طلبك؟",
"options": [
"صباحًا، من 09:00 إلى 12:00",
"ظهرًا، من 12:00 إلى 17:00",
"مساءً، من 17:00 إلى 21:00"
]
}
}جرّب كل الأنواع في بيئة الاختبار
لكل حساب قناة تجريبية لكل نوع من القنوات. أرسل أي نوع تدعمه بمفتاح اختبار، ولن يُسلَّم شيء ولن يُحتسب شيء.