💬使用 LINE User Id 發送單一訊息

使用 LINE User Id 與 line_account 發送訊息

當你需要向特定的 LINE 使用者發送個性化的訊息時，你可以利用此 API，透過 LINE User Id 搭配 line_account 來完成整合。 這種整合方式可以讓您更有效地傳達訊息給指定帳號下的使用者。

此外，使用這個 Push API 也可以幫助你節省時間和資源，因為你不需要自己從頭開始建立訊息傳遞與好友同步系統。

只需簡單的幾步操作，系統會自動幫你：

1. 檢查是否已有對應的使用者資料

2. 若沒有，透過 LINE API 驗證是否為有效好友並建立資料

3. 完成後即刻發送訊息

---

API

Endpoint

curl -X POST
    -H "Content-Type: application/json"
    https://{API_HOST}/api/v1/***

{line_account} 為系統內的 LINE 官方帳號 ID（path parameter）。

範例 (curl)

curl -X POST \
  -H "Content-Type: application/json" \
  -d '{
        "user_id": "U23f091df6743abee1122334455667788",
        "type": "text",
        "message": "這是一則透過推送的訊息",
        "is_force": false
      }' \
  https://{API_HOST}/api/social-media-contact/adapter/push-message/line-account/{line_account}

---

Response

回傳為 JSON 格式，而 HTTP status 為代碼 200，表示發送成功。

{}

---

URL / Body Parameters

Path Parameter

名稱	型別	必填	說明
line_account	int	是	系統內的 LINE Account ID

Body Parameters

名稱	型別	必填	說明
user_id	string	是	LINE UserId。長度固定 33，格式 U + 32 位 hex
type	string	是	訊息類型：text,image,carousel,image_carousel,carousel_for_products,button,quickreply
message	object / string	是	依 type 而定的訊息內容
is_force	boolean	否	是否強制發送，即使目前在對話中

---

Message 欄位訊息格式

文字訊息 Text

{
  "type": "text",
  "message": "要傳送的文字訊息"
}

（其他類型例如 image / carousel / button / quickreply 可依同一風格再展開。）

---

系統流程說明

1. 查找既有資料

   • 以 {line_account} + user_id 查找是否已有對應的聯絡人。

   • 若找到 → 直接使用該聯絡人發送訊息。

2. 若找不到，透過 LINE API 驗證好友

   • 呼叫 LINE 官方 API 檢查該 user_id 是否為 {line_account} 的有效好友。

   • 若驗證失敗 → 回傳錯誤（例如 400 / 422）。

3. 驗證通過，建立聯絡人並發送

   • 在系統內新增對應的聯絡人資料。

   • 建立完成後，即刻使用新建立的聯絡人發送 PUSH 訊息。