Tùy chỉnh chatbot

Hướng dẫn này cho bạn cách định hình lại app bot phía nhà cung cấp mà không cần rời khỏi Control Center.

Điều kiện tiên quyết

Vai trò owner hoặc admin trong không gian làm việc
Một nhà cung cấp đã kết nối. Dòng Tùy chỉnh bot chỉ xuất hiện sau khi không gian làm việc được kết nối
Một app mà Control Center có thể quản lý. Với Slack, nghĩa là kết nối giữ token làm mới cấu hình app (xoxe-…); nếu không, dòng này sẽ báo như vậy và tiếp tục bị vô hiệu hóa

Những gì bạn có thể thay đổi

Trường	Ý nghĩa	Giới hạn
Tên app	Cách nhà cung cấp liệt kê app	1–35 ký tự
Tên hiển thị của bot	Thành viên gõ gì sau `@`	1–80 ký tự
Mô tả	Một dòng mà nhà cung cấp hiển thị	140 ký tự hoặc ít hơn
Mô tả agent	Hiển thị phía trên một DM với bot	300 ký tự hoặc ít hơn
Lệnh slash	Lệnh mà thành viên gọi, không kèm dấu gạch chéo	Chuyển thành chữ thường, chỉ `a–z 0–9 _ -`, cắt ở 32 ký tự
Tin nhắn trực tiếp	Bot có bật trải nghiệm DM/agent hay không	Bật hoặc tắt

Control Center kiểm tra bốn trường văn bản trước khi gọi nhà cung cấp, nên bạn nhận được “the app name must be between 1 and 35 characters” thay vì một invalid_manifest mù mờ từ máy chủ mà bạn không nhìn thấy. Lệnh không bị từ chối mà được chuẩn hóa: dấu gạch chéo ở đầu bị bỏ, phần còn lại chuyển thành chữ thường, mọi ký tự ngoài a–z 0–9 _ - bị loại bỏ và kết quả rỗng sẽ quay về cc.

Chỉnh sửa bot

Vào Cài đặt → Không gian làm việc → Chung và cuộn tới thẻ Cầu nối chat
Trên khối nhà cung cấp, nhấp vào Tùy chỉnh bot
Hộp thoại mở ra với các giá trị trực tiếp của app, đọc lại từ nhà cung cấp — nên thay đổi mà ai đó đã thực hiện ngay trong giao diện của Slack chính là điểm bạn bắt đầu
Chỉnh sửa những gì bạn cần rồi lưu

Việc đọc các giá trị trực tiếp đó tốn một lần xoay token về phía Slack, đó là lý do dòng này cần một cú nhấp có chủ đích thay vì được trang tự đọc khi tải.

Thao tác ghi sẽ phủ các thay đổi của bạn lên định nghĩa hiện tại của app. Bất cứ thứ gì Control Center không mô hình hóa — một lệnh slash thứ hai bạn thêm trong Slack, một bước workflow, một cài đặt không liên quan — đều được giữ nguyên vẹn. Các scope và sự kiện được hợp nhất vào, không bao giờ bị bớt đi.

Sau khi lưu, Control Center đọc lại danh tính của bot để tên trong cài đặt khớp với tên trong app chat.

Cài lại khi quyền thay đổi

Khi một lần lưu làm thay đổi quyền, hộp thoại vẫn mở và hiển thị “Slack đã thay đổi quyền của app. Cài lại app để các quyền có hiệu lực”, kèm nút Cài lại app mở trang cài đặt app đó vào nhóm Slack. Trong Slack, đó là Install App → Reinstall to Workspace.

Đổi tên lệnh slash

Thay đổi Lệnh slash rồi lưu. Cầu nối sau đó viết hướng dẫn bằng lệnh mà nó được gọi lần cuối, nên văn bản trợ giúp và hướng dẫn liên kết đi theo tên mới thay vì nêu một lệnh không còn tồn tại.

Đổi tên không làm hỏng các luồng đã nối từ trước: luồng được khóa theo hội thoại, không theo lệnh.

Những gì Control Center sẽ không thay đổi

Cài đặt mang tính cấu trúc. Transport (Socket Mode), các scope bắt buộc và các đăng ký sự kiện đều được áp đặt, không phải để tùy chọn. Một app có thể bị cấu hình đến mức im lặng từ màn hình cài đặt là một phiếu hỗ trợ, không phải một tính năng
Biểu tượng của bot. Chỉ cài đặt app của chính nhà cung cấp mới đổi được nó và hộp thoại nói rõ điều đó
Các đợt chuyển đổi tính năng của chính nhà cung cấp. Một app đã ở dạng trợ lý cũ của Slack sẽ giữ nguyên dạng đó; hộp thoại này chỉnh sửa phần mô tả, chứ không chuyển đổi app

Xử lý sự cố

Không có dòng Tùy chỉnh bot nào cả

Không gian làm việc chưa được kết nối. Dòng này chỉ xuất hiện khi khối nhà cung cấp hiển thị một kết nối đang hoạt động. Xem Thiết lập tích hợp Slack.

Dòng Tùy chỉnh bot bị vô hiệu hóa

Kết nối không có thông tin xác thực để quản lý app — phụ đề của dòng ghi “Control Center cần token cấu hình app để chỉnh bot. Kết nối lại và kèm theo token.” Với Slack, hãy tạo một cặp token cấu hình app trên api.slack.com/apps và kết nối lại với token làm mới đã được điền. Đây là điều bình thường với một app được dựng thủ công hoặc tạo qua Tạo trên Slack, vì Slack không bao giờ báo app nào nó đã tạo.

“Control Center does not know which app to edit”

Kết nối đã lưu không mang app id — thường là app được kết nối thủ công trước khi id được ghi lại. Hãy kết nối lại không gian làm việc, hoặc tạo app từ Control Center.

Tên mới của bot chưa xuất hiện trong chat

Các nhà cung cấp lưu đệm metadata của app trong chốc lát. Nếu sau một phút tên vẫn cũ, hãy kiểm tra xem lần lưu có yêu cầu bạn cài lại app hay không.

Hướng dẫn liên quan

Khái niệm liên quan

Cầu chat