Message Templates

Message templates offer a way for you to offer a richer in-conversation experience than standard text messages by integrating buttons, images, lists, and more alongside text a single message. Templates can be use for many purposes, such as displaying product information, asking the message recipient to choose from a pre-determined set of options, and showing search results.

Available Templates

The following templates are available for sending structured messages:

Request URI

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

Example Request

curl -X POST -H "Content-Type: application/json" -d '{
  "recipient":{
    "id":"<PSID>"
  },
  "message":{
    "attachment":{
      "type":"template",
      "payload":{
        "template_type":"generic",
        "elements":[
           {
            "title":"Welcome!",
            "image_url":"https://petersfancybrownhats.com/company_image.png",
            "subtitle":"We have the right hat for everyone.",
            "default_action": {
              "type": "web_url",
              "url": "https://petersfancybrownhats.com/view?item=103",
              "messenger_extensions": false,
              "webview_height_ratio": "tall",
              "fallback_url": "https://petersfancybrownhats.com/"
            },
            "buttons":[
              {
                "type":"web_url",
                "url":"https://petersfancybrownhats.com",
                "title":"View Website"
              },{
                "type":"postback",
                "title":"Start Chatting",
                "payload":"DEVELOPER_DEFINED_PAYLOAD"
              }              
            ]      
          }
        ]
      }
    }
  }
}' "https://graph.facebook.com/v2.6/me/messages?access_token=<PAGE_ACCESS_TOKEN>"

Example Response

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

Properties

`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`

Property	Type	Description
`template_type`	String	Value indicating the template type `generic`, `button`, `media`, `receipt`, etc
`...`	Mixed	The rest of `message.attachment.payload` properties depend on the template type. See Available templates.