Tài liệu
Cảnh báo và báo cáo qua Microsoft Teams
Tạo webhook Workflows trong kênh Teams, thêm vào AutoPSEO và nhận cảnh báo cùng báo cáo định kỳ dưới dạng Adaptive Card có màu theo mức độ nghiêm trọng.
AutoPSEO đăng bài lên Microsoft Teams thông qua webhook Workflows. Teams cung cấp cho bạn một URL để đăng vào một kênh, và bạn thêm URL đó vào AutoPSEO như một kênh Teams. Từ đó, cảnh báo, báo cáo định kỳ, tin nhắn thử và bản tóm tắt báo cáo đột xuất sẽ xuất hiện dưới dạng Adaptive Card, tiêu đề được tô màu theo mức độ nghiêm trọng và có nút dẫn về báo cáo. Bạn không cần workspace Slack, và cũng không có ứng dụng AutoPSEO nào cần cài vào Teams.
Lấy URL webhook từ Teams
Hướng dẫn về incoming webhook của Microsoft tạo URL bằng ứng dụng Workflows:
- Trong Teams, vào kênh sẽ nhận các thẻ và chọn Thêm tùy chọn (...) bên cạnh kênh đó.
- Chọn Workflows và chọn một mẫu webhook. Hiện Microsoft gọi mẫu này là Send webhook alerts to a channel; phần gợi ý của AutoPSEO trên trang cài đặt vẫn dùng tên cũ, Post to a channel when a webhook request is received.
- Kiểm tra team và kênh mà mẫu đã điền sẵn, rồi nhấp Lưu.
- Sao chép liên kết webhook mà workflow hiển thị.
URL từ trình kết nối Incoming Webhook cũ (trên webhook.office.com) vẫn được chấp nhận. Microsoft đang ngừng hỗ trợ Microsoft 365 Connectors và sẽ chặn việc tạo mới, vì vậy hãy dùng Workflows cho mọi thiết lập mới.
Thêm kênh trong AutoPSEO
- Trong mục Microsoft Teams của Slack, Teams & Webhooks, nhấp Kênh Teams mới. Biểu mẫu mở ra với đích đến là Microsoft Teams.
- Nhập một Tên dễ nhận biết và dán URL. Với mục Teams, AutoPSEO chấp nhận địa chỉ Workflows và connector (các host như
logic.azure.com,powerautomate.com,azure-api.netvàwebhook.office.com) và từ chối các host khác. - Nhấp Thêm kênh, sau đó nhấp Gửi thử trên dòng của kênh. Một thẻ có tiêu đề là tên của mục đó sẽ xuất hiện trong kênh.
- Tạo một báo cáo định kỳ hoặc một cảnh báo và chọn kênh này.
Mỗi quy tắc chỉ gửi đến một kênh. Để nhận cùng một cảnh báo trên cả Slack và Teams, hãy tạo quy tắc hai lần, mỗi nơi một lần.
Bố cục của thẻ
Mỗi tin nhắn trở thành một Adaptive Card (phiên bản 1.4, toàn chiều rộng), được bọc trong phong bì message với tệp đính kèm application/vnd.microsoft.card.adaptive mà các ví dụ của chính Microsoft sử dụng.
- Tiêu đề in đậm, cỡ lớn. Với cảnh báo, thẻ dùng màu Attention cho mức nghiêm trọng và cao, Warning cho mức trung bình và màu mặc định cho mức thấp; báo cáo và tin nhắn thử dùng màu Accent.
- Tóm tắt: cùng một câu như trong tin nhắn Slack, kèm khoảng ngày.
- Số liệu: tối đa 12 giá trị có nhãn, chẳng hạn lượt nhấp và mức thay đổi của chúng, hoặc giá trị hiện tại của cảnh báo so với mức cơ sở.
- Bảng: với báo cáo và bản tóm tắt báo cáo, tối đa mười dòng, dùng phông chữ cố định độ rộng.
- Chân thẻ: thuộc tính, lời nhắc rằng dữ liệu Search Console trễ khoảng một ngày và chỉ những ngày đã ổn định mới được tính, cùng người gửi.
- Mở báo cáo: nút dẫn đến báo cáo tương ứng trong AutoPSEO.
Vì sao thẻ không đến
Gửi thử báo lỗi ngay lập tức; với tin nhắn theo lịch, Lịch sử gửi lưu lại phản hồi mà Teams đã trả về.
| Hiện tượng | Nguyên nhân có thể | Cách khắc phục |
|---|---|---|
| "That does not look like a Teams Workflows or Incoming Webhook URL" khi lưu | URL không thuộc host Workflows hoặc connector | Sao chép lại liên kết từ workflow |
| HTTP 400 khi Gửi thử | Thực ra không phải webhook Teams: có thể là URL Slack, hook Zapier hoặc workflow đã bị sửa để mong đợi một nội dung khác | Tạo workflow mới từ mẫu và thêm URL của nó |
| Hết thời gian chờ sau 10 giây | Teams không phản hồi kịp | Thử lại sau |
| Chuyển hướng không được theo dõi | URL chuyển tiếp sang nơi khác | Hãy thêm URL cuối cùng |
| Thẻ ngừng đến sau khi một đồng nghiệp rời đi | Microsoft gắn mỗi workflow với những người sở hữu nó, và workflow không có chủ sở hữu có thể ngừng hoạt động | Thêm đồng sở hữu cho workflow, hoặc tạo lại |
Báo cáo định kỳ bị lỗi sẽ không được gửi lại trong cùng kỳ: hãy khắc phục nguyên nhân rồi dùng Gửi ngay.
Khi nào nên dùng webhook
Teams và webhook gửi đi có thể truyền tải cùng các quy tắc, nhưng phục vụ những đối tượng đọc khác nhau. Kênh Teams dành cho con người: một thẻ đã định dạng sẵn và không cần xây dựng gì. Webhook dành cho phần mềm: sự kiện thô dưới dạng JSON có chữ ký cho Zapier, Make, n8n hoặc dịch vụ của riêng bạn. Teams mong đợi một thẻ chứ không phải JSON sự kiện của AutoPSEO, nên URL Teams luôn thuộc về mục Microsoft Teams.
Tổng quan về những gì người dùng Teams nhận được nằm ở trang Microsoft Teams.