Belgeler
Microsoft Teams uyarıları ve raporları
Bir Teams kanalında Workflows webhook'u oluşturun, AutoPSEO'ya ekleyin ve uyarıları ile zamanlanmış raporları önem derecesine göre renklendirilmiş Adaptive Card'lar olarak alın.
AutoPSEO, Microsoft Teams'e bir Workflows webhook'u üzerinden mesaj gönderir. Teams size tek bir kanala mesaj gönderen bir URL verir; siz de bu URL'yi AutoPSEO'ya bir Teams kanalı olarak eklersiniz. Uyarılar, zamanlanmış raporlar, test mesajları ve tek seferlik rapor özetleri bundan sonra Adaptive Card olarak gelir; başlık önem derecesine göre renklendirilir ve karttaki bir düğme sizi rapora götürür. Slack çalışma alanına ihtiyacınız yoktur ve Teams'e kurulacak bir AutoPSEO uygulaması da yoktur.
Teams'den webhook URL'si alın
Microsoft'un gelen webhook kılavuzu, URL'yi Workflows uygulamasıyla oluşturmanızı anlatır:
- Teams'de kartları alacak kanala gidin ve yanındaki Diğer seçenekler (...) simgesini seçin.
- Workflows'u seçin ve bir webhook şablonu belirleyin. Microsoft şu anda bu şablonu Send webhook alerts to a channel olarak adlandırıyor; AutoPSEO'nun ayarlar sayfasındaki ipucu ise hâlâ eski adı, Post to a channel when a webhook request is received ifadesini kullanıyor.
- Şablonun doldurduğu ekip ve kanalı kontrol edin, ardından Kaydet'e tıklayın.
- İş akışının gösterdiği webhook bağlantısını kopyalayın.
Eski Incoming Webhook bağlayıcısından alınan URL'ler (webhook.office.com üzerinde) hâlâ kabul edilir. Ancak Microsoft, Microsoft 365 Bağlayıcılarını kullanımdan kaldırıyor ve yenilerinin oluşturulmasını engelleyecek; bu nedenle şimdi kuracağınız her şey için Workflows'u kullanın.
Kanalı AutoPSEO'ya ekleyin
- Slack, Teams & Webhooks sayfasının Microsoft Teams bölümünde New Teams channel düğmesine tıklayın. Form, hedef olarak Microsoft Teams seçili şekilde açılır.
- Tanıyacağınız bir Ad girin ve URL'yi yapıştırın. Teams girişleri için AutoPSEO, Workflows ve bağlayıcı adreslerini (
logic.azure.com,powerautomate.com,azure-api.netvewebhook.office.comgibi ana makineler) kabul eder, diğer ana makineleri reddeder. - Add channel'a tıklayın, ardından kendi satırındaki Send test düğmesine basın. Kanalda, girişin adını taşıyan bir kart görünmelidir.
- Bir zamanlanmış rapor veya uyarı oluşturun ve bu kanalı seçin.
Bir kural tek bir kanala gönderir. Aynı uyarıyı hem Slack'te hem Teams'te almak istiyorsanız kuralı her biri için bir kez olmak üzere iki kez oluşturun.
Kartın düzeni
Her mesaj, bir Adaptive Card'a (sürüm 1.4, tam genişlik) dönüştürülür. Kart, Microsoft'un kendi örneklerinde kullanılan message zarfına ve application/vnd.microsoft.card.adaptive ekine sarılır.
- Başlık büyük ve kalın yazılır. Uyarılarda kritik ve yüksek önem dereceleri kartın Attention rengini, orta Warning rengini, düşük ise varsayılan rengi alır; raporlar ve testler Accent rengini kullanır.
- Özet: Slack mesajındaki cümlenin aynısıdır ve tarih aralığını içerir.
- Bilgiler: En fazla 12 etiketli değer; örneğin tıklamalar ve değişimleri ya da bir uyarının mevcut değerinin taban değerle karşılaştırması.
- Tablo: Raporlar ve rapor özetleri için, sabit genişlikli yazı tipiyle en fazla on satır.
- Alt bilgi: Mülk, Search Console verilerinin yaklaşık bir gün geriden geldiğini ve yalnızca tamamlanmış günlerin sayıldığını belirten bir not ve gönderen.
- Open report: AutoPSEO'daki ilgili rapora giden bir düğme.
Kart neden gelmedi
Send test hatayı hemen bildirir; zamanlanmış mesajlarda ise Delivery history, Teams'in verdiği yanıtı saklar.
| Gördüğünüz | Olası neden | Çözüm |
|---|---|---|
| Kaydederken "That does not look like a Teams Workflows or Incoming Webhook URL" | URL, bir Workflows veya bağlayıcı ana makinesinde değil | Bağlantıyı iş akışından yeniden kopyalayın |
| Send test sırasında HTTP 400 | Aslında bir Teams webhook'u değil: Slack URL'si, Zapier hook'u ya da farklı bir gövde bekleyecek şekilde düzenlenmiş bir iş akışı | Şablondan yeni bir iş akışı oluşturun ve URL'sini ekleyin |
| 10 saniye sonra zaman aşımı | Teams zamanında yanıt vermedi | Daha sonra tekrar deneyin |
| Yönlendirmeler izlenmez | URL başka bir yere yönlendiriyor | Bunun yerine son URL'yi ekleyin |
| Bir iş arkadaşı ayrıldıktan sonra kartlar durdu | Microsoft her iş akışını sahibi olan kişilere bağlar ve sahipsiz kalan bir iş akışı durabilir | İş akışına ortak sahipler ekleyin ya da yeniden oluşturun |
Başarısız olan bir zamanlanmış rapor aynı dönem içinde yeniden gönderilmez: nedeni düzeltin ve Send now düğmesini kullanın.
Bunun yerine webhook ne zaman kullanılır
Teams ve giden webhook'lar aynı kuralları taşıyabilir, ancak farklı okuyuculara hitap eder. Teams kanalı insanlar içindir: biçimlendirilmiş bir kart sunar ve hiçbir şey geliştirmenizi gerektirmez. Webhook ise yazılımlar içindir: Zapier, Make, n8n veya kendi hizmetiniz için ham olayı imzalı JSON olarak iletir. Teams, AutoPSEO'nun olay JSON'u yerine bir kart bekler; bu yüzden bir Teams URL'si her zaman Microsoft Teams bölümüne eklenmelidir.
Teams kullanıcılarının neler elde ettiğine dair genel bakış Microsoft Teams sayfasında yer alır.