---
title: "Tìm người và mở chat"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/contacts.start_chat
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# 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.

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 | Mô tả |
| --- | --- | --- | --- |
| `accountId` | `uuid` | Có |   |
| `query` | `chữ` | Có |   |
| `saveAs` | `đối tượng` | Không |   |

## Ví dụ gọi

```bash
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ề

```json
{
  "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`.