การใช้งาน Microsoft Teams

เรียนรู้วิธีใช้ node Microsoft Teams ใน n8n ปฏิบัติตามเอกสารทางเทคนิคเพื่อรวม node Microsoft Teams เข้ากับ workflow ของคุณ

ใช้ node Microsoft Teams เพื่อทำงานใน Microsoft Teams โดยอัตโนมัติ และรวม Microsoft Teams เข้ากับแอปพลิเคชันอื่นๆ n8n มีการสนับสนุนในตัวสำหรับฟีเจอร์ Microsoft Teams ที่หลากหลาย รวมถึงช่องทาง ช่องและข้อความแชท สมาชิกแชท การประชุมออนไลน์ และงานต่างๆ

ในหน้านี้ คุณจะพบรายการการดำเนินงานที่ node Microsoft Teams รองรับและลิงก์ไปยังแหล่งข้อมูลเพิ่มเติม

Credentials

จากเวอร์ชัน 2 ของ node Authentication เมนูแบบเลื่อนลงมีสามตัวเลือก:

• Teams OAuth2 : ข้อมูลประจำตัว OAuth2 เฉพาะ Microsoft Teams (ค่าเริ่มต้น) ขอบเขตเริ่มต้นครอบคลุมทุกทรัพยากรในหน้านี้ รวมถึง Chat.ReadWrite สำหรับสมาชิกแชทและข้อความแชทตั้งแต่ n8n 2.39.0 OnlineMeetings.ReadWrite สำหรับการประชุมออนไลน์ และจาก n8n 2.41.0 TeamworkTag.Read สำหรับการกล่าวถึงแท็กทีม
• Microsoft OAuth2 (Graph) : credentials Microsoft Graph ทั่วไปที่คุณสามารถนำมาใช้ซ้ำกับ node Microsoft อื่นๆ ได้ เมื่อคุณเลือกตัวเลือกนี้ ให้มอบ credentials ตามขอบเขตที่ node นี้ต้องการ อ้างถึง ขอบเขตเริ่มต้นสำหรับ Microsoft Teams สำหรับรายการทั้งหมด
• Service Principal (App-Only) : การเข้าถึงเฉพาะแอปผ่านการลงทะเบียนแอป Microsoft Entra โดยไม่มีผู้ใช้ที่ลงชื่อเข้าใช้ ทรัพยากรบางอย่างจำเป็นต้องมีผู้ใช้ที่ลงชื่อเข้าใช้และไม่สามารถใช้ได้กับข้อมูลประจำตัวนี้ อ้างถึง การสนับสนุน credentials หลักของบริการ ในหน้านี้และถึง Microsoft Entra Service Principal credentials สำหรับการตั้งค่าและการอนุญาตแอปพลิเคชันที่จำเป็น

หากคุณเชื่อมต่อ credentials Teams OAuth2 ก่อน n8n 2.39.0 ให้เชื่อมต่อใหม่เพื่อให้รับได้ OnlineMeetings.ReadWrite . หากใช้ข้อมูลประจำตัว Custom Scopes ให้เพิ่มขอบเขตไปที่ Enabled Scopes แทน

อ้างถึง Microsoft credentials สำหรับคำแนะนำในการตั้งค่าการรับรองความถูกต้อง

Government Cloud Support

หากคุณใช้ผู้เช่าระบบคลาวด์ของรัฐบาล (US Government, US Government DOD หรือจีน) ตรวจสอบให้แน่ใจว่าได้เลือกสิ่งที่เหมาะสม Microsoft Graph API Base URL ในการกำหนดค่า credentials Microsoft ของคุณ

node นี้สามารถใช้เป็นเครื่องมือ AI ได้ (This node can be used as an AI tool)

node นี้สามารถใช้เพื่อเพิ่มขีดความสามารถของ AI Agent เมื่อใช้ในลักษณะนี้ parameter จำนวนมากสามารถตั้งค่าได้โดยอัตโนมัติ หรือด้วยข้อมูลที่ควบคุมโดย AI ดูข้อมูลเพิ่มเติมได้ใน เอกสารประกอบ parameter เครื่องมือ AI .

Human-in-the-loop สำหรับการเรียกเครื่องมือ AI (Human-in-the-loop for AI tool calls)

node นี้สามารถใช้เป็นขั้นตอนการตรวจสอบโดยมนุษย์สำหรับการเรียกใช้เครื่องมือ AI Agent เมื่อกำหนดค่าด้วยวิธีนี้ AI Agent จะหยุดชั่วคราวและขออนุมัติจากมนุษย์ผ่านบริการนี้ ก่อนที่จะดำเนินการใช้เครื่องมือที่ต้องมีการควบคุมดูแล เรียนรู้เพิ่มเติมใน Human-in-the-loop สำหรับการเรียกเครื่องมือ AI .

การดำเนินงาน

ความพร้อมใช้งานของคุณสมบัติ (Feature availability)

ทรัพยากรของ Chat Member และ Online Meeting พร้อมใช้งานตั้งแต่ n8n 2.39.0 พร้อมด้วย Channel Message Get, Get Many Replies และ Reply การดำเนินงาน สมาชิกแชท Add การดำเนินงานและการประชุมออนไลน์ Create or Get, Delete และ Update การดำเนินการพร้อมใช้งานตั้งแต่ n8n 2.40.0

• ช่อง
  • สร้าง
  • ลบ
  • รับ
  • รับมากมาย
  • อัปเดต
• ข้อความช่อง
  • สร้าง
  • รับ
  • รับมากมาย
  • ได้รับการตอบกลับมากมาย
  • ตอบกลับ
• สมาชิกแชท
  • เพิ่ม
  • รับมากมาย
• ข้อความแชท
  • สร้าง
  • รับ
  • รับมากมาย
  • ส่งและรอการตอบกลับ
• การประชุมออนไลน์
  • สร้าง
  • สร้างหรือรับ
  • ลบ
  • รับ
  • อัปเดต
• งาน
  • สร้าง
  • ลบ
  • รับ
  • รับมากมาย
  • อัปเดต

รอการตอบกลับ

โดยการเลือก Send and Wait for a Response คุณสามารถส่งข้อความและหยุดการดำเนินการ workflow ชั่วคราวได้จนกว่าบุคคลจะยืนยันการดำเนินการหรือให้ข้อมูลเพิ่มเติม

Response Type

คุณสามารถเลือกระหว่างการดำเนินการรอและอนุมัติประเภทต่อไปนี้:

• Approval : ผู้ใช้สามารถอนุมัติหรือไม่อนุมัติได้จากภายในข้อความ
• Free Text : ผู้ใช้สามารถส่งคำตอบด้วยแบบฟอร์ม
• Custom Form : ผู้ใช้สามารถส่งคำตอบด้วยแบบฟอร์มที่กำหนดเองได้

คุณสามารถปรับแต่งพฤติกรรมการรอและการตอบกลับได้ ขึ้นอยู่กับประเภทการตอบกลับที่คุณเลือก คุณสามารถกำหนดค่าตัวเลือกเหล่านี้ในประเภทการตอบกลับข้างต้น:

• Limit Wait Time : กำหนดว่า workflow จะกลับมาดำเนินการโดยอัตโนมัติหลังจากระยะเวลาที่กำหนดหรือไม่ นี่อาจเป็นช่วงเวลาหรือเวลาผนังเฉพาะ
• ผนวก n8n Attribution (Append n8n Attribution) : ระบุในข้อความว่าส่งอัตโนมัติด้วย n8n (เปิด) หรือไม่ (ปิด)

การปรับแต่งการตอบรับการอนุมัติ (Approval response customization)

เมื่อใช้ชนิดการตอบสนองการอนุมัติ คุณสามารถเลือกได้ว่าจะแสดงเฉพาะปุ่มอนุมัติหรือทั้งสองอย่าง และ ปุ่มไม่อนุมัติ

คุณยังสามารถปรับแต่งป้ายกำกับปุ่มสำหรับปุ่มที่คุณรวมไว้ได้

ปรับแต่งการตอบกลับด้วยข้อความฟรี (Free Text response customization)

เมื่อใช้ประเภทการตอบกลับด้วยข้อความอิสระ คุณสามารถปรับแต่งป้ายกำกับปุ่มข้อความ ชื่อแบบฟอร์มและคำอธิบาย และป้ายกำกับปุ่มตอบกลับได้

การปรับแต่งการตอบกลับแบบฟอร์มแบบกำหนดเอง (Custom Form response customization)

เมื่อใช้ประเภทการตอบกลับแบบฟอร์มแบบกำหนดเอง คุณจะสร้างแบบฟอร์มโดยใช้ฟิลด์และตัวเลือกที่คุณต้องการ

คุณสามารถปรับแต่งแต่ละองค์ประกอบแบบฟอร์มด้วยการตั้งค่าที่ระบุไว้ใน องค์ประกอบแบบฟอร์มของ trigger แบบฟอร์ม n8n . หากต้องการเพิ่มฟิลด์เพิ่มเติม ให้เลือก Add Form Element ปุ่ม

นอกจากนี้คุณยังสามารถปรับแต่งป้ายกำกับปุ่มข้อความ ชื่อแบบฟอร์มและคำอธิบาย และป้ายกำกับปุ่มตอบกลับได้อีกด้วย

กล่าวถึง

ความพร้อมใช้งานของคุณสมบัติ (Feature availability)

การกล่าวถึง node Microsoft Teams มีให้ตั้งแต่ n8n 2.41.0

ข้อความช่อง Create และ Reply การดำเนินงานและข้อความแชท Create การดำเนินงานมี Mentions สนาม แต่ละแถวในฟิลด์ @กล่าวถึง หนึ่งคนหรือหนึ่งแท็กทีม และ n8n จะเพิ่มการกล่าวถึงในข้อความสำหรับคุณ บนข้อความช่อง ให้ตั้งค่า Mention Type ถึง User หรือ Team Tag ก่อน ข้อความแชทกล่าวถึงผู้ใช้เท่านั้น เนื่องจากแท็กทีมเป็นของทีม อ้างอิงถึง Microsoft chatMessageMention ประเภททรัพยากร สำหรับวิธีที่ Microsoft Teams จัดเก็บการกล่าวถึง

อย่าพิมพ์ชื่อลงไป Message เช่นกันหรือปรากฏขึ้นสองครั้ง

Mention Placement ทางเลือกในการดำเนินงาน Options คอลเลกชันชุดที่กล่าวถึง Start of Message ค่าเริ่มต้นให้ @Jane please review this. End of Message ให้ please review this @Jane.

การกล่าวถึงทำให้ข้อความเป็น HTML (Mentions make the message HTML)

การกล่าวถึงทำให้ Microsoft Teams แสดงผลข้อความเป็น HTML แม้ว่าจะเป็นเช่นนั้นก็ตาม Content Type คือ Text . ตัวแบ่งบรรทัดที่คุณพิมพ์ลงไป Message หยุดแสดงเป็นการขึ้นบรรทัดใหม่ ดังนั้นให้ใช้ <br> แทน

กล่าวถึงผู้ใช้ (Mention a user)

ในก Mentions แถวข้อความช่อง Create หรือ Reply , ตั้ง Mention Type ถึง User . ข้อความแชท Create ไม่มี Mention Type เนื่องจากแถวนั้นเป็นผู้ใช้อยู่แล้ว จากนั้นกรอก. User สนาม:

• From List : ค้นหาไดเรกทอรี Microsoft Entra ของคุณและเลือกผู้ใช้ รายการจับคู่ชื่อที่แสดงกับชื่อผู้ใช้หลัก (UPN) เช่น Jane Smith (jane@contoso.com) เนื่องจากชื่อที่แสดงไม่ซ้ำกันในผู้เช่า ผู้ใช้ทั่วไปก็ทำงานที่นี่เช่นกัน
• By ID : ป้อน ID object ของผู้ใช้ เช่น 7e2f1174-e8ee-4859-b8b1-a8d1cc63d276 หรือ UPN หรือที่อยู่อีเมล เช่น jacob@contoso.com . สำหรับผู้ใช้เกสต์ ให้ใช้รหัส object: UPN ของเกสต์ประกอบด้วย #EXT# ซึ่งฟิลด์นี้ปฏิเสธ

n8n ค้นหาผู้ใช้ใน Microsoft Entra ก่อนที่จะส่งข้อความ ดังนั้นการกล่าวถึงจะแสดงชื่อที่แสดงไดเรกทอรีแทนที่จะเป็นข้อความที่คุณป้อน

พูดถึงแท็กทีม (Mention a team tag)

แท็กทีมเป็นของทีม ดังนั้นการกล่าวถึงแท็กจึงใช้ได้กับข้อความช่องทางเท่านั้น ตั้งค่าการดำเนินการ Team ให้กับทีมที่เป็นเจ้าของแท็กแล้วเพิ่มก Mentions แถว, ตั้ง Mention Type ถึง Team Tag และกรอกข้อมูลลงใน Team Tag สนาม:

• From List : เลือกหนึ่งในแท็กของทีม แต่ละรายการจะแสดงจำนวนสมาชิกที่บรรทุก เช่น Engineering (4 members).
• By ID : ใส่ tag ID ที่ GET /v1.0/teams/<team-id>/tags ผลตอบแทน แท็กจะต้องเป็นของทีมที่คุณเลือก ไม่เช่นนั้น node จะล้มเหลวเมื่อค้นหาแท็ก

การกล่าวถึงแท็กจะแจ้งให้ทุกคนที่ถือแท็กทราบ node Microsoft Teams กล่าวถึงแท็กที่มีอยู่ของทีมและไม่สามารถสร้างแท็กใหม่ได้

กล่าวถึงสิทธิ์ (Mention permissions)

การกล่าวถึงผู้ใช้จำเป็นต้องมี User.Read.All สิทธิ์และแท็กทีมกล่าวถึงความต้องการ TeamworkTag.Read . ที่ Teams OAuth2 คำขอข้อมูลประจำตัวทั้งสองโดยค่าเริ่มต้น เพิ่มด้วยตนเองหากใช้ข้อมูลประจำตัว Custom Scopes หรือหากคุณรับรองความถูกต้องด้วย Microsoft OAuth2 (Graph) . ผู้ดูแลระบบ Microsoft Entra ต้องยินยอม

หากคุณเชื่อมต่อ credentials Teams OAuth2 ก่อน n8n 2.41.0 ให้เชื่อมต่อใหม่เพื่อให้รับได้ TeamworkTag.Read . หากไม่มีขอบเขต การกล่าวถึงแท็กทีมจะล้มเหลวโดยมีข้อผิดพลาดในการอนุญาต

การกล่าวถึงไม่สามารถใช้ได้กับ Service Principal (App-Only) credentials ซึ่งไม่สามารถดำเนินการใดๆ ในสามการดำเนินการที่รองรับได้ อ้างถึง การสนับสนุน credentials หลักของบริการ .

การสนับสนุน credentials หลักของบริการ

ที่ Service Principal (App-Only) ข้อมูลประจำตัวไม่มีผู้ใช้ที่ลงชื่อเข้าใช้ ดังนั้น node Microsoft Teams จึงไม่สามารถดำเนินการที่ทำหน้าที่เป็นหนึ่งเดียวได้ รายการด้านล่างระบุสิ่งที่มีอยู่สำหรับทรัพยากรแต่ละรายการ สำหรับทรัพยากรและการดำเนินการที่ไม่พร้อมใช้งาน node จะซ่อนฟิลด์และแสดงการแจ้งเตือนเมื่อคุณเลือก credentials นี้ workflow ที่ยังคงใช้อย่างใดอย่างหนึ่งล้มเหลวโดยมีข้อผิดพลาดก่อนที่ node จะส่งคำขอใดๆ

• Channel : การดำเนินการทั้งหมด
• Channel Message : รับ รับมากมาย และรับการตอบกลับมากมาย สร้างและตอบกลับไม่พร้อมใช้งาน เนื่องจาก Microsoft Graph เฉพาะแอปรองรับเฉพาะการนำเข้าการย้ายข้อมูลสำหรับข้อความช่องทางเท่านั้น ใช้ credentials OAuth2 เพื่อส่งข้อความช่องทาง
• Chat Member : ไม่สามารถใช้ได้. เครื่องมือเลือกแชทของ node แสดงรายการแชทของผู้ใช้ที่ลงชื่อเข้าใช้ ซึ่งการเข้าถึงเฉพาะแอปไม่สามารถทำได้ ดังนั้น node จึงบล็อกทรัพยากรทั้งหมด รวมถึงการแชทที่ได้รับจาก ID
• Chat Message : ไม่สามารถใช้ได้. node ส่งและอ่านข้อความแชทในฐานะผู้ใช้ที่ลงชื่อเข้าใช้
• Online Meeting : ไม่สามารถใช้ได้. node สร้างและจัดการการประชุมออนไลน์ในฐานะผู้ใช้ที่ลงชื่อเข้าใช้
• Task : การดำเนินการทั้งหมด Get Many แสดงรายการงานของแผนเสมอ: node จะซ่อน Tasks For ตัวเลือกดังนั้น Group Member ไม่สามารถใช้ได้ node ยังซ่อนไฟล์ Team ตัวเลือกและ Plan, Bucket และ Assigned To ฟิลด์ยอมรับ ID เท่านั้น

อ้างถึง Microsoft Entra Service Principal credentials สำหรับการอนุญาตแอปพลิเคชันที่แต่ละการดำเนินการต้องการ

เทมเพลตและตัวอย่าง

เรียกดูเทมเพลตการรวมเอกสาร node Microsoft Teams หรือ ค้นหาเทมเพลตทั้งหมด

ทรัพยากรที่เกี่ยวข้อง

อ้างถึง เอกสารประกอบ API ของทีม Microsoft สำหรับข้อมูลเพิ่มเติมเกี่ยวกับบริการ

จะทำอย่างไรถ้าการดำเนินการของคุณไม่รองรับ

หาก node นี้ไม่สนับสนุนการดำเนินการที่คุณต้องการ คุณสามารถใช้ HTTP Request เพื่อเรียก API ของบริการ

คุณสามารถใช้ credentials ที่คุณสร้างขึ้นสำหรับบริการนี้ใน node คำขอ HTTP:

1. ใน node คำขอ HTTP ให้เลือก Authentication > Predefined Credential Type.
2. เลือกบริการที่คุณต้องการเชื่อมต่อ
3. เลือกข้อมูลประจำตัวของคุณ

อ้างถึง Custom API actions for existing nodes สำหรับข้อมูลเพิ่มเติม