💬透過 Text-Call ID 發送訊息

概述

此 API 可透過指定的 Text-Call ID（交談識別碼） 將訊息發送至系統端。

• 取得交談識別碼的方式：

  • 透過腳本流程中的變數

  • 透過訊息範本的加密代碼解密

• 應用場景：

  • 在腳本流程中自動發送指定訊息

  • 與其他系統整合，利用交談識別碼精準定位對話並進行操作

  • 建立自動化應用，例如發送通知、建立提醒或觸發後續流程

這項設計能夠支援更靈活的場景運用，讓交談的自動化與整合能力更強化。

reply-from-external 支援範說明

1. 請注意，reply-from-external 僅支援 訊息管道，目前 不支援電話或其他來源。若需應用於電話相關情境，請另行規劃替代方案。

2. 此 API 僅適用於已進入「人工客服階段」的交談流程，即 text_call 狀態需為 status = 1。 若當前交談尚未被專人接手（即處於待接狀態），將無法成功觸發此端點，請務必確認狀態後再進行呼叫。

API

curl -X POST "https://{API_HOST}/api/v1/text-call/{text_call}/reply-from-external" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "您好，這是您的訊息內容。",
    "is_note": false
}'

Response

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

{}

Http Request

POST https://{API_HOST}/api/v1/text-call/{text_call}/reply-from-external

URL Parameters

Parameter	Description
text_call	交談 ID

Form Data

欄位名稱	類型	是否必填	範例值	說明
content	String	✅	"您好，這是您的訊息內容"	訊息主體內容。可以是客戶會看到的訊息，或僅供系統內部成員閱讀的筆記。不能為空。
is_note	Number		0 / 1	表示是否為筆記（客戶不會看到）。- 1 → 備註- 0 → 對客戶可見