API, จดหมายเวียน และการส่งทางอีเมล

ส่งจดหมายโดยตรงจากซอฟต์แวร์ของคุณ – ผ่าน REST API เป็นจดหมายเวียน หรือเพียงแค่ทางอีเมล คอนเน็กเตอร์ Claude ใช้ฟังก์ชันเดียวกัน

การยืนยันตัวตน

สร้างคีย์ได้ที่ บัญชี → คีย์ API และส่งเป็น bearer token แต่ละคำขอจะเรียกเก็บจากยอดเงินของบัญชีนั้นเท่านั้น

curl -H "Authorization: Bearer mbx_…" https://mcpbrief.de/api/v1/balance

คำอธิบาย OpenAPI: https://mcpbrief.de/openapi.json

Endpoints

GET	/balance	ยอดเงิน ราคา ผู้ส่ง ขีดจำกัดรายวัน
POST	/letter/price	ตรวจสอบที่อยู่ สร้างจดหมาย จำนวนหน้าและราคา + ตัวอย่าง PDF (ไม่มีการส่ง)
POST	/letter/send	ส่งจดหมาย (ข้อความ, PDF, DOCX, รูปภาพ; เอกสารแนบ, duplex, ศูนย์ต้นทุน)
GET	/letter/{id}	สถานะและหมายเลขติดตาม
POST	/letter/{id}/cancel	ยกเลิกก่อนพิมพ์ (คืนเงิน)
POST	/letter/{id}/resend	ส่งอีกครั้ง
GET	/letters?limit=&status=&since=&cost_center=&batch_id=	รายการจดหมายของคุณ กรองได้
POST	/letters/batch/price	ตรวจสอบจดหมายเวียน: ที่อยู่ทั้งหมด ตัวยึดตำแหน่ง ราคารวม
POST	/letters/batch/send	ส่งจดหมายเวียน (ผู้รับสูงสุด 200 ราย)

ตัวอย่าง: จดหมายลงทะเบียนพร้อมเอกสารแนบ

curl -X POST https://mcpbrief.de/api/v1/letter/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipient": {"name": "Muster GmbH", "street": "Ringstraße 5",
                "zip": "1010", "city": "Wien", "country": "AT"},
  "subject": "Rechnung 2026-17",
  "content": "Sehr geehrte Damen und Herren,\n\nanbei …",
  "attachments": [{"file_base64": "JVBERi0…", "file_name": "rechnung.pdf"}],
  "delivery": "registered", "duplex": true, "cost_center": "VERTRIEB",
  "idempotency_key": "7d1c2f0e-…"
}'

ตัวอย่าง: จดหมายเวียน

curl -X POST https://mcpbrief.de/api/v1/letters/batch/send \
  -H "Authorization: Bearer mbx_…" -H "Content-Type: application/json" \
  -d '{
  "recipients": [
    {"name": "Muster GmbH", "street": "Ringstraße 5", "zip": "1010",
     "city": "Wien", "country": "AT", "anrede": "Sehr geehrte Frau Huber"},
    {"name": "Beispiel AG", "street": "Hauptstraße 1", "zip": "10115",
     "city": "Berlin", "country": "DE", "anrede": "Sehr geehrte Damen und Herren"}
  ],
  "subject": "Preisanpassung 2027",
  "content": "{{anrede}},\n\nab 1. Jänner gelten neue Preise …",
  "delivery": "standard", "idempotency_key": "batch-2027-01"
}'

จดหมายทางอีเมล

ไม่ต้องเขียนโปรแกรม: ทุกบัญชีมีที่อยู่สำหรับสั่งงานส่วนตัว PDF ที่คุณส่งจากอีเมลของบัญชีมายังที่อยู่นี้จะถูกส่งออกเป็นจดหมาย

ไฟล์แนบ PDF แต่ละไฟล์ = จดหมายหนึ่งฉบับ ที่อยู่ในช่องหน้าต่าง (DIN 5008)
หัวเรื่องควบคุมตัวเลือก: Registered, Priority, Colour, Duplex, Ref: …, Country: …
“Enclosure” ในหัวเรื่อง: ทุกไฟล์จะรวมเป็นจดหมายฉบับเดียว
“Test” ในหัวเรื่อง: ตรวจสอบเท่านั้นและรับราคาทางอีเมล – ไม่มีการส่ง

ค่าสถานะ

endpoint สถานะ รายการ และการแจ้งเตือนทางอีเมลจะแสดงสถานะปัจจุบัน

`pending`	อยู่ในคิว
`processing`	กำลังพิมพ์และใส่ซอง
`mailed`	ส่งมอบให้ไปรษณีย์แล้ว
`failed`	ไม่ได้ส่ง
`cancelled`	ยกเลิกแล้ว
`undeliverable`	ส่งไม่ได้
`rejected`	ถูกปฏิเสธ