Tham chiếu

Tìm người và mở chat

Tìm một người theo số điện thoại hoặc @username từ một tài khoản (tuỳ chọn lưu vào danh bạ) và mở chat. Theo dõi thao tác để nhận cuộc trò chuyện.

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

Tìm một người theo số điện thoại hoặc @username từ một tài khoản (tuỳ chọn lưu vào danh bạ) và mở chat. Theo dõi thao tác để nhận cuộc trò chuyện.

Thông tin

Tên	Giá trị
Mã	`contacts.start_chat`
Scope cần	`contacts.write`
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ư → Tin nhắn mới

Trường vào

Trường	Kiểu	Bắt buộc
`accountId`	`uuid`	Có
`query`	`chữ`	Có
`saveAs`	`đối tượng`	Không

Ví dụ gọi

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

Trường ra (`data`)

Trường	Kiểu	Bắt buộc
`ok`	`true`	Có
`conversationId`	`chữ`	Có
`jobId`	`null`	Có

Ví dụ trả về

{
  "data": {
    "ok": true,
    "conversationId": "00000000-0000-4000-8000-000000000000",
    "jobId": null
  }
}

Dùng qua MCP

Không có tên sẵn trong profile nào: gọi tools_describe rồi tools_run với code: "contacts.start_chat". Tên tool khi được liệt kê: contacts_start_chat.

Tìm người và mở chat

#Thông tin

#Trường vào

#Ví dụ gọi

#Trường ra (data)