Pemecahan masalah Integrasi

Jika sebuah integrasi tidak dapat terhubung, berhenti berfungsi, atau tidak dapat menyelesaikan tugas, gunakan panduan ini untuk memeriksa koneksi, akses akun, dan sumber daya yang dipilih.

Halaman ini membahas masalah koneksi dan otorisasi umum di Atoms. Untuk penyiapan khusus layanan, tindakan yang didukung, atau konfigurasi di dalam app Anda, mulai dari Connect and Manage Integrations dan pilih panduan layanan Anda.

Mulai dengan pemeriksaan ini

1. Periksa di mana kegagalan terjadi. Apakah Agen tidak dapat menggunakan layanan di Chat, atau fitur gagal hanya di app Anda? Menghubungkan layanan untuk Chat tidak dengan sendirinya mengonfirmasi bahwa app Anda dikonfigurasi dengan benar. Untuk kegagalan yang hanya terjadi di app, lihat Connect and Manage Integrations.
2. Buka integrasi. Di Chat proyek Anda, buka menu opsi di samping input pesan, lalu pilih Connectors → Add connectors. Cari dan pilih layanannya. Periksa apakah layanan tersebut sudah terhubung atau masih menampilkan Connect. Beberapa layanan membuka layar pengelolaannya sendiri.
3. Periksa akses di layanan itu sendiri. Konfirmasikan bahwa akun yang ingin Anda hubungkan dapat membuka file, repositori, kalender, properti, atau sumber daya lain yang terlibat secara tepat.
4. Simpan error sebelum mengubah apa pun. Catat pesan yang tepat, waktu dan zona waktu, proyek atau Chat yang terdampak, dan upaya terakhir yang berhasil. Samarkan informasi pribadi dari tangkapan layar.

Buka opsi input Chat, pilih Connectors (1), lalu Add connectors (2) untuk menelusuri integrasi yang tersedia.

Anda juga dapat mengelola koneksi yang tersedia di Settings → Connectors. Pilih integrasi yang ingin Anda periksa.

Jaga kerahasiaan kredensial. Jangan pernah menempelkan kata sandi, kode login, kunci API, token akses, atau rahasia lainnya ke dalam Chat atau permintaan dukungan. Masukkan kredensial hanya dalam alur masuk layanan atau kolom konfigurasi aman yang ditentukan.

Temukan masalah Anda

Anda tidak dapat menemukan atau memulai sebuah integrasi

1. Gunakan Add connectors untuk mencari katalog. Daftar yang lebih pendek di menu Chat bukanlah katalog lengkap.
2. Jika Atoms mengatakan fitur tersebut hanya tersedia di dalam sebuah proyek, buka proyek yang dimaksud dan coba di sana.
3. Jika sebuah kontrol dinonaktifkan, baca penjelasannya. Jika memerlukan peran atau izin yang berbeda, minta bantuan pemilik proyek atau workspace. Jangan putuskan layanan lain hanya untuk melewati pembatasan.

Periksa hasilnya: Anda dapat membuka layar koneksi atau pengelolaan layanan. Jika masih tidak muncul, periksa Connect and Manage Integrations atau hubungi dukungan untuk mengonfirmasi ketersediaannya. Jangan berasumsi bahwa layanan yang hilang dapat diaktifkan melalui upaya masuk berulang.

Otorisasi tidak selesai

1. Pilih Connect sekali dan cari jendela masuk layanan. Jika browser Anda melaporkan pop-up diblokir, izinkan pop-up untuk situs Atoms dan coba lagi. Di Chrome, ikuti petunjuk untuk mengizinkan pop-up dari situs tertentu; Anda tidak perlu mengaktifkannya untuk setiap situs.
2. Pilih akun yang dimaksud dan tinjau akses yang diminta. Selesaikan alur otorisasi layanan sebelum menutup jendelanya.
3. Jika layanan secara eksplisit mengatakan organisasi Anda telah memblokir app atau akses yang diminta, simpan pesannya dan hubungi administrator Anda. Jangan mencari jalan pintas untuk melewati kebijakan organisasi Anda.
4. Kembali ke Atoms dan buka kembali integrasi untuk memeriksa statusnya. Menutup jendela masuk bukanlah konfirmasi bahwa otorisasi berhasil.

Tinjau akses yang diminta sebelum menyelesaikan otorisasi. Mengotorisasi sebuah akun tidak dengan sendirinya mengonfirmasi bahwa sumber daya yang dimaksud telah terhubung.

Jika otorisasi mencakup pemilih organisasi atau workspace, konfirmasikan pilihan yang dimaksud dan tinjau izin yang diminta.

Periksa hasilnya: Integrasi ditampilkan sebagai terhubung. Pada layar detail connector yang menggunakan tata letak standar, Connect digantikan oleh Disconnect dan Try it out. Layanan lain memiliki tata letaknya sendiri. Jika masih menampilkan Connect atau menunjukkan error, ambil hasil tersebut dan hubungi dukungan setelah satu percobaan baru.

Akun yang salah terhubung

Jika layar pengelolaan integrasi menampilkan sebuah akun, bandingkan dengan akun yang memiliki atau dapat mengakses sumber daya tersebut. Tidak setiap connector menampilkan akun yang terhubung, jadi jangan gunakan status masuk browser saat ini saja sebagai bukti akun mana yang digunakan Atoms.

Buka sumber daya langsung di layanan dengan akun yang dimaksud. Jika akun tersebut tidak dapat mengaksesnya, minta akses kepada pemilik sumber daya terlebih dahulu. Jika koneksi menggunakan akun yang salah, ikuti petunjuk pergantian akun layanan atau hubungkan kembali dengan aman dan pilih akun yang benar secara eksplisit selama otorisasi.

Periksa hasilnya: Permintaan baca kecil yang didukung mengembalikan sumber daya yang dimaksud. Jika Anda masih tidak dapat memastikan akun mana yang terhubung, hubungi dukungan daripada berulang kali memutuskan koneksi.

Integrasi terhubung, tetapi Agen tidak dapat menemukan data Anda

1. Periksa koneksi. Buka detail integrasi di Connectors dan konfirmasikan bahwa integrasi tersebut terhubung. Periksa akun atau sumber daya yang dipilih jika ditampilkan.
2. Periksa sumber daya yang tepat. Buka langsung di layanan dengan akun yang dimaksud. Konfirmasikan lokasinya dan izin aksesnya, termasuk organisasi, workspace, folder, atau properti yang benar jika relevan.
3. Buat permintaan menjadi spesifik. Sebutkan nama layanan dan berikan nama atau tautan sumber daya yang tepat jika connector mendukungnya. Minta satu tindakan baca yang didukung terlebih dahulu, alih-alih mencari dan mengubah beberapa sumber daya sekaligus.

Contohnya, jika connector mendukung pembacaan dokumen: “Gunakan [service] untuk membaca [nama dokumen atau tautan] dan beri tahu saya judulnya. Jangan ubah.”

Periksa hasilnya: Agen mengembalikan sumber daya yang dimaksud. Jika akses langsung berfungsi tetapi Agen masih tidak dapat membacanya, periksa kapabilitas yang didukung connector dan akses yang diberikan. Hubungkan kembali hanya jika ada bukti masalah otorisasi.

Agen dapat membaca data, tetapi tidak dapat mengubahnya

Pembacaan yang berhasil tidak mengonfirmasi bahwa connector mendukung perubahan yang diminta atau memiliki izin untuk melakukannya.

1. Lihat Connect and Manage Integrations atau daftar What you can do milik connector, jika ditampilkan. Konfirmasikan bahwa tindakan yang diminta didukung.
2. Periksa apakah akun yang terhubung diizinkan untuk membuat perubahan tersebut pada sumber daya yang tepat. Minta kepada pemilik sumber daya atau administrator hanya akses yang diperlukan.
3. Baca setiap error atau permintaan konfirmasi. Jika diperlukan otorisasi tambahan, ikuti alur yang didokumentasikan oleh layanan. Menghubungkan kembali tidak dapat menambahkan tindakan yang tidak didukung connector.

Sebelum mencoba lagi penulisan: Periksa tujuan untuk melihat apakah upaya pertama sudah membuat atau mengubah sesuatu. Respons gagal tidak cukup untuk membuktikan bahwa tidak ada perubahan yang terjadi. Jangan ulangi pembayaran, pesan, undangan, atau pembuatan catatan sampai Anda mengetahui hasil sebelumnya.

Periksa hasilnya: Perubahan yang didukung berhasil pada sumber daya uji yang sesuai, dan Anda mengonfirmasikannya langsung di layanan. Untuk pembayaran atau alur kerja live lainnya, gunakan petunjuk pengujian khusus layanan alih-alih transaksi nyata.

Koneksi yang sebelumnya berfungsi telah berhenti

Periksa apa yang berubah sejak permintaan terakhir yang berhasil: akun, aksesnya ke sumber daya, kebijakan app organisasi, atau otorisasi koneksi.

1. Buka kembali integrasi di Atoms dan periksa apakah integrasi tersebut masih terhubung.
2. Coba buka sumber daya langsung di layanan. Jika akses telah dihapus, selesaikan hal itu dengan pemilik sumber daya atau administrator.
3. Jika error menyatakan otorisasi telah kedaluwarsa, dicabut, atau tidak valid, ikuti Reconnect safely. Jika error berkaitan dengan gangguan layanan, batasan, atau tindakan yang tidak didukung, tangani penyebab tersebut terlebih dahulu.

Periksa hasilnya: Permintaan baca kecil berfungsi lagi. Jika error yang sama tetap ada, simpan bersama waktu terakhir yang berhasil dan hubungi dukungan.

Hasil sudah tidak terbaru atau sebuah permintaan terus gagal

1. Bandingkan hasilnya dengan layanan itu sendiri. Konfirmasikan akun, sumber daya, rentang tanggal, filter, dan zona waktu jika relevan. Minta Agen untuk mengambil nilai saat ini alih-alih mengandalkan jawaban sebelumnya dalam percakapan.
2. Untuk timeout eksplisit atau error layanan tidak tersedia, periksa status resmi atau halaman bantuan layanan. Jika error memberikan waktu coba lagi, tunggu sampai saat itu; jangan kirim permintaan berulang selama batasan atau gangguan masih berlangsung.
3. Simpan teks yang belum terkirim, muat ulang Atoms, dan periksa kembali status connector. Memuat ulang halaman tidak sama dengan mengotorisasi ulang akun.
4. Coba lagi satu permintaan baca kecil. Sebelum mencoba lagi apa pun yang mengubah data eksternal, periksa tujuan untuk hasil sebelumnya.

Periksa hasilnya: Hasil baru cocok dengan sumber daya yang dimaksud di layanan. Jika tetap tidak benar, kirimkan kepada dukungan nilai yang diharapkan dan nilai aktual beserta stempel waktunya. Jangan berasumsi bahwa setiap integrasi diperbarui dengan jadwal yang sama.

Hubungkan kembali dengan aman

Hubungkan kembali ketika otorisasi tidak valid atau akun yang salah tertaut—bukan sebagai langkah pertama untuk setiap permintaan yang gagal.

Sebelum memutuskan koneksi: Selesaikan atau jeda tugas yang bergantung pada koneksi, periksa hasil dari setiap penulisan eksternal yang tertunda, dan pastikan Anda dapat masuk lagi dengan akses yang diperlukan. Memutuskan koneksi membuat koneksi tidak tersedia sampai terhubung kembali. Periksa Connect and Manage Integrations untuk efek tambahan apa pun; jangan berasumsi bahwa memutuskan koneksi membalikkan perubahan sebelumnya atau membatalkan pekerjaan yang sudah dikirim.

1. Buka detail koneksi layanan. Jika layanan memiliki layar pengelolaan akun sendiri, ikuti petunjuk integrasi tersebut.
2. Pada layar detail connector standar, pilih Disconnect saat Anda siap, lalu pilih Connect. Jangan berasumsi akan ada konfirmasi tambahan sebelum koneksi diputuskan.
3. Pilih akun yang dimaksud dan selesaikan otorisasi. Tinjau izin yang diminta.
4. Kembali ke Atoms dan konfirmasikan status terhubung.
5. Jalankan pemeriksaan pemulihan di bawah ini sebelum melanjutkan tugas asli.

Jika error yang sama muncul kembali, hentikan menghubungkan ulang dan hubungi dukungan dengan menyertakan error tersebut serta pemeriksaan yang sudah diselesaikan.

Verifikasi bahwa masalah telah teratasi

1. Minta satu tindakan hanya-baca yang didukung pada sumber daya yang dapat Anda verifikasi secara langsung. Jika Anda menggunakan Try it out, tinjau prompt yang disarankan sebelum mengirimnya.
2. Bandingkan respons dengan layanan itu sendiri. Konfirmasikan sumber daya yang benar, konteks akun, dan hasil yang diminta—bukan hanya indikator terhubung.
3. Jika tugas Anda memerlukan perubahan, gunakan sumber daya uji yang sesuai atau alur kerja uji yang didokumentasikan oleh layanan dan verifikasi hasilnya di tujuan.

Periksa status koneksi dan sumber daya yang dipilih. Indikator terhubung saja tidak mengonfirmasi bahwa data yang diharapkan tersedia atau terbaru.

Konfirmasikan organisasi dan proyek, lalu buka Dashboard untuk memeriksa sumber daya tanpa membuat perubahan. Memutuskan koneksi bukan bagian dari pemeriksaan ini.

Jika pemeriksaan berhasil, lanjutkan tugas Anda. Jika Chat berfungsi tetapi fitur masih gagal di dalam app Anda, lihat Connect and Manage Integrations atau pemecahan masalah build dan preview. Periksa environment tempat kegagalan terjadi; permintaan Chat yang berhasil bukan bukti bahwa app dikonfigurasi dengan benar.

Dapatkan bantuan

Jika masalah berlanjut, gunakan Get support dan sertakan:

• Nama integrasi dan email akun Atoms Anda.
• Tautan proyek atau Chat yang terdampak, dan apakah kegagalan terjadi di Chat atau di app Anda. Untuk app, identifikasi environment yang terdampak.
• Akun layanan dan sumber daya yang dimaksud, dengan hanya menggunakan pengenal non-rahasia yang diperlukan untuk investigasi.
• Error yang tepat, tanggal, waktu, dan zona waktu; sertakan waktu terakhir yang berhasil jika diketahui.
• Langkah-langkah untuk mereproduksi, hasil yang diharapkan, hasil aktual, dan pemeriksaan yang sudah dicoba.
• Browser dan perangkat Anda, ditambah tangkapan layar yang disamarkan atau rekaman singkat jika berguna.

Untuk penulisan yang gagal, jelaskan apakah tujuan menunjukkan perubahan yang selesai, tidak ada perubahan, atau hasil yang tidak diketahui. Hapus kata sandi, kode login, kunci API, token, dan data pribadi yang tidak terkait dari semua lampiran.