---
title: "Xoá khỏi danh bạ Telegram"
locale: vi
url: https://tlg.builera.app/docs/reference/rest/people.delete_contact
verified: 2026-10-24
app_version: "2.0"
generated: true
---

# Xoá khỏi danh bạ Telegram

Xoá người này khỏi danh bạ Telegram của tài khoản. Cuộc trò chuyện, lịch sử và thẻ CRM vẫn giữ.

Xoá người này khỏi danh bạ Telegram của tài khoản. Cuộc trò chuyện, lịch sử và thẻ CRM vẫn giữ.

## Thông tin

| Tên | Giá trị |
| --- | --- |
| Mã | `people.delete_contact` |
| Scope cần | `contacts.write` |
| Mức | Nguy hiểm |
| Có thể cần xác nhận | Có |
| 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` |
| Cần máy chạy từ bản | `1.0.16` |
| Trong app | Hộp thư → thông tin khách → Xoá khỏi danh bạ |

## Trường vào

| Trường | Kiểu | Bắt buộc | Mô tả |
| --- | --- | --- | --- |
| `conversationId` | `uuid` | Có |   |

## Ví dụ gọi

```bash
curl -X POST https://tlg.builera.app/api/public/v2/ops/people.delete_contact \
  -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"}'
```

## Trường ra (`data`)

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

## Ví dụ trả về

```json
{
  "data": {
    "ok": true,
    "jobId": "00000000-0000-4000-8000-000000000000"
  }
}
```

## 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: "people.delete_contact"`. Tên tool khi được liệt kê: `people_delete_contact`.