> For the complete documentation index, see [llms.txt](https://en.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://en.help.firstline.cc/developer/api/advanced/send-message-via-text-call-id.md).

# Send message via Text Call ID

{% hint style="info" %}

### **reply-from-external Support Scope Description**

1. Please note,**reply-from-external** Only supports **message channels**，**does not support phone or other sources**. If you need to apply this to phone-related scenarios, please plan an alternative solution separately.
2. This **API is only applicable to conversation flows that have entered the “human customer service stage”**, that is, `text_call` the status must be `status = 1`. If the current conversation has not yet been taken over by a person (i.e., it is in pending status), this endpoint cannot be triggered successfully. Please make sure to confirm the status before calling it.
   {% endhint %}

This API can use the specified **Text-Call ID (conversation identifier)** to send messages to the system side.

* **How to obtain the conversation ID**:
  * through variables in the script flow
  * decrypt via the encryption code of the message template
* **Use cases**:
  * Automatically send specified messages in the script flow
  * Integrate with other systems, using the conversation ID to accurately locate the conversation and perform actions
  * Create automated applications, such as sending notifications, creating reminders, or triggering subsequent flows

This design supports more flexible scenario usage and strengthens the automation and integration capabilities of conversations.

## **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": "Hello, this is your message content.",
    "is_note": false
}'
```

## **Response**

Returns HTTP upon success `204 No Content`，**No Response Body**.

## **Http Request**

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

**URL Parameters**

|            |                 |
| ---------- | --------------- |
| text\_call | Conversation ID |

**JSON Request Body**

|           |                    |   |                                         |                                                                                                                                                 |
| --------- | ------------------ | - | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- |
| `content` | `String`           | ✅ | `"Hello, this is your message content"` | The main content of the message. It can be a message visible to the customer, or a note only internal system members can read. Cannot be empty. |
| `is_note` | `Boolean / 0 or 1` |   | `0` / `1`                               | Indicates whether it is a note (not visible to the customer). - `1` → Note - `0` → Visible to customer                                          |