# Gửi yêu cầu

### 1. Định nghĩa

Hiểu nhanh về API để áp dụng trong Bot Bán Hàng:\
\- Để nói 1 cách dễ hiểu. API là cách để bạn kết nối đến phần mềm mà bạn đang sử dụng (dĩ nhiên để có API thì nhà cung cấp phần mềm họ phải viết tài liệu hướng dẫn kết nối API). Ví dụ: bạn dùng Sapo, bạn muốn kết nối đến các sản phẩm của bạn trên Sapo thì phía Sapo đã làm sẵn tài liệu API để bạn có thể kết nối theo hướng dẫn của họ.\
\- Mỗi một đơn vị phần mềm họ sẽ tự định nghĩa cách thức kết nối khác nhau. Nhưng đều dựa theo 1 tiêu chuẩn chung dưới đây:\
1\. “**GET**” / “**POST**” bạn sẽ nhìn thấy 2 từ này trong quá trình đọc tài liệu. Bạn hãy hiểu đây là phương thức kết nối dạng GET hay POST. Với GET bạn hiểu nôm na là lấy dữ liệu ra, còn với POST là đưa dữ liệu vào (có chiều đọc và chiều ghi để bạn phân biệt).\
2\. Url: là đường link kết nối.\
3\. Body: là dữ liệu cho phương thức POST.\
4\. Param: là dữ liệu cho cả GET và POST.\
5\. Header: là thiết lập cho cả GET và POST.

* Tại Bot Bán Hàng, để có thể sử dụng API truyền và nhận dữ liệu giữa các bên cần áp dụng tính năng **Gửi yêu cầu** trong kịch bản.

### 2. Cách sử dụng

* Tại **Kịch bản,** chọn tính năng **Gửi yêu cầu** sau đó cài đặt API.

![Chọn tính năng gửi yêu cầu](/files/-MM3TyJO9zbXCrc1kHr8)

* Chọn phương thức truyền dữ liệu:

![Các phương thức truyền dữ liệu](/files/-MM3WRydhi8PNX7_g66I)

![Xử lý dữ liệu](/files/-MM3Wy9G_HEg4QTCFIwg)

1. Điền đường dẫn API.
2. Tắt/Bật để sử dụng tính năng tự động xử lý cấu trúc JSON.
3. Điền các trường dữ liệu cần lưu và nhận.

* Ngoài ra, có thể xử lý API tuỳ chỉnh qua dạng **Gửi yêu cầu nâng cao.**

![Chọn Nâng cao để xử lý dữ liệu tuỳ chỉnh](/files/-MM3Yz1n0dEEwXASOqNV)

Tuỳ chỉnh dữ liệu truyền đi.

![](/files/-MM3a8iyOGJ0SjkUkCLL)

* **Lưu** để hoàn tất cài đặt.


---

# 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://docs.botbanhang.vn/xay-dung-chatbot-voi-bot-ban-hang/kich-ban/untitled.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.