Entegrasyon sorun giderme

Bu sayfa, Atoms içindeki yaygın bağlantı ve yetkilendirme sorunlarını kapsar. Hizmete özel kurulum, desteklenen eylemler veya uygulamanız içindeki yapılandırma için Connect and Manage Integrations ile başlayın ve hizmetinizin kılavuzunu seçin.

Bu kontrollerle başlayın

1. Hatanın nerede gerçekleştiğini kontrol edin. Agent, Sohbet içinde bir hizmeti kullanamıyor mu, yoksa özellik yalnızca uygulamanızda mı başarısız oluyor? Sohbet için bir hizmet bağlamak, tek başına uygulamanızın doğru yapılandırıldığını doğrulamaz. Yalnızca uygulamada görülen hatalar için Connect and Manage Integrations bölümüne bakın.
2. Entegrasyonu açın. Projenizin Sohbet bölümünde, mesaj girişinin yanındaki seçenekler menüsünü açın, ardından Connectors → Add connectors seçeneğini seçin. Hizmeti arayın ve seçin. Bağlı olup olmadığını veya hâlâ Connect sunup sunmadığını kontrol edin. Bazı hizmetler kendi yönetim ekranlarını açar.
3. Erişimi hizmetin kendisinde kontrol edin. Bağlamayı amaçladığınız hesabın ilgili tam dosyayı, depoyu, takvimi, özelliği veya diğer kaynağı açabildiğini doğrulayın.
4. Herhangi bir şeyi değiştirmeden önce hatayı kaydedin. Tam mesajı, saati ve saat dilimini, etkilenen projeyi veya Sohbeti ve son başarılı denemeyi kaydedin. Ekran görüntülerindeki özel bilgileri gizleyin.

Sohbet giriş seçeneklerini açın, Connectors'ı (1), ardından kullanılabilir entegrasyonlara göz atmak için Add connectors'ı (2) seçin.

Kullanılabilir bağlantıları Settings → Connectors içinde de yönetebilirsiniz. Kontrol etmek istediğiniz entegrasyonu seçin.

Kimlik bilgilerini gizli tutun. Parolaları, giriş kodlarını, API anahtarlarını, erişim jetonlarını veya diğer gizli bilgileri asla Sohbet'e ya da bir destek talebine yapıştırmayın. Kimlik bilgilerini yalnızca hizmetin oturum açma akışında veya belirlenmiş güvenli yapılandırma alanında girin.

Sorununuzu bulun

Gördüğünüz şey	Başlangıç noktası
Bir hizmet eksik veya denetimleri kullanılamıyor	Bir entegrasyonu bulun veya başlatın
Oturum açma açılmıyor, engelleniyor veya hiç tamamlanmıyor	Yetkilendirmeyi tamamlayın
Bağlantı farklı bir hesap kullanıyor	Bağlı hesabı kontrol edin
Bağlı, ancak Agent bir kaynak bulamıyor	Bağlantıyı ve veri erişimini kontrol edin
Okuma çalışıyor, ancak oluşturma veya düzenleme başarısız oluyor	Yazma erişimini ve desteklenen eylemleri kontrol edin
Daha önce çalışan bir bağlantı başarısız oluyor	Neyin değiştiğini kontrol edin
Sonuçlar güncel değil, isteklerin süresi doluyor veya hatalar tekrarlanıyor	İsteği ve hizmet kullanılabilirliğini kontrol edin

Bir entegrasyonu bulamıyor veya başlatamıyorsunuz

1. Katalogda arama yapmak için Add connectors kullanın. Sohbet menüsündeki daha kısa liste, tam katalog değildir.
2. Atoms, özelliğin yalnızca bir proje içinde kullanılabildiğini söylüyorsa, hedef projeyi açın ve orada deneyin.
3. Bir denetim devre dışıysa, açıklamasını okuyun. Farklı bir rol veya izin gerektiriyorsa, proje ya da çalışma alanı sahibinden yardım isteyin. Bir kısıtlamayı aşmak için başka bir hizmetin bağlantısını kesmeyin.

Sonucu kontrol edin: Hizmetin bağlantı veya yönetim ekranını açabiliyor olmalısınız. Hâlâ görünmüyorsa, kullanılabilirliği doğrulamak için Connect and Manage Integrations bölümünü kontrol edin veya destekle iletişime geçin. Eksik bir hizmetin tekrarlanan oturum açma denemeleriyle etkinleştirilebileceğini varsaymayın.

Yetkilendirme tamamlanmıyor

1. Connect seçeneğini bir kez seçin ve hizmetin oturum açma penceresini arayın. Tarayıcınız açılır pencerenin engellendiğini bildirirse, Atoms sitesi için açılır pencerelere izin verin ve tekrar deneyin. Chrome'da, belirli bir siteden açılır pencerelere izin verme talimatlarını izleyin; bunu her site için etkinleştirmeniz gerekmez.
2. Hedef hesabı seçin ve istenen erişimi gözden geçirin. Pencereyi kapatmadan önce hizmetin yetkilendirme akışını tamamlayın.
3. Hizmet açıkça kuruluşunuzun uygulamayı veya istenen erişimi engellediğini söylüyorsa, mesajı kaydedin ve yöneticinizle iletişime geçin. Kuruluşunuzun politikasını aşmaya çalışmayın.
4. Atoms'a dönün ve durumunu kontrol etmek için entegrasyonu yeniden açın. Bir oturum açma penceresini kapatmak, yetkilendirmenin başarılı olduğunun doğrulaması değildir.

Yetkilendirmeyi tamamlamadan önce istenen erişimi gözden geçirin. Bir hesabı yetkilendirmek, tek başına hedef kaynağın bağlandığını doğrulamaz.

Yetkilendirme bir kuruluş veya çalışma alanı seçicisi içeriyorsa, hedef seçimi doğrulayın ve istenen izinleri gözden geçirin.

Sonucu kontrol edin: Entegrasyon bağlı olarak gösterilir. Standart düzeni kullanan bağlayıcı ayrıntı ekranlarında, Connect yerine Disconnect ve Try it out görünür. Diğer hizmetlerin kendi düzenleri vardır. Hâlâ Connect sunuyorsa veya bir hata gösteriyorsa, bu sonucu kaydedin ve yeni bir denemeden sonra destekle iletişime geçin.

Yanlış hesap bağlı

Entegrasyonun yönetim ekranı bir hesap gösteriyorsa, bunu kaynağın sahibi olan veya kaynağa erişebilen hesapla karşılaştırın. Her bağlayıcı bağlı hesabı göstermez, bu nedenle Atoms'un hangi hesabı kullandığının kanıtı olarak yalnızca tarayıcıdaki mevcut oturum açmayı kullanmayın.

Kaynağı hizmet içinde hedef hesapla doğrudan açın. Bu hesap erişemiyorsa, önce kaynak sahibinden erişim isteyin. Bağlantı yanlış hesabı kullanıyorsa, hizmetin hesap değiştirme talimatlarını izleyin veya güvenli şekilde yeniden bağlanın ve yetkilendirme sırasında doğru hesabı açıkça seçin.

Sonucu kontrol edin: Küçük, desteklenen bir okuma isteği hedef kaynağı döndürür. Hâlâ hangi hesabın bağlı olduğunu belirleyemiyorsanız, tekrar tekrar bağlantıyı kesmek yerine destekle iletişime geçin.

Entegrasyon bağlı, ancak Agent verilerinizi bulamıyor

1. Bağlantıyı kontrol edin. Connectors içinden entegrasyonun ayrıntılarını açın ve bağlı olduğunu doğrulayın. Gösteriliyorsa seçili hesabı veya kaynağı kontrol edin.
2. Tam kaynağı kontrol edin. Hedef hesapla bunu doğrudan hizmet içinde açın. Konumunu ve erişim izinlerini doğrulayın; buna ilgili olduğunda doğru kuruluş, çalışma alanı, klasör veya özellik dahildir.
3. İsteği belirgin hale getirin. Bağlayıcı destekliyorsa hizmetin adını belirtin ve tam kaynak adını veya bağlantısını verin. Aynı anda birkaç kaynağı arayıp değiştirmek yerine önce desteklenen tek bir okuma eylemi isteyin.

Örneğin, bağlayıcı belge okumayı destekliyorsa: “[service] kullanarak [document name or link] öğesini oku ve bana başlığını söyle. Onu değiştirme.”

Sonucu kontrol edin: Agent hedef kaynağı döndürür. Doğrudan erişim çalışıyor ancak Agent hâlâ okuyamıyorsa, bağlayıcının desteklenen yeteneklerini ve verilen erişimi kontrol edin. Yalnızca bir yetkilendirme sorunu olduğuna dair kanıt varsa yeniden bağlanın.

Agent verileri okuyabiliyor, ancak değiştiremiyor

Başarılı okuma, bağlayıcının istenen değişikliği desteklediğini veya bunu yapma iznine sahip olduğunu doğrulamaz.

1. Connect and Manage Integrations bölümüne veya gösteriliyorsa bağlayıcının What you can do listesine bakın. İstenen eylemin desteklendiğini doğrulayın.
2. Bağlı hesabın tam kaynak üzerinde bu değişikliği yapmasına izin verilip verilmediğini kontrol edin. Yalnızca gereken erişim için kaynak sahibinden veya yöneticiden yardım isteyin.
3. Herhangi bir hata ya da onay isteğini okuyun. Ek yetkilendirme gerekiyorsa, hizmetin belgelenmiş akışını izleyin. Yeniden bağlanmak, bağlayıcının desteklemediği bir eylemi ekleyemez.

Yazmayı yeniden denemeden önce: İlk denemenin zaten bir şey oluşturup oluşturmadığını veya değiştirip değiştirmediğini görmek için hedefi inceleyin. Başarısız bir yanıt, hiçbir değişiklik olmadığını kanıtlamak için yeterli değildir. Önceki sonucu bilmeden bir ödeme, mesaj, davet veya kayıt oluşturmayı tekrarlamayın.

Sonucu kontrol edin: Desteklenen bir değişiklik, uygun bir test kaynağında başarılı olur ve bunu doğrudan hizmet içinde doğrularsınız. Ödeme veya diğer canlı iş akışları için gerçek bir işlem yerine hizmete özel test talimatlarını kullanın.

Daha önce çalışan bir bağlantı durdu

Son başarılı istekten bu yana neyin değiştiğini kontrol edin: hesap, hesabın kaynağa erişimi, kuruluşun uygulama politikası veya bağlantının yetkilendirmesi.

1. Atoms içinde entegrasyonu yeniden açın ve hâlâ bağlı olup olmadığını kontrol edin.
2. Kaynağı doğrudan hizmet içinde açmayı deneyin. Erişim kaldırıldıysa, bunu kaynak sahibi veya yöneticiyle çözün.
3. Hata, yetkilendirmenin süresinin dolduğunu, iptal edildiğini veya geçersiz olduğunu söylüyorsa Güvenli şekilde yeniden bağlanın bölümünü izleyin. Hata bir hizmet kesintisi, sınır veya desteklenmeyen eylemle ilgiliyse, önce bu nedeni ele alın.

Sonucu kontrol edin: Küçük bir okuma isteği yeniden çalışır. Aynı hata devam ediyorsa, bunu son başarılı zamanla birlikte kaydedin ve destekle iletişime geçin.

Sonuçlar güncel değil veya bir istek sürekli başarısız oluyor

1. Sonucu hizmetin kendisiyle karşılaştırın. İlgili olduğunda hesabı, kaynağı, tarih aralığını, filtreleri ve saat dilimini doğrulayın. Agent'tan, konuşmadaki daha önceki bir yanıta güvenmek yerine güncel değeri getirmesini isteyin.
2. Açık bir zaman aşımı veya hizmet kullanılamıyor hatası için, hizmetin resmi durum ya da yardım sayfasını kontrol edin. Hata yeniden deneme zamanı veriyorsa, o zamana kadar bekleyin; sınır veya kesinti sürerken tekrar tekrar istek göndermeyin.
3. Gönderilmemiş metinleri kaydedin, Atoms'u yenileyin ve bağlayıcı durumunu yeniden kontrol edin. Sayfayı yenilemek, hesabı yeniden yetkilendirmekle aynı şey değildir.
4. Küçük bir okuma isteğini yeniden deneyin. Dış verileri değiştiren herhangi bir şeyi yeniden denemeden önce, önceki sonucu görmek için hedefi inceleyin.

Sonucu kontrol edin: Yeni sonuç, hizmetteki hedef kaynakla eşleşir. Hâlâ yanlışsa, destek ekibine beklenen ve gerçek değerleri zaman damgalarıyla birlikte gönderin. Her entegrasyonun aynı takvimde güncellendiğini varsaymayın.

Güvenli şekilde yeniden bağlanın

Yetkilendirme geçersiz olduğunda veya yanlış hesap bağlandığında yeniden bağlanın; başarısız olan her istek için ilk adım olarak değil.

Bağlantıyı kesmeden önce: Bağlantıya dayanan görevleri bitirin veya duraklatın, bekleyen herhangi bir dış yazma işleminin sonucunu kontrol edin ve gerekli erişimle tekrar oturum açabildiğinizden emin olun. Bağlantıyı kesmek, yeniden bağlanana kadar bağlantıyı kullanılamaz hale getirir. Ek etkiler için Connect and Manage Integrations bölümünü kontrol edin; bağlantıyı kesmenin önceki değişiklikleri geri aldığını veya zaten gönderilmiş işleri iptal ettiğini varsaymayın.

1. Hizmetin bağlantı ayrıntılarını açın. Kendi hesap yönetimi ekranı varsa, o entegrasyonun talimatlarını izleyin.
2. Standart bağlayıcı ayrıntı ekranında, hazır olduğunuzda Disconnect seçeneğini seçin, ardından Connect seçeneğini seçin. Bağlantı kesilmeden önce ek bir onay olacağını varsaymayın.
3. Hedef hesabı seçin ve yetkilendirmeyi tamamlayın. İstenen izinleri gözden geçirin.
4. Atoms'a dönün ve bağlı durumu doğrulayın.
5. Orijinal göreve devam etmeden önce aşağıdaki kurtarma kontrolünü çalıştırın.

Aynı hata geri dönerse, yeniden bağlanmayı bırakın ve hata ile birlikte zaten tamamlanmış kontrolleri destek ekibine iletin.

Sorunun çözüldüğünü doğrulayın

1. Doğrudan doğrulayabildiğiniz bir kaynak üzerinde desteklenen, salt okunur tek bir eylem isteyin. Try it out kullanıyorsanız, göndermeden önce önerilen istemi gözden geçirin.
2. Yanıtı hizmetin kendisiyle karşılaştırın. Yalnızca bağlı göstergesini değil, doğru kaynağı, hesap bağlamını ve istenen sonucu doğrulayın.
3. Göreviniz değişiklik gerektiriyorsa, uygun bir test kaynağı veya hizmetin belgelenmiş test iş akışını kullanın ve sonucu hedefte doğrulayın.

Bağlantı durumunu ve seçili kaynağı kontrol edin. Yalnızca bağlı göstergesi, beklenen verilerin kullanılabilir veya güncel olduğunu doğrulamaz.

Kuruluşu ve projeyi doğrulayın, ardından değişiklik yapmadan kaynağı incelemek için Dashboard'u açın. Bağlantıyı kesmek bu kontrolün bir parçası değildir.

Kontrol başarılıysa, görevinize devam edin. Sohbet çalışıyor ancak özellik hâlâ uygulamanız içinde başarısız oluyorsa, Connect and Manage Integrations veya build and preview troubleshooting bölümüne bakın. Hatanın oluştuğu ortamı kontrol edin; başarılı bir Sohbet isteği, uygulamanın doğru yapılandırıldığının kanıtı değildir.

Yardım alın

Sorun devam ediyorsa, Get support kullanın ve şunları ekleyin:

• Entegrasyon adı ve Atoms hesap e-posta adresiniz.
• Etkilenen proje veya Sohbet bağlantısı ve hatanın Sohbet'te mi yoksa uygulamanızda mı gerçekleştiği. Bir uygulama için etkilenen ortamı belirtin.
• Araştırma için gereken gizli olmayan tanımlayıcıları kullanarak hedef hizmet hesabı ve kaynak.
• Tam hata, tarih, saat ve saat dilimi; biliniyorsa son başarılı zamanı da ekleyin.
• Yeniden oluşturma adımları, beklenen sonuç, gerçek sonuç ve zaten denenmiş kontroller.
• Tarayıcınız ve cihazınız, ayrıca yararlıysa gizlenmiş ekran görüntüleri veya kısa bir kayıt.

Başarısız bir yazma işlemi için, hedefin tamamlanmış bir değişiklik, hiç değişiklik veya bilinmeyen bir sonuç gösterip göstermediğini belirtin. Tüm eklerden parolaları, giriş kodlarını, API anahtarlarını, jetonları ve ilgisiz özel verileri kaldırın.