> For the complete documentation index, see [llms.txt](https://help.firstline.cc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.firstline.cc/developer/api/jin-jie/tou-guo-text-call-id-fa-song-xun-xi.md).

# 透過 Text Call ID 發送訊息

{% hint style="info" %}

### **reply-from-external 支援範說明**

1. 請注意，**reply-from-external** 僅支援 **訊息管道**，**不支援電話或其他來源**。若需應用於電話相關情境，請另行規劃替代方案。
2. 此 **API 僅適用於已進入「人工客服階段」的交談流程**，即 `text_call` 狀態需為 `status = 1`。 若當前交談尚未被專人接手（即處於待接狀態），將無法成功觸發此端點，請務必確認狀態後再進行呼叫。
   {% endhint %}

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

* **取得交談識別碼的方式**：
  * 透過腳本流程中的變數
  * 透過訊息範本的加密代碼解密
* **應用場景**：
  * 在腳本流程中自動發送指定訊息
  * 與其他系統整合，利用交談識別碼精準定位對話並進行操作
  * 建立自動化應用，例如發送通知、建立提醒或觸發後續流程

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

## **API**

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

## **Response**

成功時回傳 HTTP `204 No Content`，**沒有 Response Body**。

## **Http Request**

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

**URL Parameters**

|            |       |
| ---------- | ----- |
| text\_call | 交談 ID |

**JSON Request Body**

|           |                   |   |                 |                                         |
| --------- | ----------------- | - | --------------- | --------------------------------------- |
| `content` | `String`          | ✅ | `"您好，這是您的訊息內容"` | 訊息主體內容。可以是客戶會看到的訊息，或僅供系統內部成員閱讀的筆記。不能為空。 |
| `is_note` | `Boolean / 0 或 1` |   | `0` / `1`       | 表示是否為筆記（客戶不會看到）。- `1` → 備註- `0` → 對客戶可見 |