การแจ้งเตือนและรายงานผ่าน Microsoft Teams

AutoPSEO ส่งข้อความไปยัง Microsoft Teams ผ่าน Workflows webhook โดย Teams จะให้ URL ที่ใช้โพสต์ลงในแชนเนลหนึ่งแชนเนล แล้วคุณนำ URL นั้นมาเพิ่มใน AutoPSEO เป็นแชนเนล Teams จากนั้นการแจ้งเตือน รายงานตามกำหนดเวลา ข้อความทดสอบ และสรุปรายงานแบบครั้งเดียวจะส่งมาในรูปแบบ Adaptive Card โดยชื่อเรื่องจะมีสีตามระดับความรุนแรงและมีปุ่มสำหรับเปิดรายงาน คุณไม่จำเป็นต้องมี Slack workspace และไม่ต้องติดตั้งแอป AutoPSEO ใน Teams

รับ URL ของ webhook จาก Teams

คู่มือ incoming webhook ของ Microsoft สร้าง URL ด้วยแอป Workflows ดังนี้

1. ใน Teams ไปที่แชนเนลที่ต้องการรับการ์ด แล้วเลือก ตัวเลือกเพิ่มเติม (...) ข้างแชนเนลนั้น
2. เลือก Workflows แล้วเลือกเทมเพลต webhook ปัจจุบัน Microsoft เรียกเทมเพลตนี้ว่า Send webhook alerts to a channel ส่วนคำแนะนำของ AutoPSEO ในหน้าการตั้งค่ายังใช้ชื่อเดิมว่า Post to a channel when a webhook request is received
3. ตรวจสอบทีมและแชนเนลที่เทมเพลตกรอกให้ แล้วคลิก Save
4. คัดลอกลิงก์ webhook ที่ workflow แสดงให้

URL จาก Incoming Webhook connector รุ่นเก่า (บน webhook.office.com) ยังใช้งานได้ อย่างไรก็ตาม Microsoft กำลังยกเลิก Microsoft 365 Connectors และจะบล็อกการสร้างใหม่ ดังนั้นสำหรับสิ่งที่ตั้งค่าตอนนี้ควรใช้ Workflows

เพิ่มแชนเนลใน AutoPSEO

1. ในส่วน Microsoft Teams ของ Slack, Teams & Webhooks คลิก New Teams channel ฟอร์มจะเปิดขึ้นโดยเลือก Microsoft Teams เป็นปลายทางไว้แล้ว
2. กรอก Name ที่คุณจำได้ง่าย แล้ววาง URL สำหรับรายการ Teams นั้น AutoPSEO รองรับที่อยู่ของ Workflows และ connector (โฮสต์เช่น logic.azure.com, powerautomate.com, azure-api.net และ webhook.office.com) และจะปฏิเสธโฮสต์อื่น
3. คลิก Add channel แล้วคลิก Send test ในแถวของแชนเนลนั้น ควรมีการ์ดที่ใช้ชื่อของรายการเป็นชื่อเรื่องปรากฏในแชนเนล
4. สร้างรายงานตามกำหนดเวลาหรือการแจ้งเตือนแล้วเลือกแชนเนลนี้

หนึ่งกฎส่งไปยังหนึ่งแชนเนลเท่านั้น หากต้องการให้การแจ้งเตือนเดียวกันไปทั้ง Slack และ Teams ให้สร้างกฎสองครั้ง แยกสำหรับแต่ละปลายทาง

รูปแบบการจัดวางของการ์ด

แต่ละข้อความจะกลายเป็น Adaptive Card หนึ่งใบ (เวอร์ชัน 1.4 ความกว้างเต็ม) ห่อด้วย envelope message พร้อม attachment ชนิด application/vnd.microsoft.card.adaptive ตามที่ตัวอย่างของ Microsoft เองใช้

• ชื่อเรื่อง ตัวอักษรขนาดใหญ่และเป็นตัวหนา การแจ้งเตือนระดับ critical และ high ใช้สี Attention ของการ์ด ระดับ medium ใช้สี Warning และระดับ low ใช้สีเริ่มต้น ส่วนรายงานและข้อความทดสอบใช้สี Accent
• สรุป ประโยคเดียวกับที่อยู่ในข้อความ Slack พร้อมช่วงวันที่
• ข้อเท็จจริง (Facts) ค่าที่มีป้ายกำกับสูงสุด 12 รายการ เช่น จำนวนคลิกและการเปลี่ยนแปลง หรือค่าปัจจุบันเทียบกับค่าพื้นฐานของการแจ้งเตือน
• ตาราง สำหรับรายงานและสรุปรายงาน แสดงได้สูงสุดสิบแถวด้วยฟอนต์ความกว้างคงที่
• ส่วนท้าย แสดงพร็อพเพอร์ตี้ ข้อความเตือนว่าข้อมูลจาก Search Console ล่าช้าประมาณหนึ่งวันและนับเฉพาะวันที่ข้อมูลนิ่งแล้วเท่านั้น และผู้ส่ง
• Open report ปุ่มที่ลิงก์ไปยังรายงานที่เกี่ยวข้องใน AutoPSEO

ทำไมการ์ดจึงไม่มาถึง

Send test จะแจ้งความล้มเหลวทันที ส่วนข้อความที่ตั้งเวลาไว้ Delivery history จะเก็บคำตอบที่ Teams ส่งกลับมา

รายงานตามกำหนดเวลาที่ส่งไม่สำเร็จจะไม่ถูกส่งซ้ำในรอบเดียวกัน ให้แก้ที่สาเหตุแล้วใช้ Send now

เมื่อใดควรใช้ webhook แทน

Teams และwebhook ขาออกสามารถรองรับกฎชุดเดียวกันได้ แต่ผู้อ่านต่างกัน แชนเนล Teams ใช้สำหรับคน คือการ์ดที่จัดรูปแบบแล้วโดยไม่ต้องสร้างอะไรเพิ่ม ส่วน webhook ใช้สำหรับซอฟต์แวร์ คือเหตุการณ์ดิบในรูปแบบ JSON ที่ลงลายเซ็นสำหรับ Zapier, Make, n8n หรือบริการของคุณเอง Teams ต้องการการ์ดมากกว่า JSON ของเหตุการณ์จาก AutoPSEO ดังนั้น URL ของ Teams จึงต้องอยู่ภายใต้ Microsoft Teams เสมอ

ภาพรวมของสิ่งที่ผู้ใช้ Teams จะได้รับอยู่ที่หน้า Microsoft Teams