إرسال رسائل

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

إرسال رسائل إلى قناة واجهة برمجة التطبيقات

لإرسال رسائل إلى قناة API تحتاج إلى فهم أساسي للنماذج والتسميات المستخدمة في بيفاتيل.

دعونا نحاول فهم هذه أولا.

1. القناة: تحدد القناة نوع مصدر المحادثات. على سبيل المثال: Facebook و Twitter و API وما إلى ذلك.

2. البريد الوارد: يمكنك إنشاء مصادر متعددة للمحادثات من نفس نوع القناة. على سبيل المثال: يمكن أن يكون لديك أكثر من صفحة فيسبوك مرتبطة بحساب بيفاتيل.

3. تسمى كل صفحة باسم البريد الوارد في بيفاتيل.

4. المحادثة: المحادثة عبارة عن مجموعة من الرسائل.

5. جهة الاتصال: كل محادثة لها شخص حقيقي مرتبط بها ، ويسمى هذا الشخص جهة اتصال. صناديق البريد الوارد لجهات الاتصال: هذه هي الجلسة لكل جهة اتصال في علبة الوارد.

6. يمكن أن يكون لجهة الاتصال جلسات متعددة ومحادثات متعددة في نفس البريد الوارد.

كيف ترسل رسالة في قناة API؟ لإرسال رسالة في قناة API ، يجب عليك إنشاء جهة اتصال ، ثم إنشاء محادثة ، ثم إرسال رسالة. تتطلب واجهات برمجة التطبيقات api_access_token في رأس الطلب.

يمكنك الحصول على هذا الرمز المميز من خلال زيارة إعدادات ملف التعريف الخاص بك > رمز الوصول

1. إنشاء جهة اتصال

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

{
  "email": "string",
  "name": "string",
  "phone_number": "string",
  "thumbnail": "string",
  "additional_attributes": {},
  "contact_inboxes": [
    {
      "source_id": "string",
      "inbox": {
        "id": 0,
        "name": "string",
        "website_url": "string",
        "channel_type": "string",
        "avatar_url": "string",
        "widget_color": "string",
        "website_token": "string",
        "enable_auto_assignment": true,
        "web_widget_script": "string",
        "welcome_title": "string",
        "welcome_tagline": "string",
        "greeting_enabled": true,
        "greeting_message": "string"
      }
    }
  ],
  "id": 0,
  "availability_status": "string"
}

كما ترى في الحمولة ، ستتمكن من رؤية contact_inboxes وسيكون لكل contact_inbox source_id.

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

2. إنشاء محادثة

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

{
  "id": 0
}

3. إنشاء رسالة جديدة

هناك 2 أنواع من الرسائل:

الرسائل الواردة: يتم تصنيف الرسائل المرسلة من قبل المستخدم كرسالة واردة

الرسائل الصادرة: يتم تصنيف الرسائل المرسلة من قبل الوكيل كرسالة صادرة.

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

{
    "id": 0,
    "content": "This is a incoming message from API Channel",
    "inbox_id": 0,
    "conversation_id": 0,
    "message_type": 0,
    "content_type": null,
    "content_attributes": {},
    "created_at": 0,
    "private": false,
    "sender": {
        "id": 0,
        "name": "Pranav",
        "type": "contact"
  }  }

إذا كان كل شيء ناجحا ، فسترى المحادثة على لوحة التحكم على النحو التالي.

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