مكونات المحادثات

مكونات المحادثات هي ميزات داخل الدردشة يمكنك تمكينها في أرقام هواتف النشاط التجاري. تسهل تفاعل مستخدمي واتساب مع النشاط التجاري. يمكنك تكوين أوامر سهلة الاستخدام وتوفير أدوات مكتوبة مسبقًا لتمهيد التفاعل وتشجيعه يمكن للمستخدمين الضغط عليها والترحيب بالعملاء الجدد برسالة ترحيبية.

التقييدات

إذا قام مستخدم واتساب بالضغط على رابط عالمي (أي رابط wa. me) الذي تم تكوينه بنص محضر مسبقًا، فسيتم تجاهل واجهات المستخدم في أدوات التمهيد وتشجيع التفاعل تلقائيًا.

التكوين عبر مدير واتساب (WAM)

يمكنك تكوين كل هذه الميزات في مدير واتساب على الأرقام المحددة التي تختارها:

1. انتقل إلى لوحة معلومات "تطبيقاتي" في موقع Meta للمطوّرين.
2. حدّد تطبيقك، ثم في اللوحة اليمنى، حدّد تكوين ضمن واتساب.
3. ضمن أرقام الهواتف حدد إدارة أرقام الهواتف.
4. في أقصى يسار رقم الهاتف الذي تريد تكوينه، حدد أيقونة الترس ضمن الإعدادات.
5. حدد العمليات التلقائية.
6. الوصول وتكوين مكونات المحادثة.

يمكن لشركاء الحلول تكوين هذه الميزات لعملائهم أيضًا إذا توفرت لديهم إمكانية الوصول إلى حساب واتساب للأعمال لدى عملائهم في مدير واتساب.

الرسائل الترحيبية

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

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

إذا قمت بتمكين هذه الميزة وراسلك المستخدم، فسيتحقق عميل واتساب من سلسلة الرسائل الموجودة بين المستخدم ورقم هاتف النشاط التجاري. إذا لم توجد أي محادثات، فسيعمل العميل على تشغيل حدث webhook لـ messages مع تعيين type على request_welcome. يمكنك بعد ذلك الرد على المستخدم برسالة ترحيبية من تصميمك الخاص.

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

رسالة قالب إعلان دوّار كرسالة ترحيبية

حمولة بيانات حدث Webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "type": "request_welcome"  // Indicates first time message from WhatsApp user
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

أدوات التمهيد وتشجيع التفاعل

أدوات التمهيد وتشجيع التفاعل هي سلاسل نصية قابلة للتخصيص وقابلة للنقر تظهر في سلسلة رسائل في المرة الأولى التي تتحدث فيها مع مستخدم ما. على سبيل المثال، "ترتيب رحلة" أو "إنشاء خطة تمارين رياضية".

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

يمكنك تكوين ما يصل إلى 4 أدوات للتمهيد وتشجيع التفاعل على رقم هاتف النشاط التجاري. يمكن أن يكون لكل أداة تشجيع تفاعل 80 حرفًا كحد أقصى. الرموز التعبيرية غير مدعومة.

عندما ينقر المستخدم على أداة التمهيد وتشجيع تفاعل، يتم تشغيل حدث webhook للرسالة القياسية التي تم تلقيها مع تعيين سلسلة أداة التمهيد وتشجيع التفاعل على الخاصية body في حمولة البيانات. إذا حاول المستخدم مراسلتك بدلاً من الضغط على أداة التمهيد وتشجيع التفاعل، فستظهر لوحة المفاتيح كتراكب، ولكن يمكن تجاهلها لعرض قائمة التمهيد وتشجيع التفاعل مرة أخرى.

حمولة بيانات حدث Webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "Plan a trip"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

الأوامر

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

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

/imagine - Create images using a text prompt

عندما يكتب مستخدم واتساب /imagine cars racing on Mars، سيعمل ذلك على تشغيل حدث webhook الرسالة التي تم تلقيها مع تعيين السلسلة النصية المحددة تلك على الخاصية body. يمكنك حينها إنشاء صورة لسيارات تتسابق على كوكب المريخ وعرضها.

يمكنك تحديد ما يصل إلى 30 أمرًا. يكون لكل أمر 32 حرفًا كحد أقصى وكل تلميح 256 حرفًا كحد أقصى. الرموز التعبيرية غير مدعومة.

حمولة بيانات حدث Webhook

{
  "object": "whatsapp_business_account",
  "entry": [
    {
      "id": "<WHATSAPP_BUSINESS_ACCOUNT_ID>",
      "changes": [
        {
          "value": {
            "messaging_product": "whatsapp",
            "metadata": {
              "display_phone_number": "<BUSINESS_DISPLAY_PHONE_NUMBER>",
              "phone_number_id": "<BUSINESS_PHONE_NUMBER_ID>"
            },
            "contacts": [
              {
                "profile": {
                  "name": "<WHATSAPP_USER_NAME>"
                },
                "wa_id": "<WHATSAPP_USER_ID>"
              }
            ],
            "messages": [
              {
                "from": "<WHATSAPP_USER_PHONE_NUMBER_ID>",
                "id": "<WHATSAPP_MESSAGE_ID>",
                "timestamp": "<TIMESTAMP>",
                "text": {
                  "body": "/imagine cars racing on Mars"
                },
                "type": "text"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

التكوين عبر API

باستخدام API، يمكنك أيضًا تكوين مكونات المحادثة وعرض أي قيم تم تكوينها.

تحتوي API مكونات المحادثة على نقطتي نهاية:

POST </PHONE_NUMBER_ID>/conversational_automation والتي تُستخدم لتكوين مكونات المحادثة على رقم هاتف معين.

GET /<PHONE_NUMBER_ID>/conversational_automation والتي تقوم بإرجاع القيم الحالية لحقول Enable_welcome_message وcommands وprompts على رقم هاتف معين.

تكوين مكونات المحادثة عبر API

يمكنك تكوين مكونات المحادثة على رقم هاتف محدد عن طريق استدعاء نقطة النهاية POST.

بنية الطلب

// Enable or disable the Welcome Message for the given phone number ID
POST /<PHONE_NUMBER_ID>/conversational_automation?enable_welcome_message=<ENABLE_DISABLE>

// Configure Commands with names and descriptions
POST /<PHONE_NUMBER_ID>/conversational_automation?commands=<COMMAND_LIST>

// Configure Prompts
POST /<PHONE_NUMBER_ID>/conversational_automation?prompts=<PROMPT>

خصائص النص

"commands": {
     "command_name": "generate"
     "command_description": "Create a new image",
     “command_name”: “rethink”
     “command_description”: “Generate new images from existing images”,
} 

عينة من الطلب

   curl -X POST \
 'https://graph.facebook.com/v19.0/PHONE_NUMBER_ID/conversational_automation' \
 -H 'Authorization: Bearer ACCESS_TOKEN' \
 -H 'Content-Type: application/json' \
 -d '{
   "enable_welcome_message": true/false,
   "commands": [
     {
       "command_name": "tickets",
       "command_description": "Book flight tickets",
     },
     {
       "command_name": "hotel",
       "command_description": "Book hotel",
     }
   ],
 "prompts": ["Book a flight","plan a vacation"]
}'

عينة من الاستجابة

{
  "success": true
}

عرض التكوين الحالي عبر API

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

بنية الطلب

GET  /<PHONE_NUMBER_ID>?fields=conversational_automation

عينة من الاستجابة

{
  "conversational_automation": {
    "enable_welcome_message": true
    "prompts": [
      "Find the best hotels in the area",
      "Find deals on rental cars"
    ],
    "commands": [
      {
        "command_name": "tickets",
        "command_description": "Book flight tickets",
      },
      {
        "command_name": "hotel",
        "command_description": "Book hotel",
      }
    ],
  }
  "id": "123456"
}

الاختبار

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

بالنسبة للرسائل الترحيبية وأدوات التمهيد وتشجيع التفاعل، إذا كان لديك بالفعل سلسلة دردشة مع رقم هاتف النشاط التجاري، فيجب أولاً حذف سلسلة الدردشة:

1. افتح السلسلة في عميل واتساب.
2. اضغط على الملف الشخصي لرقم هاتف النشاط التجاري
3. اضغط على مسح الدردشة > مسح كل الرسائل.
4. حذف الدردشة.
5. يمكنك بدء سلسلة دردشة جديدة مع هذا النشاط التجاري.

يمكنك بعد ذلك إرسال رسالة إلى رقم هاتف النشاط التجاري، والتي من المفترض أن تؤدي إلى تشغيل حدث webhook لـ request_welcome.