Lễ tân AI trên Messenger

Mẫu này làm gì

Bạn cần gì

• Meta App và token của từng Page

  Một Meta App có Messenger, webhook trỏ về Hycorn, và Page access token của mỗi Page bạn muốn gắn. Hộp thoại tạo trigger Messenger chỉ đúng URL webhook và từng bước bên Meta.

• Khoá Google Gemini

  Cơ sở kiến thức tìm bằng model nhúng gemini-embedding-001.

• Khoá DeepSeek, hoặc model khác gọi được công cụ

  Bước Lễ tân AI mặc định chạy DeepSeek; đổi sang OpenAI, Gemini, Claude… ngay trong bước đó nếu bạn muốn.

• API của doanh nghiệp (tuỳ chọn)

  Để bot tra giá, lịch trống, đơn hàng thật: một API HTTP của bạn và khoá của nó.

Cài đặt từng bước

1. 1

   Tạo workflow từ mẫu

   Bấm “Dùng mẫu này”: Hycorn tạo một bản nháp trong tài khoản của bạn và mở trình sửa.

2. 2

   Điền thông tin doanh nghiệp

   Mở bước Lễ tân AI, sửa các chỗ [trong ngoặc vuông] ở phần hướng dẫn: tên, lĩnh vực, địa chỉ, giờ mở cửa, hotline, link đặt lịch.

3. 3

   Thêm khoá AI

   Ở mục API key: khoá DeepSeek (hoặc của model bạn chọn) và khoá Google Gemini.

4. 4

   Nạp kiến thức

   Mở trang Kho tri thức, tạo kho le-tan và kéo thả câu hỏi thường gặp, bảng giá, quy định (Excel, PDF, Word) vào đó; hỏi thử ngay bên cạnh.

5. 5

   Xuất bản

   Trigger chạy bản đã xuất bản của workflow, không chạy bản nháp.

6. 6

   Gắn Messenger cho từng Page

   Ở mục Trigger, thêm một trigger Messenger cho mỗi Page: Page ID và khoá messenger_page (Page access token). Rồi làm theo các bước bên Meta mà hộp thoại liệt kê: webhook, verify token, đăng ký Page nhận messages, messaging_postbacks, message_echoes.

7. 7

   Nhắn thử

   Nhắn Page bằng một tài khoản thử — khi Meta App còn ở chế độ phát triển, chỉ người có vai trò trong app mới nhắn được. Mỗi tin là một lần chạy bạn xem lại được trong workflow.

8. 8

   Nối API (tuỳ chọn)

   Thêm một công cụ HTTP ở mục Công cụ với khoá api_key của bạn, rồi chọn nó ở bước Lễ tân AI → Công cụ.

Các bước trong workflow

Đúng như trong bản nháp bạn nhận được — sửa từng bước trong trình sửa sau khi dùng mẫu.

1. 1
   1. Tin nhắn MessengerBắt đầu

   Gắn trigger Messenger cho từng Page ở mục Trigger. Tin khách gửi tới Page (các tin gửi liền nhau được gộp làm một) nằm ở $trigger.input.trigger: text, sender_id, page_id, postback, attachments.

2. 2
   2. Chuẩn bị ngữ cảnhCode

   Lấy câu khách hỏi (chữ, hoặc tên nút bấm), giờ Việt Nam hiện tại và tên cơ sở kiến thức (biến receptionist_kb, không có thì le-tan). Không gọi mạng.

3. 3
   3. Đọc trạng thái tạm dừngĐọc trạng thái

   Khoá hycorn.muted của khách này: có khi nhân viên vừa trả lời trong Page Inbox, hoặc bot vừa chuyển cho nhân viên. Tự hết hạn.

4. 4
   4. Bot đang tạm dừng?Rẽ nhánh

   Đúng: nhân viên đang lo cuộc trò chuyện này — bot không gửi gì.

5. 5
   5. Có nội dung để trả lời?Rẽ nhánh(sau bước 4 · Không)

   Sai khi khách chỉ gửi sticker, ảnh hay tệp (không có chữ, không bấm nút).

6. 6
   6. Tra cứu kiến thứcTìm trong kiến thức(sau bước 5 · Có)

   5 đoạn gần câu hỏi nhất trong cơ sở kiến thức (quy định, câu hỏi thường gặp). Chưa nạp gì thì trả rỗng, không lỗi.

7. 7
   7. Tiếp tục dù tra cứu lỗiNối nhánh(sau bước 6)

   Tra cứu kiến thức lỗi (ví dụ dịch vụ embedding hỏng) thì bot vẫn trả lời bằng công cụ, chỉ không có tài liệu tham khảo.

8. 8
   8. Đã tra cứu xong?Rẽ nhánh

   Bước Nối chạy cả khi nhánh trên không chạy (bot tạm dừng, sticker): chỉ đi tiếp khi tra cứu đã chạy, thành công hay lỗi.

9. 9
   9. Đọc lịch sử hội thoạiĐọc trạng thái(sau bước 8 · Có)

   Tối đa 20 lượt gần nhất với khách này, tự quên sau 30 ngày không nhắn.

10. 10
    10. Chuẩn bị hội thoạiCode

    Câu hỏi lần này + lịch sử đã làm sạch: lịch sử Messenger gửi kèm tin nhắn (nhật ký hội thoại, hoặc lịch sử bạn nhập khi chạy thử), nếu không có thì lịch sử trong kho. Chỉ lượt của khách và của Page, 40 tin gần nhất, bắt đầu bằng lượt của khách.

11. 11
    11. Lễ tân AIAgent AI

    Trả lời như lễ tân từ thông tin doanh nghiệp, kiến thức đã nạp và các công cụ bạn nối thêm. Trả JSON: reply, handoff (cần nhân viên), reason.

12. 12
    12. Soạn tin gửi kháchCode

    Lấy reply từ JSON, sửa link https:\/\/ thành https://, bỏ markdown, đổi gạch đầu dòng thành •.

13. 13
    13. Gửi câu trả lờiGửi tin Messenger

    Gửi bằng khoá của Page khách đã nhắn (đi kèm lần chạy). Tin dài tự tách; mọi tin mang metadata hycorn để không bị nhầm là nhân viên.

14. 14
    14. Ghi lượt hội thoạiCode

    Thêm câu hỏi và câu trả lời vừa gửi vào lịch sử; giữ 20 lượt, dưới 15 KB.

15. 15
    15. Lưu lịch sửLưu trạng thái

    Ghi lịch sử mới của khách này, tự quên sau 30 ngày không nhắn. Các lượt của một khách chạy lần lượt, nên ghi đè không mất lượt nào.

16. 16
    16. Chuyển nhân viên?Rẽ nhánh

    Lễ tân AI báo handoff = true (khách muốn gặp người, khiếu nại, việc ngoài khả năng).

17. 17
    17. Đã trả lờiKết thúc(sau bước 16 · Không)
18. 18
    18. Dừng: nhân viên đang trả lờiKết thúc(sau bước 4 · Có)

    Không gửi gì cho khách.

19. 19
    19. Câu trả lời cho sticker, ảnhMẫu chữ(sau bước 5 · Không)

    Bot chỉ đọc được chữ: nhắc khách nhắn nội dung cần hỏi.

20. 20
    20. Gửi câu trả lời mẫuGửi tin Messenger

    Kèm nút trả lời nhanh; khách bấm nút là thành câu hỏi bằng chữ.

21. 21
    21. Xong (tin không có chữ)Kết thúc
22. 22
    22. Ghi lỗi hệ thốngCode(sau bước 11 · khi lỗi)

    Lễ tân AI lỗi (hết thời gian, nhà cung cấp lỗi): dựng bản ghi tạm dừng.

23. 23
    23. Tạm dừng bot 10 phútLưu trạng thái

    Không gửi lời xin lỗi lặp lại khi hệ thống đang lỗi; nhân viên trả lời thay trong Page Inbox.

24. 24
    24. Lời xin lỗiMẫu chữ
25. 25
    25. Gửi lời xin lỗiGửi tin Messenger
26. 26
    26. Xong (lỗi hệ thống)Kết thúc
27. 27
    27. Ghi lý do chuyểnCode(sau bước 16 · Có)

    Dựng bản ghi {by: bot, reason, at} để lưu vào khoá tạm dừng.

28. 28
    28. Tạm dừng bot 30 phútLưu trạng thái

    Bot im với khách này 30 phút để nhân viên trả lời trong Page Inbox.

29. 29
    29. Đã chuyển nhân viênKết thúc