Hướng dẫn sử dụng botbanhang

Widget là một ứng dụng giúp tích hợp hệ thống của doanh nghiệp hoặc đối tác lên Chatbox Bot Bán Hàng dễ dàng như: Tạo đơn hàng, giao hàng, thanh toán, CRM, Call Center, Marketing, Tracking, Analytic , AI …

Widget App có 2 dạng : Private và Public.

• Private : Bạn có thể tự tạo Widget và sử dụng được ngay mà không cần chờ duyệt. (Dành cho các app nội bộ doanh nghiệp hoặc môi trường Sanbox cho Developer)
• Public : Đối tác tạo Widget App và submit lên Marketplace để các doanh nghiệp khác có thể sử dụng App của đối tác. (Đối với trường hợp này vui lòng liên hệ chúng tôi để trở thành Đối tác)
  
  

II. Mô hình sử dụng

Widget App sẽ có 2 luồng xử lý chính gồm:

• Cài đặt app: Cấp quyền và lưu “token_partner“.
  
• Lấy dữ liệu: Thông qua “secret_key” và “token” trên param của URL Iframe.

III. Tạo Widget App

Bước 1: Bạn cần tạo trước 1 Page Facebook tại : https://www.facebook.com/pages/create

Bước 2: Đăng nhập Bot Bán Hàng tại : https://botbanhang.vn/page

Bước 3: Truy cập link sau để tạo một ứng dụng :

Bước 4: Bổ sung thông tin để tạo App như bên dưới. Lưu ý: – URL của App (iframe): Giao diện ứng dụng hiển thị trên Chatbox cho nhân viên sử dụng.

– URL đăng nhập (OAuth) : Xác thực người dùng trên hệ thống của bạn. Sẽ hiển thị khi admin page ấn cài đặt ứng dụng.

– Quyền truy cập dữ liệu :

• Hồ sơ công khai : Họ tên, link avatar, id_messenger(psid), tên page, page id.
• Dữ liệu nhắn tin: Tin nhắn cuối cùng, thời gian, kênh nhắn.
• Dữ liệu liên lạc : Số điện thoại và email
• Dữ liệu nhãn : Gắn nhãn của nhân viên lên khách hàng.
• Ghi chú: Ghi chú cuối cùng.

– Nhân viên: ID và tên nhân viên phụ trách

– Chatbot Bán hàng: Token Chatbot để gửi các kịch bản tin nhắn khi có id_messenger (psid), trạng thái chatbot có được kích hoạt lên khách hàng hay không.

Bước 5: Sau khi tạo App bạn cần lưu lại Mã bí mật (Secret key)

Bước 6: App hiện tại của bạn mặc định là Private có thể cài đặt và sử dụng được luôn. Nếu bạn muốn đưa App lên Marketplace để nhiều doanh nghiệp sử dụng, truy cập menu Public ứng dụng

IV. Cài đặt Widget và xác thực người dùng trên hệ thống.

Bước 1: Người dùng ấn cài đặt App Bot Bán Hàng hiện Popup một màn hình với URL đăng nhập (Oauth) đã thiết lập trong App trước đó. Ví dụ URL bạn sẽ nhận được: https://app.domain.com/login.html?access_token=<token_bbh>

Bước 2: Sau khi người dùng của bạn đăng nhập, redirect về URI Callback của Bot Bán Hàng với các tham số <token_bbh> bên trên và <your_token> là token người dùng hệ thống của bạn:

https://botbanhang.vn/chat/#/redirect?access_token=<token_bbh>&token_partner=<your_token>

22. Lấy dữ liệu từ Widget

Bước 1: Sau khi cài đặt và kích hoạt App lên Chatbox.

Bước 2: Nhân viên mở 1 hội thoại Chat. Widget app của bạn sẽ được gọi tới URL Iframe mà bạn đã thiết lập và kèm theo tham số access_token của Bot Bán Hàng truyền vào để bạn lấy dữ liệu khách hàng.

https://app.domain.com/iframe.html?access_token=<token_bbh>

Bước 3: API Lấy dữ liệu người dùng từ server.

`Method : POST URL: https://chatbox-app.botbanhang.vn/v1/service/partner-authenticate Header:

• Content-Type : application/json Body :
• access_token : <token_bbh> // Từ param url bên trên
• secret_key : <secret_key> // Trong thiết lập App. `

Lưu ý: Khi bạn lấy dữ liệu người dùng, bạn cần request từ server để đảm bảo không tiết lộ “secret_key” từ App của bạn.

VI. Best Practice

• Server / Hosting :
• Phía hosting / server cần được bật cache hoặc qua 1 CDN (ví dụ: Cloudflare) để tối ưu trải nghiệm load static file.
• App tương tác dữ liệu business logic qua JSON API.
• Server API nên có TTL dưới 50, đặt tại Việt Nam hoặc Singapore hoặc Hongkong.
• Widget App :
• Khuyến khích sử dụng các App dạng SPA hoặc app đơn giản thì thuần “HTML + jQuery + Bootstrap”.
• Bật cache khi load các file css / js / image. Các file js / css / image nên load từ domain của bạn hoặc có CDN.
• Tổng dung lượng file javascript sau khi minifier không nên quá 100kb.
• Không khuyến khích Widget App sử dụng Render server side.
• Không nên load quá nhiều dữ liệu, nội dung trong 1 widget. Load các hình ảnh/dữ liệu nặng, font chữ…
• UI KIT nên sử dụng Bootstrap với dạng UI Form.

VII. Liên hệ & Hỗ trợ

Liên hệ Developer:

• Telegram : Mr.Minh ( 0333776915 ) , Mr.Manh ( 0398501802 )
• Mail : [email protected] , [email protected]

Liên hệ hợp tác kinh doanh:

• Telegram : Mr.Tung (0985828212)
• Mail : [email protected]

  Bạn cần tư vấn Chatbot để tự động tối ưu quy trình bán hàng & tối ưu thời gian làm việc của nhân viên, tăng tỷ lệ chuyển đổi khách hàng từ quảng cáo để tiết kiệm chi phí. Hãy ấn “Tư vấn Chatbot miễn phí” phía dưới để được tư vấn miễn phí từ đội ngũ chuyên gia Bot Bán Hàng.