Tham chiếu
Lưu vào danh bạ
Lưu người của cuộc trò chuyện vào danh bạ Telegram của tài khoản.
Xem MarkdownTrang này sinh tự động từ mã nguồn mỗi lần phát hành.
Lưu người của cuộc trò chuyện vào danh bạ Telegram của tài khoản.
Thông tin
| Tên | Giá trị |
|---|---|
| Mã | contacts.add |
| 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ư → thông tin chat |
Trường vào
| Trường | Kiểu | Bắt buộc | Mô tả |
|---|---|---|---|
conversationId |
uuid |
Có | |
firstName |
chữ |
Có | |
lastName |
chữ |
Không | |
sharePhone |
đúng/sai |
Không |
Ví dụ gọi
curl -X POST https://tlg.builera.app/api/public/v2/ops/contacts.add \
-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","firstName":"…"}'Trường ra (data)
| Trường | Kiểu | Bắt buộc |
|---|---|---|
ok |
true |
Có |
jobId |
chữ |
Có |
Ví dụ trả về
{
"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: "contacts.add". Tên tool khi được liệt kê: contacts_add.