مرجع قالب الزر

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

المحتويات

محدد URI للطلب

https://graph.facebook.com/v19.0/me/messages?access_token=<PAGE_ACCESS_TOKEN>

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

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"button",
        "text":"What do you want to do next?",
        "buttons":[
          {
            "type":"web_url",
            "url":"https://www.messenger.com",
            "title":"Visit Messenger"
          },
          {
            ...
          },
          {...}
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

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

{
  "recipient_id": "1254477777772919",
  "message_id": "AG5Hz2Uq7tuwNEhXfYYKj8mJEM_QPpz5jdCK48PnKAjSdjfipqxqMvK8ma6AC8fplwlqLP_5cgXIbu7I3rBN0P"
}  

الخصائص

recipient

وصف مستلم الرسالة. يجب أن تتضمن كل الطلبات واحدًا من id أو phone_number أو user_ref.

الخاصيةالنوعالوصف

recipient.id

String (سلسلة)

إما PSID أو phone_number أو user_ref لمستلم الرسالة.

recipient.phone_number

String (سلسلة)

اختياري. رقم هاتف المستلم بتنسيق +1(212)555-2368.


يجب أن تتم الموافقة على البرنامج التلقائي في مطابقة العملاء لإرسال رسائل بهذه الطريقة.

recipient.user_ref

String (سلسلة)

اختياري.user_refمن المكون الإضافي "مربع الاختيار"

recipient.name

كائن (Object)

اختياري. يُستخدم فقط في حالة تعيين phone_number. يحدد اسم الشخص في التنسيق:


{"first_name":"John", "last_name":"Doe"}

يساعد تقديم الاسم في زيادة احتمالات حدوث مطابقة ناجحة.

message

Description of the message to be sent.
Property Type Description

message.attachment

Object

An object describing attachments to the message.

message.attachment

Property Type Description

type

String

Value must be template

payload

Object

يمثل payload للقالب.

message.attachment.payload

الخاصية النوع الوصف

template_type

String (سلسلة)

يجب أن تكون القيمة button

text

String (سلسلة)

نص بتشفير UTF-8 يصل إلى 640 حرفًا. سيظهر النص فوق الأزرار.

buttons

مصفوفة<button>

مجموعة من 1-3 أزرار والتي تظهر كأزرار دعوة لاتخاذ إجراء.