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. 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 để đ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

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.

• 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.

Key	Description
businessId	id doanh nghiệp Nhanh.vn
pageId	pageId
channel	id kênh chat, xem bảng channel bên dưới
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

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)