Hướng dẫn sử dụng SEMJAT dựa trên ảnh chụp màn hình được tạo từ luồng trang tổng quan sem.chat thực. Mỗi hướng dẫn sẽ cho bạn biết nội dung cần nhấp, điều gì sẽ xảy ra sau nhấp chuột, cách kiểm tra, cách khắc phục sự cố và việc cần làm tiếp theo.
Ghi chú ảnh chụp màn hình: mọi hình ảnh trong hướng dẫn này được chụp từ ứng dụng sem.chat thật bằng một không gian làm việc demo. Thông tin tài khoản nhạy cảm, dữ liệu khách hàng, khóa API, chi tiết thanh toán và nội dung cuộc trò chuyện riêng tư được che trước khi xuất bản.
01
Bắt đầu
Tạo tài khoản, hoàn tất quá trình đăng ký, hiểu bảng điều khiển, tạo bot đầu tiên, kiểm tra riêng tư, cài đặt và chọn gói phù hợp.
/xác thựcĐăng ký, dùng thử và bot đầu tiên
1Bắt đầu bằng Đăng ký hoặc Đăng nhập từ trang web hoặc ứng dụng công cộng.
2Xác minh địa chỉ email trước khi dựa vào thông báo hoặc tin nhắn thanh toán.
3Sử dụng tính năng giới thiệu để tạo bot đầu tiên trước khi mở trang tổng quan.
/tổng quanTổng quan sau khi đăng nhập
1Sử dụng các hành động nhanh để tạo bot, xem bot, mở phân tích hoặc quản lý thanh toán.
2Xem lại các bot đang hoạt động, conversations, số phút thoại và mức độ hài lòng trước khi thực hiện thay đổi.
3Kiểm tra hoạt động gần đây sau mỗi lần kiểm tra thiết lập.
Lần ra mắt đầu tiên
Đăng ký, bắt đầu dùng thử và hiểu bảng điều khiển
Cái này dùng để làm gì: Sử dụng quy trình công việc này cho không gian làm việc hoàn toàn mới hoặc khi giới thiệu một đồng đội chưa bao giờ sử dụng sem.chat.
Trước khi bạn bắt đầu
Sử dụng email doanh nghiệp có thể nhận email xác minh và thanh toán.
Quyết định xem ai sẽ sở hữu không gian làm việc trước khi mời những người còn lại trong nhóm.
Giữ một trang web thử nghiệm an toàn hoặc trang dàn dựng sẵn sàng để cài đặt tiện ích.
1
Mở trang đăng ký ứng dụng
Truy cập app.sem.chat/auth từ nút Đăng nhập / Đăng ký trên trang web.
Kết quả mong đợi: Trang xác thực hiển thị các tùy chọn đăng nhập và tạo tài khoản.
2
Tạo tài khoản
Nhập email doanh nghiệp, tạo mật khẩu và gửi biểu mẫu đăng ký.
Kết quả mong đợi: Ứng dụng yêu cầu xác minh hoặc chuyển sang giai đoạn giới thiệu sau khi tài khoản được chấp nhận.
3
Xác minh email
Mở email xác minh và nhấp vào liên kết xác nhận.
Kết quả mong đợi: Tài khoản có thể nhận thông báo thanh toán, lời mời, báo cáo và cảnh báo.
4
Hoàn tất quá trình giới thiệu
Nhập tên doanh nghiệp, mô tả mục tiêu hỗ trợ, chọn màu bắt đầu và tạo bot đầu tiên.
Kết quả mong đợi: Không gian làm việc mở ra với bản nháp bot và trạng thái dùng thử đang hoạt động.
5
Mở Tổng quan
Nhấp vào Tổng quan ở thanh bên trái.
Kết quả mong đợi: Trang tổng quan hiển thị thẻ usage, hành động nhanh và hoạt động gần đây.
6
Chọn hành động tiếp theo
Sử dụng Tạo Bot mới để thiết lập, Xem tất cả Bot để quản lý, Phân tích hiệu suất hoặc Thanh toán cho giới hạn gói.
Kết quả mong đợi: Bạn biết nơi để tiếp tục dựa trên trạng thái của không gian làm việc.
Làm thế nào để kiểm tra nó: Tạo một bot thử nghiệm riêng tư và gửi tin nhắn thử nghiệm trước khi mời đồng đội. Xác nhận những thay đổi về hoạt động Tổng quan sau khi kiểm tra.
vấn đề
sửa chữa
Email xác minh không đến
Kiểm tra thư rác, xác nhận chính tả email, sau đó yêu cầu một email xác minh khác.
Bảng điều khiển mở trên Thanh toán
Không gian làm việc có thể cần một bản dùng thử hoặc kế hoạch tích cực. Bắt đầu dùng thử hoặc chọn gói phù hợp trước khi thiết lập.
Một đồng đội không thể truy cập vào không gian làm việc
Mời họ từ Cài đặt, Nhóm thay vì chia sẻ thông tin đăng nhập của chủ sở hữu.
Phải làm gì tiếp theo: Tạo bot đầu tiên, kiểm tra nó một cách riêng tư, sau đó cài đặt tiện ích trên trang thử nghiệm.
Thử nghiệm ra mắt riêng tư
Tạo thử nghiệm bot riêng tư đầu tiên trước khi đi vào hoạt động
Cái này dùng để làm gì: Sử dụng tính năng này để xác minh tài khoản, bot, tiện ích và theo dõi lịch sử trước khi khách hàng nhìn thấy trợ lý.
Trước khi bạn bắt đầu
Chuẩn bị sẵn một câu hỏi mẫu cho khách hàng.
Chuẩn bị sẵn trang dàn dựng hoặc trang thử nghiệm HTML cục bộ.
Không sử dụng dữ liệu khách hàng thực trong lần thử nghiệm đầu tiên.
1
Mở My Bots
Nhấp vào My Bots trong thanh bên hoặc sử dụng Xem tất cả Bot từ phần Tổng quan.
Kết quả mong đợi: Bạn có thể thấy bot được tạo trong quá trình giới thiệu hoặc trạng thái trống bằng nút Bot mới.
2
Mở trình tạo bot
Nhấp vào Bot mới hoặc Chỉnh sửa trên bot hiện có.
Kết quả mong đợi: Bot Builder mở ra với các điều khiển Cơ bản, Tiện ích, Kiến thức, Giọng nói và tích hợp.
3
Lưu bot một lần
Điền tên bot được yêu cầu và tin nhắn đầu tiên, sau đó nhấp vào Lưu.
Kết quả mong đợi: Bot nhận được ID hợp lệ và có thể tạo mã nhúng.
4
Xem trước riêng tư
Sử dụng bảng xem trước và đặt câu hỏi mẫu của bạn.
Kết quả mong đợi: Câu trả lời phải phù hợp với hướng dẫn của bạn hoặc tiết lộ những kiến thức còn thiếu.
5
Cài đặt trên dàn
Mở Nhúng, sao chép đoạn mã HTML và dán đoạn mã đó trước thẻ nội dung đóng trên trang dàn dựng.
Kết quả mong đợi: Tiện ích xuất hiện ở góc được định cấu hình trên máy tính để bàn và thiết bị di động.
6
Xác nhận theo dõi
Mở Hộp thư đến hoặc Chat History sau cuộc trò chuyện thử nghiệm.
Kết quả mong đợi: Cuộc trò chuyện thử nghiệm sẽ xuất hiện với đúng lịch sử bot, kênh và tin nhắn.
Làm thế nào để kiểm tra nó: Gửi một tin nhắn văn bản và một lần kiểm tra giọng nói nếu giọng nói được bật. Xác nhận cả hai đều xuất hiện trong Chat History.
vấn đề
sửa chữa
Mã nhúng không có sẵn
Lưu bot trước. Nếu đồng bộ hóa giọng nói vẫn đang chờ xử lý, hãy đợi đồng bộ hóa hoặc lưu lại sau khi hoàn tất các trường bắt buộc.
Tiện ích hiển thị bot sai
Xác nhận data-bot-id trong đoạn mã khớp với ID bot từ phương thức Nhúng.
Không có cuộc trò chuyện nào xuất hiện trong lịch sử
Làm mới Chat History, xác nhận bot đang hoạt động và đảm bảo quá trình kiểm tra diễn ra trên tiện ích đã cài đặt chứ không phải trang cũ.
Phải làm gì tiếp theo: Chuyển sang phần thiết lập Bot Builder và đào tạo kiến thức.
02
Tạo và cấu hình Bot
Xây dựng, chỉnh sửa, xem trước, kích hoạt, chuyển hoặc xóa bot khỏi My Bots và Bot Builder.
/bảng điều khiểnMy Bots trung tâm điều khiển
1Nhấp vào Bot mới để bắt đầu một trợ lý mới.
2Sử dụng Chỉnh sửa, Nhúng, Chuyển, Kích hoạt hoặc Xóa trên mỗi thẻ bot.
3Kiểm tra trạng thái hoạt động và thời gian cập nhật lần cuối trước khi thử nghiệm.
/bots/:id/chỉnh sửaBot Builder tab cơ bản
1Điền tên bot, hình đại diện, tin nhắn đầu tiên và hướng dẫn hệ thống.
2Sử dụng Preview để kiểm tra trước khi xuất bản.
3Lưu và đồng bộ trước khi sao chép mã nhúng.
Tạo bot
Tạo bot mới từ My Bots
Cái này dùng để làm gì: Sử dụng quy trình làm việc này khi thương hiệu, trang web, hàng đợi hỗ trợ hoặc chiến dịch mới cần trợ lý riêng.
Trước khi bạn bắt đầu
Chuẩn bị tên bot, mục tiêu, tin nhắn đầu tiên và hai hoặc ba câu hỏi mẫu.
Thu thập trang web công cộng URL nếu bạn định nhập nội dung.
Xác nhận gói cho phép số lượng bot và tính năng giọng nói/hình đại diện mà bạn cần.
1
Mở My Bots
Nhấp vào My Bots ở thanh bên.
Kết quả mong đợi: Các bot hiện có và nút Bot mới sẽ hiển thị.
2
Nhấp vào Bot mới
Bắt đầu bot mới từ trang My Bots.
Kết quả mong đợi: Bot Builder mở đầu bằng trợ lý nháp.
3
Đặt danh tính bot
Nhập Tên Bot, tải lên hoặc chọn hình đại diện và viết tin nhắn đầu tiên mà khách truy cập sẽ nhìn thấy.
Kết quả mong đợi: Bảng xem trước phản ánh tên trợ lý, hình đại diện và lời chào.
4
Viết hướng dẫn hệ thống
Mô tả những gì bot nên làm, cách nó nói, những gì nó nên tránh và khi nào nó nên yêu cầu sự giúp đỡ của con người.
Kết quả mong đợi: Trợ lý có quy tắc ứng xử rõ ràng trước khi bổ sung kiến thức.
5
Bổ sung kiến thức cơ bản
Dán thông tin cần thiết về công ty, sản phẩm, hỗ trợ, giá cả và liên hệ vào vùng kiến thức.
Kết quả mong đợi: Bot có thể trả lời các câu hỏi phổ biến mà không cần nhập trang web.
6
Lưu bot
Nhấp vào Lưu và đợi xác nhận đã lưu hoặc đồng bộ hóa.
Kết quả mong đợi: Bot có ID ổn định, có thể kiểm tra bản xem trước và có sẵn các tùy chọn nhúng.
7
Xem trước kết quả
Đặt các câu hỏi mẫu đã chuẩn bị sẵn trong Bản xem trước.
Kết quả mong đợi: Câu trả lời phải tuân theo hướng dẫn và sử dụng kiến thức bạn đã nhập.
8
Chỉ kích hoạt khi sẵn sàng
Bật bot hoạt động sau khi vượt qua bài kiểm tra riêng tư.
Kết quả mong đợi: Bot đã sẵn sàng cho lưu lượng truy cập widget hoặc kênh.
Làm thế nào để kiểm tra nó: Hãy hỏi ít nhất năm câu hỏi thực tế. Kiểm tra xem câu trả lời có đúng hay không, liệu nó có còn gắn liền với thương hiệu hay không và liệu nó có yêu cầu sự trợ giúp của con người khi cần hay không.
vấn đề
sửa chữa
Câu trả lời quá chung chung
Bổ sung kiến thức cụ thể hơn và viết lại hướng dẫn kèm ví dụ về câu trả lời hay.
Bot từ chối các câu hỏi cần trả lời
Loại bỏ những hướng dẫn quá nghiêm ngặt và bổ sung những kiến thức đáng tin cậy cho chủ đề đó.
Lưu không tạo mã nhúng
Kiểm tra các trường bắt buộc và lưu lại sau khi quá trình đồng bộ hóa nhà cung cấp giọng nói kết thúc.
Phải làm gì tiếp theo: Định cấu hình cài đặt tiện ích, thêm kiến thức về trang web, sau đó cài đặt bot.
Quản lý bot
Chỉnh sửa, sao chép quy trình làm việc, chuyển, hủy kích hoạt hoặc xóa bot
Cái này dùng để làm gì: Sử dụng quy trình làm việc này khi bot cần cập nhật, thay đổi quyền sở hữu, tạm dừng tạm thời hoặc xóa vĩnh viễn.
Trước khi bạn bắt đầu
Xuất mọi dữ liệu cuộc trò chuyện hoặc liên hệ mà bạn phải giữ lại trước khi xóa bot.
Xác nhận bot không được nhúng trên trang web trực tiếp trước khi xóa hoặc chuyển nó.
Báo cho đồng đội trước khi tắt bot sản xuất.
1
Mở My Bots
Tìm thẻ bot theo tên hoặc trạng thái.
Kết quả mong đợi: Thẻ hiển thị trạng thái hiện tại và các hành động sẵn có.
2
Nhấp vào Chỉnh sửa
Mở trình tạo bot và thực hiện các thay đổi cần thiết.
Kết quả mong đợi: Trình chỉnh sửa tải cấu hình hiện tại.
3
Lưu và kiểm tra lại
Nhấp vào Lưu sau mỗi lần thay đổi tài liệu, sau đó chạy các câu hỏi xem trước.
Kết quả mong đợi: Cấu hình đã lưu được sử dụng bởi tiện ích xem trước và cài đặt.
4
Tắt tạm thời
Sử dụng nút chuyển đổi đang hoạt động nếu bot tạm thời ngừng xử lý khách truy cập.
Kết quả mong đợi: Bot ngừng phân phát lưu lượng truy cập trực tiếp trong khi vẫn duy trì cấu hình.
5
Chuyển quyền sở hữu
Sử dụng Chuyển khoản, nhập email người nhận và xác nhận.
Kết quả mong đợi: Tài khoản đã chọn sẽ nhận quyền sở hữu theo quy trình chuyển ứng dụng.
6
Chỉ xóa sau khi kiểm tra
Sử dụng Xóa, đọc cảnh báo và chỉ xác nhận khi không còn cần đến bot nữa.
Kết quả mong đợi: Bot và cấu hình liên quan sẽ bị xóa theo cảnh báo.
Làm thế nào để kiểm tra nó: Sau khi chỉnh sửa, hãy mở tiện ích đã cài đặt và đặt câu hỏi chính xác đã thúc đẩy sự thay đổi. Xác nhận câu trả lời trực tiếp đã thay đổi.
vấn đề
sửa chữa
Câu trả lời cũ vẫn xuất hiện
Làm mới trang web, xác nhận bạn đã lưu đúng bot và kiểm tra xem kiến thức đã nhập có cần đồng bộ hóa hay không.
Chuyển không thành công
Xác nhận email người nhận là hợp lệ và tài khoản đích có thể chấp nhận bot.
Xóa do bấm nhầm
Dừng lại trước khi xác nhận cuối cùng. Cảnh báo xóa tồn tại vì hành động này có thể xóa vĩnh viễn dữ liệu bot.
Phải làm gì tiếp theo: Xem lại phân tích và lịch sử sau khi thay đổi trực tiếp để đảm bảo trải nghiệm của khách truy cập được cải thiện.
03
Cài đặt tiện ích
Sao chép mã nhúng chính xác, cài đặt mã đó trong các ngữ cảnh HTML, WordPress, React hoặc SDK nâng cao, sau đó xác minh hành vi của máy tính để bàn và thiết bị di động.
Nhúng phương thứcSao chép đoạn cài đặt trang web
1Chọn HTML, WordPress, React hoặc NPM/SDK dựa trên ngăn xếp trang web.
2Sao chép mã sau khi bot được lưu và đồng bộ hóa.
3Dán đoạn mã trước thẻ nội dung đóng hoặc trong bố cục khung.
HTML cài đặt
Cài đặt tiện ích trên trang web HTML chuẩn
Cái này dùng để làm gì: Sử dụng tùy chọn này khi bạn có thể chỉnh sửa mẫu trang, chân trang chủ đề hoặc bố cục HTML toàn cầu.
Trước khi bạn bắt đầu
Trước tiên hãy lưu bot để phương thức nhúng có ID bot thực.
Sử dụng một trang web dàn dựng trước khi sản xuất.
Giữ phiên bản tập lệnh chính xác và data-bot-id từ phương thức.
1
Mở My Bots
Tìm bot bạn muốn cài đặt và nhấp vào Nhúng.
Kết quả mong đợi: Phương thức Nhúng mở ra với các tab cài đặt.
2
Chọn HTML
Chọn tab HTML và nhấp vào Sao chép mã.
Kết quả mong đợi: Tập lệnh widget được sao chép có đính kèm ID bot.
3
Mở mẫu trang web
Chỉnh sửa tệp bố cục hoặc chân trang chung hiển thị trên mọi trang nơi tiện ích sẽ xuất hiện.
Kết quả mong đợi: Bạn đang chỉnh sửa phần vỏ trang web được chia sẻ chứ không phải một trang riêng biệt trừ khi đó là chủ ý.
4
Dán trước khi đóng phần thân
Dán đoạn mã ngay trước thẻ đóng body.
Kết quả mong đợi: Tập lệnh tải sau nội dung trang và có thể gắn vùng chứa tiện ích.
5
Xuất bản hoặc triển khai
Lưu mẫu và triển khai trang web.
Kết quả mong đợi: Tập lệnh widget có sẵn trên các trang mục tiêu.
6
Kiểm tra máy tính để bàn và thiết bị di động
Mở trang web trong cửa sổ trình duyệt mới và trên chế độ xem trên thiết bị di động.
Kết quả mong đợi: Tiện ích xuất hiện ở vị trí đã định cấu hình và mở mà không gặp lỗi bảng điều khiển.
Làm thế nào để kiểm tra nó: Gửi tin nhắn từ trang trực tiếp, sau đó mở Hộp thư đến và Chat History để xác nhận cuộc trò chuyện thuộc về đúng bot.
vấn đề
sửa chữa
Thiếu tiện ích
Xác nhận mã nằm trước thẻ nội dung đóng, tập lệnh không bị trình tạo trang web chặn và bot đang hoạt động.
Xuất hiện bot sai
Sao chép lại đoạn mã và so sánh data-bot-id với bot mong muốn.
Điều khiển trang chồng chéo widget
Thay đổi vị trí hoặc kích thước trong Cài đặt tiện ích và kiểm tra lại trên thiết bị di động.
Phải làm gì tiếp theo: Điều chỉnh cài đặt tiện ích và thu thập khách hàng tiềm năng sau khi cài đặt.
Cài đặt trong luồng WordPress, React hoặc giọng nói nâng cao SDK
Cái này dùng để làm gì: Sử dụng tùy chọn này khi trang web được quản lý bởi CMS, ứng dụng React hoặc tích hợp giọng nói tùy chỉnh.
Trước khi bạn bắt đầu
Biết ngăn xếp nào sở hữu bố cục được chia sẻ.
Sử dụng đoạn mã chính xác được hiển thị trong sem.chat cho bot đã chọn.
Để sử dụng SDK nâng cao, hãy xác nhận rằng bạn có Vapi khóa công khai và ID trợ lý bắt buộc.
1
tùy chọn WordPress
Sử dụng Giao diện, Trình chỉnh sửa chủ đề, footer.php hoặc plugin đầu trang và chân trang đáng tin cậy.
Kết quả mong đợi: Đoạn mã được tải trên các trang WordPress công khai.
2
tùy chọn React
Tạo một thành phần ChatWidget nhỏ, nối tập lệnh vào useEffect và hiển thị tập lệnh đó trong bố cục gốc.
Kết quả mong đợi: Tiện ích tải một lần và dọn dẹp nếu bố cục bị ngắt kết nối.
3
Tùy chọn SDK nâng cao
Chỉ sử dụng tab NPM/SDK khi bạn cần điều khiển cuộc gọi thoại tùy chỉnh ngoài tiện ích mặc định.
Kết quả mong đợi: Ứng dụng của bạn kiểm soát phiên thoại trong khi sem.chat vẫn là nguồn trợ lý được định cấu hình.
4
Xác minh ID bot
Xác nhận mã đã cài đặt tham chiếu ID bot từ phương thức Nhúng.
Kết quả mong đợi: Tiện ích trực tiếp kết nối với trợ lý dự định.
5
Kiểm tra bảng điều khiển
Mở công cụ dành cho nhà phát triển trình duyệt và tải lại.
Kết quả mong đợi: Không có lỗi tập lệnh bị chặn, vùng chứa trùng lặp hoặc lỗi mạng.
Làm thế nào để kiểm tra nó: Hoàn thành một tin nhắn kiểm tra từ trang web đã cài đặt, sau đó xác nhận nó xuất hiện trong Hộp thư đến với trang dự kiến URL.
vấn đề
sửa chữa
React tải các tiện ích trùng lặp
Bảo vệ việc chèn tập lệnh bằng một tham chiếu hoặc chỉ hiển thị thành phần trong bố cục gốc.
WordPress loại bỏ các thẻ tập lệnh
Sử dụng plugin chèn chân trang hoặc tệp chủ đề cho phép tập lệnh.
SDK cuộc gọi không thể bắt đầu
Kiểm tra khóa chung, ID trợ lý, quyền của trình duyệt và quyền truy cập gói cho giọng nói.
Phải làm gì tiếp theo: Di chuyển tới Cài đặt tiện ích để kiểm soát hành vi, thương hiệu và thu thập khách hàng tiềm năng.
npm install @vapi-ai/web
import Vapi from '@vapi-ai/web';
const vapi = new Vapi('YOUR_VAPI_PUBLIC_KEY');
await vapi.start('YOUR_ASSISTANT_ID');
vapi.on('call-start', () => console.log('Call started'));
vapi.on('call-end', () => console.log('Call ended'));
04
Cài đặt tiện ích
Định cấu hình chế độ, chủ đề, kích thước, vị trí, màu sắc, nhãn hiệu, phản ứng, âm thanh, sự đồng ý, thu thập khách hàng tiềm năng, xếp hạng, email theo dõi và trạng thái kích hoạt.
Bot Builder / Tiện íchSự xuất hiện của widget và hành vi của khách truy cập
1Chọn chat, giọng nói hoặc chế độ kết hợp.
2Đặt chủ đề, màu sắc, vị trí, kích thước, nhãn hiệu, sự đồng ý và âm thanh.
3Định cấu hình thu thập khách hàng tiềm năng, xếp hạng, phản ứng và hành vi theo dõi.
Hành vi của tiện ích
Định cấu hình hành vi của tiện ích hướng tới khách truy cập
Cái này dùng để làm gì: Sử dụng tính năng này sau lần cài đặt đầu tiên hoặc bất cứ lúc nào tiện ích cần phù hợp với trang web và thu hút khách hàng tiềm năng tốt hơn.
Trước khi bạn bắt đầu
Cài đặt tiện ích trên trang dàn dựng.
Biết liệu khách truy cập nên bắt đầu bằng chat, giọng nói hay cả hai.
Chuẩn bị sự đồng ý và bản sao thu thập khách hàng tiềm năng nếu được yêu cầu đối với khu vực.
1
Mở trình tạo bot
Mở My Bots, nhấp vào Chỉnh sửa, sau đó chọn tab Tiện ích.
Kết quả mong đợi: Điều khiển widget xuất hiện cho bot đã chọn.
2
Chọn chế độ
Chọn Trò chuyện, Thoại hoặc Kết hợp dựa trên trải nghiệm của khách truy cập mà bạn muốn.
Kết quả mong đợi: Bản xem trước thay đổi để hiển thị chế độ đã chọn.
3
Đặt giao diện
Chọn chủ đề, màu sắc, kích thước, vị trí nút và các tùy chọn nhãn hiệu.
Kết quả mong đợi: Tiện ích phù hợp với trang web mà không bao gồm nội dung quan trọng.
4
Bật kiểm soát khách truy cập
Bật hoặc tắt lời nhắc phản hồi, âm thanh, xếp hạng và sự đồng ý.
Kết quả mong đợi: Khách truy cập chỉ nhìn thấy các điều khiển mà bạn muốn họ sử dụng.
5
Định cấu hình thu thập khách hàng tiềm năng
Chọn các trường bắt buộc, trường mô tả tùy chọn và thời điểm biểu mẫu xuất hiện.
Kết quả mong đợi: Danh bạ được thu thập trước hoặc trong conversations theo thiết lập của bạn.
6
Đặt email theo dõi
Định cấu hình hành vi email tiếp theo nếu kế hoạch của bạn bao gồm nó.
Kết quả mong đợi: Khách truy cập có thể nhận được tin nhắn tiếp theo sau khi giải quyết conversations.
7
Lưu và kiểm tra
Nhấp vào Lưu, tải lại trang dàn dựng và mở tiện ích.
Kết quả mong đợi: Tiện ích trực tiếp khớp với cài đặt đã lưu.
Làm thế nào để kiểm tra nó: Mở tiện ích trên máy tính để bàn và thiết bị di động, gửi biểu mẫu khách hàng tiềm năng, để lại xếp hạng và xác nhận liên hệ cũng như cuộc trò chuyện đã được ghi lại.
vấn đề
sửa chữa
Màu sắc chưa cập nhật
Lưu bot, làm mới trang web và xác nhận tiện ích đã cài đặt sử dụng cùng một ID bot.
Trường khách hàng tiềm năng bị thiếu
Xác nhận việc thu thập khách hàng tiềm năng đã được bật và đáp ứng điều kiện kích hoạt đã chọn.
Khách truy cập không thể sử dụng giọng nói
Kiểm tra cài đặt Giọng nói, quyền sử dụng micrô của trình duyệt, quyền truy cập gói và giới hạn số phút thoại.
Phải làm gì tiếp theo: Thêm cài đặt giọng nói/hình đại diện và nguồn kiến thức trước khi bắt đầu sản xuất.
05
Giọng nói và Hình đại diện
Chọn giọng nói gốc, định cấu hình chế độ và giới hạn giọng nói, đọc bản ghi, sao chép giọng nói, gán giọng nói nhân bản và quản lý hình đại diện cổ phiếu hoặc tùy chỉnh.
Bot Builder / Giọng nóiGiọng nói, giới hạn, bản chép lời và hình đại diện
1Chọn một giọng nói gốc hoặc một giọng nói nhân bản đã lưu.
2Đặt giới hạn số phút thoại và lưu bản ghi.
3Chọn hình đại diện có sẵn hoặc tải lên hình đại diện tùy chỉnh nếu gói cho phép.
Thiết lập giọng nói
Thiết lập cuộc gọi thoại và bản chép lời
Cái này dùng để làm gì: Hãy sử dụng tính năng này khi khách truy cập cần nói chuyện với bot thay vì chỉ gõ phím.
Trước khi bạn bắt đầu
Xác nhận gói bao gồm số phút thoại và các tùy chọn giọng nói/hình đại diện mong muốn.
Sử dụng môi trường trình duyệt yên tĩnh để thử nghiệm.
Chuẩn bị một câu hỏi hỗ trợ hoặc bán hàng thực tế để kiểm tra bằng giọng nói.
1
Mở cài đặt Giọng nói
Mở trình tạo bot và chọn khu vực Giọng nói hoặc Giọng nói và Hình đại diện.
Kết quả mong đợi: Điều khiển bằng giọng nói và lựa chọn giọng nói hiện tại có thể nhìn thấy được.
2
Chọn một giọng nói chứng khoán
Xem trước các giọng nói có sẵn, chọn giọng nói phù hợp nhất và lưu lựa chọn.
Kết quả mong đợi: Bot sử dụng giọng nói đã chọn cho cuộc gọi.
3
Định cấu hình chế độ giọng nói
Sử dụng Cài đặt tiện ích để chọn Thoại hoặc Kết hợp khi có sẵn giọng nói cho khách truy cập.
Kết quả mong đợi: Khách truy cập sẽ thấy tùy chọn giọng nói trong tiện ích.
4
Đặt giới hạn giọng nói
Xác định giới hạn cho mỗi người dùng hoặc không gian làm việc nếu có.
Kết quả mong đợi: Các cuộc gọi dài hoặc lặp đi lặp lại không thể tiêu tốn nhiều phút hơn dự định.
5
Bật bản ghi
Bật tính năng lưu bản ghi nếu bạn cần xem lại cuộc gọi trong lịch sử.
Kết quả mong đợi: Cuộc gọi thoại tạo bản ghi có thể đọc được sau phiên.
6
Kiểm tra cuộc gọi
Mở tiện ích, cho phép truy cập micrô, bắt đầu cuộc gọi và đặt câu hỏi đã chuẩn bị sẵn.
Kết quả mong đợi: Bot sẽ phản hồi bằng giọng nói và cuộc gọi kết thúc suôn sẻ.
7
Đọc bản ghi
Mở Chat History và tìm cuộc trò chuyện thoại.
Kết quả mong đợi: Bản ghi cho thấy những gì khách truy cập và bot đã nói.
Làm thế nào để kiểm tra nó: Hoàn thành một cuộc gọi ngắn và xác nhận số phút thoại, bản chép lời và chế độ hội thoại đã được ghi lại.
vấn đề
sửa chữa
Trình duyệt chặn micrô
Cho phép quyền sử dụng micrô trong trình duyệt và tải lại trang.
Tùy chọn giọng nói đã bị khóa
Mở Thanh toán và xác nhận gói không gian làm việc có bao gồm các tính năng thoại.
Bản ghi trống
Xác nhận tính năng lưu bản ghi đã được bật và cuộc gọi đã kết thúc bình thường.
Phải làm gì tiếp theo: Bổ sung hoặc tinh chỉnh kiến thức để câu trả lời bằng giọng nói được chính xác.
Bản sao giọng nói và hình đại diện
Sao chép giọng nói và gán hình đại diện tùy chỉnh
Cái này dùng để làm gì: Sử dụng tính năng này khi trợ lý cần trải nghiệm giọng nói có thương hiệu hoặc hình đại diện nói chuyện.
Trước khi bạn bắt đầu
Chỉ sử dụng âm thanh và hình ảnh mà bạn được phép sử dụng.
Ghi lại các mẫu giọng nói rõ ràng với độ nhiễu nền thấp.
Xác nhận giới hạn gói cho giọng nói nhân bản và hình đại diện tùy chỉnh.
1
Nhân bản giọng nói mở
Nhấp vào Sao chép giọng nói từ vùng Giọng nói.
Kết quả mong đợi: Hộp thoại tải lên hiển thị các yêu cầu mẫu được chấp nhận.
2
Tải mẫu lên
Tải lên từ một đến năm bản ghi rõ ràng và gửi yêu cầu sao chép.
Kết quả mong đợi: Giọng nói nhân bản xuất hiện sau khi xử lý hoặc hộp thoại hiển thị yêu cầu tiếp theo.
3
Gán giọng nói nhân bản
Chọn giọng nói nhân bản trong bộ chọn giọng nói và lưu.
Kết quả mong đợi: Các cuộc gọi trong tương lai sử dụng giọng nói nhân bản.
4
Chọn một hình đại diện có sẵn
Chọn một hình đại diện đi kèm nếu không cần tải lên hình đại diện tùy chỉnh.
Kết quả mong đợi: Trải nghiệm giọng nói có bản sắc trực quan.
5
Tải lên hình đại diện tùy chỉnh
Tải lên hình ảnh khuôn mặt rõ ràng hoặc video ngắn nếu gói của bạn hỗ trợ.
Kết quả mong đợi: Hình đại diện được xử lý và có sẵn để lựa chọn.
6
Chạy bản xem trước đầy đủ
Bắt đầu cuộc gọi thoại và xác nhận hành vi giọng nói, hình đại diện và bản ghi cùng nhau.
Kết quả mong đợi: Trải nghiệm của khách truy cập phù hợp với thương hiệu được định cấu hình.
Làm thế nào để kiểm tra nó: Đặt một câu hỏi ngắn với giọng nói nhân bản được chọn và xác nhận cuộc gọi sử dụng giọng nói/hình đại diện dự kiến.
vấn đề
sửa chữa
Chất lượng bản sao kém
Ghi âm mẫu sạch hơn bằng một loa, âm lượng ổn định và không có nhạc.
Tải lên hình đại diện tùy chỉnh không khả dụng
Kiểm tra Thanh toán để biết giới hạn hình đại diện theo kế hoạch.
Tiếng xưa vẫn vang lên
Lưu bot sau khi chọn giọng nói mới và tải lại trang widget.
Phải làm gì tiếp theo: Tiếp tục với Kiến thức và Dữ liệu để trải nghiệm giọng nói có câu trả lời chính xác.
06
Kiến thức và dữ liệu
Thêm kiến thức thủ công, nhập nội dung trang web, áp dụng kết quả thu thập thông tin, đồng bộ hóa nội dung đã nhập, thêm nguồn cấp dữ liệu sản phẩm URLs, làm mới hoặc xóa nguồn cấp dữ liệu và xác minh câu trả lời bằng các câu hỏi kiểm tra.
Bot Builder / Kiến thứcNguồn kiến thức và kiểm tra câu trả lời
1Thêm kiến thức thủ công về chính sách, giá cả và quy tắc thương hiệu.
2Nhập các trang web và áp dụng kết quả thu thập dữ liệu.
3Thêm nguồn cấp dữ liệu sản phẩm và đồng bộ hóa chúng khi hàng tồn kho thay đổi.
Nguồn tri thức
Đào tạo bot bằng kiến thức thủ công, nhập trang web và nguồn cấp dữ liệu sản phẩm
Cái này dùng để làm gì: Hãy sử dụng tùy chọn này bất cứ khi nào trợ lý đưa ra câu trả lời không đầy đủ hoặc cần thông tin mới về sản phẩm, chính sách hoặc trang web.
Trước khi bạn bắt đầu
Chuẩn bị nguồn URLs và nguồn cấp dữ liệu sản phẩm URLs.
Quyết định những trang nào không nên nhập, chẳng hạn như trang quản trị hoặc trang riêng tư.
Tạo câu hỏi kiểm tra cho mỗi chủ đề bạn thêm vào.
1
Kiến thức mở
Mở Bot Builder và chọn tab Kiến thức hoặc Dữ liệu.
Kết quả mong đợi: Kiến thức thủ công, nhập trang web và công cụ cấp dữ liệu sản phẩm được hiển thị.
2
Bổ sung kiến thức thủ công
Dán các thông tin, chính sách, giá cả, chi tiết liên hệ và ghi chú về phong cách trả lời ngắn gọn.
Kết quả mong đợi: Bot có nguồn đáng tin cậy ngay lập tức cho các câu trả lời có mức độ ưu tiên cao.
3
Nhập nội dung trang web
Dán trang web công cộng URL và bắt đầu thu thập/nhập.
Kết quả mong đợi: Kết quả thu thập thông tin hiển thị các trang được phát hiện hoặc trạng thái nhập.
4
Xem xét và áp dụng kết quả
Giữ lại những trang hữu ích, loại bỏ những trang không liên quan, sau đó áp dụng nội dung đã chọn.
Kết quả mong đợi: Chỉ nội dung trang web được phê duyệt mới được đưa vào cơ sở kiến thức.
5
Thêm nguồn cấp dữ liệu sản phẩm URLs
Dán Google Merchant Center hoặc nguồn cấp dữ liệu được hỗ trợ URLs và nhập.
Kết quả mong đợi: Sản phẩm, giá cả, tính sẵn có và thuộc tính sẽ có sẵn cho bot.
6
Làm mới hoặc xóa nguồn cấp dữ liệu
Sử dụng tính năng làm mới khi dữ liệu danh mục thay đổi và xóa các nguồn cấp dữ liệu không còn được sử dụng.
Kết quả mong đợi: Bot tránh dữ liệu sản phẩm cũ hoặc trùng lặp.
7
Lưu và đồng bộ hóa
Lưu bot và đợi quá trình đồng bộ hóa hoàn tất.
Kết quả mong đợi: Kiến thức mới nhất được sử dụng để xem trước và trả lời tiện ích trực tiếp.
8
Đặt câu hỏi xác minh
Hỏi một câu hỏi kiểm tra cho mỗi nguồn bạn đã thêm.
Kết quả mong đợi: Câu trả lời trích dẫn hoặc phản ánh chính xác nội dung cập nhật.
Làm thế nào để kiểm tra nó: Đặt câu hỏi về giá cả, lợi nhuận, tình trạng còn hàng, thông tin công ty và các chủ đề không được hỗ trợ. Xác nhận bot trả lời các chủ đề đã biết và không phát minh ra các chi tiết chưa biết.
vấn đề
sửa chữa
Trình thu thập thông tin nhập các trang không liên quan
Xóa các trang đó khỏi kết quả đã chọn và thêm hướng dẫn thủ công rõ ràng hơn.
Giá sản phẩm đã cũ
Làm mới nguồn cấp dữ liệu và xác nhận nguồn cấp dữ liệu URL có chứa các giá trị hiện tại.
Bot tạo nên câu trả lời
Thêm quy tắc mà bot phải nói rằng nó không chắc chắn và đưa ra sự hỗ trợ của con người khi thiếu kiến thức.
Phải làm gì tiếp theo: Quay lại Xem trước, kiểm tra lại, sau đó cài đặt hoặc cập nhật tiện ích.
07
Hộp thư đến, Live Support, Lịch sử, Danh bạ
Xử lý conversations hàng ngày, yêu cầu yêu cầu hỗ trợ trực tiếp, điều khiển bằng tay trở lại AI, xuất lịch sử, quản lý danh bạ và đồng bộ hóa danh bạ với SendPulse.
/hộp thư đếnQuy trình hội thoại trong hộp thư đến
1Lọc theo bot hoặc kênh.
2Mở một cuộc trò chuyện và trả lời như một con người khi cần thiết.
3Sử dụng các điều khiển dịch, giải quyết và chuyển giao một cách cẩn thận.
/hỗ trợ trực tiếpKiểm soát chuyển giao hỗ trợ trực tiếp
1Yêu cầu chờ bàn giao nhanh chóng.
2Trả lời với tư cách là người đại diện hoặc chuyển cuộc trò chuyện lại cho AI.
3Giải quyết khi khách truy cập không còn cần sự giúp đỡ của con người.
/chat-lịch sửLịch sử hội thoại và xuất khẩu
1Tìm kiếm theo khách truy cập, bot, kênh hoặc ngày.
2Mở bản ghi đầy đủ cho các phiên văn bản và giọng nói.
3Xuất CSV hoặc JSON khi cần.
/liên hệDanh bạ và xuất SendPulse
1Lọc danh bạ theo bot hoặc nguồn.
2Mở chi tiết liên hệ và bối cảnh cuộc trò chuyện.
3Xuất hoặc đồng bộ hóa các liên hệ đã chọn sang SendPulse.
Trả lời hộp thư đến
Mở một cuộc trò chuyện và gửi câu trả lời của con người
Cái này dùng để làm gì: Sử dụng tính năng này khi nhà điều hành cần phản hồi khách hàng từ sem.chat thay vì để AI tiếp tục một mình.
Trước khi bạn bắt đầu
Xác nhận người vận hành có quyền truy cập vào bot hoặc không gian làm việc.
Đọc cuộc trò chuyện trước khi trả lời.
Biết liệu khách truy cập có mong đợi cùng một ngôn ngữ hay không.
1
Mở hộp thư đến
Nhấp vào Hộp thư đến trong thanh bên.
Kết quả mong đợi: conversations gần đây xuất hiện cùng với bot, kênh, khách truy cập, trạng thái và thời gian.
2
Lọc nếu cần
Sử dụng các bộ lọc kênh, bot, chưa đọc hoặc trạng thái để tìm cuộc trò chuyện.
Kết quả mong đợi: Danh sách thu hẹp vào bộ hội thoại bạn cần.
3
Mở cuộc trò chuyện
Nhấp vào hàng khách truy cập.
Kết quả mong đợi: Toàn bộ chuỗi, thông tin khách truy cập và điều khiển trả lời đều hiển thị.
4
Dịch nếu cần
Sử dụng điều khiển dịch khi ngôn ngữ của khách truy cập khác với ngôn ngữ của nhân viên hỗ trợ.
Kết quả mong đợi: Người đại diện có thể hiểu và trả lời phù hợp.
5
Gửi trả lời
Viết phản hồi của con người và gửi nó.
Kết quả mong đợi: Tin nhắn được thêm vào chuỗi dưới dạng phản hồi của tác nhân/con người.
6
Giải quyết hoặc tiếp tục mở
Giải quyết cuộc trò chuyện nếu đã hoàn tất hoặc để ngỏ để theo dõi.
Kết quả mong đợi: Trạng thái hộp thư đến khớp với trạng thái thực của khách hàng.
Làm thế nào để kiểm tra nó: Gửi câu trả lời kiểm tra an toàn cho cuộc trò chuyện kiểm tra và xác nhận nó xuất hiện trong tiện ích dành cho khách truy cập và Chat History.
vấn đề
sửa chữa
Trả lời không gửi được
Kiểm tra trạng thái mạng, trạng thái hội thoại và liệu hỗ trợ trực tiếp có được yêu cầu hay không.
Ngôn ngữ của khách truy cập sai
Sử dụng bản dịch hoặc cập nhật cài đặt ngôn ngữ của bot trước khi trả lời.
Cuộc trò chuyện không có trong Hộp thư đến
Tìm kiếm Chat History và xác nhận việc kiểm tra tiện ích đã sử dụng đúng bot.
Phải làm gì tiếp theo: Sử dụng Live Support cho hàng đợi chuyển giao đang hoạt động và Chat History cho kiểm tra.
Hỗ trợ trực tiếp
Yêu cầu, trả lời, chuyển giao lại cho AI và giải quyết chuyển giao
Cái này dùng để làm gì: Sử dụng điều này khi AI yêu cầu một con người hoặc một khách truy cập rõ ràng cần một tác nhân.
Trước khi bạn bắt đầu
Có sẵn một đại lý trước khi cho phép hỗ trợ trực tiếp.
Xác định thời điểm AI nên yêu cầu chuyển giao trong hướng dẫn của bot.
Luôn bật cài đặt thông báo cho cảnh báo chuyển giao.
1
Mở Live Support
Nhấp vào Live Support ở thanh bên.
Kết quả mong đợi: Đang chờ và chuyển giao đang hoạt động conversations hiển thị.
2
Yêu cầu yêu cầu
Nhấp vào Xác nhận quyền sở hữu đối với cuộc trò chuyện đang chờ.
Kết quả mong đợi: Các tổng đài viên khác có thể thấy cuộc trò chuyện được xử lý tích cực.
3
Đọc ngữ cảnh
Mở tin nhắn và thông tin chi tiết về khách truy cập trước khi trả lời.
Kết quả mong đợi: Người đại diện hiểu tại sao việc chuyển giao lại xảy ra.
4
Gửi câu trả lời của con người
Trả lời rõ ràng và cập nhật chủ đề.
Kết quả mong đợi: Người truy cập nhận được phản hồi của con người.
5
Trao lại cho AI nếu thích hợp
Hãy quay lại khi vấn đề được giải quyết và AI có thể tiếp tục.
Kết quả mong đợi: AI tiếp tục xử lý cuộc trò chuyện.
6
Giải quyết khi hoàn tất
Nhấp vào Giải quyết sau khi khách truy cập không cần trợ giúp nữa.
Kết quả mong đợi: Việc chuyển giao được đóng lại và loại bỏ khỏi hàng đợi đang hoạt động.
Làm thế nào để kiểm tra nó: Tạo bản bàn giao thử nghiệm, yêu cầu, trả lời một lần, gửi lại và xác nhận các thay đổi trạng thái trong Live Support và Chat History.
vấn đề
sửa chữa
Đại lý bỏ lỡ yêu cầu
Bật thông báo trình duyệt/email/đẩy và thêm quy trình sở hữu hàng đợi.
AI tiếp tục chiếm lĩnh quá sớm
Điều chỉnh các hướng dẫn và quy tắc bàn giao để sự kiểm soát của con người vẫn hoạt động cho đến khi được giải quyết hoặc bàn giao lại.
CRM bên ngoài không đồng bộ
Sử dụng webhooks hoặc bỏ phiếu từ phần Bí quyết dành cho nhà phát triển.
Phải làm gì tiếp theo: Kết nối CRM/webhooks nếu nhóm hỗ trợ làm việc bên ngoài sem.chat.
Lịch sử và liên hệ
Tìm kiếm, xuất và sử dụng bản ghi cuộc trò chuyện/liên hệ
Cái này dùng để làm gì: Sử dụng tính năng này để kiểm tra, đánh giá khách hàng tiềm năng, xuất CSV và đồng bộ hóa SendPulse.
Trước khi bạn bắt đầu
Quyết định xem bạn cần conversations, danh bạ hay cả hai.
Áp dụng phạm vi ngày chính xác trước khi xuất.
Không xuất nhiều dữ liệu cá nhân hơn mức cần thiết.
1
Mở Chat History
Nhấp vào Chat History ở thanh bên.
Kết quả mong đợi: Bộ lọc hội thoại, số liệu thống kê và danh sách bản ghi được hiển thị.
2
Tìm kiếm và lọc
Lọc theo bot, kênh, chế độ, khách truy cập hoặc phạm vi ngày.
Kết quả mong đợi: Chỉ conversations phù hợp vẫn hiển thị.
3
Mở bản ghi
Nhấp vào cuộc trò chuyện để đọc toàn bộ chuỗi tin nhắn.
Kết quả mong đợi: Toàn bộ bối cảnh, chi tiết liên hệ và siêu dữ liệu cuộc trò chuyện đều hiển thị.
4
Xuất conversations
Nhấp vào Xuất và chọn định dạng cần thiết nếu có.
Kết quả mong đợi: Bản xuất chứa dữ liệu cuộc trò chuyện đã được lọc.
5
Mở Danh bạ
Bấm vào Danh bạ trong thanh bên.
Kết quả mong đợi: Bản ghi khách hàng tiềm năng/người liên hệ xuất hiện cùng với nguồn, bot và trạng thái.
6
Lọc và xuất danh bạ
Tìm kiếm liên hệ, chọn bản ghi mong muốn, sau đó xuất hoặc đồng bộ hóa với SendPulse.
Kết quả mong đợi: Các liên hệ đã chọn có sẵn bên ngoài sem.chat tùy theo hành động đã chọn.
Làm thế nào để kiểm tra nó: Xuất CSV đã lọc nhỏ và mở cục bộ để xác nhận các cột và phạm vi ngày là chính xác.
vấn đề
sửa chữa
Thiếu liên hệ trong Danh bạ
Xác nhận tính năng thu thập khách hàng tiềm năng đã được bật và khách truy cập đã gửi biểu mẫu.
Xuất khẩu quá lớn
Thu hẹp phạm vi ngày hoặc bộ lọc bot trước khi xuất.
SendPulse không đồng bộ hóa được
Trước tiên, hãy kết nối SendPulse trong Tiện ích tích hợp, sau đó quay lại Danh sách liên hệ.
Phải làm gì tiếp theo: Xem lại Analytics để hiểu xu hướng hiệu suất sau khi hoạt động đang chạy.
08
Kênh và tích hợp
Kết nối Slack, Facebook, Instagram, WhatsApp, Telegram thông qua BotFather, thông tin xác thực thủ công, liên kết chat thay thế, SendPulse và tích hợp CRM.
/tích hợpCác kênh, CRM và kết nối email
1Chọn kênh hoặc thẻ tích hợp CRM.
2Thực hiện theo các bước OAuth hoặc thông tin xác thực cho từng nhà cung cấp.
3Ngắt kết nối hoặc kiểm tra lại các tiện ích tích hợp trên cùng một trang.
Kết nối kênh
Kết nối kênh nhắn tin hoặc tích hợp CRM
Cái này dùng để làm gì: Hãy sử dụng tùy chọn này khi sem.chat nhận được conversations bên ngoài tiện ích trang web hoặc gửi địa chỉ liên hệ đến các công cụ khác.
Trước khi bạn bắt đầu
Có quyền truy cập quản trị viên vào nền tảng bên ngoài.
Biết bot nào sẽ nhận tin nhắn kênh.
Sử dụng các kênh thử nghiệm trước khi kết nối tài khoản sản xuất.
1
Tích hợp mở
Nhấp vào Tích hợp trong thanh bên.
Kết quả mong đợi: Các kênh có sẵn, công cụ CRM, SendPulse và các tùy chọn tiện ích trang web đều hiển thị.
2
Chọn tích hợp
Nhấp vào Kết nối trên Slack, kênh Meta, Telegram, SendPulse, CRM hoặc thông tin xác thực thủ công.
Kết quả mong đợi: Hộp thoại thiết lập hoặc luồng OAuth sẽ mở ra.
3
Hoàn tất thiết lập nhà cung cấp
Đối với các kênh OAuth, hãy phê duyệt các quyền được yêu cầu. Đối với các kênh thủ công, hãy dán mã thông báo, bí mật, ID tài khoản hoặc webhook được yêu cầu URL.
Kết quả mong đợi: sem.chat lưu trữ kết nối và hiển thị tích hợp là đã kết nối.
4
Chỉ định bot
Chọn bot nào sẽ xử lý tin nhắn từ kênh đó khi hộp thoại hỏi.
Kết quả mong đợi: Tin nhắn đến định tuyến đến trợ lý chính xác.
5
Kiểm tra kênh
Gửi tin nhắn thử nghiệm từ kênh bên ngoài.
Kết quả mong đợi: Thông báo xuất hiện trong Hộp thư đến hoặc Chat History dưới đúng kênh.
6
Ngắt kết nối nếu cần
Sử dụng Ngắt kết nối khỏi thẻ tích hợp khi kênh sẽ dừng.
Kết quả mong đợi: sem.chat ngừng nhận hoặc gửi thông qua tích hợp đó.
Làm thế nào để kiểm tra nó: Gửi một tin nhắn kiểm tra qua kênh được kết nối và xác nhận phản hồi của bot, hàng Hộp thư đến và bản ghi lịch sử.
vấn đề
sửa chữa
Mã thông báo Telegram không thành công
Tạo hoặc đặt lại mã thông báo trong BotFather và dán lại.
Slack tin nhắn không đến
Kiểm tra phạm vi ứng dụng, đăng ký sự kiện URL, mã thông báo bot, ký bí mật và tư cách thành viên kênh.
Kết nối kênh meta không thành công
Xác nhận tài khoản Facebook/Instagram/WhatsApp có quyền quản trị viên và quyền truy cập doanh nghiệp bắt buộc.
SendPulse đồng bộ hóa không thành công
Kết nối lại SendPulse và xác nhận các trường liên hệ đã được ánh xạ.
Phải làm gì tiếp theo: Ghi lại quyền sở hữu kênh cho nhóm và giám sát Hộp thư đến sau khi ra mắt.
09
Lên lịch
Tạo loại sự kiện, định cấu hình tình trạng phòng trống, kết nối lịch, quản lý đặt chỗ, tạo liên kết một lần, định cấu hình email đặt phòng, đánh giá phân tích, đặt sự kiện trả phí và kiểm tra liên kết đặt phòng công khai.
/lập kế hoạchLên lịch không gian làm việc
1Sử dụng các tab cho Loại sự kiện, Đặt chỗ, Phân tích, Liên kết một lần, Lịch, Email và Cài đặt.
2Chỉnh sửa, sao chép, nhúng, kích hoạt hoặc tạm dừng các loại sự kiện.
3Sao chép liên kết công khai và chạy thử nghiệm đặt phòng riêng tư.
Biên tập sự kiệnCấu hình loại sự kiện
1Nhập tên, mô tả, thời lượng, vị trí và bộ đệm.
2Đặt tính khả dụng, thời hạn đặt chỗ, câu hỏi, tùy chọn sự kiện phải trả phí và quy tắc hủy.
3Lưu sự kiện trước khi chia sẻ liên kết.
/book/:tên người dùng/:eventSlugTrang đặt phòng công cộng
1Khách truy cập chọn ngày từ trang đặt phòng công khai.
2Khách truy cập chọn một khoảng thời gian có sẵn.
3Khách truy cập xác nhận đặt phòng và nhận email xác nhận.
Loại sự kiện
Tạo loại sự kiện và xuất bản liên kết đặt phòng
Cái này dùng để làm gì: Sử dụng điều này khi khách truy cập nên đăng ký các buổi demo, tư vấn, cuộc gọi bán hàng, giới thiệu hoặc các buổi hỗ trợ.
Trước khi bạn bắt đầu
Chọn tên sự kiện, thời lượng, loại cuộc họp và chủ sở hữu.
Đặt múi giờ và tính khả dụng trước khi chia sẻ liên kết.
Kết nối lịch nếu việc đặt phòng đôi có vấn đề.
1
Mở lịch trình
Nhấp vào Lập lịch trong thanh bên.
Kết quả mong đợi: Không gian làm việc lập lịch trình hiển thị các tab cho loại sự kiện, đặt chỗ, phân tích, liên kết một lần, lịch, email và cài đặt.
2
Tạo một loại sự kiện
Nhấp vào Tạo, sau đó thêm tên, mô tả, thời lượng, vị trí, vùng đệm và quy tắc đặt chỗ.
Kết quả mong đợi: Sự kiện này có đủ thông tin công khai để du khách có thể hiểu được.
3
Đặt phòng trống
Định cấu hình giờ hàng tuần, ghi đè ngày, khoảng thời gian thông báo và khoảng thời gian đăng ký.
Kết quả mong đợi: Khách truy cập chỉ nhìn thấy thời gian bạn sẵn sàng cung cấp.
4
Thêm câu hỏi
Thêm các câu hỏi bắt buộc như số điện thoại, công ty, trang web hoặc mục tiêu cuộc họp.
Kết quả mong đợi: Đặt chỗ thu thập bối cảnh mà nhóm của bạn cần trước cuộc gọi.
5
Kết nối lịch
Mở Lịch và kết nối Google, Outlook hoặc iCal nếu có.
Kết quả mong đợi: Thời gian bận rộn có thể bị chặn và việc đặt chỗ đã được xác nhận có thể được ghi vào lịch.
6
Đặt email và lời nhắc
Mở Email và định cấu hình tin nhắn xác nhận, nhắc nhở, hủy và lên lịch lại.
Kết quả mong đợi: Du khách nhận được thông tin đặt phòng chính xác.
7
Chia sẻ và kiểm tra liên kết công khai
Sao chép liên kết sự kiện, mở nó trong cửa sổ riêng tư, chọn một vị trí và hoàn tất đăng ký thử nghiệm.
Kết quả mong đợi: Việc đặt chỗ xuất hiện trong tab Đặt chỗ và thông báo xác nhận sẽ được gửi.
Làm thế nào để kiểm tra nó: Hoàn thành một lần đăng ký kiểm tra, một lần lên lịch lại và một lần hủy. Xác nhận từng sự kiện xuất hiện trong Lịch lập lịch và lịch được kết nối.
vấn đề
sửa chữa
Không có lần nào xuất hiện trên trang công khai
Kiểm tra múi giờ, tình trạng sẵn có hàng tuần, ghi đè ngày, cửa sổ thông báo và xung đột lịch được kết nối.
Thiếu email đặt chỗ
Kiểm tra cài đặt email và thư mục thư rác, sau đó gửi yêu cầu kiểm tra khác.
Thanh toán không thành công trong sự kiện thanh toán
Xác nhận cài đặt tích hợp thanh toán/thanh toán và đơn vị tiền tệ là hợp lệ trước khi xuất bản.
Phải làm gì tiếp theo: Nhúng liên kết đặt phòng vào bot, trang web hoặc email theo dõi.
Lập kế hoạch nâng cao
Sử dụng các liên kết, phân tích, nội dung nhúng và sự kiện trả phí một lần
Cái này dùng để làm gì: Sử dụng tính năng này khi lập kế hoạch cần có sẵn tạm thời, báo cáo, đăng ký được nhúng hoặc thanh toán.
Trước khi bạn bắt đầu
Trước tiên, hãy tạo ít nhất một loại sự kiện.
Kết nối lịch trước khi sử dụng nhiều liên kết một lần.
Xác định chính sách hoàn tiền/hủy trước khi kích hoạt các sự kiện trả phí.
1
Tạo liên kết một lần
Mở Liên kết một lần, chọn vị trí hoặc quy tắc được cung cấp, sau đó tạo liên kết.
Kết quả mong đợi: Người nhận chỉ có thể đặt chỗ từ tình trạng sẵn có đã chọn.
2
Nhúng lịch trình
Sử dụng tùy chọn nhúng thẻ sự kiện nếu luồng đặt chỗ xuất hiện trên trang web của bạn.
Kết quả mong đợi: Giao diện người dùng đặt phòng có thể được đặt trong trang nơi khách truy cập chuyển đổi.
3
Xem lại phân tích lập kế hoạch
Mở Analytics bên trong Lập kế hoạch.
Kết quả mong đợi: Bạn có thể xem lượt đặt trước, xu hướng hoàn thành và hiệu suất của loại sự kiện.
4
Bật sự kiện trả phí
Mở trình chỉnh sửa sự kiện, đặt giá, đơn vị tiền tệ và hành vi thanh toán.
Kết quả mong đợi: Khách tham quan phải hoàn thành bước thanh toán theo setup sự kiện.
5
Kiểm tra đặt chỗ
Mở Đặt chỗ và xem xét các mục sắp tới, đã hoàn thành, bị hủy và lên lịch lại.
Kết quả mong đợi: Nhóm có thể quản lý việc tham dự và theo dõi.
Làm thế nào để kiểm tra nó: Đặt qua trang công khai và qua trang nhúng nếu được sử dụng. Xác nhận cả hai đều tạo cùng một loại bản ghi đặt phòng.
vấn đề
sửa chữa
Liên kết một lần hiển thị sai vị trí
Tạo lại liên kết bằng nhóm vị trí nhỏ hơn hoặc phạm vi ngày chặt chẽ hơn.
Đặt chỗ được nhúng quá hẹp
Đặt nội dung nhúng vào vùng chứa nội dung rộng hơn và kiểm tra bố cục trên thiết bị di động.
Phân tích trông trống rỗng
Tạo hoặc chờ đặt chỗ thực sự; phân tích phụ thuộc vào hồ sơ đặt phòng.
Phải làm gì tiếp theo: Kết nối kết quả lập lịch với Báo cáo và Phân tích.
10
Phân tích và Báo cáo
Chọn phạm vi ngày, sử dụng ngày tùy chỉnh, đọc số liệu cốt lõi, xuất CSV, xem xét mức độ hài lòng và xu hướng trò chuyện, định cấu hình báo cáo qua email và xác minh việc gửi.
/phân tíchTrang tổng quan phân tích
1Chọn phạm vi ngày hoặc ngày tùy chỉnh.
2Đọc các số liệu về cuộc trò chuyện, mức độ hài lòng, ngôn ngữ, kênh và chuyển đổi.
3Xuất CSV để phân tích ngoại tuyến.
Cài đặt / Báo cáoThiết lập báo cáo email
1Chọn nhịp báo cáo hàng ngày, hàng tuần hoặc hàng tháng.
2Thêm người nhận báo cáo.
3Gửi báo cáo ngay lập tức để phân phối thử nghiệm.
Đánh giá phân tích
Đọc phân tích và xuất dữ liệu hiệu suất
Cái này dùng để làm gì: Sử dụng công cụ này để đánh giá hàng tuần, kiểm tra khởi chạy, đánh giá chất lượng hỗ trợ và phân tích chuyển đổi.
Trước khi bạn bắt đầu
Chọn phạm vi ngày trước khi đọc số liệu.
Biết bot hoặc kênh nào bạn đang đánh giá.
Loại trừ ngày kiểm tra riêng khi báo cáo hiệu suất sản xuất.
1
Mở phân tích
Nhấp vào Analytics ở thanh bên.
Kết quả mong đợi: Số liệu trên trang tổng quan và bảng biểu đồ có thể nhìn thấy được.
2
Chọn phạm vi ngày
Chọn hôm nay, 7 ngày, 30 ngày hoặc ngày tùy chỉnh.
Kết quả mong đợi: Tất cả các biểu đồ cập nhật theo khoảng thời gian đã chọn.
3
Đọc số liệu cốt lõi
Đánh giá conversations, số phút thoại, mức độ hài lòng, chuyển đổi và kết hợp kênh.
Kết quả mong đợi: Bạn hiểu khối lượng và chất lượng tương tác của khách hàng.
4
Đánh giá xu hướng
Xem xét xu hướng trò chuyện, sự thay đổi về mức độ hài lòng, câu hỏi hàng đầu và mô hình ngôn ngữ/kênh.
Kết quả mong đợi: Bạn có thể xác định nơi cần cải thiện hướng dẫn bot hoặc nhân sự.
5
Xuất CSV
Sử dụng Xuất CSV khi nhóm cần phân tích bảng tính.
Kết quả mong đợi: CSV chứa phạm vi ngày và số liệu đã chọn.
6
Biến phát hiện thành thay đổi
Cập nhật hướng dẫn về bot, kiến thức, cài đặt tiện ích hoặc phạm vi hỗ trợ dựa trên dữ liệu.
Kết quả mong đợi: Phân tích dẫn đến cải tiến sản phẩm cụ thể.
Làm thế nào để kiểm tra nó: Xuất một ngày tùy chỉnh nhỏ CSV và xác minh phạm vi ngày cũng như số liệu khớp với những gì trang tổng quan hiển thị.
vấn đề
sửa chữa
Các chỉ số có vẻ quá cao
Kiểm tra xem giai đoạn/kiểm tra conversations có được đưa vào phạm vi ngày đã chọn hay không.
Sự hài lòng là trống rỗng
Bật xếp hạng trong Cài đặt tiện ích và đợi khách truy cập để lại xếp hạng.
Số phút thoại không khớp với mong đợi
Xác nhận chế độ giọng nói chỉ được bật trên các bot dự định.
Phải làm gì tiếp theo: Lên lịch báo cáo qua email để hiển thị định kỳ.
Báo cáo
Định cấu hình báo cáo email định kỳ và gửi thử nghiệm
Cái này dùng để làm gì: Hãy sử dụng tính năng này khi chủ sở hữu, người quản lý hoặc khách hàng cần bản tóm tắt hiệu suất tự động.
Trước khi bạn bắt đầu
Quyết định ai sẽ nhận được báo cáo.
Sử dụng địa chỉ email đã được xác minh.
Chọn nhịp độ phù hợp với nhịp độ đánh giá kinh doanh.
1
Mở Cài đặt rồi đến Báo cáo
Đi tới Cài đặt và chọn tab Báo cáo hoặc sử dụng chuyển hướng Báo cáo nếu có.
Kết quả mong đợi: Nhịp báo cáo, người nhận và lịch sử được hiển thị.
2
Chọn nhịp
Kích hoạt báo cáo hàng ngày, hàng tuần hoặc hàng tháng.
Kết quả mong đợi: Lịch trình báo cáo được lưu trữ cho không gian làm việc.
3
Thêm người nhận
Nhập địa chỉ email sẽ nhận được báo cáo.
Kết quả mong đợi: Báo cáo được gửi đến các bên liên quan chính xác.
4
Gửi báo cáo ngay lập tức
Nhấp vào Gửi ngay hoặc hành động báo cáo tức thì tương đương.
Kết quả mong đợi: Một email báo cáo sẽ được gửi ngay lập tức để xác minh.
5
Xem lại lịch sử báo cáo
Kiểm tra bảng lịch sử sau khi báo cáo được gửi.
Kết quả mong đợi: Bạn có thể xác nhận trạng thái và thời gian giao hàng.
Làm thế nào để kiểm tra nó: Gửi báo cáo ngay lập tức cho người nhận bài kiểm tra và xác nhận việc nhận và định dạng.
vấn đề
sửa chữa
Email báo cáo không đến
Kiểm tra chính tả người nhận, thư mục thư rác và trạng thái lịch sử báo cáo.
Người sai nhận được báo cáo
Cập nhật người nhận và lưu trước lần gửi theo lịch tiếp theo.
Nội dung báo cáo có cảm giác ồn ào
Điều chỉnh kỳ vọng về phạm vi ngày và sử dụng Analytics để xem xét thủ công sâu hơn.
Phải làm gì tiếp theo: Sử dụng nhịp báo cáo làm nhịp điệu hoạt động để cải tiến bot.
11
Thanh toán, Nhóm, Bảo mật, Cài đặt, Liên kết
Bắt đầu hoặc nâng cấp gói, quản lý cổng thanh toán, mời đồng đội, đặt vai trò, chỉnh sửa hồ sơ/ngôn ngữ, định cấu hình thông báo, bật 2FA, sử dụng các hành động trong vùng nguy hiểm và chạy quy trình làm việc của đơn vị liên kết.
/thanh toánKiểm soát kế hoạch và thanh toán
1Xem lại gói hiện tại, trạng thái dùng thử và các giới hạn usage.
2So sánh các tính năng của gói trước khi nâng cấp.
3Mở cổng thanh toán để biết hóa đơn, phương thức thanh toán, hủy hoặc kích hoạt lại.
/cài đặtCài đặt, nhóm và bảo mật
1Sử dụng Chung cho hồ sơ và ngôn ngữ.
2Sử dụng Nhóm cho lời mời và vai trò.
3Sử dụng Bảo mật cho các khóa 2FA, API và các hành động trong vùng nguy hiểm.
/liên kếtKiểm soát chương trình liên kết
1Tham gia chương trình để tạo link giới thiệu.
2Sao chép liên kết giới thiệu cho các chiến dịch.
3Đặt email thanh toán và yêu cầu thanh toán đủ điều kiện.
Thanh toán
Bắt đầu, nâng cấp, hủy hoặc kích hoạt lại gói
Cái này dùng để làm gì: Sử dụng tùy chọn này khi không gian làm việc cần kích hoạt bản dùng thử, thêm giới hạn, hóa đơn, cập nhật thanh toán hoặc thay đổi đăng ký.
Trước khi bạn bắt đầu
Chủ tài khoản hoặc quản trị viên thanh toán phải thực hiện các hành động thanh toán.
Xác nhận những tính năng được kiểm soát theo kế hoạch: giọng nói, giọng nói nhân bản, hình đại diện tùy chỉnh, API, nhóm, CRM và các kênh.
Sử dụng cổng thanh toán an toàn để thay đổi phương thức thanh toán và hóa đơn.
1
Thanh toán mở
Nhấp vào Thanh toán ở thanh bên.
Kết quả mong đợi: Gói hiện tại, trạng thái dùng thử, giới hạn usage và thẻ gói được hiển thị.
2
So sánh các kế hoạch
Xem xét các giới hạn chat, giọng nói, nhóm, API, hình đại diện, tích hợp, lập lịch và hỗ trợ.
Kết quả mong đợi: Bạn biết gói nào sẽ mở khóa tính năng cần thiết.
3
Chọn khoảng thời gian thanh toán
Chọn hàng tháng hoặc hàng năm nếu có sẵn nút chuyển đổi.
Kết quả mong đợi: Cập nhật giá cả và tiết kiệm cho khoảng thời gian đã chọn.
4
Nâng cấp hoặc bắt đầu thanh toán
Chọn gói mong muốn và hoàn tất thanh toán.
Kết quả mong đợi: Việc đăng ký sẽ hoạt động sau khi xác nhận thanh toán.
5
Mở cổng thông tin khách hàng
Sử dụng cổng thanh toán để biết phương thức thanh toán, hóa đơn, hủy hoặc kích hoạt lại.
Kết quả mong đợi: Các hành động thanh toán nhạy cảm diễn ra trong cổng thông tin nhà cung cấp an toàn.
6
Xác minh quyền truy cập tính năng
Quay lại tính năng đã bị khóa và tải lại ứng dụng.
Kết quả mong đợi: Tính năng đã mở khóa hiện khả dụng nếu gói có bao gồm tính năng này.
Làm thế nào để kiểm tra nó: Sau khi nâng cấp, hãy mở tính năng đã khóa trước đó, chẳng hạn như bản sao giọng nói hoặc phím API và xác nhận khóa đã biến mất.
vấn đề
sửa chữa
Tính năng vẫn bị khóa sau khi nâng cấp
Làm mới ứng dụng, đợi một lát để đồng bộ hóa đăng ký, sau đó kiểm tra lại Thanh toán.
Thanh toán đã bị hủy
Quay lại Thanh toán và bắt đầu thanh toán lại; không có thay đổi kế hoạch nào xảy ra sau khi thanh toán bị hủy.
Cần đổi hóa đơn, thẻ
Mở cổng thông tin khách hàng thay vì chỉnh sửa chi tiết thanh toán bên trong ứng dụng.
Phải làm gì tiếp theo: Mời đồng đội và bảo mật tài khoản chủ sở hữu.
Đội ngũ và an ninh
Mời đồng đội, đặt vai trò, chỉnh sửa hồ sơ, bật 2FA và quản lý cài đặt
Cái này dùng để làm gì: Sử dụng tính năng này khi không gian làm việc chuyển từ thiết lập một mình sang hoạt động nhóm.
Trước khi bạn bắt đầu
Biết rõ vai trò của từng đồng đội trước khi gửi lời mời.
Sử dụng quyền truy cập có đặc quyền tối thiểu: Chủ sở hữu, Quản trị viên, Người chỉnh sửa, Người xem.
Chuẩn bị sẵn ứng dụng xác thực cho 2FA.
1
Mở cài đặt
Nhấp vào Cài đặt trong thanh bên.
Kết quả mong đợi: Các tab chung, thông báo, nhóm, báo cáo, nhà phát triển, bảo mật và các tab liên quan đều hiển thị.
2
Chỉnh sửa hồ sơ và ngôn ngữ
Cập nhật tên hiển thị, thông tin hồ sơ và ngôn ngữ ưa thích nói chung.
Kết quả mong đợi: Ứng dụng xác định chính xác người dùng và sử dụng ngôn ngữ đã chọn nếu có.
3
Mời các thành viên trong nhóm
Mở Nhóm, nhập email, chọn vai trò và gửi lời mời.
Kết quả mong đợi: Đồng đội nhận được liên kết lời mời và xuất hiện ở trạng thái chờ xử lý cho đến khi được chấp nhận.
4
Đặt quyền vai trò
Sử dụng Chủ sở hữu để có toàn quyền kiểm soát, Quản trị viên để quản lý, Người chỉnh sửa để thay đổi nội dung và Người xem để có quyền truy cập chỉ đọc.
Kết quả mong đợi: Mỗi người dùng có quyền truy cập phù hợp với trách nhiệm của họ.
5
Định cấu hình thông báo
Chọn thông báo qua email, trình duyệt, đẩy, hỗ trợ trực tiếp, thanh toán và báo cáo.
Kết quả mong đợi: Đúng người sẽ nhận được thông báo mà không gây ra tiếng ồn không cần thiết.
6
Kích hoạt 2FA
Mở Bảo mật, bật xác thực hai yếu tố, quét mã và lưu trữ chi tiết khôi phục.
Kết quả mong đợi: Tài khoản yêu cầu yếu tố thứ hai sau khi đăng nhập mật khẩu.
7
Sử dụng các hành động trong vùng nguy hiểm một cách cẩn thận
Xuất dữ liệu cần thiết và xác nhận các tiện ích/tích hợp đang hoạt động trước các hành động phá hoại tài khoản.
Kết quả mong đợi: Không gian làm việc tránh mất dữ liệu do tai nạn.
Làm thế nào để kiểm tra nó: Mời một đồng đội thử nghiệm, chấp nhận lời mời trong một trình duyệt riêng và xác nhận vai trò chỉ hiển thị các tính năng dự định.
vấn đề
sửa chữa
Thiếu email mời
Kiểm tra thư rác, gửi lại lời mời và xác minh địa chỉ.
Đồng đội nhìn thấy quá nhiều
Hạ thấp vai trò của họ và xem lại cài đặt truy cập bot.
Thiết lập 2FA không thành công
Kiểm tra thời gian của thiết bị, quét lại mã QR và lưu trữ chi tiết khôi phục trước khi dựa vào nó.
Phải làm gì tiếp theo: Chỉ định cấu hình khóa API cho người dùng và dịch vụ cần chúng.
liên kết
Tham gia liên kết, sao chép liên kết giới thiệu, đặt email thanh toán và yêu cầu thanh toán
Cái này dùng để làm gì: Sử dụng tính năng này khi đối tác hoặc khách hàng muốn giới thiệu người dùng sem.chat mới và theo dõi hoạt động hoa hồng.
Trước khi bạn bắt đầu
Sử dụng tài khoản nên sở hữu thuộc tính giới thiệu.
Chuẩn bị email thanh toán trước khi yêu cầu thanh toán.
Kiểm tra các quy tắc của chương trình trước khi xuất bản các chiến dịch giới thiệu.
1
Mở liên kết
Nhấp vào Liên kết trong thanh bên hoặc mở tab liên kết từ Cài đặt nếu được liên kết ở đó.
Kết quả mong đợi: Trang chương trình liên kết hiển thị các khu vực tham gia, giới thiệu, thanh toán và lịch sử.
2
Tham gia chương trình
Nhấn Join nếu tài khoản chưa tham gia.
Kết quả mong đợi: Mã giới thiệu và liên kết giới thiệu được tạo.
3
Sao chép liên kết giới thiệu
Sao chép liên kết duy nhất và sử dụng nó trong nội dung, chiến dịch hoặc tin nhắn của đối tác.
Kết quả mong đợi: Đăng ký thông qua liên kết có thể được quy cho tài khoản liên kết.
4
Đặt email thanh toán
Nhập email thanh toán và lưu nó.
Kết quả mong đợi: Các khoản thanh toán đủ điều kiện có thể được định tuyến chính xác.
5
Xem xét các lượt giới thiệu và hoa hồng
Kiểm tra danh sách giới thiệu, trạng thái hoa hồng và lịch sử thanh toán.
Kết quả mong đợi: Bạn biết những gì đang chờ xử lý, đủ điều kiện hoặc đã được thanh toán.
6
Yêu cầu thanh toán
Nhấp vào Yêu cầu thanh toán khi đáp ứng các quy tắc và mức tối thiểu của chương trình.
Kết quả mong đợi: Yêu cầu thanh toán được ghi lại để xử lý.
Làm thế nào để kiểm tra nó: Mở liên kết giới thiệu trong trình duyệt riêng tư và xác nhận rằng nó nằm trong luồng đăng ký dự kiến với tính năng theo dõi giới thiệu.
vấn đề
sửa chữa
Liên kết giới thiệu bị thiếu
Hãy tham gia chương trình trước hoặc làm mới trang liên kết sau khi tham gia.
Yêu cầu thanh toán không có sẵn
Kiểm tra ngưỡng thanh toán tối thiểu, trạng thái hoa hồng đủ điều kiện và email thanh toán.
Giới thiệu không được phân bổ
Xác nhận khách truy cập đã sử dụng liên kết giới thiệu chính xác và không loại bỏ các thông số theo dõi.
Phải làm gì tiếp theo: Sử dụng Phân tích và Báo cáo để theo dõi tác động của khách hàng được giới thiệu nếu có.
12
Thông báo và App Updates
Xem lại cảnh báo, đánh dấu thông báo đã đọc, lọc các sự kiện quan trọng và sử dụng các bản cập nhật ứng dụng để hiểu những thay đổi mới của sản phẩm.
/thông báoTrung tâm thông báo
1Sử dụng Đánh dấu tất cả đã đọc sau khi xem lại các cảnh báo chưa đọc.
2Lọc theo sự kiện chưa đọc, thanh toán, hỗ trợ trực tiếp hoặc sự kiện hệ thống.
3Mở tính năng liên quan sau khi đọc cảnh báo.
/cập nhật ứng dụngNguồn cấp dữ liệu cập nhật ứng dụng
1Đọc ghi chú phát hành để biết các tính năng và bản sửa lỗi mới.
2Sử dụng thông tin chi tiết để đào tạo đồng đội trước khi thay đổi quy trình làm việc.
3Kiểm tra cập nhật sau khi nhận thấy những thay đổi về giao diện người dùng hoặc hành vi.
Thông báo
Xem lại thông báo và hành động theo cảnh báo
Cái này dùng để làm gì: Sử dụng tùy chọn này khi ứng dụng báo cáo chuyển giao, trạng thái thanh toán, sự kiện hệ thống, gửi báo cáo hoặc hoạt động quan trọng trong không gian làm việc.
Trước khi bạn bắt đầu
Đảm bảo tùy chọn thông báo được đặt trong Cài đặt.
Có phạm vi hỗ trợ trực tiếp nếu cảnh báo chuyển giao được bật.
Xem lại các cảnh báo chưa đọc trước khi đánh dấu chúng là đã đọc.
1
Mở thông báo
Nhấp vào Thông báo trong thanh bên hoặc mục nhập thông báo tiêu đề ứng dụng.
Kết quả mong đợi: Trung tâm thông báo liệt kê các cảnh báo gần đây.
2
Lọc cảnh báo
Sử dụng bộ lọc danh mục hoặc chưa đọc để tập trung vào thanh toán, hỗ trợ trực tiếp, bot, báo cáo hoặc sự kiện hệ thống.
Kết quả mong đợi: Chỉ những cảnh báo phù hợp vẫn hiển thị.
3
Mở trang liên quan
Nhấp vào cảnh báo hoặc sử dụng ngữ cảnh của cảnh báo để mở Thanh toán, Live Support, Báo cáo hoặc bot có liên quan.
Kết quả mong đợi: Bạn hành động theo thông báo thay vì chỉ đọc nó.
4
Đánh dấu đã đọc
Đánh dấu một cảnh báo đã đọc hoặc sử dụng Đánh dấu tất cả đã đọc sau khi xem lại.
Kết quả mong đợi: Số lượng giảm chưa đọc và các mục đã xem xét không còn được đánh dấu nữa.
5
Điều chỉnh tùy chọn
Mở Cài đặt, Thông báo nếu có quá nhiều hoặc quá ít cảnh báo đến.
Kết quả mong đợi: Luồng thông báo phù hợp với nhu cầu của nhóm.
Làm thế nào để kiểm tra nó: Tạo một sự kiện thử nghiệm an toàn, chẳng hạn như yêu cầu hỗ trợ trực tiếp hoặc báo cáo tức thì, sau đó xác nhận thông báo xuất hiện và có thể được đánh dấu là đã đọc.
vấn đề
sửa chữa
Không có thông báo nào đến
Kiểm tra tùy chọn thông báo Cài đặt, quyền của trình duyệt và liệu sự kiện có thực sự xảy ra hay không.
Quá nhiều cảnh báo
Vô hiệu hóa các danh mục ồn ào hoặc chỉ gửi chúng cho các thành viên trong nhóm có trách nhiệm.
Số lượng chưa đọc dường như bị kẹt
Làm mới ứng dụng sau khi đánh dấu tất cả các bộ lọc đã đọc và xác nhận không ẩn các mục chưa đọc.
Phải làm gì tiếp theo: Xem lại App Updates khi hành vi thay đổi hoặc các điều khiển mới xuất hiện.
Cập nhật ứng dụng
Sử dụng các bản cập nhật ứng dụng để hiểu những thay đổi của sản phẩm
Cái này dùng để làm gì: Hãy sử dụng tính năng này khi đồng đội cần tìm hiểu những gì đã thay đổi trước khi sử dụng tính năng mới.
Trước khi bạn bắt đầu
Mở các bản cập nhật sau khi phát hành chính hoặc khi giao diện người dùng thay đổi.
Chia sẻ ghi chú cập nhật có liên quan với người dùng hỗ trợ và bán hàng.
Kiểm tra lại các quy trình công việc quan trọng sau những thay đổi lớn.
1
Mở App Updates
Nhấp vào App Updates ở thanh bên.
Kết quả mong đợi: Nguồn cấp dữ liệu cập nhật hiển thị các tính năng mới, bản sửa lỗi và ghi chú phát hành.
2
Đọc bản cập nhật mới nhất
Mở thẻ cập nhật gần đây nhất hoặc chế độ xem chi tiết.
Kết quả mong đợi: Bạn thấy những gì đã thay đổi và nó ảnh hưởng đến quy trình công việc nào.
3
Ánh xạ sự thay đổi vào quy trình làm việc của bạn
Xác định xem bản cập nhật có ảnh hưởng đến bot, tiện ích, hỗ trợ, lập lịch, thanh toán hay nhà phát triển hay không.
Kết quả mong đợi: Các thành viên phù hợp trong nhóm biết những gì cần kiểm tra.
4
Kiểm tra lại các đường dẫn quan trọng
Nếu bản cập nhật ảnh hưởng đến quy trình sản xuất, hãy lặp lại các bước thủ công có liên quan từ tài liệu này.
Kết quả mong đợi: Nhóm xác nhận quy trình làm việc đã thay đổi vẫn hoạt động.
5
Chia sẻ nội bộ
Gửi bản tóm tắt cập nhật cho người dùng sở hữu khu vực bị ảnh hưởng.
Kết quả mong đợi: Việc áp dụng nhóm diễn ra suôn sẻ hơn và giảm bớt các câu hỏi hỗ trợ.
Làm thế nào để kiểm tra nó: Sau khi cập nhật liên quan, hãy lặp lại hướng dẫn cho tính năng bị ảnh hưởng và xác nhận ảnh chụp màn hình hoặc tên bước vẫn khớp.
vấn đề
sửa chữa
Cập nhật đề cập đến một tính năng bị khóa
Mở Thanh toán để xác nhận xem gói hiện tại có bao gồm nó hay không.
Đội đã bỏ lỡ một sự thay đổi
Thêm bài đánh giá App Updates vào bản phát hành hoặc quy trình hoạt động hàng tuần.
Tài liệu trông cũ sau khi cập nhật
Sử dụng Hướng dẫn kỹ sư để cập nhật ảnh chụp màn hình và các bước.
Phải làm gì tiếp theo: Luôn cập nhật tài liệu công khai khi các tính năng phát triển.
13
Bí quyết dành cho nhà phát triển
Tạo khóa API, sử dụng xác thực x-api-key, gọi điểm cuối dựa trên hành động, kết nối hỗ trợ trực tiếp với CRM, đăng ký webhook, xác minh chữ ký và nhúng tiện ích vào mã.
Cài đặt/Nhà phát triểnPhím API, khởi động nhanh và tab usage
1Tạo và thu hồi khóa API từ tab Khóa API.
2Sử dụng Quick Start cho các ví dụ về đường cong đầu tiên.
3Xem lại mức sử dụng trước khi bật tự động hóa khối lượng lớn.
API bắt đầu nhanh
Tạo khóa API và thực hiện cuộc gọi API đầu tiên
Cái này dùng để làm gì: Sử dụng tính năng này để báo cáo tập lệnh, ứng dụng tùy chỉnh, cầu nối CRM, hỗ trợ trực tiếp bên ngoài hoặc tự động hóa.
Trước khi bạn bắt đầu
Sử dụng môi trường phía máy chủ. Không để lộ khóa API trong trình duyệt JavaScript.
Tạo một khóa riêng cho mỗi tích hợp.
Sao chép key ngay vì bí mật được hiển thị một lần.
1
Nhà phát triển mở
Mở Cài đặt và chọn Nhà phát triển hoặc sử dụng chuyển hướng Nhà phát triển nếu có.
Kết quả mong đợi: API Các tab Khóa, Quick Start, Tài liệu và Sử dụng đều hiển thị.
2
Tạo khóa
Nhấp vào Tạo khóa, đặt nhãn rõ ràng và sao chép ngay lập tức.
Kết quả mong đợi: Khóa bắt đầu bằng sk_live_ và có sẵn cho các yêu cầu phía máy chủ.
3
Gửi tiêu đề x-api-key
Bao gồm x-api-key trên mọi yêu cầu API công khai.
Kết quả mong đợi: API công khai có thể xác thực yêu cầu và đưa nó vào phạm vi của chủ sở hữu.
4
Danh sách bot
Gọi action=list-bots để tìm ID bot bạn cần.
Kết quả mong đợi: Phản hồi trả về ID bot, tên, trạng thái hoạt động và tóm tắt cấu hình.
5
Gửi tin nhắn chat
POST hành động chat với botId và tin nhắn.
Kết quả mong đợi: Phản hồi trả về thông tin trả lời, mô hình và usage.
6
Kiểm tra usage
Gọi action=usage trước khi chạy các công việc có khối lượng lớn.
Kết quả mong đợi: Bạn biết kế hoạch hiện tại và trạng thái usage trước khi chạy tự động hóa.
7
Xoay phím khi cần thiết
Thu hồi các khóa không sử dụng và tạo khóa mới cho các nhà cung cấp hoặc dịch vụ đã thay đổi.
Kết quả mong đợi: Các dịch vụ cũ không thể tiếp tục sử dụng thông tin xác thực cũ.
Làm thế nào để kiểm tra nó: Chạy list-bots và chat từ thiết bị đầu cuối cục bộ hoặc môi trường máy chủ, sau đó xác nhận cuộc trò chuyện xuất hiện trong Chat History nếu chat được gửi.
vấn đề
sửa chữa
401 hoặc phản hồi trái phép
Kiểm tra chính tả x-api-key, sao chép toàn bộ khóa và xác nhận rằng nó chưa bị thu hồi.
Không tìm thấy bot
Sử dụng lại list-bots và xác nhận bot thuộc về chủ sở hữu khóa API.
Sự cố CORS của trình duyệt
Di chuyển lệnh gọi API sang phần phụ trợ của bạn; Khóa API được thiết kế để sử dụng phía máy chủ.
Phải làm gì tiếp theo: Sử dụng /api-docs để tham khảo điểm cuối tập trung và giữ trang này làm hướng dẫn quy trình làm việc.
Danh sách bot
curl -X GET "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api?action=list-bots" \
-H "x-api-key: sk_live_your_key_here"
Gửi tin nhắn chat
curl -X POST "https://akhsrklbijflesmcqxur.supabase.co/functions/v1/public-api" \
-H "x-api-key: sk_live_your_key_here" \
-H "Content-Type: application/json" \
-d '{
"action": "chat",
"botId": "YOUR_BOT_ID",
"message": "What can you help me with?"
}'
Cầu hỗ trợ trực tiếp CRM
Thăm dò ý kiến hoặc đẩy các yêu cầu hỗ trợ trực tiếp vào CRM
Cái này dùng để làm gì: Sử dụng tính năng này khi tổng đài viên làm việc trong hệ thống khác nhưng sem.chat nhận được cuộc trò chuyện của khách truy cập.
Trước khi bạn bắt đầu
Tạo khóa API chuyên dụng được đặt tên cho cầu nối CRM.
Quyết định xem bỏ phiếu hay webhooks có phù hợp với cơ sở hạ tầng của bạn hay không.
Đảm bảo CRM lưu trữ ID cuộc trò chuyện để trả lời/giải quyết trong tương lai.
1
Danh sách chờ bàn giao
GET hành động=live-support-list với trạng thái=được yêu cầu hoặc trạng thái=tất cả.
Kết quả mong đợi: CRM nhận conversations mở cần có sự chú ý của con người.
2
Tìm nạp tin nhắn
GET hành động=live-support-messages với conversationId.
Kết quả mong đợi: CRM có bối cảnh chuỗi đầy đủ và thông tin chi tiết về khách truy cập.
3
Yêu cầu trước khi trả lời
POST hành động=live-support-claim.
Kết quả mong đợi: sem.chat đánh dấu cuộc trò chuyện là đã được xử lý tích cực.
4
Gửi đại lý trả lời
POST action=live-support-reply với conversationId, tin nhắn và tên tác nhân.
Kết quả mong đợi: Khách truy cập nhận được phản hồi của con người và cập nhật chủ đề.
5
Giải quyết hoặc trả lại
POST action=live-support-resolve với độ phân giải được giải quyết hoặc bàn giao lại.
Kết quả mong đợi: Cuộc trò chuyện sẽ rời khỏi hàng chờ hoặc AI sẽ tiếp tục kiểm soát.
6
Trạng thái nhật ký trong CRM
Lưu trữ trạng thái chuyển giao mới nhất, ID tin nhắn và dấu thời gian.
Kết quả mong đợi: CRM và sem.chat vẫn có thể kiểm tra được.
Làm thế nào để kiểm tra nó: Tạo chuyển giao an toàn, phản chiếu nó tới CRM, trả lời từ cầu nối và xác nhận cập nhật chuỗi của khách truy cập.
vấn đề
sửa chữa
Vé trùng lặp CRM
Sử dụng conversationId làm khóa bình thường trong cầu nối CRM của bạn.
Các câu trả lời đến không theo thứ tự
Lưu trữ dấu thời gian của tin nhắn và tránh trả lời đồng thời từ nhiều hệ thống.
AI trả lời khi nhân viên đang làm việc
Yêu cầu bàn giao trước và chỉ giao lại khi đại lý hoàn thành.
Phải làm gì tiếp theo: Đăng ký webhook nếu việc bỏ phiếu quá chậm hoặc quá tốn kém.
Webhook
Đăng ký webhook và xác minh X-SemChat-Signature
Cái này dùng để làm gì: Hãy sử dụng tính năng này khi hệ thống của bạn cần các sự kiện theo thời gian thực để chuyển giao, thông báo và cập nhật độ phân giải.
Trước khi bạn bắt đầu
Webhook URL phải là HTTPS và có thể truy cập được từ Internet công cộng.
Lưu trữ bí mật webhook ngay lập tức; nó được hiển thị một lần.
Xác minh chữ ký trước khi xử lý sự kiện.
1
Đăng ký webhook
POST hành động webhook-register với url và sự kiện.
Kết quả mong đợi: Phản hồi bao gồm thông tin chi tiết về webhook và bí mật ký một lần.
2
Lưu trữ bí mật
Lưu bí mật trong môi trường máy chủ hoặc trình quản lý bí mật của bạn.
Kết quả mong đợi: Việc giao hàng trong tương lai có thể được xác minh.
3
Xác minh chữ ký
Đọc X-SemChat-Signature và so sánh nó với HMAC SHA-256 trên nội dung yêu cầu thô.
Kết quả mong đợi: Chỉ những đơn hàng sem.chat chính hãng mới được chấp nhận.
4
Xử lý các lần thử lại một cách bình thường
Sử dụng ID sự kiện hoặc ID cuộc trò chuyện/tin nhắn để tránh xử lý trùng lặp.
Kết quả mong đợi: Việc thử lại không tạo ra bản ghi CRM trùng lặp.
5
Liệt kê webhook
GET hành động webhook-list để kiểm tra các điểm cuối đã định cấu hình.
Kết quả mong đợi: Bạn có thể xem URL, sự kiện, trạng thái đã bật và trạng thái phân phối gần đây.
6
Xóa webhook cũ
POST hành động webhook-delete với ID webhook.
Kết quả mong đợi: Điểm cuối cũ ngừng nhận sự kiện.
Làm thế nào để kiểm tra nó: Đăng ký điểm cuối thử nghiệm, kích hoạt sự kiện hỗ trợ trực tiếp, xác minh chữ ký và xác nhận trình xử lý của bạn trả về 2xx.
vấn đề
sửa chữa
Chữ ký không khớp
Sử dụng nội dung thô, chưa được phân tích cú pháp JSON và xác nhận bí mật webhook chính xác.
Webhook không nhận được sự kiện nào
Xác nhận danh sách sự kiện bao gồm sự kiện bạn đang thử nghiệm và điểm cuối là HTTPS.
Webhook hết thời gian chờ
Ghi nhận nhanh chóng và xử lý công việc lâu dài một cách không đồng bộ.
Phải làm gì tiếp theo: Liên kết các kỹ sư với /api-docs để biết ví dụ và chi tiết về điểm cuối.
Sử dụng API công khai dựa trên hành động một cách chính xác
Cái này dùng để làm gì: Hãy sử dụng điều này khi chọn hành động phù hợp cho một tính năng.
Trước khi bạn bắt đầu
Mọi yêu cầu đều sử dụng cùng một hàm api công khai URL.
Hành động GET sử dụng tham số truy vấn. Hành động POST sử dụng nội dung JSON.
Gửi x-api-key theo tất cả các yêu cầu.
Làm thế nào để kiểm tra nó: Gọi usage và list-bots làm thử nghiệm khói sau bất kỳ thay đổi nào về khóa hoặc điểm cuối API.
vấn đề
sửa chữa
Phương thức không khớp
Sử dụng phương pháp hiển thị trong bảng điểm cuối. Một số hành động chỉ GET hoặc chỉ POST.
Thiếu giá trị bắt buộc
Kiểm tra botId, conversationId, id webhook và chính tả hành động.
Phải làm gì tiếp theo: Sử dụng Quick Start cho các yêu cầu đầu tiên, sau đó /api-docs để tham khảo đầy đủ.
phương pháp
hành động
Mục đích
GET
list-bots
Liệt kê tất cả các bot có sẵn cho chủ sở hữu khóa API.
GET
get-bot
Tìm nạp một cấu hình bot theo ID bot.
POST
chat
Gửi tin nhắn của khách truy cập tới bot và trả lời AI.
GET
conversations
Liệt kê conversations gần đây cho bot, tối đa 100 bản ghi.
GET
usage
Trả lại gói, tín dụng, số lượng bot, conversations và khóa API usage.
GET
live-support-list
Danh sách conversations đang chờ hoặc được xử lý bởi tác nhân con người.
GET
live-support-messages
Tìm nạp chuỗi chuyển giao có tin nhắn và thông tin khách truy cập.
POST
live-support-reply
Gửi phản hồi của con người-tác nhân từ hệ thống bên ngoài.
POST
live-support-claim
Yêu cầu một cuộc trò chuyện chuyển tiếp đang chờ.
POST
live-support-resolve
Giải quyết việc chuyển giao hoặc trả lại quyền kiểm soát cho AI.
POST
webhook-register
Đăng ký điểm cuối webhook HTTPS.
GET
webhook-list
Liệt kê các đăng ký webhook mà không trả lại bí mật.
POST
webhook-delete
Xóa đăng ký webhook theo ID.
14
Hướng dẫn kỹ sư: Thêm tính năng
Thêm tuyến đường, điều hướng trang tổng quan, cài đặt trình tạo bot, Supabase bảng/chức năng/di chuyển, API tài liệu, tài liệu công khai, kiểm tra SEO và xác minh cục bộ.
Quy trình làm việc của tính năng ứng dụng
Thêm lộ trình ứng dụng, trang, mục điều hướng và mục nhập tài liệu
Cái này dùng để làm gì: Hãy sử dụng tính năng này khi thêm tính năng bảng thông tin mới hướng tới khách hàng.
Trước khi bạn bắt đầu
Tạo một nhánh trước khi chỉnh sửa.
Xác định xem tính năng này thuộc về kho lưu trữ ứng dụng hay kho lưu trữ giao diện người dùng sem.chat công khai.
Kiểm tra các mẫu cài đặt, thanh bên, i18n và tuyến đường hiện có trước khi thêm cấu trúc mới.
1
Thêm tuyến đường
Cập nhật src/App.tsx với tuyến được bảo vệ cho các trang của khách hàng hoặc chỉ tuyến công khai khi trang phải ở chế độ công khai.
Kết quả mong đợi: URL phân giải trong ứng dụng mà không cần nhấn vào NotFound.
2
Tạo hoặc cập nhật thành phần trang
Sử dụng các mẫu trang, tải dữ liệu, trạng thái trống, trạng thái tải và quyền hiện có.
Kết quả mong đợi: Tính năng này hoạt động nhất quán với bảng điều khiển.
3
Thêm điều hướng bảng điều khiển
Cập nhật nguồn thanh bên/điều hướng với nhãn, biểu tượng, tuyến đường và cổng kế hoạch nếu được yêu cầu.
Kết quả mong đợi: Người dùng có thể khám phá trang mới từ trình bao ứng dụng.
4
Thêm tab hoặc cài đặt trình tạo bot
Nếu tính năng này thuộc về bot, hãy thêm tính năng đó vào trong tab Bot Builder và duy trì tính năng đó thông qua các luồng lưu hiện có.
Kết quả mong đợi: Cấu hình dành riêng cho bot được lưu cùng với bot, không bị mắc kẹt ở trạng thái cục bộ.
5
Thêm các thay đổi về lược đồ/hàm Supabase
Tạo di chuyển cho các bảng/chính sách và các hàm biên cho công việc phía máy chủ.
Kết quả mong đợi: Hành vi của cơ sở dữ liệu và máy chủ có thể được triển khai nhiều lần.
6
Cập nhật hình dạng API nếu công khai
Thêm hoặc mở rộng khả năng xử lý hành động trong supabase/functions/public-api/index.ts và ghi lại hành vi x-api-key.
Kết quả mong đợi: Tích hợp có thể sử dụng tính năng này một cách an toàn.
7
Cập nhật tài liệu ứng dụng và tài liệu công khai
Cập nhật tài liệu dành cho nhà phát triển trong ứng dụng và trang /tài liệu này kèm theo ảnh chụp màn hình và các bước nhấp chuột.
Kết quả mong đợi: Người dùng và kỹ sư nhìn thấy tính năng này ở cả hai nơi.
8
Chạy kiểm tra
Chạy thử nghiệm/xây dựng ứng dụng, trình tối ưu hóa SEO trên trang web công cộng, kiểm tra sơ đồ trang web và xác minh trình duyệt.
Kết quả mong đợi: Tính năng này hoạt động cục bộ và trang web công cộng vẫn có thể được thu thập dữ liệu.
Làm thế nào để kiểm tra nó: Mở tuyến mới, sử dụng tính năng từ đầu đến cuối, kiểm tra lỗi bảng điều khiển/mạng và xác minh mọi thay đổi cơ sở dữ liệu từ giao diện người dùng.
vấn đề
sửa chữa
Tuyến đường hoạt động nhưng điều hướng không làm nổi bật
Kiểm tra các đường dẫn chuyển hướng và khớp tuyến đường trong thanh bên.
Dữ liệu hoạt động cục bộ nhưng không được triển khai
Xác nhận di chuyển, chính sách RLS và các biến môi trường của hàm biên.
Tài liệu công khai bị thiếu trong sơ đồ trang web
Chạy trình tối ưu hóa SEO và kiểm tra sitemap.xml để tìm URL chuẩn.
Phải làm gì tiếp theo: Chụp hoặc tạo lại ảnh chụp màn hình tài liệu bất cứ khi nào giao diện người dùng thay đổi.
Quy trình bảo trì tài liệu
Cập nhật trang tài liệu công khai này sau khi thay đổi sản phẩm
Cái này dùng để làm gì: Sử dụng tính năng này khi ảnh chụp màn hình, quy trình làm việc, hành vi API hoặc điều hướng thay đổi.
Trước khi bạn bắt đầu
Chỉ sử dụng dữ liệu demo an toàn.
Không bao giờ tiết lộ khách hàng thực, email, chi tiết thanh toán, khóa API hoặc conversations riêng tư.
Cập nhật sổ tay tiếng Anh trước, sau đó làm mới từng trang tài liệu đã bản địa hóa trước khi kiểm tra SEO.
1
Kiểm tra lộ trình đã thay đổi
Mở lộ trình ứng dụng và xác định những gì đã thay đổi một cách trực quan và theo quy trình.
Kết quả mong đợi: Bạn biết hàng hướng dẫn, ảnh chụp màn hình và khắc phục sự cố nào cần chỉnh sửa.
2
Chụp hoặc tạo ảnh chụp màn hình an toàn
Sử dụng không gian làm việc demo và che dấu bí mật trước khi lưu nội dung WebP trong nội dung/tài liệu.
Kết quả mong đợi: Ảnh chụp màn hình chính xác và an toàn để xuất bản.
3
Cập nhật hướng dẫn
Chỉnh sửa các phần liên quan Mục này dùng để làm gì, Trước khi bạn bắt đầu, Các bước, Kết quả mong đợi, Kiểm tra, Khắc phục sự cố và Tiếp theo.
Kết quả mong đợi: Hướng dẫn cho người dùng biết những gì cần nhấp và điều gì sẽ xảy ra sau mỗi lần nhấp.
4
Cập nhật điều hướng nếu cần
Thêm phần này vào TOC cố định, bộ chọn phần dành cho thiết bị di động và chỉ mục trực quan nếu đó là một trang chính.
Kết quả mong đợi: Người đọc có thể tìm thấy nội dung mới một cách nhanh chóng.
5
Chạy công cụ SEO
Chạy node tools/seo-optimize-static-pages.js và node tools/seo-optimize-static-pages.js --check.
Kết quả mong đợi: Đầu ra Canonical, siêu dữ liệu, sơ đồ trang web và robot vẫn chính xác.
6
Chạy dọn dẹp và kiểm tra khác biệt
Chạy node tools/static-translation-cleanup.js --audit và git diff --check.
Kết quả mong đợi: Bản dịch tĩnh và khoảng trắng sạch sẽ.
7
Xác minh trình duyệt
Phục vụ trang web cục bộ và kiểm tra/tài liệu trên máy tính để bàn và thiết bị di động.
Kết quả mong đợi: Tải hình ảnh, tìm kiếm, nút sao chép hoạt động, đánh dấu TOC và bố cục không chồng lên biểu ngữ cookie.
Làm thế nào để kiểm tra nó: Tìm kiếm tên tính năng đã thay đổi trên /documentation và xác nhận khối hướng dẫn chính xác xuất hiện.
vấn đề
sửa chữa
Điểm đánh dấu ảnh chụp màn hình trôi dạt trên thiết bị di động
Giữ các điểm đánh dấu bên trong ảnh chụp màn hình hoặc sử dụng tọa độ đánh dấu đáp ứng.
Tìm kiếm bỏ lỡ hướng dẫn mới
Thêm các từ khóa hữu ích vào data-title và bao gồm các thuật ngữ sản phẩm chính xác mà người dùng tìm kiếm.
Tài liệu bản địa hóa trở nên lỗi thời
Sau khi chỉnh sửa sổ tay tiếng Anh, hãy làm mới từng trang tài liệu đã bản địa hóa, chạy lại trình tối ưu SEO và xác nhận sitemap.xml bao gồm mọi URL tài liệu.
Phải làm gì tiếp theo: Cam kết các thay đổi trang tài liệu, nội dung, liên kết đầu trang/chân trang, .htaccess và sơ đồ trang web cùng nhau.
Cần tham chiếu API tập trung?
Trang /api-docs cũ hơn vẫn có sẵn để biết chi tiết API cấp điểm cuối.