Nasıl yardımcı olabiliriz?

Bir entegrasyon sorunu bildirdiğinizde, net ve ilgili bilgilerin sağlanması, destek ekibinin etkilenen hizmeti anlamasına, sorunu mümkünse yeniden üretmesine ve muhtemel nedeni belirlemesine yardımcı olur. Faydalı bir destek talebi, neyi denediğinizi, ne beklediğinizi ve gerçekte ne olduğunu açıklamalıdır. Dahil edilmesi gereken bilgiler 1. Entegrasyon adı İlgili dış uygulama veya hizmeti tanımlayın. 2. Sorunun tanımı Başarısız olan veya beklenmedik bir sonuç üreten işlemi açıklayın. 3. Beklenen davranış Ne olması gerektiğini tanımlayın. 4. Gerçek davranış Bunun yerine ne olduğunu tanımlayın. 5. Hata mesajı Mümkünse tam hata metnini veya durum kodunu ekleyin. 6. Yaklaşık zaman damgası Sorunun meydana geldiği tarih, saat ve zaman dilimini sağlayın. 7. Etkilenen işlem İlgili entegrasyon eylemini, iş akışını, otomasyonu veya iş sürecini tanımlayın. 8. Sıklık Sorunun sürekli mi yoksa aralıklı mı olduğunu açıklayın. 9. Son değişiklikler Son hesap, izin, yapılandırma veya yetkilendirme değişikliklerini belirtin. 10. Daha önce denenen sorun giderme Destekle iletişime geçmeden önce atılan adımları açıklayın. 11. İş etkisi Sorunun kritik bir işlemi engelleyip engellemediğini, müşterileri etkileyip etkilemediğini veya gecikmelere neden olup olmadığını açıklayın. 12. Destekleyici kanıt Mümkünse ilgili ekran görüntülerini veya hassas olmayan tanılama detaylarını ekleyin. Örnek destek talebi Konu: Entegrasyon bağlantı sorunu Entegrasyon: [Dış hizmet adı] Etkilenen işlem: [İşlem açıklaması] Sorun başladı: [Tarih ve saat ile zaman dilimi] Beklenen sonuç: [Ne olmalı] Gerçek sonuç: [Ne oldu] Hata mesajı: [Tam hata mesajı] Son değişiklikler: [Varsa ilgili değişiklikler] Tamamlanan sorun giderme: [Zaten denenen adımlar] İş etkisi: [Etkilenen işlemlerin açıklaması] Asla paylaşılmaması gereken bilgiler nelerdir? Şunları dahil etmeyin: 1. Parolalar. 2. API anahtarları. 3. OAuth erişim belirteçleri. 4. OAuth yenileme belirteçleri. 5. Müşteri gizlilikleri. 6. Webhook imza gizlilikleri. 7. Özel kimlik doğrulama bilgileri. 8. Gereksiz müşteri kişisel bilgileri. 9. Sorunla ilgisi olmayan hassas iş kayıtları. Bir ekran görüntüsü gizli bilgiler içeriyorsa, paylaşmadan önce düzenleyin. Destekle iletişime geçmeden önce entegrasyonu koparmalı mıyım? Otomatik olarak hayır. Bir entegrasyonu koparmak veya yeniden yetkilendirmek, durumunu değiştirebilir ve orijinal sorunu araştırmayı zorlaştırabilir. Entegrasyonun yetkisiz bir etkinlikten şüpheleniliyorsa, uygun güvenlik önlemlerini önceliklendirin. Sorun önemli bir iş operasyonunu etkiliyorsa ne olur? İş etkisini açıkça tanımlayın ve işlemin tamamen engellenip engellenmediğini veya yalnızca kısmen etkilenip etkilenmediğini belirtin. Dış sağlayıcı bir kesinti yaşıyorsa ne olur? Herhangi bir ilgili sağlayıcı durumu bilgisi ve sorunun ne zaman başladığına dair yaklaşık zamanı ekleyin. Destek, başarısız dış operasyonların kurtarılmasını garanti edebilir mi? Kurtarma, işlemin, dış sağlayıcının davranışının ve mevcut yeniden deneme veya kurtarma mekanizmalarının durumuna bağlıdır. Her başarısız işlemin otomatik olarak yeniden oynatılabileceğini varsaymayın. Tavsiye edilen yaklaşım Tam hata, etkilenen entegrasyon, ilgili zaman damgaları ve iş etkisi ile birlikte kısa ama eksiksiz bir rapor gönderin. Bu, gereksiz gidip gelmeleri azaltmaya yardımcı olur ve daha etkili bir araştırmayı destekler.