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

رسائل التفاعل عبارة عن تفاعلات بالرموز التعبيرية يمكنك تطبيقها على رسالة سابقة تلقيتها من مستخدم على واتساب.

القيود

عند إرسال رسالة تفاعل، سيتم تشغيل حدث webhook للرسائل المرسلة (تم تعيين status إلى sent)؛ ولن يتم تشغيل أحداث webhook للرسائل المُستلمة والمقروءة.

إرسال رسائل التفاعل

استخدم نقطة النهاية POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages لتطبيق التفاعل بالرموز التعبيرية على رسالة تلقيتها من مستخدم واتساب.

بنية الطلب

POST /<WHATSAPP_BUSINESS_PHONE_NUMBER_ID>/messages

نص المنشور

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "<WHATSAPP_USER_PHONE_NUMBER>",
  "type": "reaction",
  "reaction": {
    "message_id": "<WHATSAPP_MESSAGE_ID>",
    "emoji": "<EMOJI>"
  }
}

معلمات نص المنشور

العنصر النائبالوصفمثال للقيمة

<EMOJI>

سلسلة

مطلوب.

تسلسل تخطي Unicode للرمز التعبيري، أو الرمز التعبيري نفسه، لتطبيقه على رسالة المستخدم.

مثال على تسلسل تخطي Unicode:

\uD83D\uDE00

مثال على الرمز التعبيري:

😀

<WHATSAPP_MESSAGE_ID>

سلسلة

مطلوب.

معرف رسالة واتساب لرسالة تريد تطبيق الرمز التعبيري عليها.

إذا مضى على الرسالة التي تتفاعل معها أكثر من 30 يومًا أو لا تقابل أي رسالة في المحادثة أو تم حذفها أو كانت بحد ذاتها رسالة تفاعل، فلن يتم عرض رسالة التفاعل وستتلقى حدث webhook messages يحتوي على رمز الخطأ 131009.

wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=

<WHATSAPP_USER_PHONE_NUMBER>

String

Required.

WhatsApp user phone number.

+16505551234

مثال على الطلب

مثال على طلب لتطبيق الرمز التعبيري للوجه المبتسم (😀) على رسالة مستخدم تم استلامها سابقًا.

curl 'https://graph.facebook.com/v21.0/106540352242922/messages' \
-H 'Content-Type: application/json' \
-H 'Authorization: Bearer EAAJB...' \
-d '
{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "+16505551234",
  "type": "reaction",
  "reaction": {
    "message_id": "wamid.HBgLMTY0NjcwNDM1OTUVAgASGBQzQUZCMTY0MDc2MUYwNzBDNTY5MAA=",
    "emoji": "\uD83D\uDE00"
  }
}'

مثال على الاستجابة

{
  "messaging_product": "whatsapp",
  "contacts": [
    {
      "input": "+16505551234",
      "wa_id": "16505551234"
    }
  ],
  "messages": [
    {
      "id": "wamid.HBgLMTY0NjcwNDM1OTUVAgARGBI1RjQyNUE3NEYxMzAzMzQ5MkEA"
    }
  ]
}