這份文件已更新。
中文(台灣) 的翻譯尚未完成。
英文更新時間:2023年5月15日

一般型範本

一般型範本可讓您傳送含有圖像、文字和按鈕的結構化訊息。在 elements 陣列中說明多個範本的一般型範本,將會傳送可平行捲動的輪播項目,每個項目都是由圖像、文字和按鈕組成。

目前無法透過桌上型電腦使用這項功能。

內容

要求 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":"

回應範例

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

屬性

recipient

訊息收件人的說明。所有要求都必須包含下列其中一個屬性來識別收件人。

屬性 類型 說明

recipient.id

字串

訊息收件人的 IG 範圍用戶編號(IGSID)。

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

字串

值必須為 generic

elements

陣列 <element>

element 物件陣列,說明所要傳送的一般型範本實例。指定多個元素將會傳送可平行捲動的範本輪播。最多支援 10 個元素。

message.attachment.payload.elements

一般型範本支援每則訊息最多 10 個元素。除了 title 之外,還必須設定至少一個屬性。

屬性名稱 類型 說明

title

字串

顯示在範本中的標題。以 80 個字元為限。

subtitle

字串

選用。顯示在範本中的副標題。以 80 個字元為限。

image_url

字串

選用。顯示在範本中的圖像網址。

default_action

物件

選用。點按範本時所執行的預設動作。接受與「網址」按鈕相同的屬性,title 除外。

buttons

陣列 <button>

選用。附加於範本的按鈕陣列。支援每個元素最多 3 個按鈕。僅支援 postbackweb_url 按鈕。