# 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](https://2299560279-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FkqD6qBCDVbHh0yciWW1F%2Fuploads%2Fgit-blob-9680c9347dd979971cee0b9f443ddec7c11a10fa%2FVpage_Order_Iframe.jpg?alt=media)

## 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) |