傳送 API 參考資料
「傳送 API」是傳送訊息給用戶時所使用的主要 API，內容包括文字、附件、範本、傳送者動作等等。
建立
建立訊息並向您的顧客或對您的 Facebook 粉絲專頁感興趣的人傳送訊息。
準備工作
必備資料：
- 可在粉絲專頁執行
MESSAGE工作的用戶所要求的粉絲專頁存取權杖 pages_messaging權限- 訊息收件人必須在過去 24 小時內向您的粉絲專頁傳送訊息，或同意在標準 24 小時訊息期限外接收您的粉絲專頁訊息
限制
- 訊息標籤不能用於傳送促銷內容
請注意，傳送 API 不包含用於識別訊息接收者的 recipient_id （在使用 recipient.user_ref 或 recipient.phone_number 所傳送訊息的回應中）。
要求範例
若要傳送訊息給用戶，請向 /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..."
}
參數
| 參數 | 說明 |
|---|---|
| 粉絲專頁傳送的訊息類型。使用此參數時，必須設定
|
必要項目 | 所傳送訊息的訊息類型
|
| 用戶將收到的推播通知類型
|
必要項目 | 粉絲專頁傳送之訊息的收件用戶
|
| 訊息視窗中顯示的動作圖示，表示粉絲專頁收到用戶訊息時對其採取的動作。
只能使用 |
| 讓您的粉絲專頁能夠在標準 24 小時訊息期限外傳送訊息給用戶的標籤。
|
訊息標籤使用方式
下表列出每個訊息標籤的傳訊類型。
| 訊息標籤 | 使用方式 |
|---|---|
| 允許的使用方式
禁止的使用方式（非完整清單）
不適用於 Instagram 傳訊 API。 |
| 允許的使用方式
禁止的使用方式（非完整清單）
不適用於 Instagram 傳訊 API。 |
| 允許的使用方式
禁止的使用方式（非完整清單）
不適用於 Instagram 傳訊 API。 |
| 允許的使用方式
禁止的使用方式（非完整清單）
Instagram 傳訊 API 的必要項目。 |
| 允許的使用方式
禁止的使用方式（非完整清單）
不適用於 Instagram 傳訊 API。 |
更新
您無法在這個端點執行此操作。
刪除
您無法在這個端點執行此操作。
另請參閱
開發人員支援
- Meta 狀態工具
用於檢查 Meta 企業產品的狀態及中斷。
- Meta 開發人員支援工具用於回報錯誤及查看回報的錯誤，以取得有關廣告或企業管理平台的協助等。
- 請前往 Messenger 平台的支援資源，以查看更多 Messenger 平台的支援資源。