ACAP Knowledge Base

Appearance

Quy trình Kích hoạt Kênh Giao tiếp (SOP) ​

Tổng quan

Tài liệu hướng dẫn Nhân viên Admin từng bước tích hợp các Kênh mạng xã hội (Zalo, Facebook, Web chat) vào nền tảng.

Persona & Context ​

  • Chân dung: Quản trị viên, IT Support (Admin).
  • Mục tiêu: Mở rộng cổng tương tác, thu thập tin nhắn từ các nguồn khác về một cổng duy nhất cho ACAP Platform (Omnichannel).

Quy trình làm việc (Process Flow) ​

Các bước thực hiện ​

  1. Bước 1: Đăng nhập ACAP Platform Truy cập bằng tài khoản có quyền adminProcedure.

  2. Bước 2: Vào Menu Channels Chuyển đến phần Quản lý Kênh Phân phối. Tại đây bạn sẽ thấy danh sách các kênh (Zalo, FB).

  3. Bước 3: Gắn cấu hình bảo mật

    • Đối với Zalo: Bạn cần paste OA Token từ Zalo Developer.
    • Đối với Facebook: Copy cấu hình App Secret và kích hoạt Webhook.
    • Gọi API sinh nội bộ từ channel.create với tham số type, name, config (dữ liệu token ở trên).

  4. Bước 4: Xác nhận và Chờ đồng bộ Sau khi báo "Thành công", hệ thống sẽ bắt đầu lắng nghe Webhook cho kênh vừa setup. Nếu khách hàng mới chat từ Zalo, một conversation mới lập tức hiện trong Inbox.

Troubleshooting: Không nhận được tin từ Webhook - **Triệu chứng:** Kết nối Channel báo active nhưng gửi tin qua Zalo không hiện lên web. - **Nguyên nhân chính:** Thường do Facebook/Zalo chưa trỏ trúng Callback URL của Server ACAP. - **Cách fix:** Mở Developers Console của Zalo/Facebook, copy lại địa chỉ Webhook của hệ thống đặt vào trường `Webhook URL`.

Links nội bộ liên quan: