انتقل إلى المحتوى

أنواع الرسائل

تسعة أنواع من الرسائل بنص طلب واحد

يحدد طلب الإرسال قناة ومستلمًا ونوعًا، ويوضع المحتوى تحت مفتاح يحمل اسم النوع. تعرض هذه الصفحة كل نوع، ونص الطلب الذي ينتجه، والقنوات التي تدعمه.

جدول الدعم

أي قناة تقبل أي نوع

تُعلن كل قناة ما تقبله في capabilities. إرسال نوع لا تدعمه القناة يعيد 400 unsupported_message_type ولا يُخصم شيء.

دعم أنواع الرسائل حسب نوع القناة
النوعWhatsAppSMSSMS OTPTelegramMessengerInstagramTikTok
نص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
  • Instagram
  • TikTok
POST /v1/messages
{
  "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
  • Instagram
  • TikTok
POST /v1/messages
{
  "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
POST /v1/messages
{
  "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: "button"

أزرار الرد

رسالة بثلاثة ردود سريعة كحد أقصى. يعود معرّف الزر الذي ضُغط إلى Webhook الخاص بك في حدث message.received.

من 1 إلى 3 أزرار. title: حتى 20 حرفًا.

  • WhatsApp Business
  • Telegram
  • Messenger
  • Instagram
  • TikTok
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "button",
  "button": {
    "body": {
      "text": "تم حجز طاولتك لشخصين الليلة في الساعة 19:30. هل ما زال الموعد يناسبك؟"
    },
    "action": {
      "buttons": [
        {
          "reply": {
            "id": "confirm",
            "title": "تأكيد"
          }
        },
        {
          "reply": {
            "id": "reschedule",
            "title": "تغيير الموعد"
          }
        },
        {
          "reply": {
            "id": "cancel",
            "title": "إلغاء الحجز"
          }
        }
      ]
    }
  }
}
type: "list"

قائمة

قائمة تُفتح من زر واحد، بصفوف مجمّعة في أقسام معنونة.

action.button: حتى 20 حرفًا.

  • WhatsApp Business
POST /v1/messages
{
  "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
POST /v1/messages
{
  "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
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "location",
  "location": {
    "latitude": 25.2048,
    "longitude": 55.2708,
    "name": "نقطة الاستلام",
    "address": "شارع الشيخ زايد، دبي"
  }
}
type: "contacts"

جهات اتصال

بطاقة جهة اتصال واحدة أو أكثر. تُمرَّر المصفوفة إلى القناة كما هي، فهي تستخدم صيغة جهات الاتصال الخاصة بالمزوّد.

يعرض المثال صيغة جهات الاتصال في WhatsApp.

  • WhatsApp Business
  • Telegram
POST /v1/messages
{
  "channel": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "to": "+971501234567",
  "type": "contacts",
  "contacts": [
    {
      "name": {
        "formatted_name": "مكتب الدعم",
        "first_name": "الدعم"
      },
      "phones": [
        {
          "phone": "+971800123456",
          "type": "WORK"
        }
      ]
    }
  ]
}
type: "poll"

استطلاع

استطلاع أصلي في Telegram بسؤال ومجموعة خيارات.

Telegram فقط.

  • Telegram
POST /v1/messages
{
  "channel": "ch_4Tn8rW2yK6dF9sA1mQ5v",
  "to": "584201337",
  "type": "poll",
  "poll": {
    "question": "متى تفضّل أن نوصل طلبك؟",
    "options": [
      "صباحًا، من 09:00 إلى 12:00",
      "ظهرًا، من 12:00 إلى 17:00",
      "مساءً، من 17:00 إلى 21:00"
    ]
  }
}

جرّب كل الأنواع في بيئة الاختبار

لكل حساب قناة تجريبية لكل نوع من القنوات. أرسل أي نوع تدعمه بمفتاح اختبار، ولن يُسلَّم شيء ولن يُحتسب شيء.