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

Nếu một tích hợp không kết nối được, ngừng hoạt động hoặc không thể hoàn thành một tác vụ, hãy dùng hướng dẫn này để kiểm tra kết nối, quyền truy cập tài khoản và tài nguyên đã chọn.

Trang này đề cập đến các sự cố kết nối và ủy 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 Kết nối và Quản lý Tích hợp và chọn hướng dẫn cho dịch vụ của bạn.

Bắt đầu với các bướ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 Kết nối và Quản lý Tích hợp.
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, sau đó 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 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), sau đó 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, khóa API, 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

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 dự định dùng 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 Kết nối và Quản lý Tích hợp 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 bằng cách thử đăng nhập lặp đi lặp lại.

Ủy 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 cửa sổ bật lên bị chặn, hãy cho phép pop-up cho trang Atoms rồi 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 dự định dùng và xem lại quyền truy cập được yêu cầu. Hoàn tất luồng ủy quyền của dịch vụ trước khi đóng cửa sổ của nó.
3. Nếu dịch vụ nêu rõ 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 lại 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 phải là xác nhận rằng ủy 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 ủy quyền. Việc ủy quyền một tài khoản tự nó không xác nhận rằng tài nguyên dự định dùng đã được kết nối.

Nếu phần ủy quyền có 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 dùng 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 nhầm 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 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 cho việc Atoms đang dùng tài khoản nào.

Mở trực tiếp tài nguyên trong dịch vụ bằng tài khoản dự định dùng. Nếu tài khoản đó không thể truy cập, hãy yêu cầu chủ sở hữu tài nguyên cấp quyền trước. 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 ủy quyền.

Kiểm tra kết quả: Một yêu cầu đọc nhỏ, được hỗ trợ sẽ 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 dùng. 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 [tên tài liệu hoặc liên kết] 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 được, hãy kiểm tra các khả năng được hỗ trợ của connector và quyền truy cập đã được cấp. Chỉ kết nối lại nếu có bằng chứng về vấn đề ủy 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 Kết nối và Quản lý Tích hợp 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 đúng 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 ủy quyền bổ sung, hãy làm theo quy trình được tài liệu hóa của dịch vụ. Việc 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 một 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ợ sẽ thành công trên một tài nguyên kiểm thử 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 đang chạy 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 ủy 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ỡ, 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 ủy 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ả đã cũ 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. Đối với lỗi hết thời gian chờ rõ ràng hoặc lỗi 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 đợi đến lúc đó; đừng gửi yêu cầu lặp đi 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 ủy quyền lại 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 ủy 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 rằng 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 Kết nối và Quản lý Tích hợp để 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, sau đó chọn Connect. Đừng cho rằng sẽ có thêm một bước xác nhận trước khi ngắt kết nối.
3. Chọn đúng tài khoản dự định dùng và hoàn tất ủy 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 một lỗi xuất hiện lại, hãy ngừng kết nối lại và liên hệ hỗ trợ kèm theo lỗi đó và các bước kiểm tra đã hoàn tất.

Xác minh rằng sự cố đã đượ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 kiểm thử phù hợp hoặc quy trình kiểm thử được tài liệu hóa 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ỉ riêng chỉ báo đã kết nối 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, sau đó 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 Kết nối và Quản lý Tích hợp hoặc khắc phục sự cố build và preview. 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 Nhận hỗ trợ và bao gồm:

• Tên tích hợp và email tài khoản Atoms của bạn.
• Dự án hoặc liên kết Chat bị ảnh hưởng, và việc 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 dùng, chỉ sử 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 với ả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.

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