Dokumentasi
Notifikasi dan laporan Microsoft Teams
Buat webhook Workflows di channel Teams, tambahkan ke AutoPSEO, lalu terima notifikasi dan laporan terjadwal berupa Adaptive Card yang diberi warna sesuai tingkat keparahan.
AutoPSEO mengirim pesan ke Microsoft Teams melalui webhook Workflows. Teams memberi Anda sebuah URL yang mengirim pesan ke satu channel, lalu Anda menambahkan URL tersebut ke AutoPSEO sebagai channel Teams. Notifikasi, laporan terjadwal, pesan uji, dan ringkasan laporan sekali kirim kemudian tiba sebagai Adaptive Card, dengan judul berwarna sesuai tingkat keparahan dan tombol yang mengarah kembali ke laporan. Anda tidak memerlukan workspace Slack, dan tidak ada aplikasi AutoPSEO yang harus dipasang di Teams.
Dapatkan URL webhook dari Teams
Panduan incoming webhook dari Microsoft membuat URL tersebut melalui aplikasi Workflows:
- Di Teams, buka channel yang akan menerima kartu, lalu pilih More options (...) di sebelahnya.
- Pilih Workflows dan pilih template webhook. Saat ini Microsoft menamainya Send webhook alerts to a channel; petunjuk AutoPSEO di halaman pengaturan masih memakai nama lama, Post to a channel when a webhook request is received.
- Periksa tim dan channel yang sudah diisi otomatis oleh template, lalu klik Save.
- Salin tautan webhook yang ditampilkan oleh workflow.
URL dari konektor Incoming Webhook lama (di webhook.office.com) masih diterima. Microsoft sedang menghentikan Microsoft 365 Connectors dan akan memblokir pembuatan konektor baru, jadi gunakan Workflows untuk semua yang Anda siapkan sekarang.
Tambahkan channel di AutoPSEO
- Di bagian Microsoft Teams pada Slack, Teams & Webhooks, klik New Teams channel. Formulir terbuka dengan Microsoft Teams sebagai tujuannya.
- Masukkan Name yang mudah Anda kenali dan tempel URL-nya. Untuk entri Teams, AutoPSEO menerima alamat Workflows dan konektor (host seperti
logic.azure.com,powerautomate.com,azure-api.net, danwebhook.office.com) dan menolak host lainnya. - Klik Add channel, lalu klik Send test pada barisnya. Sebuah kartu berjudul nama entri tersebut akan muncul di channel.
- Buat laporan terjadwal atau notifikasi dan pilih channel ini.
Satu aturan hanya mengirim ke satu channel. Agar notifikasi yang sama muncul di Slack dan di Teams, buat aturannya dua kali, masing-masing untuk satu tujuan.
Tata letak kartu
Setiap pesan menjadi satu Adaptive Card (versi 1.4, lebar penuh), yang dibungkus dalam amplop message dengan lampiran application/vnd.microsoft.card.adaptive seperti pada contoh resmi Microsoft.
- Judul dengan huruf tebal berukuran besar. Untuk notifikasi, kartu memakai warna Attention untuk tingkat critical dan high, Warning untuk medium, dan warna default untuk low; laporan dan pesan uji memakai warna Accent.
- Ringkasan: kalimat yang sama seperti pada pesan Slack, lengkap dengan rentang tanggal.
- Fakta: hingga 12 nilai berlabel, misalnya klik beserta perubahannya, atau nilai saat ini dibandingkan dengan nilai dasar (baseline) sebuah notifikasi.
- Tabel: untuk laporan dan ringkasan laporan, hingga sepuluh baris dalam font lebar tetap.
- Footer: properti, pengingat bahwa data Search Console tertunda sekitar satu hari dan hanya hari yang sudah final yang dihitung, serta pengirimnya.
- Open report: tombol menuju laporan yang sesuai di AutoPSEO.
Mengapa kartu tidak muncul
Send test langsung melaporkan kegagalan; untuk pesan terjadwal, Delivery history menyimpan jawaban yang diberikan Teams.
| Yang Anda lihat | Kemungkinan penyebab | Solusi |
|---|---|---|
| "That does not look like a Teams Workflows or Incoming Webhook URL" saat menyimpan | URL tidak berada di host Workflows atau konektor | Salin ulang tautan dari workflow |
| HTTP 400 pada Send test | Ternyata bukan webhook Teams: URL Slack, hook Zapier, atau workflow yang diubah sehingga mengharapkan isi pesan yang berbeda | Buat workflow baru dari template dan tambahkan URL-nya |
| Waktu habis setelah 10 detik | Teams tidak merespons tepat waktu | Coba lagi nanti |
| Pengalihan (redirect) tidak diikuti | URL meneruskan ke tempat lain | Tambahkan URL akhirnya |
| Kartu berhenti setelah seorang rekan keluar | Microsoft mengaitkan setiap workflow dengan pemiliknya, dan workflow tanpa pemilik bisa berhenti | Tambahkan pemilik bersama pada workflow, atau buat ulang |
Laporan terjadwal yang gagal tidak dikirim ulang dalam periode yang sama: perbaiki penyebabnya, lalu gunakan Send now.
Kapan menggunakan webhook
Teams dan webhook keluar dapat membawa aturan yang sama, tetapi melayani pembaca yang berbeda. Channel Teams ditujukan untuk manusia: kartu yang sudah terformat dan tanpa perlu membangun apa pun. Webhook ditujukan untuk perangkat lunak: event mentah dalam bentuk JSON bertanda tangan untuk Zapier, Make, n8n, atau layanan Anda sendiri. Teams mengharapkan kartu, bukan JSON event AutoPSEO, sehingga URL Teams selalu ditempatkan di bagian Microsoft Teams.
Ikhtisar tentang apa yang didapat pengguna Teams ada di halaman Microsoft Teams.