ข้อมูลอ้างอิงเครื่องมือ Spacemail MCP

Spacemail MCP เชื่อมต่อผู้ช่วย AI ของคุณ (เช่น Claude) เข้ากับกล่องจดหมาย Spacemail ของคุณ ผ่านสิ่งนี้ ผู้ช่วยสามารถแสดงรายการโฟลเดอร์ของคุณ แสดงรายการ ค้นหา และอ่านอีเมลของคุณ ทำเครื่องหมายว่าอ่านแล้วหรือเป็นรายการโปรด ย้ายอีเมลระหว่างโฟลเดอร์หรือไปยังถังขยะ และส่ง ตอบกลับ และส่งต่ออีเมลจากที่อยู่ของคุณเอง — คุณเพียงขอด้วยภาษาปกติ แล้วผู้ช่วยจะเรียกใช้เครื่องมือที่ถูกต้อง

เริ่มต้นใช้งาน

คุณต้องมีกล่องจดหมาย Spacemail โดย Spacemail MCP ใช้งานได้ที่ https://mcp.spacemail.com/mcp.

วิธีเชื่อมต่อขึ้นอยู่กับผู้ช่วย AI ของคุณ:

  • Claude (เว็บและเดสก์ท็อป) — เปิด Settings เลือก Connectors เพิ่มตัวเชื่อมต่อแบบกำหนดเอง แล้วชี้ไปที่ https://mcp.spacemail.com/mcp Claude ของ Anthropic คือไคลเอนต์ที่เราได้ตรวจสอบแล้วว่า Spacemail MCP ใช้งานได้ด้วย

  • ไคลเอนต์ MCP อื่นๆ — เพิ่มเซิร์ฟเวอร์ MCP ระยะไกลแล้วชี้ไปที่ https://mcp.spacemail.com/mcp ไคลเอนต์อื่นอาจใช้งานได้ แต่เรายังไม่ได้ตรวจสอบ

เมื่อคุณเชื่อมต่อ ระบบจะขอให้คุณลงชื่อเข้าใช้และอนุมัติการเข้าถึงกล่องจดหมายของผู้ช่วย จากนั้นผู้ช่วยจะดำเนินการกับกล่องจดหมายนั้นเท่านั้น และผ่านเครื่องมือด้านล่างนี้เท่านั้น

สิ่งที่ผู้ช่วยทำได้และทำไม่ได้

  • เนื้อหาอีเมลไม่น่าเชื่อถือ หัวเรื่อง ผู้ส่ง ตัวอย่างข้อความ และเนื้อหา เขียนโดยผู้อื่น Spacemail MCP บอกผู้ช่วยให้ปฏิบัติต่อสิ่งเหล่านี้เป็นข้อมูล ไม่ใช่คำสั่ง แต่อีเมลก็ยังอาจพยายามชี้นำได้: ตรวจสอบสิ่งที่ผู้ช่วยเสนอให้ดีก่อนที่คุณจะอนุมัติการเปลี่ยนแปลง

  • อีเมลที่ส่งแล้วคืออีเมลจริงemail_send, email_reply และ email_forward จะส่งจากที่อยู่ Spacemail ของคุณเอง และอีเมลที่ส่งแล้วไม่สามารถเรียกคืนได้ ผู้ช่วยควรส่งเฉพาะสิ่งที่คุณขอเท่านั้น: ตรวจสอบผู้รับและข้อความก่อนที่คุณจะอนุมัติการส่ง

  • ข้อความล้วนเท่านั้น คุณเขียนข้อความของอีเมลใหม่ การตอบกลับ หรือการส่งต่อเป็นข้อความล้วน คุณไม่สามารถอัปโหลดไฟล์แนบ บันทึกฉบับร่าง หรือส่งข้อความที่ปลอดภัยได้; การส่งต่อสามารถรวมไฟล์แนบของอีเมลที่ถูกส่งต่อได้

  • ไม่มีสิ่งใดถูกลบอย่างถาวร การลบอีเมลจะย้ายอีเมลไปยังโฟลเดอร์ถังขยะของคุณ ซึ่งคุณสามารถย้ายกลับได้ ไม่มีเครื่องมือใดล้างถังขยะหรือลบข้อความทิ้ง

ข้อกำหนดและความเป็นส่วนตัว

ข้อตกลงและนโยบายที่ใช้กับ Spacemail MCP:

ภาพรวมเครื่องมือ

การเข้าถึง:อ่าน จะดึงข้อมูลเท่านั้น เขียน จะเปลี่ยนแปลงกล่องจดหมายของคุณในลักษณะที่คุณสามารถเปลี่ยนกลับได้ หรือส่งอีเมลจากที่อยู่ของคุณ ซึ่งไม่สามารถย้อนกลับได้

  • เครื่องมือ: folder_list

    สิ่งที่ทำ: แสดงรายการโฟลเดอร์ของคุณพร้อมจำนวนที่ยังไม่ได้อ่านและจำนวนทั้งหมด

    การเข้าถึง: อ่าน

  • เครื่องมือ: email_list

    สิ่งที่ทำ: แสดงรายการอีเมลในโฟลเดอร์ โดยเรียงจากใหม่สุดก่อน

    การเข้าถึง: อ่าน

  • เครื่องมือ: email_search

    สิ่งที่ทำ: ค้นหาอีเมลตามข้อความ ยังไม่ได้อ่าน รายการโปรด หรือความสำคัญสูง

    การเข้าถึง: อ่าน

  • เครื่องมือ: email_read

    สิ่งที่ทำ: อ่านอีเมลหนึ่งฉบับและทำเครื่องหมายว่าอ่านแล้ว

    การเข้าถึง: เขียน

  • เครื่องมือ: email_mark_read

    สิ่งที่ทำ: ทำเครื่องหมายอีเมลว่าอ่านแล้วหรือยังไม่ได้อ่าน

    การเข้าถึง: เขียน

  • เครื่องมือ: email_mark_favorite

    สิ่งที่ทำ: ทำเครื่องหมายอีเมลเป็นรายการโปรดหรือลบเครื่องหมายออก

    การเข้าถึง: เขียน

  • เครื่องมือ: email_move

    สิ่งที่ทำ: ย้ายอีเมลไปยังโฟลเดอร์อื่น

    การเข้าถึง: เขียน

  • เครื่องมือ: email_delete

    สิ่งที่ทำ: ย้ายอีเมลไปยังถังขยะ

    การเข้าถึง: เขียน

  • เครื่องมือ: email_send

    สิ่งที่ทำ: ส่งอีเมลใหม่

    การเข้าถึง: เขียน

  • เครื่องมือ: email_reply

    สิ่งที่ทำ: ตอบกลับอีเมล หรือตอบกลับทั้งหมด

    การเข้าถึง: เขียน

  • เครื่องมือ: email_forward

    สิ่งที่ทำ: ส่งต่ออีเมล โดยมีไฟล์แนบรวมอยู่ด้วยตามค่าเริ่มต้น

    การเข้าถึง: เขียน

วิธีระบุอีเมล

อีเมลทุกฉบับในรายการหรือผลการค้นหาจะมี folderFullName และ uid เครื่องมืออื่นจะใช้ค่าสองค่านี้เป็น folder และ uiduid ใช้ได้เฉพาะภายในโฟลเดอร์ของมันและจะเปลี่ยนเมื่ออีเมลถูกย้าย ดังนั้นหลังจากย้ายแล้ว ผู้ช่วยจะใช้ uid ใหม่ที่การย้ายส่งกลับมา หรือแสดงรายการโฟลเดอร์อีกครั้ง

โฟลเดอร์ Virtual/All ครอบคลุมทุกโฟลเดอร์ รวมถึง Trash, Spam, Drafts และ Sent โดยยอมรับได้เฉพาะกับ email_list และ email_search เท่านั้น; แต่ละผลลัพธ์ยังคงมีโฟลเดอร์จริงของอีเมลนั้นอยู่

เวิร์กโฟลว์ทั่วไป

ติดตามอีเมลที่ยังไม่ได้อ่าน

  1. email_search พร้อม unreadOnly: true จะค้นหาอีเมลที่ยังไม่ได้อ่านในทุกโฟลเดอร์

  2. email_read จะเปิดอีเมลที่คุณถามถึง; การอ่านจะทำเครื่องหมายว่าอ่านแล้ว

จัดระเบียบโฟลเดอร์

  1. folder_list แสดงโฟลเดอร์และชื่อที่ตรงกันทุกประการ

  2. email_list แสดงรายการอีเมลของโฟลเดอร์

  3. email_move จัดเก็บอีเมลลงในอีกโฟลเดอร์หนึ่ง หรือ email_delete ย้ายไปยังถังขยะ

ตอบอีเมล

  1. email_search หรือ email_list ค้นหาอีเมลนั้น

  2. email_read จะแสดงให้คุณดู เพื่อให้คุณตัดสินใจได้ว่าจะตอบอะไร

  3. email_reply ส่งคำตอบของคุณ หรือ email_forward ส่งต่ออีเมลให้คนอื่น

ข้อมูลอ้างอิงเครื่องมือ

โฟลเดอร์

folder_list — แสดงรายการโฟลเดอร์

การเข้าถึง: อ่าน

แสดงรายการโฟลเดอร์ของกล่องจดหมายเป็นรายการแบบแบน รวมถึงโฟลเดอร์ที่ซ้อนกัน ใช้ fullName ของโฟลเดอร์เป็นอาร์กิวเมนต์ folder ของเครื่องมืออื่น

เครื่องมือนี้ไม่มีพารามิเตอร์

{
"folders": [
{ "fullName": "INBOX", "name": "INBOX", "parentFullName": "", "unread": 3, "total": 120, "role": "inbox" },
{ "fullName": "Receipts", "name": "Receipts", "parentFullName": "", "unread": 0, "total": 14, "role": null }
]
}

role คือ inbox, sent, drafts, trash, junk หรือ archive เมื่อโฟลเดอร์มีค่าเหล่านี้ มิฉะนั้นจะเป็น null.

อีเมล

email_list — แสดงรายการอีเมล

การเข้าถึง: อ่าน

แสดงรายการอีเมลของหนึ่งโฟลเดอร์ โดยเรียงจากใหม่สุดก่อน ทีละหนึ่งหน้า

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง 1–1024 อักขระ: fullName ของโฟลเดอร์ หรือ Virtual/All

  • พารามิเตอร์: page

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: จำนวนเต็ม ≥ 0, เริ่มนับจากศูนย์ ค่าเริ่มต้นคือ 0

  • พารามิเตอร์: count

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: จำนวนเต็ม 1–100: จำนวนอีเมลต่อหน้า ค่าเริ่มต้นคือ 25

{
"items": [
{
"folderFullName": "INBOX",
"uid": 4821,
"from": [{ "name": "Jane Doe", "address": "jane@example.com" }],
"to": [{ "name": null, "address": "you@yourdomain.com" }],
"subject": "Invoice for October",
"date": "2026-10-14T09:12:00Z",
"previewText": "Hi, please find the invoice attached…",
"isRead": false,
"isFavorite": false,
"isAnswered": false,
"hasAttachments": true,
"importance": "Normal"
}
],
"total": 120,
"page": 0,
"count": 25,
"hasMore": true
}

email_search — ค้นหาอีเมล

การเข้าถึง: อ่าน

ค้นหาอีเมลของโฟลเดอร์ตามข้อความและตัวกรอง ทีละหนึ่งหน้า หากไม่ระบุโฟลเดอร์ จะค้นหาใน Virtual/All.

  • พารามิเตอร์: folder

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: สตริง 1–1024 อักขระ ค่าเริ่มต้นคือ Virtual/All

  • พารามิเตอร์: query

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: สตริง 3–255 อักขระ: ข้อความที่จะค้นหา

  • พารามิเตอร์: unreadOnly

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: บูลีน: เฉพาะอีเมลที่ยังไม่ได้อ่าน

  • พารามิเตอร์: favoritesOnly

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: บูลีน: เฉพาะอีเมลที่เป็นรายการโปรด

  • พารามิเตอร์: highPriorityOnly

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: บูลีน: เฉพาะอีเมลที่มีความสำคัญสูง

  • พารามิเตอร์: page

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: จำนวนเต็ม ≥ 0, เริ่มนับจากศูนย์ ค่าเริ่มต้นคือ 0

  • พารามิเตอร์: count

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: จำนวนเต็ม 1–100: จำนวนอีเมลต่อหน้า ค่าเริ่มต้นคือ 25

ผลลัพธ์มีรูปแบบเดียวกับ email_list.

email_read — อ่านอีเมล

การเข้าถึง: เขียน — การอ่านจะทำเครื่องหมายอีเมลว่าอ่านแล้ว

อ่านอีเมลหนึ่งฉบับ: ส่วนหัว รายละเอียดไฟล์แนบ และเนื้อหา เนื้อหาจะเป็นเวอร์ชัน HTML ที่ผ่านการจัดระเบียบแล้วเมื่ออีเมลมีรูปแบบนั้น (bodyFormathtml) มิฉะนั้นจะเป็นข้อความล้วน (bodyFormattext) โดยตัดที่ 100,000 อักขระ (bodyTruncated) ไฟล์แนบจะแสดงเป็นรายการเท่านั้น ไม่ได้ดาวน์โหลด

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์จริงของอีเมล (folderFullName) ไม่ใช่ Virtual/All

  • พารามิเตอร์: uid

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: จำนวนเต็มบวก: uid ของอีเมลในโฟลเดอร์นั้น

{
"message": {
"folderFullName": "INBOX",
"uid": 4821,
"messageId": "<abc123@example.com>",
"from": [{ "name": "Jane Doe", "address": "jane@example.com" }],
"to": [{ "name": null, "address": "you@yourdomain.com" }],
"cc": [],
"subject": "Invoice for October",
"date": "2026-10-14T09:12:00Z",
"body": "<p>Hi, please find the invoice attached.</p>",
"bodyFormat": "html",
"bodyTruncated": false,
"attachments": [{ "name": "invoice.pdf", "contentType": "application/pdf", "size": 48213 }],
"importance": "Normal"
},
"markedRead": true
}

markedRead เป็น false เมื่อมีการส่งคืนอีเมลแล้ว แต่การทำเครื่องหมายว่าอ่านแล้วล้มเหลว

email_mark_read — ทำเครื่องหมายอีเมลว่าอ่านแล้วหรือยังไม่ได้อ่าน

การเข้าถึง: เขียน

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์จริงของอีเมล ไม่ใช่ Virtual/All

  • พารามิเตอร์: uid

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: จำนวนเต็มบวก

  • พารามิเตอร์: read

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: บูลีน: true ทำเครื่องหมายอีเมลว่าอ่านแล้ว, false ว่ายังไม่ได้อ่าน

{ "folderFullName": "INBOX", "uid": 4821, "isRead": true }

การตั้งค่าสถานะเดิมซ้ำสองครั้งไม่ก่อให้เกิดปัญหา uid ที่ไม่ได้อยู่ในโฟลเดอร์จะไม่ถูกรายงานเป็นข้อผิดพลาด ดังนั้นผู้ช่วยจะนำ uid มาจากรายการล่าสุด

email_mark_favorite — ทำเครื่องหมายอีเมลเป็นรายการโปรด

การเข้าถึง: เขียน

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์จริงของอีเมล ไม่ใช่ Virtual/All

  • พารามิเตอร์: uid

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: จำนวนเต็มบวก

  • พารามิเตอร์: favorite

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: บูลีน: true ทำเครื่องหมายอีเมลเป็นรายการโปรด, false เอาเครื่องหมายออก

{ "folderFullName": "INBOX", "uid": 4821, "isFavorite": true }

email_move — ย้ายอีเมล

การเข้าถึง: เขียน

ย้ายอีเมลหนึ่งฉบับไปยังอีกโฟลเดอร์หนึ่งในกล่องจดหมายเดียวกัน การย้ายไปยังโฟลเดอร์ที่อีเมลนั้นอยู่แล้วจะถูกปฏิเสธ

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์จริงของอีเมล ไม่ใช่ Virtual/All

  • พารามิเตอร์: uid

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: จำนวนเต็มบวก

  • พารามิเตอร์: destinationFolder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์ที่จะย้ายอีเมลไป ไม่ใช่ Virtual/All

{ "previousFolderFullName": "INBOX", "folderFullName": "Receipts", "uid": 77 }

อีเมลจะได้รับ uid ใหม่ในโฟลเดอร์ปลายทาง uid จะเป็น null เมื่อเซิร์ฟเวอร์ไม่ได้รายงานค่า; ให้แสดงรายการโฟลเดอร์ปลายทางเพื่อค้นหาอีเมล การย้ายจะไม่ถูกลองใหม่โดยอัตโนมัติ: หากไม่สามารถยืนยันได้ ผู้ช่วยจะแสดงรายการโฟลเดอร์ก่อนลองอีกครั้ง

email_delete — ลบอีเมล

การเข้าถึง: เขียน

ย้ายอีเมลหนึ่งฉบับไปยังโฟลเดอร์ถังขยะ อีเมลจะไม่ถูกลบทิ้งและสามารถย้ายกลับได้; อีเมลที่อยู่ในถังขยะแล้วจะถูกปฏิเสธ เพราะขั้นตอนเดียวที่เหลือคือการลบถาวร ซึ่ง Spacemail MCP จะไม่ทำเด็ดขาด

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์จริงของอีเมล ไม่ใช่ Virtual/All

  • พารามิเตอร์: uid

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: จำนวนเต็มบวก

{ "previousFolderFullName": "INBOX", "folderFullName": "Trash", "uid": 912 }

การส่ง

เครื่องมือเหล่านี้ส่งอีเมลจริงจากที่อยู่ Spacemail ของคุณเอง; ไม่สามารถเปลี่ยนผู้ส่งได้ ผลลัพธ์ระบุเพียงว่าเซิร์ฟเวอร์อีเมลยอมรับอีเมลเพื่อจัดส่งแล้ว ไม่ได้หมายความว่าได้จัดส่งสำเร็จแล้ว

ทั้งสามเครื่องมือใช้ข้อจำกัดเหล่านี้ร่วมกัน:

  • ผู้รับต้องเป็นที่อยู่อีเมลล้วน เช่น alice@example.com โดยไม่มีชื่อที่แสดง รวมกันได้สูงสุด 50 รายการ ที่อยู่เดียวกันที่ระบุซ้ำสองครั้งจะนับเพียงครั้งเดียว

  • ข้อความ (body) เป็นข้อความล้วนยาวได้สูงสุด 200,000 อักขระ การขึ้นบรรทัดใหม่จะถูกรักษาไว้; จะไม่ถูกส่งเป็น HTML

  • ไม่สามารถอัปโหลดไฟล์แนบได้ ไม่มีการบันทึกฉบับร่าง และไม่มีการส่งข้อความที่ปลอดภัย

การส่งจะไม่ถูกทำซ้ำแบบไม่ตรวจสอบ หากเซิร์ฟเวอร์อีเมลไม่ได้ยืนยัน (infrastructure.mailcore.outcome-unknown) อีเมลอาจถูกส่งไปแล้วอยู่ดี: ผู้ช่วยจะค้นหาอีเมลนั้นในโฟลเดอร์ส่งแล้วของคุณก่อนส่งอีกครั้ง

email_send — ส่งอีเมล

การเข้าถึง: เขียน — ส่งอีเมลจริง ซึ่งไม่สามารถย้อนกลับได้

ส่งอีเมลใหม่

  • พารามิเตอร์: to

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: รายการที่อยู่อีเมล 1–50 รายการ

  • พารามิเตอร์: cc

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: รายการที่อยู่อีเมลได้สูงสุด 50 รายการ ค่าเริ่มต้นคือไม่มี

  • พารามิเตอร์: bcc

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: รายการที่อยู่อีเมลได้สูงสุด 50 รายการ ซึ่งซ่อนจากผู้รับรายอื่น ค่าเริ่มต้นคือไม่มี

  • พารามิเตอร์: subject

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: บรรทัดเดียว ยาวได้สูงสุด 998 อักขระ

  • พารามิเตอร์: body

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: ข้อความล้วน ยาวได้สูงสุด 200,000 อักขระ

{ "accepted": true }

To, Cc และ Bcc รวมกันได้สูงสุด 50 ที่อยู่

email_reply — ตอบกลับอีเมล

การเข้าถึง: เขียน — ส่งอีเมลจริง ซึ่งไม่สามารถย้อนกลับได้

ตอบกลับอีเมลหนึ่งฉบับ หัวเรื่องจะมีคำนำหน้า Re: (ไม่ซ้ำสองครั้ง) การตอบกลับจะถูกรวมเธรดไว้ใต้อีเมลนั้น และอีเมลจะถูกอ้างอิงไว้ใต้ข้อความของคุณพร้อมส่วนหัวที่ระบุชื่อผู้ส่ง อีเมลที่ยาวมากจะถูกอ้างอิงได้สูงสุด 100,000 อักขระและทำเครื่องหมายว่าถูกตัดทอน การตอบกลับจะไม่ทำเครื่องหมายอีเมลว่าอ่านแล้ว

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์จริงของอีเมล ไม่ใช่ Virtual/All

  • พารามิเตอร์: uid

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: จำนวนเต็มบวก

  • พารามิเตอร์: body

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: ข้อความล้วน ยาวได้สูงสุด 200,000 อักขระ

  • พารามิเตอร์: replyAll

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: บูลีน: true จะตอบกลับไปยังผู้รับ To และ Cc รายอื่นด้วย ค่าเริ่มต้นคือ false

{ "accepted": true }

การตอบกลับจะถูกส่งไปยังที่อยู่ Reply-To ของอีเมล; หากไม่มี หรือระบุเพียงคุณคนเดียว จะส่งไปยังผู้ส่ง; หากนั่นคือคุณเช่นกัน เช่น อีเมลในโฟลเดอร์ส่งแล้วของคุณ จะส่งไปยังผู้รับ To เดิมของอีเมลนั้น โดยจะตัดที่อยู่ของคุณเองออกเสมอ เมื่อใช้ replyAll ผู้รับ To และ Cc รายอื่นของอีเมลจะถูกเพิ่มเข้ามา; ที่อยู่หลักของคุณจะถูกตัดออก แต่ alias ของคุณจะไม่ถูกตัดออก ดังนั้นสำเนาอาจส่งถึงคุณผ่านหนึ่งในนั้น การตอบกลับจะส่งไปยังผู้รับได้สูงสุด 50 ราย

email_forward — ส่งต่ออีเมล

การเข้าถึง: เขียน — ส่งอีเมลจริง ซึ่งไม่สามารถย้อนกลับได้

ส่งต่ออีเมลหนึ่งฉบับไปยังผู้รับใหม่ หัวเรื่องจะมีคำนำหน้า Fwd: (ไม่ซ้ำสองครั้ง) และอีเมลจะถูกอ้างอิงไว้ใต้ข้อความของคุณพร้อมส่วนหัวที่ระบุชื่อผู้ส่ง ได้สูงสุด 100,000 อักขระ การส่งต่อจะเริ่มการสนทนาใหม่ การส่งต่อจะไม่ทำเครื่องหมายอีเมลว่าอ่านแล้ว

  • พารามิเตอร์: folder

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: โฟลเดอร์จริงของอีเมล ไม่ใช่ Virtual/All

  • พารามิเตอร์: uid

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: จำนวนเต็มบวก

  • พารามิเตอร์: to

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: รายการที่อยู่อีเมล 1–50 รายการ

  • พารามิเตอร์: body

    จำเป็น: ใช่

    ประเภทและข้อจำกัด: สตริง: ข้อความล้วน ยาวได้สูงสุด 200,000 อักขระ

  • พารามิเตอร์: includeAttachments

    จำเป็น: ไม่

    ประเภทและข้อจำกัด: บูลีน: true จะส่งต่อไฟล์แนบของอีเมล false จะส่งต่อเฉพาะข้อความ ค่าเริ่มต้นคือ true

{ "accepted": true }

ข้อผิดพลาด

เมื่อเครื่องมือล้มเหลว ผู้ช่วยจะได้รับข้อผิดพลาดพร้อม code, ประโยค detail และ retryable ซึ่งบอกว่าการลองใหม่ภายหลังจะช่วยได้หรือไม่ ข้อผิดพลาดที่คุณอาจพบมีดังนี้:

  • รหัส: business.email.same-folder

    ความหมาย: ปลายทางคือโฟลเดอร์ที่อีเมลอยู่แล้ว

  • รหัส: business.email.already-in-trash

    ความหมาย: อีเมลอยู่ในถังขยะแล้ว

  • รหัส: business.email.trash-folder-not-found

    ความหมาย: กล่องจดหมายไม่มีโฟลเดอร์ที่ทำเครื่องหมายเป็นถังขยะ

  • รหัส: business.email.no-recipient

    ความหมาย: อีเมลใหม่หรือการส่งต่อไม่มีผู้รับ

  • รหัส: business.email.no-reply-recipient

    ความหมาย: อีเมลไม่ได้ระบุใครให้ตอบกลับนอกจากคุณ

  • รหัส: business.email.too-many-recipients

    ความหมาย: มีผู้รับรวมมากกว่า 50 ราย

  • รหัส: business.email.unauthorized

    ความหมาย: กล่องจดหมายปฏิเสธการเข้าถึง ให้เชื่อมต่อ Spacemail MCP ใหม่

  • รหัส: business.mailcore.folder-not-found

    ความหมาย: ไม่มีโฟลเดอร์นี้อยู่ ตรวจสอบ folder_list

  • รหัส: business.mailcore.message-not-found

    ความหมาย: อีเมลไม่ได้อยู่ในโฟลเดอร์นั้น ให้แสดงรายการโฟลเดอร์อีกครั้ง

  • รหัส: business.mailcore.quota-exceeded

    ความหมาย: กล่องจดหมายเต็ม

  • รหัส: business.mailcore.invalid-target-folder

    ความหมาย: ไม่สามารถย้ายอีเมลไปยังโฟลเดอร์นั้นได้ เช่น Drafts หรือ Sent

  • รหัส: infrastructure.mailcore.timeout

    ความหมาย: กล่องจดหมายไม่ตอบกลับทันเวลา; ลองใหม่ได้

  • รหัส: infrastructure.mailcore.unavailable

    ความหมาย: บริการกล่องจดหมายไม่พร้อมใช้งาน; ลองใหม่ได้

  • รหัส: infrastructure.mailcore.outcome-unknown

    ความหมาย: การย้ายหรือการส่งไม่ได้รับการยืนยัน; ให้แสดงรายการโฟลเดอร์ หรือดูใน Sent ก่อนทำซ้ำ

จำเป็นต้องใช้อีเมลที่ถูกต้อง