# TÀI LIỆU API

**Getfly CRM** cung cấp giao diện lập trình ứng dụng (API) mở, cho phép các hệ thống của đối tác kết nối và trao đổi dữ liệu một cách linh hoạt, hiệu quả. Nhờ vậy, doanh nghiệp có thể dễ dàng tích hợp Getfly CRM với các công cụ và nền tảng khác đang sử dụng, tạo ra một hệ sinh thái quản trị thống nhất và tối ưu hóa quy trình hoạt động

## 1. Nội dung tài liệu

* Khách hàng
* Chiến dịch - Cơ hội
* Đơn hàng
* Sản phẩm
* Qũy
* Tổng đài điện thoại
* Ticket
* Người dùng
* Webhook
* Cấu hình

## 2. Chi tiết tài liệu

### 2.1. Tài liệu API 6.0: [Tại đây](https://developer.getfly.vn/docs/6.0/intro)

### 2.2. Tài liệu API 6.1: [Tại đây](https://developer.getfly.vn/docs/6.1/intro)

#### **Điểm Nâng Cấp Nổi Bật Trong API 6.1**

* **Truy xuất theo mã (code) thay vì ID:**\
  Ví dụ: dùng account\_code thay cho account\_id, giúp chuẩn hóa dữ liệu và dễ dàng tích hợp với hệ thống khác.
* **Thêm mới & cập nhật thông minh:**\
  Hỗ trợ sử dụng **mã hoặc tên** (VD: tên nhóm khách hàng, ngành nghề…) thay cho ID. Nếu chưa có, hệ thống sẽ **tự động tạo mới**.
* **Bổ sung thêm nhiều API mới:**
  * API **Công việc**
  * API **Đơn hàng mua**
  * API **Báo cáo khách hàng**

## 3. Hướng dẫn lẫy API key

Mỗi một hệ thống Getfly sẽ có một mã **API key** khác nhau. Mã API Key bao gồm dãy ký tự chứa chữ và số. Để có thể lấy được thông tin API key, tài khoản của bạn cần được phân quyền **Quản lý quyền**.&#x20;

Để lấy mã API key bạn thao tác hướng dẫn sau

Truy cập hệ thống Getfly ⇒ Cài đặt ⇒ Tích hợp ⇒ Tích hợp phần mềm khác ⇒ Chọn **kết nối** **với Getfly**

<figure><img src="https://wiki.getfly.vn/public/img/images/image(600).png" alt="" width="563"><figcaption></figcaption></figure>

Sau khi chọn kết nối Getfly thì sẽ hiện ra 1 dãy ký tự, đây chính là API key trong hệ thống của bạn

<figure><img src="https://wiki.getfly.vn/public/img/images/image(603).png" alt="" width="563"><figcaption></figcaption></figure>

**Lưu ý:**&#x20;

* Khi hệ thống đã có sẵn dãy mã API Key, bạn vui lòng không bấm tạo mới. Nếu bạn bấm tạo mới thì hệ thống sẽ tự động ngắt kết nối với những phần mềm khác mà bạn đã kết nối trước đó bằng dãy API key đã có sẵn này.
* Khi hệ thống chưa có dãy mã API Key nào thì bạn có thể bấm tạo mới để lấy thông tin mã kết nối.

## 4. Lưu ý

* API Getfly tuân thủ chuẩn **RESTFUL**, có thể truy cập trực tiếp từ trình duyệt.
* Mọi truy vấn cần thông qua **Base URL**.
* Hỗ trợ cả http và https, nhưng **nên dùng HTTPS** để đảm bảo bảo mật.
* Chỉ hỗ trợ định dạng **Content-Type: application/json.**
* Getfly cung cấp phương pháp xác thực qua **API Key**


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://helpdesk6.getfly.vn/tai-lieu-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
