Microsoft Teams'i bağlayın: adım adım kılavuz
Çalıştırma özetini bir Teams kanalına gönderir; NEXUS_TEAMS_NOTIFY=true olduğunda başarısız olan her test için de bir mesaj gönderir. Bu kılavuz, sıfırdan başlayıp doğrulanmış bir bağlantı kurmanıza yardımcı olur ve karşılaşabileceğiniz hataları nedenleri ve çözümleriyle birlikte listeler.
Son güncelleme:
Kimlik bilgilerinizi gizli tutun. Bir sohbete asla belirteç, anahtar, parola veya webhook URL'si yapıştırmayın. Bunları yalnızca Studio → Ayarlar → Entegrasyonlar bölümüne girin; burada çalışma alanınızın .env dosyasına kaydedilir ve nokta olarak gösterilir. Aynı kural yapay zekâ asistanı için de geçerlidir: bu kılavuzda size yol gösterebilir, ancak belirtecinize asla ihtiyaç duymaz.
Gereksinimler
- İş akışı ekleyebileceğiniz bir Teams kanalı.
- Bu kanal için bir Workflows webhook URL'si.
Kimlik bilgilerini alın
- Teams'te kanalın ··· menüsünü → İş Akışları'nı açın ve "Bir webhook isteği alındığında kanala gönderi yayınla" seçeneğini ekleyin.
- Size verilen webhook URL'sini kopyalayın. logic.azure.com ile biter (eski bağlayıcılar: webhook.office.com). URL'nin kendisi gizli bilgidir.
- Panonuzda tutun. Studio dışında hiçbir yere yapıştırmayın (sonraki adım).
Studio'da bağlantıyı kurun
- Studio'da Ayarlar → Entegrasyonlar → Microsoft Teams'i açın.
- Webhook URL'sini yapıştırın ve Kaydet & test gönder düğmesine basın. Kanala bir test mesajı gönderilir.
TEAMS_ENABLEDseçeneğini açın. Başarısız olan her test için bir mesaj almak istiyorsanızNEXUS_TEAMS_NOTIFYseçeneğini de açın.
Çalıştığını doğrulayın
- Test mesajı gönder işlemi "Gönderildi." yanıtını verir ve mesaj kanalda görünür.
- Herhangi bir testi çalıştırın. Çalıştırma özeti kanala gelir.
Sık karşılaşılan hatalar
| Gördüğünüz | Neden | Çözüm |
|---|---|---|
| "Webhook yok" | TEAMS_WEBHOOK_URL boş. | Webhook URL'sini Ayarlar → Entegrasyonlar bölümüne yapıştırın ve kaydedin. |
"TEAMS_WEBHOOK_URL bir Teams webhook'u değil" | Değer, logic.azure.com veya webhook.office.com alanında bir https URL'si değil. | URL'yi iş akışının "Bir webhook isteği alındığında kanala gönderi yayınla" tetikleyicisinden tekrar kopyalayın. |
| Teams'ten gelen HTTP 4xx veya 5xx yanıtı | İş akışı kapatılmış veya silinmiş ya da sahibi ayrılmış veya lisansını kaybetmiş; bu nedenle artık çalışmıyor. | Teams'te iş akışını açın (İş Akışları → yönet), açın veya yeni bir iş akışı oluşturun ve yeni URL'yi kaydedin. |
| "Teams'e ulaşılamadı (ENOTFOUND)" veya "20 s içinde yanıt vermedi" | Bu bilgisayar Microsoft'a ulaşamıyor: VPN veya vekil sunucu engelliyor ya da ağ bağlantısı yok. | Aynı bilgisayardan ağ bağlantısını kontrol edin ve tekrar deneyin. |
| Test çalışıyor ancak başarısızlık bildirimleri gönderilmiyor | TEAMS_ENABLED false olarak ayarlanmış veya yalnızca çalıştırma özeti açık: test başına mesajlar için NEXUS_TEAMS_NOTIFY=true olmalı. | Her iki anahtarı da açın. |
Ayar anahtarları
| Anahtar | Ne yapar | Geçerli değer | Nasıl denetlenir |
|---|---|---|---|
TEAMS_ENABLED | Microsoft Teams'e uyarı gönder | true veya false | Test mesajı geldikten sonra açın. |
TEAMS_WEBHOOK_URL | Bildirimler için Teams kanalı (gizlidir, yalnızca bu bilgisayara kaydedilir) | Bir https://…logic.azure.com veya …webhook.office.com URL'si | Test mesajı gönder işlemi kanala mesaj gönderir. |
NEXUS_TEAMS_NOTIFY | Her başarısızlık için Teams uyarısı | true veya false | Yalnızca çalıştırma özeti değil, başarısız olan her test için bir mesaj gelir. |
Daha fazlası: tüm entegrasyonlar, Ayarlar kılavuzu, sorun giderme. Diğer kılavuzlar: Jira Cloud, Azure Boards, Slack, Telegram, GitHub Issues.
Hâlâ çözüme ulaşamadınız mı? Studio'nun gösterdiği hata satırını aynen ekleyerek [email protected] adresine yazın. Erişim belirteci eklemeyin.