Entegrasyon sorun giderme

Bir Entegrasyon bağlanmıyorsa, çalışmayı durduruyorsa veya bir görevi tamamlayamıyorsa, bağlantıyı, hesap erişimini ve seçilen kaynağı kontrol etmek için bu kılavuzu kullanın.

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 Entegrasyonları Bağlayın ve Yönetin ile başlayın ve hizmetinizin kılavuzunu seçin.

Bu kontrollerle başlayın

1. Hatanın nerede oluştuğunu kontrol edin. Agent, Chat içinde bir hizmeti kullanamıyor mu, yoksa özellik yalnızca uygulamanızda mı başarısız oluyor? Chat için bir hizmet bağlamak, tek başına uygulamanızın doğru yapılandırıldığını doğrulamaz. Yalnızca uygulamadaki hatalar için Entegrasyonları Bağlayın ve Yönetin bölümüne bakın.
2. Entegrasyonu açın. Projenizin Chat bölümünde, mesaj girişinin yanındaki seçenekler menüsünü açın, ardından Connectors → Add connectors seçeneğini belirleyin. Hizmeti arayın ve seçin. Bağlı olup olmadığını veya hâlâ Connect seçeneğini 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 Chat’i ve son başarılı denemeyi kaydedin. Ekran görüntülerindeki özel bilgileri gizleyin.

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

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 Chat’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

Bir entegrasyonu bulamıyor veya başlatamıyorsunuz

1. Katalogda arama yapmak için Add connectors seçeneğini kullanın. Chat 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 Entegrasyonları Bağlayın ve Yönetin 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. Bir kez Connect seçeneğini belirleyin 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 onayı değildir.

Yetkilendirmeyi tamamlamadan önce istenen erişimi gözden geçirin. Bir hesabı yetkilendirmek, hedef kaynağın bağlı olduğunu tek başına 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, Disconnect ve Try it out ile değiştirilir. Diğer hizmetlerin kendi düzenleri vardır. Hâlâ Connect sunuyorsa veya bir hata gösteriyorsa, bu sonucu kaydedin ve bir yeni 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ğı doğrudan hizmette hedef hesapla 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. Entegrasyonun ayrıntılarını Connectors içinde açın ve bağlı olduğunu doğrulayın. Gösteriliyorsa seçilen hesabı veya kaynağı kontrol edin.
2. Tam kaynağı kontrol edin. Bunu hedef hesapla doğrudan hizmette açın. İlgili olduğunda doğru kuruluş, çalışma alanı, klasör veya özellik dâhil olmak üzere konumunu ve erişim izinlerini doğrulayın.
3. İsteği belirgin hâle getirin. Bağlayıcı destekliyorsa hizmetin adını verin ve tam kaynak adını veya bağlantısını sağlayın. 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. Bunu değiştirme.”

Sonucu kontrol edin: Agent hedef kaynağı döndürür. Doğrudan erişim çalışıyor ancak Agent hâlâ bunu 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. Gösteriliyorsa Entegrasyonları Bağlayın ve Yönetin bölümüne veya 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. Kaynak sahibinden veya yöneticiden yalnızca gereken erişimi 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.

Bir yazma işlemini 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 öğrenmeden 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 hizmette 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 hizmette 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 bir yeniden deneme zamanı veriyorsa, o zamana kadar bekleyin; sınır veya kesinti devam ederken tekrarlanan istekler göndermeyin.
3. Gönderilmemiş metinleri kaydedin, Atoms’u yenileyin ve bağlayıcı durumunu tekrar 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, beklenen ve gerçek değerleri zaman damgalarıyla birlikte desteğe 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 yeniden oturum açabileceğinizden emin olun. Bağlantıyı kesmek, yeniden bağlanana kadar bağlantıyı kullanılamaz hâle getirir. Ek etkiler için Entegrasyonları Bağlayın ve Yönetin 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 belirleyin, ardından Connect seçeneğini belirleyin. 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 tamamladığınız kontrolleri destekle paylaşın.

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

1. Doğrudan doğrulayabileceğ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çilen 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. Chat çalışıyor ancak özellik hâlâ uygulamanız içinde başarısız oluyorsa, Entegrasyonları Bağlayın ve Yönetin veya derleme ve önizleme sorun giderme bölümüne bakın. Hatanın oluştuğu ortamı kontrol edin; başarılı bir Chat isteği, uygulamanın doğru yapılandırıldığının kanıtı değildir.

Yardım alın

Sorun devam ederse, Destek alın seçeneğini kullanın ve şunları ekleyin:

• Entegrasyon adı ve Atoms hesap e-posta adresiniz.
• Etkilenen proje veya Chat bağlantısı ve hatanın Chat’te mi yoksa uygulamanızda mı oluştuğu. 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 üretme adımları, beklenen sonuç, gerçek sonuç ve daha önce denenen 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.