قناة مخصصة للبدء السريع

يسمح هذا التكامل لفريقك بالدردشة مع عملائك عبر أي قناة مراسلة عبر تنفيذ مخصص.

توصيل قناة مخصصة

الخطوة 1: انتقل إلى الإعدادات > القنوات

الخطوة 2: انقر أضف قناة > قناة مخصصة > الاتصال

الخطوة 3: أدخل عنوان URL Webhook الوجهة حيث سيتم إرسال الرسائل الصادرة.

الخطوة 4: حدد نوع المعرف للقناة > انقر التالي

يتم استخدام أنواع الهوية لتحديد هوية المستخدم وتستخدم للاتصال بخادم التكامل المخصص الخاص بك.

هناك نوعان من معرفات الهوية المتاحة:

1. رقم الهاتف: استخدم هذا إذا كان موفر خدمة المراسلة يتعرف على جهات الاتصال استناداً إلى رقم هاتفهم.

   1. تنسيق العينة: +60177872890

2. معرف مخصص: استخدم هذا إذا كان موفر خدمة المراسلة يتعرف على جهات الاتصال استناداً إلى معرف تم إنشاؤه خصيصاً.

   1. الحد الأقصى لطول الحرف هو 50.

   2. A-Z،a-z،0-9،_،=،+،/و@مسموح بها.

الخطوة 5: سيوفر مربع الحوار التاليمعرف القناة،API Token، وWebhook URL على سبيل المثال.

1. معرف القناة:gfd8g7fd89dgfd

2. API Token:aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd

3. رابط Webhook:https://app.respond.io/custom/channel/webhook/

   يتيح لك استخدام نوع معرف رقم الهاتف بدء محادثة وإرسال الرسالة الأولى إلى جهة اتصال.

نقل الرسائل إلى respond.io.

يتم استخدام عنوان URL لـ Webhook لنشر الرسائل وصدى الرسائل وإيصالات الرسائل على منصة respond.io.

سيتم تشغيل الكود المقدم على webhook على respond.io، وسيتم إنشاء جهة اتصال إذا لزم الأمر، وحفظ الرسالة تحت تلك الجهة.

عينة للرسائل.

curl -X POST \\  
  https://app.respond.io/custom/channel/webhook/ \\  
  -H 'التفويض: الناقل aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \\  
  -H 'التحكم في ذاكرة التخزين المؤقت: لا ذاكرة تخزين مؤقت' \\  
  -H 'نوع المحتوى: application/json' \\  
  -d '{  
  "معرف القناة": "gfd8g7fd89dgfd",  
  "معرف جهة الاتصال": "+60177872890",  
  "الأحداث": \[  
    {  
      "النوع": "رسالة"،  
      "معرف الطالب": "xcvzzxcxczxczxc"،  
      "الطابع الزمني": 2132131321000،  
      "رسالة": {  
        "النوع": "نص"،  
        "نص": "مرحباً بالعالم"  
      }  
    }  
  \]،  
  "جهة الاتصال": {  
    "الاسم الأول": "جون"،  
    "اسم العائلة": "دو"،  
    "صورة الملف الشخصي": ""،  
    "رمز البلد": "MY"،  
    "البريد الإلكتروني": "[email protected]"،  
    "الهاتف": "+60177872890"،  
    "اللغة": "en"  
  }  
}'

عينة لتكرار الرسائل.

curl -X POST \\  
  https://app.respond.io/custom/channel/webhook/ \\  
  -H 'التفويض: الناقل aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \\  
  -H 'التحكم في ذاكرة التخزين المؤقت: لا ذاكرة تخزين مؤقت' \\  
  -H 'نوع المحتوى: application/json' \\  
  -d '{  
  "معرف القناة": "gfd8g7fd89dgfd",  
  "معرف جهة الاتصال": "+60177872890",  
  "الأحداث": \[  
    {  
      "النوع": "رسالة\_صدى"،  
      "معرف الرسالة": "xcvzzxcxczxczxc"،  
      "الطابع الزمني": 2132131321000،  
      "الرسالة": {  
        "النوع": "نص"،  
        "نص": "مرحباً بالعالم"  
      }  
    }  
  \]،  
  "جهة الاتصال": {  
    "الاسم الأول": "جون"،  
    "اسم العائلة": "دو"،  
    "صورة الملف الشخصي": "",  
    "رمز البلد": "MY"،  
    "البريد الإلكتروني": "[email protected]"،  
    "الهاتف": "+60177872890"،  
    "اللغة": "en"  
  }  
}'

عينة لإيصالات المراسلة.

curl -X POST \\  
  https://app.respond.io/custom/channel/webhook/ \\  
  -H 'authorization: Bearer aaaxczsadzxcasdacxzcasdaaaxczsadzxcasdacxzcasd' \\  
  -H 'cache-control: no-cache' \\  
  -H 'content-type: application/json' \\  
  -d '{  
  "channelId": "gfd8g7fd89dgfd",  
  "contactId": "+60177872890",  
  "events": \[  
    {  
      "type": "message\_status"،  
      "mId": "xcvzzxcxczxczxc"،  
      "timestamp": 2132131321000،  
      "status": {  
        "value": "sent|delivered|read|failed"،  
        "message": "Error: Sending failed due to invalid token"  
      }  
  \]  
}'

الحقل	الوصف	المصادقة
معرف القناة.	معرف القناة الفريدة	مطلوب. حقل فريد. يولدها المجيب.يو.
معرف جهة الاتصال.	معرف جهة اتصال فريد	مطلوب. فريد الرد. io معرّف جهة الاتصال. الحد الأقصى 50 حرفاً.
الأحداث.نوع	نوع الحدث	مطلوب. النوع المتوفر: رسالة، رسالة صدى، وحالة الرسالة.
الأحداث.mld	معرف الرسالة	مطلوب. معرف الرسالة الفريد. الحد الأقصى 50 حرفاً.
الأحداث.timestamp	UNIX Epoch الوقت (بالمللي ثانية)	مطلوب. وقت الحدث الذي أدى إلى إعادة المكالمة.
الأحداث.message.type	نوع الرسالة	مطلوب. أنواع الرسائل المتاحة: النص والمرفق والموقع والرد السريع. ارجع قسم نوع الرسالة لعينات نوع الرسالة الأخرى.
الأحداث.message.text	نص الرسالة	مطلوب. أقصى طول 7000 حرف.
الأحداث.status.value	نص	مطلوب إذا كان نوع الحدث هو حالة الرسالة. قيم الحالة المتاحة: تم إرسالها وتسليمها وقراءتها وفشلها.
events.status.message يجب أن تكون أحداث.	نص	مطلوب إذا فشلت الأحداث.status.value.
اتصل بالاسم الأول	الاسم الأول	اختياري. الحد الأقصى 50 حرفاً.
contact.lastName يجب أن تترجم إلى: اسم العائلة.	اسم العائلة	اختياري. الحد الأقصى 50 حرفاً.
contact.profilePic يجب أن تترجم.	صورة الملف الشخصي رابط يجب أن تترجم إلى: رابط صورة الملف الشخصي.	اختياري. يجب ألا يتجاوز حجم الصورة الرمزية 100 كيلوبايت. 720x720 يجب أن تكون 720×720.
جهات الاتصال يجب أن يكون جهة الاتصال.	رمز اللغة يجب أن يكون: رمز اللغة.	اختياري. راجع هنا لقائمة القيم.
contact.countryCode يجب أن تترجم.	رمز البلد	اختياري. رمز البلد المكون من حرفين - رمز ISO ALPHA-2.
contact.timezone يجب أن تترجم.	المنطقة الزمنية	اختياري. (الحد الأدنى: -24) (الحد الأقصى: 24).
الاتصال بالبريد الإلكتروني	عنوان البريد الإلكتروني	اختياري. الحد الأقصى 50 حرفاً.
contact.phone يجب أن تترجم.	رقم الهاتف	اختياري. الحد الأقصى 18 حرفاً.
لغة الاتصال	اللغة	اختياري. ISO 639-1.

الرد - النجاح (حالة HTTP → 200)

"موافق"

التعامل مع الرسائل الصادرة من المجيب.io

جواب.io سيتصل بنقطة النهاية<API Base URL>/message

تأكد من تطبيق الرمزرسالة صادرةعلى المسار/messageلخادم الويب الخاص بك.

إليك مثال cURL من المجيب.io الذي يستدعي النقطة النهائية:

يجب أن تتجنب ترجمة كود إلى النص العربي.

الرد - النجاح (حالة HTTP → 200)

{  
	"mId": "1640141607842"  
}

يجب أن تحدث المصادقة عند نقطة النهاية قبل إرسال الرسالة إلى مزود خدمة المراسلة.

يجب أن تتجنب ترجمة كود إلى النص العربي.

يجب أن تتجنب ترجمة كود إلى النص العربي.

يجب أن تتجنب ترجمة كود إلى النص العربي. شاهد مشروعنا GitHub هنا.

نوع الرسائل

عينة للنص

مرحبا بـ respond.io ومرحبا بك يجب أن تكون: "مرحبا بك في respond.io".

الحقل	الوصف	المصادقة
نوع	نوع الرسالة	مطلوب. نص
نص	نص الرسالة	مطلوب. أقصى طول 7000 حرف.

عينة لملف الوسائط

يجب أن تتجنب ترجمة كود إلى النص العربي.

الحقل	الوصف	المصادقة
نوع	نوع الرسالة	مطلوب. مرفق.
مرفق.نوع	نوع المرفق	مطلوب. أنواع المرفقات المتاحة: الصورة، الفيديو، الصوت والملفات.
رابط المرفق	عنوان ويب	مطلوب. الحد الأقصى 2000 حرف. تأكد من أنه رابط عام حتى يتمكن المستخدمون أو جهات الاتصال من رؤية المحتوى.
نوع المرفق	نوع MIME للمرفق	اختياري
اسم المرفق	اسم الملف	اختياري. يجب أن يتضمن اسم الملف امتدادا. الحد الأقصى 256 حرف (بما في ذلك امتداد الملف). إرسال ملف بدون ملحق أو مع ملحق خاطئ قد يتسبب في عدم تمكن جهة الاتصال أو المستخدم من فتح الملف.
وصف المرفق	وصف الملف	اختياري. الحد الأقصى 256 حرفاً. ينطبق فقط على المرفقات.نوع = الصورة.

تأكد من عدم تحميل عنوان URL المرفق تلقائيًا بواسطة المتصفح. يجب أن يحتوي رأس Content-Disposition للاستجابة HTTP على القيمة الافتراضية، وهي inline.

عينة للموقع

{  
  "type": "location",  
  "latitude": 0.123456,  
  "longitude": -0.1234,  
  "address": "Sky Suites, Jalan P. Ramlee, Kuala Lumpur, 50250 Kuala Lumpur, Wilayah Persekutuan Kuala Lumpur"  
}

الحقل	الوصف	المصادقة
نوع	نوع الرسالة	مطلوب. الموقع.
خط العرض	الإحداثيات	مطلوب. خط العرض (± 90 درجة مئوية) ضمن نطاقات صالحة.
خط العرض.	الإحداثيات	مطلوب. الطول (± 180) ضمن نطاقات صالحة.
العنوان	عنوان الموقع	اختياري. الحد الأقصى 256 حرفاً.

عينة للرد السريع

عينة رد سريع.

الحقل	الوصف	المصادقة
نوع	نوع الرسالة	مطلوب. رد سريع.
العنوان	عنوان الرد السريع	مطلوب. الحد الأقصى 256 حرفاً.
الردود	نص الرد	مطلوب. الحد الأقصى 10 ردود بحد أقصى 256 حرف لكل رد.

رموز الخطأ

Error (HTTP Status → 4xx)

تكوين القناة

الخطوة 1: انقر الإعدادات > قنوات

الخطوة 2: تحديد موقع القناة المخصصة > انقر إدارة

الخطوة 3: في صفحة تكوين القناة المخصصة سترى الإعدادات التالية:

• أيقونة القناة - تحميل صورة تستخدم كأيقونة لقناتك المخصصة.

• اسم القناة - يمكن تغيير اسم القناة واستخدامها داخليا لتحديد القناة.

• رابط Webhook للرسالة الصادرة — عنوان ويب هوك للرسائل الصادرة إلى هذه القناة.

• رابط Webhook للرسالة الواردة — عنوان ويب هوك للرسائل الواردة إلى هذه القناة.

• ID Type - هذه تستخدم لتحديد هوية المستخدم وتستخدم للتواصل مع خادم التكامل المخصص الخاص بك.

• معرف القناة - معرف القناة الفريدة لتحديد قناتك المخصصة.

• API Token - معرف فريد يستخدم لمصادقة مستخدم للوصول إلى واجهة برمجة التطبيقات.

الخطوة 4: انقر فوق حفظ التغييرات لتحديث تكوين القناة المخصصة.

الأسئلة الشائعة واستكشاف الأخطاء

هل يمكنني توصيل الدردشات من منصات أخرى باستخدام قناة مخصصة؟

نعم، يمكنك. إليك ثلاث خطوات يجب اتباعها:

1. في respon.io، أدخل مقصد URL webhook من المنصة الأخرى إلى حقل Webhook للرسائل الواردة.

2. في المنصة الأخرى، قم بإعداد رابط webhook للإشارة إلى respon.io، مما يسمح لجهات الاتصال بإرسال الرسائل إليك.

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

تأكد من تأكيد المنصة الأخرى بأن الخطوتين الأولتين قابلتين للتنفيذ.

أسئلة متكررة حول Webhooks للقناة المخصصة.

لماذا يعيد الويبهوك وضع 200 حتى لو لم يتم تسليم الرسالة إلى الرد.io؟

عند توصيل قناة مخصصة، ستعيد الرسائل المرسلة إلى respond.io عبر webhooks دائمًا رمز حالة 200 على الفور، بغض النظر عما إذا كانت الرسالة قد تسلمت بنجاح إلى respond.io. ويرجع ذلك إلى طبيعة الـ Webhooks، المصممة لإعادة استجابة فورية دون التحقق من نجاح تسليم الرسالة.