Bu rehberde: Bir Teams kanalında Workflows uygulamasıyla gelen webhook adresi oluşturur ve OrqLabs'a girersiniz. Ardından iş akışlarından kanala kart mesajı gönderir, Ekibe bildir kutusuyla onay isteklerini ve raporları Teams'e düşürürsünüz.
⏱ 10 dakika
Kimlik kartı
| Alan | Değer |
|---|---|
| Sağlayıcı anahtarı | MICROSOFT_TEAMS |
| Kategori | Mesajlaşma |
| Kimlik doğrulama | Webhook adresi (Workflows) |
| Kapsam | Proje bazlı |
| Webhook | Giden (OrqLabs → Teams) |
| Yetenekler | Uygulama işlemleri |
| Kullanan kutular | Microsoft Teams (app.microsoftTeams), Ekibe bildir (utility.notify, kanal Microsoft Teams) |
Ne işe yarar?
- Kanal mesajı: başlık, markdown metin ve isteğe bağlı bir düğmeden (ör. "Onayla") oluşan bir Adaptive Card gönderir.
- Ekip bildirimleri: Ekibe bildir kutusunda Microsoft Teams kanalını seçtiğinizde onay istekleri, rapor özetleri ve hata uyarıları Teams kanalına da gider; düğme OrqLabs panelindeki ilgili sayfayı açar.
Bağlantı tek yönlüdür: OrqLabs kanala yazar, Teams'teki mesajları okumaz.
Ön koşullar
- Microsoft 365 hesabı ve mesaj gönderilecek ekipte (team) üyelik.
- Kuruluşunuzda Workflows (Power Automate) uygulamasının açık olması. Bazı kuruluşlarda yönetici izni gerekir.
- OrqLabs'ta Sahip veya Yönetici rolü.
Adım adım kurulum
A) Teams'te webhook adresi (Workflows)
- Teams'te mesajların düşeceği kanala gidin → kanal adının yanındaki ⋯ (Diğer seçenekler) → Workflows.
- Post to a channel when a webhook request is received (veya Send webhook alerts to a channel) şablonunu seçin.
- Ad verin (
OrqLabs bildirimleri), bağlantıyı onaylayın → Next. - Ekip ve kanalın doğru seçildiğini kontrol edin → Add workflow.
- Son ekranda gösterilen webhook adresini kopyalayın. Adres
https://…logic.azure.com/workflows/…veyahttps://…powerplatform.com/powerautomate/automations/direct/workflows/…biçimindedir ve sonundasig=ile başlayan bir imza taşır.
Dikkat: Adresi bilen herkes kanala mesaj gönderebilir; bir parola gibi saklayın. Eski Office 365 bağlayıcı adresleri (
…webhook.office.com) Microsoft tarafından kapatılmaktadır; yeni kurulumlarda Workflows kullanın.
B) OrqLabs'ta bağlama
- Entegrasyonlar → Microsoft Teams → Bağla → Proje seçin.
- Incoming webhook URL alanına adresin tamamını (imza dahil) yapıştırın.
- Bağla. OrqLabs bağlanırken kanala test mesajı göndermez; yalnızca adresin bir Microsoft Workflows adresi olduğunu (https,
logic.azure.com/powerplatform.com/webhook.office.com) kontrol eder.
Kanal mesajı göndermek (Microsoft Teams kutusu)
| Alan | Açıklama |
|---|---|
| Title | Kalın başlık (ör. Yeni aday: {{ $json.name }}) |
| Text (markdown) | Mesaj gövdesi. Teams'in desteklediği temel markdown: **kalın**, _italik_, listeler, [bağlantı](https://…) |
| Button link | İsteğe bağlı; girilirse kartın altına bir düğme eklenir |
| Button label | Düğme yazısı (varsayılan Open) |
Kutu her öğe için bir kart gönderir; çıktı { sent: true, status } olur. Test çalıştırmalarında mesaj gönderilmez (öğe testMode notuyla geçer).
Ekibe bildir ile kullanma
- Ekibe bildir kutusunda Channels alanına Microsoft Teams ekleyin (uygulama içi bildirim, e-posta ve Slack ile birlikte seçilebilir).
- Kutunun Title ve Body alanları kartın başlığı ve metni olur; Link verilirse "Open in OrqLabs" düğmesi panelde o sayfayı açar (ör.
/approvals). - Teams bağlı değilse veya gönderim başarısız olursa iş akışı durmaz; çalıştırma günlüğünde
WARNING – teams notification not deliveredsatırı görünür.
Örnek: Onay iste kutusundan önce bir Ekibe bildir (Teams) ekleyerek içerik onaylarını ekibin Teams kanalına duyurabilirsiniz.
Limitler
| Konu | Sınır |
|---|---|
| Mesaj boyutu | 28 KB (OrqLabs metni ~20.000 karakterde keser) |
| Hız | Webhook başına saniyede ~4 istek; fazlasında Teams 429 döner, OrqLabs yeniden dener |
| Biçim | Adaptive Card 1.4; HTML desteklenmez |
| Gönderen | Mesaj, iş akışını oluşturan kişi adına ya da "Workflows" botu olarak görünür |
Bağlantıyı test etme
Bağlantıyı test et yalnızca adresin biçimini ve alan adını kontrol eder; kanala bir şey göndermez. Gerçek denemeyi bir iş akışını Microsoft Teams kutusuyla elle çalıştırarak yapın.
Kimlik bilgilerini yenileme
- Workflows'ta akışı silerseniz veya kapatırsanız adres çalışmaz (404). Yeni bir akış oluşturup adresi Kimlik bilgileri → Güncelle ile girin.
- Akış, onu oluşturan kişiye bağlıdır. Kişi kuruluştan ayrılırsa akışa bir ortak sahip (co-owner) ekleyin; aksi halde akış durabilir.
Sık karşılaşılan hatalar
| Hata | Olası neden | Çözüm |
|---|---|---|
CONFIG – not a Teams Workflows webhook URL | Başka bir adres (ör. Slack) veya eksik kopyalanmış adres | Workflows'taki adresi baştan sona kopyalayın |
AUTH – workflow no longer exists (404) | Akış silinmiş veya kapatılmış | Workflows'ta akışı açın ya da yeni adres oluşturun |
AUTH – webhook URL rejected (401/403) | sig= imzası eksik veya değişmiş | Adresi yeniden kopyalayın |
INVALID – Teams rejected the card (400) | Kart çok büyük veya metin bozuk | Metni kısaltın |
| Mesaj gelmiyor ama hata yok | Akış çalıştı ama başka kanala gönderiyor | Workflows → akış → Run history ve kanal seçimini kontrol edin |
Sık sorulan sorular
Özel (private) kanala gönderebilir miyim? Workflows botu özel kanallarda henüz gönderim yapamayabilir; standart veya paylaşılan bir kanal kullanın.
Kişiye özel (DM) mesaj atılır mı? Hayır; bu entegrasyon yalnızca webhook'un bağlı olduğu kanala yazar.
Birden fazla kanala nasıl gönderirim? Her kanal için ayrı bir Workflows adresi oluşturup ayrı bir Microsoft Teams bağlantısı ekleyin; kutuda Bağlı hesap ile kanalı seçin.