Tham chiếu

Gửi tin nhắn chữ

Gửi tin nhắn chữ trong một cuộc trò chuyện qua cửa an toàn của tài khoản (hạn mức, giờ chạy, người đã từ chối). Trả về messageId + một thao tác để theo dõi tới khi Telegram xác nhận.

Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.

Thông tin

Tên	Giá trị
Mã	`messages.send`
Scope cần	`messages.send`
Mức	Ghi
Có thể cần xác nhận	Không
Kiểu chạy	Xếp việc cho máy chạy
Cần `Idempotency-Key`	Có
Vai trò thành viên được phép	`owner`, `manager`, `agent`
Trong app	Hộp thư → ô soạn tin

Trường vào

Trường	Kiểu	Bắt buộc
`conversationId`	`uuid`	Có
`text`	`chữ`	Có
`replyToMessageId`	`số nguyên`	Không
`topicId`	`số nguyên`	Không
`inReplyToEventId`	`chữ`	Không
`ifLastMessageId`	`uuid`	Không
`clientMessageId`	`uuid`	Không

Ví dụ gọi

curl -X POST https://tlg.builera.app/api/public/v2/ops/messages.send \
  -H "Authorization: Bearer $TELEGRAM_AUTO_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: <mã riêng mỗi việc>" \
  -d '{"conversationId":"00000000-0000-0000-0000-000000000000","text":"…"}'

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`timings`	`đối tượng \| null`	Không
`ok`	`true`	Có
`messageId`	`chữ`	Có

Ví dụ trả về

{
  "data": {
    "timings": {
      "startedAt": 1,
      "stages": {}
    },
    "ok": true,
    "messageId": "00000000-0000-4000-8000-000000000000"
  }
}

Dùng qua MCP

Tool messages_send có tên sẵn trong profile: Vận hành realtime (realtime), Thiết lập tự chạy (setup), Tìm khách (prospecting), Báo cáo (reports), Quản trị (admin), Đầy đủ (full). Ở profile khác, tìm bằng tools_search rồi chạy bằng tools_run.

Gửi tin nhắn chữ

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)