建立
建立訊息並傳送給您的顧客或對您 Facebook 專頁感興趣的用戶。
準備工作
您將需要:
限制
請注意,如果是使用 recipient.user_ref
或 recipient.phone_number
傳送的訊息,傳送 API 不會在回應中加入 recipient_id
來識別訊息傳送對象。
要求範例
如要傳送訊息給用戶,請向 /PAGE-ID/messsages
端點傳送 POST
要求,其中包含已設定的 messaging_type
和 recipient
參數,以及訊息內容。
我們已設定特定格式以便閱讀。以下範例是對用戶訊息的回覆,其中專頁傳送的是純文字訊息。
curl -X POST "https://graph.facebook.com/v21.0
/{PAGE_ID}/messages" \
-d "recipient={'id':'{PSID}'}" \
-d "messaging_type=RESPONSE" \
-d "message={'text':'hello, world'}" \
-d "access_token={PAGE_ACCESS_TOKEN}"
成功的話,應用程式將會收到以下 JSON 回應:
{
"recipient_id": "PAGE-SCOPED-ID",
"message_id": "AG5Hz2U..."
}
參數
參數 | 說明 | message 物件 | 專頁傳送的訊息類型。使用此參數時必須設定 text 或 attachement 其一。 |
messaging_type 列舉必要項目 | 所傳送訊息的類型 RESPONSE :這類訊息是用來回覆已收到的訊息,包括在 24 小時標準訊息期間內所傳送的推廣和非推廣訊息。舉例來說,如有用戶要求確認預約或想了解最新動態,您便可使用這個標籤來回覆。 UPDATE :這類訊息為主動傳送,並非用來回覆已收到的訊息。包括在 24 小時標準訊息期間內所傳送的推廣和非推廣訊息。
|
notification_type 列舉 | 用戶收到的推送通知類型 |
recipient 物件必要項目 | 您專頁所傳送訊息的接收者 id :專頁範圍用戶編號,用於傳送訊息以回應您專頁在過去 24 小時內所收到的訊息,或適用於已同意在標準 24 小時訊息期限以外接收您專頁訊息的用戶
user_ref :用戶參考資料,用於傳送訊息以回應選框附加程式或顧客洽談附加程式
comment_id :留言編號,用於以私人回覆形式傳送訊息,以回應您專頁帖子上的訪客留言
post_id :專頁帖子編號,用於以私人回覆形式傳送訊息,以回應您專頁上的訪客帖子
|
sender_action 列舉 | 訊息視窗中顯示的操作圖示,表示專頁對專頁從用戶處收到的訊息所採取的操作。 只可與 recipient 參數一併傳送。不可與 message 參數一併傳送,必須作為個別要求傳送。 |
tag 列舉 | 使您的專頁能夠在標準 24 小時訊息期間以外向用戶傳送訊息的標籤。 ACCOUNT_UPDATE :將您傳送給顧客的訊息標註為對其應用程式或帳戶的非定期更新。 查看所有允許的使用方式。不適用於 Instagram 訊息 API。 CONFIRMED_EVENT_UPDATE :將您傳送給顧客的訊息標註為即將舉行的活動之提醒,或顧客已登記的進行中活動的更新。 查看所有允許的使用方式。不適用於 Instagram 訊息 API。 CUSTOMER_FEEDBACK :將您傳送給顧客的訊息標註為 顧客意見問卷調查 。顧客意見問卷調查必須在收到顧客最後一則訊息的 7 天內傳送。 查看所有允許的使用方式。不適用於 Instagram 訊息 API。 HUMAN_AGENT : Instagram 訊息 API 的必要項目。在傳送給用戶的訊息中加入這個標籤後,系統即會允許真人服務人員回覆該用戶的訊息。您可在收到用戶訊息的 7 天內傳送訊息。真人服務人員支援服務用於處理無法在標準訊息期間內解決的問題。 查看所有允許的使用方式。標準存取權限或開發模式中尚未能使用 Human Agent 權限。使用真人服務人員標籤之前,您需要完成應用程式審查流程。在應用程式審查申請提交期間,請提供清晰的說明和演示,說明您打算如何在體驗中運用真人服務人員標籤。 POST_PURCHASE_UPDATE :將您傳送給顧客的訊息標註為顧客最近購買項目的更新。 查看所有允許的使用方式。不適用於 Instagram 訊息 API。
|
訊息標籤使用方式
下表列出每種訊息標籤的訊息類型。
訊息標籤 | 使用方式 | ACCOUNT_UPDATE
| 允許使用方式申請狀態變更通知,例如信用卡或職位申請狀態變更 可疑活動通知,例如欺詐警示
不適用的使用方式(非盡列)不適用於 Instagram 訊息 API。 |
CONFIRMED_EVENT_UPDATE
| 允許使用方式不適用的使用方式(非盡列)推廣內容,包括但不限於促銷特價、優惠、優惠券和折扣 用戶未登記的活動相關內容(如提醒購買活動門票、交叉銷售其他活動,以及巡迴活動行程表等) 與過往活動相關的訊息 提示用戶參與跟 Messenger 上過往互動無關的任何問卷調查、投票活動或評論
不適用於 Instagram 訊息 API。 |
CUSTOMER_FEEDBACK
| 允許使用方式不適用的使用方式(非盡列)不適用於 Instagram 訊息 API。 |
HUMAN_AGENT
| 允許使用方式不適用的使用方式(非盡列)Instagram 訊息 API 必要項目。 |
POST_PURCHASE_UPDATE
| 允許使用方式不適用的使用方式(非盡列)不適用於 Instagram 訊息 API。 |