Khắc phục sự cố Tích hợp

Trang này đề cập đến các sự cố kết nối và cấp quyền phổ biến trong Atoms. Để thiết lập theo từng dịch vụ, các hành động được hỗ trợ hoặc cấu hình bên trong app của bạn, hãy bắt đầu với Connect and Manage Integrations và chọn hướng dẫn cho dịch vụ của bạn.

Bắt đầu với các kiểm tra này

1. Kiểm tra nơi xảy ra lỗi. Agent không thể sử dụng một dịch vụ trong Chat hay tính năng chỉ lỗi trong app của bạn? Việc kết nối một dịch vụ cho Chat tự nó không xác nhận rằng app của bạn đã được cấu hình đúng. Với các lỗi chỉ xảy ra trong app, xem Connect and Manage Integrations.
2. Mở Tích hợp. Trong Chat của dự án, mở menu tùy chọn bên cạnh ô nhập tin nhắn, rồi chọn Connectors → Add connectors. Tìm kiếm và chọn dịch vụ. Kiểm tra xem dịch vụ đã được kết nối hay vẫn còn hiển thị Connect. Một số dịch vụ mở màn hình quản lý riêng của chúng.
3. Kiểm tra quyền truy cập trong chính dịch vụ đó. Xác nhận rằng tài khoản bạn định kết nối có thể mở đúng tệp, kho lưu trữ, lịch, thuộc tính hoặc tài nguyên khác liên quan.
4. Lưu lỗi trước khi thay đổi bất cứ điều gì. Ghi lại chính xác thông báo, thời gian và múi giờ, dự án hoặc Chat bị ảnh hưởng, và lần thử thành công gần nhất. Che thông tin riêng tư trong ảnh chụp màn hình.

Mở các tùy chọn nhập Chat, chọn Connectors (1), rồi Add connectors (2) để duyệt các Tích hợp khả dụng.

Bạn cũng có thể quản lý các kết nối khả dụng trong Settings → Connectors. Chọn Tích hợp bạn muốn kiểm tra.

Giữ thông tin xác thực ở chế độ riêng tư. Không bao giờ dán mật khẩu, mã đăng nhập, API key, access token hoặc bí mật khác vào Chat hoặc yêu cầu hỗ trợ. Chỉ nhập thông tin xác thực trong luồng đăng nhập của dịch vụ hoặc trường cấu hình bảo mật được chỉ định.

Tìm vấn đề của bạn

Những gì bạn thấy	Nơi bắt đầu
Một dịch vụ bị thiếu hoặc các điều khiển của dịch vụ đó không khả dụng	Tìm hoặc bắt đầu một Tích hợp
Đăng nhập không mở, bị chặn hoặc không bao giờ hoàn tất	Hoàn tất cấp quyền
Kết nối đang dùng một tài khoản khác	Kiểm tra tài khoản đã kết nối
Đã kết nối, nhưng Agent không thể tìm thấy tài nguyên	Kiểm tra kết nối và quyền truy cập dữ liệu
Đọc hoạt động, nhưng tạo hoặc chỉnh sửa bị lỗi	Kiểm tra quyền ghi và các hành động được hỗ trợ
Một kết nối trước đây hoạt động nay bị lỗi	Kiểm tra điều gì đã thay đổi
Kết quả đã cũ, yêu cầu bị hết thời gian hoặc lỗi lặp lại	Kiểm tra yêu cầu và tính khả dụng của dịch vụ

Bạn không thể tìm thấy hoặc bắt đầu một Tích hợp

1. Dùng Add connectors để tìm trong danh mục. Danh sách ngắn hơn trong menu Chat không phải là toàn bộ danh mục.
2. Nếu Atoms cho biết tính năng chỉ khả dụng trong một dự án, hãy mở đúng dự án đó và thử tại đó.
3. Nếu một điều khiển bị vô hiệu hóa, hãy đọc phần giải thích của nó. Nếu cần vai trò hoặc quyền khác, hãy nhờ chủ sở hữu dự án hoặc không gian làm việc hỗ trợ. Đừng ngắt kết nối một dịch vụ khác chỉ để vượt qua hạn chế.

Kiểm tra kết quả: Bạn có thể mở màn hình kết nối hoặc quản lý của dịch vụ. Nếu nó vẫn không xuất hiện, hãy kiểm tra Connect and Manage Integrations hoặc liên hệ hỗ trợ để xác nhận tính khả dụng. Đừng cho rằng một dịch vụ bị thiếu có thể được bật lên bằng cách thử đăng nhập lặp đi lặp lại.

Cấp quyền không hoàn tất

1. Chọn Connect một lần và tìm cửa sổ đăng nhập của dịch vụ. Nếu trình duyệt báo pop-up bị chặn, hãy cho phép pop-up cho trang Atoms và thử lại. Trong Chrome, làm theo hướng dẫn cho phép pop-up từ một trang cụ thể; bạn không cần bật chúng cho mọi trang.
2. Chọn đúng tài khoản và xem lại quyền truy cập được yêu cầu. Hoàn tất luồng cấp quyền của dịch vụ trước khi đóng cửa sổ đó.
3. Nếu dịch vụ nêu rõ rằng tổ chức của bạn đã chặn app hoặc quyền truy cập được yêu cầu, hãy lưu thông báo và liên hệ quản trị viên của bạn. Đừng tìm cách lách chính sách của tổ chức.
4. Quay lại Atoms và mở lại Tích hợp để kiểm tra trạng thái của nó. Việc đóng cửa sổ đăng nhập không xác nhận rằng việc cấp quyền đã thành công.

Xem lại quyền truy cập được yêu cầu trước khi hoàn tất cấp quyền. Việc cấp quyền cho một tài khoản tự nó không xác nhận rằng tài nguyên dự định đã được kết nối.

Nếu việc cấp quyền bao gồm bộ chọn tổ chức hoặc không gian làm việc, hãy xác nhận lựa chọn dự định và xem lại các quyền được yêu cầu.

Kiểm tra kết quả: Tích hợp được hiển thị là đã kết nối. Trên các màn hình chi tiết connector dùng bố cục tiêu chuẩn, Connect được thay bằng Disconnect và Try it out. Các dịch vụ khác có bố cục riêng. Nếu vẫn còn hiển thị Connect hoặc báo lỗi, hãy ghi lại kết quả đó và liên hệ hỗ trợ sau một lần thử mới.

Đã kết nối sai tài khoản

Nếu màn hình quản lý của Tích hợp hiển thị một tài khoản, hãy so sánh tài khoản đó với tài khoản sở hữu hoặc có thể truy cập tài nguyên. Không phải mọi connector đều hiển thị tài khoản đã kết nối, vì vậy đừng chỉ dùng trạng thái đăng nhập hiện tại của trình duyệt làm bằng chứng về tài khoản mà Atoms đang sử dụng.

Mở trực tiếp tài nguyên trong dịch vụ bằng tài khoản dự định. Nếu tài khoản đó không thể truy cập, trước tiên hãy yêu cầu chủ sở hữu tài nguyên cấp quyền. Nếu kết nối đang dùng sai tài khoản, hãy làm theo hướng dẫn chuyển đổi tài khoản của dịch vụ hoặc kết nối lại an toàn và chọn rõ ràng đúng tài khoản trong quá trình cấp quyền.

Kiểm tra kết quả: Một yêu cầu đọc nhỏ, được hỗ trợ trả về đúng tài nguyên dự định. Nếu bạn vẫn không thể xác định tài khoản nào đã được kết nối, hãy liên hệ hỗ trợ thay vì ngắt kết nối lặp đi lặp lại.

Tích hợp đã được kết nối, nhưng Agent không thể tìm thấy dữ liệu của bạn

1. Kiểm tra kết nối. Mở chi tiết của Tích hợp trong Connectors và xác nhận rằng nó đã được kết nối. Kiểm tra tài khoản hoặc tài nguyên đã chọn nếu có hiển thị.
2. Kiểm tra đúng tài nguyên. Mở trực tiếp tài nguyên đó trong dịch vụ bằng tài khoản dự định. Xác nhận vị trí và quyền truy cập của nó, bao gồm đúng tổ chức, không gian làm việc, thư mục hoặc thuộc tính nếu có liên quan.
3. Làm cho yêu cầu cụ thể. Nêu tên dịch vụ và cung cấp tên hoặc liên kết chính xác của tài nguyên khi connector hỗ trợ. Trước tiên hãy yêu cầu một hành động đọc được hỗ trợ, thay vì tìm kiếm và thay đổi nhiều tài nguyên cùng lúc.

Ví dụ, nếu connector hỗ trợ đọc tài liệu: “Dùng [service] để đọc [document name or link] và cho tôi biết tiêu đề của nó. Đừng thay đổi nó.”

Kiểm tra kết quả: Agent trả về đúng tài nguyên dự định. Nếu truy cập trực tiếp hoạt động nhưng Agent vẫn không thể đọc, hãy kiểm tra các khả năng được hỗ trợ và quyền truy cập đã cấp của connector. Chỉ kết nối lại nếu có bằng chứng về sự cố cấp quyền.

Agent có thể đọc dữ liệu, nhưng không thể thay đổi dữ liệu đó

Việc đọc thành công không xác nhận rằng connector hỗ trợ thay đổi được yêu cầu hoặc có quyền để thực hiện thay đổi đó.

1. Xem Connect and Manage Integrations hoặc danh sách What you can do của connector, nếu có hiển thị. Xác nhận rằng hành động được yêu cầu là được hỗ trợ.
2. Kiểm tra xem tài khoản đã kết nối có được phép thực hiện thay đổi đó trên đúng tài nguyên hay không. Chỉ yêu cầu chủ sở hữu tài nguyên hoặc quản trị viên cấp quyền cần thiết.
3. Đọc mọi lỗi hoặc yêu cầu xác nhận. Nếu cần cấp quyền bổ sung, hãy làm theo luồng được ghi nhận của dịch vụ. Kết nối lại không thể thêm một hành động mà connector không hỗ trợ.

Trước khi thử lại thao tác ghi: Kiểm tra đích đến để xem lần thử đầu tiên đã tạo hoặc thay đổi điều gì chưa. Một phản hồi thất bại không đủ để chứng minh rằng không có thay đổi nào xảy ra. Đừng lặp lại một khoản thanh toán, tin nhắn, lời mời hoặc việc tạo bản ghi cho đến khi bạn biết kết quả trước đó.

Kiểm tra kết quả: Một thay đổi được hỗ trợ thành công trên một tài nguyên thử nghiệm phù hợp, và bạn xác nhận trực tiếp trong dịch vụ. Với thanh toán hoặc các quy trình thực tế khác, hãy dùng hướng dẫn kiểm thử riêng của dịch vụ thay vì một giao dịch thật.

Một kết nối trước đây hoạt động nay đã dừng

Kiểm tra điều gì đã thay đổi kể từ yêu cầu thành công gần nhất: tài khoản, quyền truy cập của tài khoản đó vào tài nguyên, chính sách app của tổ chức hoặc việc cấp quyền của kết nối.

1. Mở lại Tích hợp trong Atoms và kiểm tra xem nó còn được kết nối hay không.
2. Thử mở trực tiếp tài nguyên trong dịch vụ. Nếu quyền truy cập đã bị gỡ bỏ, hãy giải quyết việc đó với chủ sở hữu tài nguyên hoặc quản trị viên.
3. Nếu lỗi cho biết việc cấp quyền đã hết hạn, bị thu hồi hoặc không hợp lệ, hãy làm theo Kết nối lại an toàn. Nếu lỗi liên quan đến sự cố dịch vụ, giới hạn hoặc hành động không được hỗ trợ, hãy xử lý nguyên nhân đó trước.

Kiểm tra kết quả: Một yêu cầu đọc nhỏ hoạt động trở lại. Nếu vẫn còn cùng lỗi đó, hãy lưu lại cùng với thời điểm thành công gần nhất và liên hệ hỗ trợ.

Kết quả đã lỗi thời hoặc một yêu cầu liên tục thất bại

1. So sánh kết quả với chính dịch vụ đó. Xác nhận tài khoản, tài nguyên, khoảng ngày, bộ lọc và múi giờ nếu có liên quan. Yêu cầu Agent lấy giá trị hiện tại thay vì dựa vào câu trả lời trước đó trong cuộc trò chuyện.
2. Với lỗi hết thời gian rõ ràng hoặc dịch vụ không khả dụng, hãy kiểm tra trang trạng thái hoặc trợ giúp chính thức của dịch vụ. Nếu lỗi đưa ra thời gian thử lại, hãy chờ đến lúc đó; đừng gửi các yêu cầu lặp lại khi giới hạn hoặc sự cố vẫn còn.
3. Lưu mọi văn bản chưa gửi, làm mới Atoms và kiểm tra lại trạng thái connector. Làm mới trang không giống với việc cấp quyền lại cho tài khoản.
4. Thử lại một yêu cầu đọc nhỏ. Trước khi thử lại bất cứ điều gì làm thay đổi dữ liệu bên ngoài, hãy kiểm tra đích đến để xem kết quả trước đó.

Kiểm tra kết quả: Kết quả mới khớp với tài nguyên dự định trong dịch vụ. Nếu vẫn không chính xác, hãy gửi cho bộ phận hỗ trợ giá trị mong đợi và giá trị thực tế kèm dấu thời gian. Đừng cho rằng mọi Tích hợp đều cập nhật theo cùng một lịch.

Kết nối lại an toàn

Hãy kết nối lại khi việc cấp quyền không hợp lệ hoặc sai tài khoản được liên kết — không phải như bước đầu tiên cho mọi yêu cầu thất bại.

Trước khi ngắt kết nối: Hoàn tất hoặc tạm dừng các tác vụ phụ thuộc vào kết nối, kiểm tra kết quả của mọi thao tác ghi bên ngoài đang chờ và bảo đảm bạn có thể đăng nhập lại với quyền truy cập cần thiết. Việc ngắt kết nối sẽ làm kết nối không khả dụng cho đến khi được kết nối lại. Kiểm tra Connect and Manage Integrations để biết mọi ảnh hưởng bổ sung; đừng cho rằng việc ngắt kết nối sẽ đảo ngược các thay đổi trước đó hoặc hủy công việc đã được gửi đi.

1. Mở chi tiết kết nối của dịch vụ. Nếu nó có màn hình quản lý tài khoản riêng, hãy làm theo hướng dẫn của Tích hợp đó.
2. Trên màn hình chi tiết connector tiêu chuẩn, chọn Disconnect khi bạn đã sẵn sàng, rồi chọn Connect. Đừng cho rằng sẽ có xác nhận bổ sung trước khi ngắt kết nối.
3. Chọn đúng tài khoản và hoàn tất cấp quyền. Xem lại các quyền được yêu cầu.
4. Quay lại Atoms và xác nhận trạng thái đã kết nối.
5. Chạy bước kiểm tra khôi phục bên dưới trước khi tiếp tục tác vụ ban đầu.

Nếu cùng lỗi đó quay lại, hãy ngừng kết nối lại và liên hệ hỗ trợ kèm lỗi và các bước kiểm tra đã hoàn tất.

Xác minh rằng vấn đề đã được giải quyết

1. Yêu cầu một hành động chỉ đọc, được hỗ trợ trên một tài nguyên mà bạn có thể xác minh trực tiếp. Nếu bạn dùng Try it out, hãy xem lại câu lệnh được đề xuất trước khi gửi.
2. So sánh phản hồi với chính dịch vụ đó. Xác nhận đúng tài nguyên, ngữ cảnh tài khoản và kết quả được yêu cầu — không chỉ là chỉ báo đã kết nối.
3. Nếu tác vụ của bạn cần thay đổi, hãy dùng một tài nguyên thử nghiệm phù hợp hoặc quy trình kiểm thử được ghi nhận của dịch vụ và xác minh kết quả tại đích đến.

Kiểm tra trạng thái kết nối và tài nguyên đã chọn. Chỉ báo đã kết nối tự nó không xác nhận rằng dữ liệu mong đợi có sẵn hoặc được cập nhật.

Xác nhận tổ chức và dự án, rồi mở Dashboard để kiểm tra tài nguyên mà không thực hiện thay đổi. Ngắt kết nối không phải là một phần của bước kiểm tra này.

Nếu bước kiểm tra thành công, hãy tiếp tục tác vụ của bạn. Nếu Chat hoạt động nhưng tính năng vẫn lỗi trong app của bạn, hãy xem Connect and Manage Integrations hoặc build and preview troubleshooting. Kiểm tra môi trường nơi xảy ra lỗi; một yêu cầu Chat thành công không phải là bằng chứng rằng app đã được cấu hình đúng.

Nhận trợ giúp

Nếu sự cố vẫn tiếp diễn, hãy dùng Get support và bao gồm:

• Tên Tích hợp và email tài khoản Atoms của bạn.
• Liên kết dự án hoặc Chat bị ảnh hưởng, và liệu lỗi xảy ra trong Chat hay trong app của bạn. Với app, hãy xác định môi trường bị ảnh hưởng.
• Tài khoản dịch vụ và tài nguyên dự định, chỉ dùng các định danh không bí mật cần thiết để điều tra.
• Lỗi chính xác, ngày, giờ và múi giờ; bao gồm thời điểm thành công gần nhất nếu biết.
• Các bước để tái hiện, kết quả mong đợi, kết quả thực tế và các bước kiểm tra đã thử.
• Trình duyệt và thiết bị của bạn, cùng ảnh chụp màn hình đã che thông tin hoặc một bản ghi ngắn nếu hữu ích.

Với một thao tác ghi thất bại, hãy cho biết đích đến hiển thị thay đổi đã hoàn tất, không có thay đổi hay kết quả chưa rõ. Xóa mật khẩu, mã đăng nhập, API key, token và dữ liệu riêng tư không liên quan khỏi mọi tệp đính kèm.