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

القنوات

سبعة أنواع من القنوات خلف نقطة نهاية واحدة

OmniMessage بوابة تعمل بقنواتك أنت. تربط جهات الإرسال التي تملكها أصلًا، وتُعنوَن جميعها وتُتتبّع وتُحتسب بالطريقة نفسها.

استخدم قنواتك الخاصة

اربطها مرة واحدة، من لوحة التحكم أو عبر الـ API

تصبح جهة الإرسال المربوطة قناة لها معرّف. وهذا المعرّف هو القيمة الوحيدة الخاصة بالقناة في طلب الإرسال.

  • جهة الإرسال ملكك

    الرقم أو الروبوت أو الحساب مسجّل باسمك لدى المزوّد. ترك OmniMessage لا يعني التخلي عن جهة الإرسال.

  • فاتورتان منفصلتان

    يتقاضى OmniMessage رسم بوابة عن كل رسالة صادرة. وما تفرضه Meta أو Twilio أو أي مزوّد آخر مقابل القناة يُفوتره المزوّد عليك مباشرة.

  • سجّل الدخول أو ألصق بيانات الاعتماد

    تُفوَّض قنوات WhatsApp و Messenger و Instagram بتسجيل الدخول عبر Facebook من لوحة التحكم، وقناة TikTok بتسجيل الدخول عبر TikTok. أما Telegram و SMS و SMS OTP فتُربط ببيانات الاعتماد، من لوحة التحكم أو عبر الـ API، وكذلك رقم WhatsApp الموجود أصلًا على Cloud API.

  • بيانات الاعتماد للكتابة فقط

    تُمرَّر الرموز المميزة والأكواد وبيانات الاعتماد إلى طبقة التسليم عند ربط القناة. لا تخزّنها البوابة ولا يعيدها الـ API أبدًا.

POST /v1/channels
curl https://api.omnimessage.co/v1/channels \
  -H "Authorization: Bearer om_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "type": "whatsapp",
    "name": "Support line",
    "identifier": "+971800123456",
    "credentials": {
      "wab_account_id": "...",
      "phone_number_id": "...",
      "access_token": "..."
    }
  }'
201 Created
{
  "id": "ch_7Hq2mN5vB8cX1zL0pK3j",
  "object": "channel",
  "mode": "live",
  "type": "whatsapp",
  "name": "Support line",
  "identifier": "+971800123456",
  "status": "active",
  "connection_status": "pending",
  "capabilities": ["text", "attachments", "template", "button", "list", "location", "contacts", "cta_url"],
  "created_at": "2026-10-01T08:00:00.000Z"
}

لقنوات WhatsApp و Telegram و SMS و SMS OTP. يتطلب النطاق channels:write. اشترك في الحدثين channel.connected وchannel.disconnected لمتابعة حالة الاتصال.

WhatsApp Business

أرسل من رقم هاتف تملكه على منصة WhatsApp Business (Cloud API). يمرّر OmniMessage رسائلك إلى Cloud API ويبلغك بحالات الإرسال والتسليم والقراءة والفشل.

⁦$0.001⁩ لكل رسالة صادرة، أو رصيد واحد من الباقة

ما تحتاجه
حساب Facebook له صلاحية الوصول إلى حافظة أعمالك في Meta. اختر «المتابعة عبر Facebook» في لوحة التحكم، وسيتولى التسجيل المضمّن من Meta إعداد حساب WhatsApp Business والرقم. ويمكن أيضًا ربط رقم موجود على Cloud API بمعرّفاته ورمز وصول لمستخدم النظام، من لوحة التحكم أو عبر الـ API.
بيانات اعتماد API
wab_account_idphone_number_idaccess_token
نوع القناة
whatsapp
معرّف المُرسِل
رقم هاتف المُرسِل بصيغة E.164، مثل +971800123456.
المستلم (to)
رقم هاتف بصيغة E.164.
معلومات مفيدة
  • خارج نافذة خدمة العملاء البالغة 24 ساعة، لا يقبل WhatsApp إلا رسائل القوالب المعتمدة.
  • اعرض القوالب المعتمدة لقناة ما عبر GET /v1/channels/:id/templates.
  • رسوم المحادثات من Meta تُحتسب على حساب WhatsApp Business الخاص بك، وهي منفصلة عن رسم البوابة.

SMS

أرسل رسائل SMS من رقم هاتف في حسابك على Twilio. استخدمه للإشعارات والتذكيرات والمحادثات في الاتجاهين، مع تسليم الرسائل الواردة إلى Webhook الخاص بك.

⁦$0.0005⁩ لكل رسالة صادرة، أو رصيد واحد من الباقة

ما تحتاجه
حساب Twilio ورقم هاتف مفعّلة عليه خدمة الرسائل.
بيانات اعتماد API
account_sidphone_number_sidauth_token
نوع القناة
sms
معرّف المُرسِل
رقم هاتف المُرسِل بصيغة E.164.
المستلم (to)
رقم هاتف بصيغة E.164.
أنواع الرسائل
نصمرفقات
معلومات مفيدة
  • تتوقف مرفقات الوسائط على ما يدعمه رقمك وشبكة الوجهة.
  • رسوم شركات الاتصالات و Twilio تُحتسب على حسابك في Twilio، وهي منفصلة عن رسم البوابة.

SMS OTP

نوع قناة مخصص لرموز التحقق. يقبل النص العادي فقط، فلا يمكن لمسار تسجيل الدخول أن يرسل عبره شيئًا آخر بالخطأ.

⁦$0.0005⁩ لكل رسالة صادرة، أو رصيد واحد من الباقة

ما تحتاجه
حساب لدى مزوّد رسائل OTP الذي تتعامل معه ومفتاح الـ API الخاص به.
بيانات اعتماد API
api_key
نوع القناة
sms_otp
معرّف المُرسِل
اسم المُرسِل أو الرقم المسجّل لدى مزوّدك.
المستلم (to)
رقم هاتف بصيغة E.164.
أنواع الرسائل
نص
معلومات مفيدة
  • نص فقط. تُرفض المرفقات والأنواع التفاعلية بالخطأ unsupported_message_type.
  • رسوم المزوّد يحتسبها مزوّدك، وهي منفصلة عن رسم البوابة.

Telegram

أرسل عبر روبوت Telegram أنشأته أنت. رمز الروبوت هو بيانات الاعتماد الوحيدة، ومن يراسل الروبوت تصلك رسائله كأحداث message.received.

⁦$0.0003⁩ لكل رسالة صادرة، أو رصيد واحد من الباقة

ما تحتاجه
روبوت Telegram ورمزه من @BotFather. يُقرأ اسم مستخدم الروبوت من Telegram عند الربط.
بيانات اعتماد API
access_token
نوع القناة
telegram
معرّف المُرسِل
اسم مستخدم الروبوت، ويُقرأ من Telegram بواسطة الرمز.
المستلم (to)
معرّف المحادثة في Telegram.
معلومات مفيدة
  • لا يستطيع الروبوت مراسلة شخص إلا إذا بدأ هذا الشخص محادثة معه.
  • معرّف محادثة كل شخص مضمّن في أحداث message.received التي يطلقها.

Messenger

ردّ على من يتواصلون مع صفحتك على Facebook بالنص والوسائط وأزرار الرد. تصل الرسائل الواردة إلى Webhook الخاص بك مع معرّف المُرسِل الذي تحتاجه للرد.

⁦$0.0005⁩ لكل رسالة صادرة، أو رصيد واحد من الباقة

ما تحتاجه
صفحة Facebook وحساب Facebook له تحكم كامل فيها.
طريقة الربط
في لوحة التحكم، اختر «المتابعة عبر Facebook» ثم اختر الصفحة التي سترسل منها.لا توجد بيانات اعتماد تُنسخ لهذا النوع من القنوات، ولا يمكن إنشاؤه بمفتاح API.
نوع القناة
messenger
معرّف المُرسِل
الصفحة التي ترسل منها القناة.
المستلم (to)
معرّف المستخدم الخاص بالصفحة (Page-scoped ID).
أنواع الرسائل
نصمرفقاتأزرار الرد
معلومات مفيدة
  • تصدر المعرّفات الخاصة بالصفحة لكل صفحة على حدة. تصلك ضمن أحداث message.received.
  • تسري سياسات المراسلة لدى Meta على ما يمكنك إرساله ومتى.

Instagram

ردّ على الرسائل المباشرة الواردة إلى حسابك الاحترافي على Instagram بالنص والوسائط وأزرار الرد، عبر نقطة النهاية نفسها التي تستخدمها لكل القنوات.

⁦$0.0005⁩ لكل رسالة صادرة، أو رصيد واحد من الباقة

ما تحتاجه
حساب Instagram احترافي مرتبط بصفحة Facebook تديرها.
طريقة الربط
في لوحة التحكم، اختر «المتابعة عبر Facebook» ثم اختر الصفحة المرتبط بها حسابك على Instagram. لا يمكن ربط الصفحات التي ليس لها حساب احترافي مرتبط.لا توجد بيانات اعتماد تُنسخ لهذا النوع من القنوات، ولا يمكن إنشاؤه بمفتاح API.
نوع القناة
instagram
معرّف المُرسِل
حساب Instagram الذي ترسل منه القناة.
المستلم (to)
معرّف المستخدم الخاص بالصفحة (Page-scoped ID).
أنواع الرسائل
نصمرفقاتأزرار الرد
معلومات مفيدة
  • تصدر المعرّفات لكل حساب على حدة. تصلك ضمن أحداث message.received.
  • تسري سياسات المراسلة لدى Meta على ما يمكنك إرساله ومتى.

TikTok

ردّ على من يراسلون حساب أعمالك على TikTok بالنص والوسائط وأزرار الرد، وتتبّع كل رسالة بالحالات وإشعارات Webhook نفسها.

⁦$0.0005⁩ لكل رسالة صادرة، أو رصيد واحد من الباقة

ما تحتاجه
حساب TikTok Business يمكنك تسجيل الدخول إليه.
طريقة الربط
في لوحة التحكم، اختر «المتابعة عبر TikTok» ووافق على منح الوصول إلى رسائل حساب أعمالك.لا توجد بيانات اعتماد تُنسخ لهذا النوع من القنوات، ولا يمكن إنشاؤه بمفتاح API.
نوع القناة
tiktok
معرّف المُرسِل
حساب TikTok الذي ترسل منه القناة.
المستلم (to)
معرّف المُرسِل الوارد في حدث message.received.
أنواع الرسائل
نصمرفقاتأزرار الرد
معلومات مفيدة
  • تسري سياسات المراسلة لدى TikTok على ما يمكنك إرساله ومتى.

اربط قناتك الأولى

أنشئ حسابًا، وأضف جهة إرسال تملكها أصلًا، وأرسل عبرها بالطلب نفسه الذي جرّبته في بيئة الاختبار.