line:send 的 Public API 金鑰。查詢發送結果需另勾選 line:read;既有金鑰不會自動取得這兩個權限。
組織須已設定 LINE 官方帳號、啟用 LINE 模組。收件人必須是同組織聯絡人,而且唯一綁定的個人 LINE 帳號仍追蹤官方帳號。未綁定、已取消追蹤或同時綁定多個有效帳號時,API 回傳 409 resource_state_conflict,原因在 error.details.reason。不支援群組發送。
發送文字
此操作會發出真實 LINE 訊息。請使用已確認的收件人與內容,並為每次獨立的發送意圖建立一個非機密的Idempotency-Key。
201 代表建立發送紀錄,請繼續檢查回應的 status:
查詢與重送
id。此查詢僅涵蓋公開 API/MCP 建立的發送紀錄,不是收件匣歷史 API。訊息會同步寫入 CRM 的 LINE 收件匣。
相同 Idempotency-Key 和內容重送時,只會讀回同一筆紀錄的目前狀態,並回傳 Idempotency-Replayed: true。相同金鑰搭配不同內容會得到 409 idempotency_conflict。這些防重送紀錄不會到期;即使刪除收件匣訊息或聯絡人,也不會再次發送。一分鐘內尚未開始發送者顯示 failed 與 dispatch_not_started,之後也無法再發送;已開始發送卻沒有記錄結果者顯示 unknown。LINE HTTP 429(速率限制或每月配額)是明確拒絕,回傳 failed 與 provider_rejected;等待限制解除或處理配額後,可用新金鑰再次嘗試。逾時或服務商 5xx 仍為 unknown。
MCP
發送工具是brightalk_send_line_message:
brightalk_get_line_message,輸入 { "message_id": "發送回應的 id" }。MCP 查詢模式會隱藏發送工具;需啟用操作模式並使用具有 line:send 的金鑰。
衝突原因
409 resource_state_conflict 的原因位於 error.details.reason。這些衝突發生時尚未建立發送紀錄,修正原因後可沿用相同金鑰重試。