أنواع رسائل WhatsApp On-Premise المدعومة | WOZTELL

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

فيما يلي قائمة بأنواع الرسائل المدعومة التي يمكن إرسالها عبر WhatsApp On-Premise:

نص

رسالة نصية على WhatsApp
رسالة نصية على WhatsApp
{
"type": "TEXT",
"text": "مرحبا بالعالم!",
}
نسخ
الخاصية الوصف مطلوب
type TEXT نعم
text سلسلة نصية؛ الحد الأقصى 2000 حرف نعم


صورة

صورة WhatsApp
صورة WhatsApp
صورة WhatsApp
صورة WhatsApp
{
"type": "IMAGE",
"text": "أنا Sanuker!",
"attachment_id": "289832336612941",
}
نسخ
الخاصية الوصف مطلوب
type IMAGE نعم
text سلسلة نصية؛ تعليق على الصورة لا
attachment_id معرف الوسائط للصورة نعم (أو url)
url رابط الصورة نعم (أو attachment_id)
نصيحة
  • يجب أن تكون الصورة بتنسيق صورة صالح:  .jpeg أو .png
  • يجب أن تكون الصورة 8-بت ، RGB أو RGBA
  • الحد الأقصى لحجم الملف هو 5MB


صوت

رسالة صوتية على WhatsApp
رسالة صوتية على WhatsApp
{
"type": "AUDIO",
"attachment_id": "668795277867495"
}
نسخ
الخاصية الوصف مطلوب
type AUDIO نعم
attachment_id معرف الوسائط للصوت نعم (أو url)
url رابط الصوت نعم (أو attachment_id)
نصيحة
  • يجب أن يكون الصوت بتنسيق ملف صوتي صالح، بما في ذلك .aac، mp4، mpeg، amr، ogg (يدعم فقط ترميزات opus، لا يدعم قاعدة ogg)
  • الحد الأقصى لحجم الملف هو 16MB


فيديو

فيديو WhatsApp
فيديو WhatsApp
فيديو WhatsApp
فيديو WhatsApp
{
"type": "VIDEO",
"attachment_id": "496729438556614",
"text": "TEXT"
}
نسخ
الخاصية الوصف مطلوب
type VIDEO نعم
text سلسلة نصية؛ تعليق على الفيديو لا
attachment_id معرف الوسائط للفيديو نعم (أو url)
url رابط الفيديو نعم (أو attachment_id)
نصيحة
  • يجب أن يكون الفيديو بتنسيق ملف فيديو صالح، بما في ذلك mp4 و 3gp.
  • الحد الأقصى لحجم الملف هو 16MB.
  • يدعم فقط H.264 لفيديو والكود الصوتي AAC.
  • يدعم الفيديو مع مسار صوتي واحد أو بدون مسار صوتي


ملصق

ملصق WhatsApp
ملصق WhatsApp
{
"type": "STICKER",
"attachment_id": "1030335650902052"
}
نسخ
الخاصية الوصف مطلوب
type VIDEO نعم
url رابط الملصق نعم (أو attachment_id)
attachment_id معرف الوسائط للملصق نعم (أو url)
نصيحة
  • يجب أن يكون تنسيق الصورة webp وبأبعاد 512x512 بيكسل
  • الحد الأقصى لحجم الملف للملصق الثابت:  100KB
  • الحد الأقصى لحجم الملف للملصق المتحرك:  500KB


ملف

ملف WhatsApp
ملف WhatsApp
ملف WhatsApp
ملف WhatsApp
{
"type": "FILE",
"filename": "TEXT",
"attachment_id": "496729438556614"
}
نسخ
الخاصية الوصف مطلوب
type FILE نعم
filename سلسلة نصية؛ اسم معاينة الملف لا
url رابط الملف نعم (أو attachment_id)
attachment_id معرف الوسائط للملف نعم (أو url)
نصيحة
  • يجب أن يكون الملف بتنسيق ملف صالح، بما في ذلك plain، pdf، vnd.ms-powerpoint، msword1، vnd.ms-excel، vnd.openxmlformats-officedocument.wordprocessingml.document، vnd.openxmlformats-officedocument.presentationml.presentation، vnd.openxmlformats-officedocument.spreadsheetml.sheet.
  • الحد الأقصى لحجم الملف هو 100MB


الموقع

موقع WhatsApp
موقع WhatsApp
{
"type": "LOCATION",
"location": {
"name": "شركة ABC",
"address": "الغرفة C، الطابق الأول، مبنى DFG، 101 طريق قوس قزح",
"lat": "22.31586918460027",
"long": "114.20883121469535"
}
}
نسخ
الخاصية الوصف مطلوب
type LOCATION نعم
name سلسلة نصية؛ اسم الموقع لا
address سلسلة نصية؛ عنوان الموقع لا
lat خط العرض نعم
long خط الطول نعم


جهة اتصال

{
"type": "CONTACTS",
"contacts": [
{
"id": "YXpJfusT",
"name": {
"formatted_name": "جون لي",
"first_name": "جون",
"last_name": "لي",
"prefix": "السيد"
},
"addresses": [
{
"type": "work",
"city": "هونغ كونغ",
"street": "طريق قوس قزح 131، مبنى ABC"
}
],
"emails": [
{
"type": "work",
"email": "workmail123@gmail.com"
}
],
"phones": [
{
"type": "main",
"phone": "+1 413-252-1446",
"wa_id": "14132521446"
}
],
"urls": [
{
"type": "work",
"url": "www.sanuker.com"
}
],
"org": {
"company": " Sanuker"
}
}
]
}
الخاصية الوصف مطلوب
name سلسلة نصية؛ اسم جهة الاتصال نعم
address سلسلة نصية؛ عنوان جهة الاتصال لا
birthday سلسلة نصية؛ تاريخ لا
emails سلسلة نصية؛ عنوان البريد الإلكتروني لا
org سلسلة نصية؛ اسم الشركة لا
phones سلسلة نصية؛ رقم الهاتف لا
urls سلسلة نصية؛ رابط لا
ملاحظة

داخل كائن phones يجب تعبئة كل من phone و wa_id حتى يتمكن WhatsApp من التعرف عليها كحساب تجاري صالح للتواصل.

وإلا فسيتم عرض نص "دعوة إلى WhatsApp" فقط.

"phones": [
{
"type": "main",
"phone": "+1 413-252-1446",
"wa_id": "14132521446"
}
]
نسخ


كل كائن داخل Contact يحتوي على واحد أو أكثر من المعلمات الاختيارية، يمكنك الرجوع إلى هنا للمزيد من التفاصيل.



تفاعل

تفاعل WhatsApp
تفاعل WhatsApp
{
"type": "REACTION",
"message_id": "wamid.HBgLODUyNTQwNjM1OTgVAgASGBQzRUIwOTVERkZCRDIwODg5REQwMAA=",
"emoji": "😊"
},
نسخ
الخاصية الوصف مطلوب؟
type REACTION نعم
message_id المعرف لتحديد الرسالة التي سيتم التفاعل معها نعم
emoji الإيموجي المستخدم كرد فعل؛ يمكن أن يكون الإدخال هو الإيموجي نفسه أو في الترميز Unicode الهروب i.e. \uD83D\uDE0A نعم
ملاحظة

يمكن الحصول على معرف الرسالة السابقة من حدث الرسالة في السجلات أو باستخدام ApiScope.chat في Open API.

على سبيل المثال:

query chat {
apiViewer{
conversationHistory (first: 10, platform: "whatsapp-cloud", memberId: "999abe6524f9db0009963008") {
edges{
node{
memberId
messageEvent
}
}
}
}
}
نسخ


الرسائل التفاعلية

تسمح الرسائل التفاعلية للمستخدمين بالرد بسرعة من خلال توفير أزرار يمكن النقر عليها. لا يمكن للمستخدمين اختيار أكثر من خيار واحد في نفس الوقت من قائمة أو رسالة زر، ولكن يمكنهم العودة وإعادة فتح رسالة سابقة.

رسائل القائمة

رسالة قائمة - 1
رسالة قائمة - 1
رسالة قائمة - 2
رسالة قائمة - 2
{
"type": "WHATSAPP_LIST",
"header": {
"type": "text",
"text": "مرحباً 👋🏻"
},
"body": {
"text": "توفر Sanuker حلول روبوتات الدردشة."
},
"footer": {
"text": "شريك الأعمال الرسمي لفيسبوك وواتساب"
},
"action": {
"button": "القائمة",
"sections": [
{
"title": "عنوان القسم",
"rows": [
{
"payload": "التحيات",
"title": "القائمة الرئيسية",
"description": "مرحباً!"
},
{
"payload": "عن Sanuker",
"title": "عن Sanuker",
"description": "من أنت؟"
}
]
}
]
}
}
الخاصية الوصف مطلوب
Header رأس رسالة القائمة الخاصة بك، يُسمح فقط بالنص لرسالة القائمة لا
Body محتوى جسم الرسالة (حد أقصى 1024 حرفًا) نعم
Footer محتوى التذييل (حد أقصى 60 حرفًا) لا
Action داخل الإجراء، يجب تضمين:
- حقل زر بمحتوى الزر الخاص بك، و
- كائن قسم واحد على الأقل (الحد الأقصى 10)

داخل القسم، يجب إضافة كائن صف واحد على الأقل
نعم

action كائن

الخاصية الوصف مطلوب؟
button محتوى الزر. لا يمكن أن يكون سلسلة فارغة ويجب أن يكون فريدًا داخل الرسالة (الحد الأقصى 20 حرفًا) نعم
sections مصفوفة كائنات الأقسام. هناك حد أدنى 1 وحد أقصى 10 نعم

section كائن

الخاصية الوصف مطلوب؟
title عنوان القسم نعم (إذا كانت الرسالة تحتوي على أكثر من قسم.)
rows تحتوي على قائمة الصفوف. يجب أن يحتوي كل صف على عنوان ومعرف. يمكنك إضافة وصف، لكنه اختياري نعم

أزرار الرد

زر الرد
زر الرد
{
"type": "WHATSAPP_REPLY_BUTTONS",
"header": {
"type": "image",
"image": {
"id": "2e5a7aad-e8c7-43ba-ad5e-b298bb32f8af"
}
},
"body": {
"text": "توفر Sanuker حلول روبوتات الدردشة."
},
"footer": {
"text": "شريك الأعمال الرسمي لفيسبوك وواتساب"
},
"action": {
"buttons": [
{
"type": "reply",
"reply": {
"payload": "GREETINGS",
"title": "القائمة الرئيسية"
}
},
{
"type": "reply",
"reply": {
"payload": "ABOUT_SANUKER",
"title": "عن Sanuker"
}
}
]
}
}
الخاصية الوصف مطلوب
Header رأس رسالة قائمتك؛ يمكن أن يكون نصًا أو وسائط: "صورة"، "فيديو"، "وثيقة" لا
Body محتوى جسم الرسالة (حد أقصى 1024 حرفًا) نعم
Footer محتوى التذييل (حد أقصى 60 حرفًا) لا
Action يجب عليك إضافة زر واحد على الأقل، ويجب تضمين النوع والعنوان. لا يمكنك إضافة أكثر من 3 أزرار نعم

action كائن

الخاصية الوصف مطلوب؟
buttons يمكن أن يحتوي الزر على المعلمات التالية:
type: النوع المدعوم الوحيد هو الرد (لرسائل زر الرد)
title: عنوان الزر. لا يمكن أن يكون سلسلة فارغة ويجب أن يكون فريدًا داخل الرسالة (الحد الأقصى 20 حرفًا)
نعم


رسالة منتج فردي

{
"type": "PRODUCT",
"action": {
"type": "single",
"catalog_id": "1134377510532066",
"product_retailer_id": "03-Pack"
},
"body": {
"text": "اطلع على حقيبة اليوم الخاصة بنا"
}
}
الخاصية الوصف مطلوب
body محتوى جسم الرسالة (حد أقصى 1024 حرفًا) لا
footer محتوى التذييل (حد أقصى 60 حرفًا) لا
action يجب أن يحتوي على
- يجب أن يكون single لرسالة منتج فردي.
- catalogId: معرف الكتالوج الذي تريد استخدامه لهذه الرسالة. استرجع هذا المعرف عبر مدير التجارة.
- productId: معرف المنتج الفريد (معرف المحتوى).
نعم

رسالة منتجات متعددة

نصيحة

يمكن أن تحتوي رسالة المنتجات المتعددة فقط على اختيار يصل إلى 30 منتجًا من المخزون.


{
"type": "PRODUCT",
"header": {
"type": "text",
"text": "مجموعة الخريف"
},
"action": {
"type": "multi",
"catalog_id": "1134377510532066",
"sections": [
{
"title": "الأساسيات الحضرية"
"product_items": [
"01-Pack",
"02-Bag"
]
},
{
"title": "أساسيات التنزه"
"product_items": [
"03-Pack"
]
}
]
},
"body": {
"text": "انقر لعرض العناصر لرؤية مجموعة الخريف الخاصة بنا"
}
}
الخاصية الوصف مطلوب
header type يجب أن يكون text. يحتوي على كائن نصي بالمحتوى المطلوب نعم
body محتوى التذييل (حد أقصى 1024 حرفًا) نعم
footer محتوى التذييل (حد أقصى 60 حرفًا) لا
action يجب أن يحتوي على
- type: يجب أن يكون multi لرسالة المنتجات المتعددة.
- catalogId: معرف الكتالوج الذي تريد استخدامه لهذه الرسالة. استرجع هذا المعرف عبر مدير التجارة
- sections: مصفوفة كائنات الأقسام. يجب أن تتضمن قسمًا واحدًا على الأقل
نعم

sections حقل:

الخاصية الوصف مطلوب
title عنوان لكل قسم نعم
product_items product_retailer_id: معرف المنتج الفريد (معرف المحتوى) نعم


قالب رسالة WhatsApp

قالب رسالة WhatsApp
قالب رسالة WhatsApp
{
"type": "TEMPLATE",
"components": [
{
"parameters": [
{
"image": {
"id": "57ec1287-6915-4a44-8dc9-9caa620385e1"
},
"type": "image"
}
],
"type": "header"
},
{
"type": "button"
}
]
}

تفاصيل القالب

الخاصية الوصف مطلوب؟
Name يمكن أن يحتوي فقط على أحرف أبجدية رقمية صغيرة وشرطات سفلية (_)؛ لا يُسمح بأي أحرف أو مسافات أخرى نعم
Category حدد الفئة الصحيحة للقالب الخاص بك؛ راجع قائمة الفئات المدعومة نعم
Language حدد اللغة الصحيحة للقالب الخاص بك؛ سيكون اسم القالب نفسه لجميع الترجمات؛ ستحدد حقل اللغة عند إرسال القالب؛ راجع قائمة اللغات المدعومة نعم
Content محتوى قالب الرسالة الخاص بك؛ دعم عناصر نائب للمعلمات بصيغة {{1}} نعم
Header رأس قالب الرسالة الخاص بك؛ يمكن أن يكون نصًا أو وسائط: "صورة"، "فيديو"، "وثيقة" لا
Body جسم قالب الرسالة الخاص بك (حد الحروف: 1024) نعم
Footer تذييل النص الخاص بقالب الرسالة لا
Buttons زر أو أزرار قالب الرسالة الخاصة بك؛ استدعاء للعمل أو رد سريع؛ 3 أزرار كحد أقصى. لا

الحد الأقصى لعدد الأحرف

الخاصية حد الأحرف
الجسم (بدون رأس / تذييل) حتى 1024 حرفًا
الجسم (مع رأس / تذييل) حتى 160 حرفًا
رأس حتى 60 حرفًا
تذييل حتى 60 حرفًا

يرجى التنويه إلى أنه، ضمن قالب رسالة WhatsApp، لا ينطبق حد الأحرف على المتغير.

إجراءات الإعداد

  1. افتح "منشئ الردود" واختر نوع الرد "قالب رسالة WhatsApp".
إنشاء رد قالب رسالة WhatsApp
إنشاء رد قالب رسالة WhatsApp
  1. اختر أي "قالب رسالة" موجود مسبقًا. يرجى التأكد من إتمام عملية تقديم قالب الرسالة لعرض القوالب الموجودة لديك.

  2. قم بتعيين سياسة اللغة إلى حتمية.

  3. اختر لغة قالب الرسالة الخاص بك.

  1. يرجى مراجعة الإعدادات الاختيارية أدناه:
  • أضف الحمولة إذا كان لقالب الرسالة الخاص بك زر رد سريع.
إضافة أزرار الحمولة إلى قالب رسالة WhatsApp
إضافة أزرار الحمولة إلى قالب رسالة WhatsApp
  • أضف معرف الوسائط أو الرابط إذا كان للرأس الخاص بك ملفات وسائط متعددة مثل الصور أو الفيديو.
إضافة وسائط إلى قالب رسالة WhatsApp
إضافة وسائط إلى قالب رسالة WhatsApp


الرد على

يمكنك إرسال رسالة كرد على رسالة سابقة في المحادثة. سيتم اقتباس الرسالة السابقة في الفقاعة السياقية وسيتم عرضها مع رسالة الرد.

أثناء إرسال أي رسائل إلى مستخدم WhatsApp، تحتاج إلى إضافة الخاصية reply_to وتحديد الرسالة السياقية باستخدام Message ID

{
"type": "TEXT",
"text": "مرحباً! كيف الحال؟",
"reply_to": "wamid.HBgLODUyNTQwNjM1OTgVAgASGBQzRUIwQjBGOTBBREU1QTgzQkRFQwA="
}
الخاصية الوصف مطلوب
reply_to معرف رسالة الرسالة التي سيتم الرد عليها نعم
ملاحظات
  • يمكن فقط اقتباس الرسائل التي لا يتجاوز عمرها 30 يومًا في الفقاعة السياقية. وإلا، سيتم إرسال الرسالة بشكل طبيعي بدلاً من كونها ردًا.
  • لن يرى المستلمون الفقاعة السياقية إذا كانت رسالة الرد قالب رسالة.
  • لن يرى المستلمون على KaiOS الفقاعة السياقية إذا كانت رسالة الرد صورة أو فيديو أو صوت أو رسالة تسجيل صوتي (PTT).
  • يمكن الحصول على معرف الرسالة السابقة من حدث الرسالة في السجلات أو باستخدام ApiScope.chat في Open API.

على سبيل المثال:

query chat {
apiViewer{
conversationHistory (first: 10, platform: "whatsapp-cloud", memberId: "999abe6524f9db0009963008") {
edges{
node{
memberId
messageEvent
}
}
}
}
}