# Iframe khung tạo đơn

* Mặc định Vpage sẽ tích hợp phần tạo đơn hàng với [Nhanh POS](https://nhanh.vn). Nếu bạn dùng 1 phần mềm quản lý khác, và muốn tích hợp khung tạo đơn hàng, thì bạn có thể vào phần Cài đặt > [API khung tạo đơn](https://vpage.nhanh.vn/app/setting/orderiframe) để điền link mong muốn tích hợp.
  * **Chú ý**: Cài đặt này đi theo doanh nghiệp, các page gắn vào doanh nghiệp sẽ được đổi sang khung tạo đơn mới.

![Cài đặt API khung tạo đơn](/files/DaU3P9zYEPLt6l9Z4AhE)

## Config web server

* Web server của bạn cần response thêm header **Content-Security-Policy: frame-ancestors 'self' <https://vpage.nhanh.vn>** để cho phép nhúng iframe trên Vpage.
  * Đọc thêm về [Content Security Policy](https://developer.mozilla.org/en-US/docs/Web/HTTP/Guides/CSP).
* Nếu dùng Nginx, trong đoạn `server {...}` thêm dòng sau

```
add_header Content-Security-Policy "frame-ancestors 'self' https://vpage.nhanh.vn" always;
```

* Nếu dùng Apache httpd, trong VirtualHost hoặc `.htaccess` thêm dòng sau:

```
Header always set Content-Security-Policy "frame-ancestors 'self' https://vpage.nhanh.vn"
```

* Nếu dùng PHP có thể thêm bằng cách:

```
<?php
header("Content-Security-Policy: frame-ancestors 'self' https://vpage.nhanh.vn");
```

## Order Iframe params

* Nếu bạn điền link riêng của bạn là <https://example.com/order/add>, thì khi nhân viên chăm sóc mở 1 hội thoại, Vpage sẽ load URL cho iframe kèm các GET params liên quan <https://example.com/order/add?businessId=10100\\&pageId=123456789\\&conversationId=>... Xem thêm các params ở bảng bên dưới.
* Iframe của bạn nhận các params này, lưu theo thông tin đơn hàng để có thông tin về page, và hội thoại.
* Sau khi lưu đơn hàng, nếu bạn muốn bắn **Meta Conversion API** để báo cáo doanh thu lên trình quản lý quảng cáo của Meta, giúp tối ưu lượt mua và khách hàng tiềm năng, thì bạn có thể dùng [Meta Conversion API](https://apidocs.nhanh.vn/v3/vpage/marketing/meta_send_capi).

| Key             | Description                                            |
| --------------- | ------------------------------------------------------ |
| businessId      | id doanh nghiệp Nhanh.vn                               |
| pageId          | pageId                                                 |
| channel         | id kênh chat, xem [bảng channel bên dưới](#channel)    |
| conversationId  | id hội thoại                                           |
| customerName    | Tên khách hàng                                         |
| customerMobile  | Số điện thoại khách hàng                               |
| customerEmail   | Email khách hàng                                       |
| customerAddress | Địa chỉ khách hàng                                     |
| fbPsid          | Page UserId trên Meta (Facebook, Instagram)            |
| fbAdsId         | id quảng cáo (nếu hội thoại đến từ ads)                |
| vpageUserId     | id nhân viên Vpage đang thực hiện thao tác tạo đơn     |
| vpageGroupId    | id nhóm được chia hội thoại                            |
| vpagePostId     | id bài post mà hội thoại phát sinh                     |
| postType        | Loại bài viết, xem [bảng postType bên dưới](#postType) |

### channel

| value | Channel        |
| ----- | -------------- |
| 1     | FaceBook       |
| 2     | Instagram      |
| 4     | SHOPEE         |
| 5     | ZALO           |
| 6     | LAZADA         |
| 7     | TELEGRAM       |
| 8     | WHATSAPP       |
| 6     | TIKTOK         |
| 10    | ZALO\_PERSONAL |

### postType

| value | Channel                                                                                                                      |
| ----- | ---------------------------------------------------------------------------------------------------------------------------- |
| 1     | post quảng cáo                                                                                                               |
| 2     | organic - từ ad hoặc tự nhiên                                                                                                |
| 4     | Loại post chưa xác định (có thể là đơn người dùng tự inbox, hoặc người dùng cmt vào bài viết trong page rồi phát sinh inbox) |


---

# 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://apidocs.nhanh.vn/v3/vpage/conversation/order_iframe.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.