เซิร์ฟเวอร์ ManyMoney Messaging MCP
ภาพรวม
Anchor link toเซิร์ฟเวอร์ ManyMoney Messaging MCP เป็นส่วนที่ทำหน้าที่ส่งข้อความ ซึ่งทำงานคู่กับ เซิร์ฟเวอร์ ManyMoney AI MCP ในขณะที่เซิร์ฟเวอร์ ManyMoney AI MCP ช่วยคุณวางแผนและสร้างแคมเปญ เซิร์ฟเวอร์ Messaging MCP จะมอบพลังให้ AI agent ของคุณสามารถส่งข้อความได้จริง — ไม่ว่าจะเป็น push notifications, อีเมล, SMS, WhatsApp, Telegram, LINE, Kakao และอื่นๆ — ตามความต้องการ จากคำสั่งที่เป็นภาษาธรรมชาติ
เชื่อมต่อกับ Model Context Protocol (MCP) client ใดก็ได้ แล้ว agent ของคุณจะสามารถส่ง push ไปยัง segment หรือส่งอีเมลส่วนบุคคลไปยังผู้ใช้ที่ต้องการได้ทั้งหมดจากคำขอภาษาธรรมชาติเพียงคำขอเดียว
ช่องทางที่รองรับ
Anchor link to| ช่องทาง | ประเภทข้อความ |
|---|---|
| Push — iOS | การแจ้งเตือนมาตรฐาน, แบบเงียบ, และแบบสำคัญ, VoIP pushes, และ Live Activities |
| Push — Android | Push มาตรฐาน, รวมถึง Huawei และ Amazon Fire |
| Push — Web | Web push ใน Chrome, Firefox, Safari, และ Edge (Windows) |
| อีเมล | เนื้อหา HTML, เทมเพลต, ไฟล์แนบ, From/Reply-To ที่กำหนดเอง |
| SMS | ข้อความตัวอักษรผ่านแพลตฟอร์ม SMS ที่กำหนดค่าไว้ในบัญชีของคุณ |
| เทมเพลตที่ได้รับการอนุมัติจาก Meta สำหรับการส่งออก; ข้อความรูปแบบอิสระจะใช้ได้เฉพาะภายใน 24 ชั่วโมงหลังจากผู้ใช้ส่งข้อความถึงคุณก่อน | |
| Telegram | ข้อความตัวอักษรพร้อมตัวแปรเนื้อหา |
| LINE | ข้อความเนื้อหาและเทมเพลต |
| Kakao | ข้อความเนื้อหาและเทมเพลต |
วิธีการทำงาน
Anchor link to- เชื่อมต่อเซิร์ฟเวอร์ Messaging MCP กับ AI client ของคุณเพียงครั้งเดียว (ดู เชื่อมต่อเซิร์ฟเวอร์ MCP ด้านล่าง)
- ใน AI client ของคุณ เปิดแชทใหม่และอธิบายการส่งด้วยภาษาธรรมดา ระบุแอปพลิเคชัน, กลุ่มเป้าหมาย (segment หรือผู้ใช้ที่ต้องการ), ข้อความ, และเวลาที่จะส่งหากไม่ใช่การส่งทันที ดู สิ่งที่ต้องใส่ในคำขอของคุณ ด้านล่าง คุณไม่จำเป็นต้องสร้างคำขอ API หรือ JSON ด้วยตัวเอง
- เมื่อ agent พร้อมที่จะส่ง ให้ตรวจสอบรายละเอียดและอนุมัติการดำเนินการใน client ของคุณ
- หลังจากที่คุณอนุมัติ Pushwoosh จะส่งข้อความและส่งคืน รหัสข้อความ ใช้รหัสนี้ใน ประวัติข้อความ เพื่อค้นหาการส่งและติดตามการจัดส่งและสถิติ
สิ่งที่ agent ของคุณสามารถทำได้
Anchor link toหลังจากการตั้งค่า agent สามารถ:
- ส่งผ่านช่องทางที่รองรับ: push (iOS, Android, Web), อีเมล, SMS, WhatsApp, Telegram, LINE, หรือ Kakao
- เข้าถึง segment: ส่งข้อความถึงทุกคนใน segment
- เข้าถึงผู้ใช้ที่ต้องการ: ส่งไปยัง user ID หนึ่งรายหรือมากกว่าหลังจากเกิดเหตุการณ์ (อัปเดตคำสั่งซื้อ, รีเซ็ตรหัสผ่าน, และอื่นๆ)
- ตั้งเวลาการจัดส่ง: ส่งทันที, ในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาท้องถิ่นของผู้ใช้แต่ละคน
- ปรับแต่งเนื้อหาให้เป็นส่วนตัว: เติมค่าใน placeholder ของเทมเพลต เช่น
{{first_name}}หรือ{{promo_code}}ตามผู้รับแต่ละราย - นับการส่งเป็นส่วนหนึ่งของแคมเปญ: บอก agent ว่าจะใช้ รหัสแคมเปญ ใด การจัดส่งและการมีส่วนร่วมสำหรับการส่งนั้นจะแสดงภายใต้แคมเปญนั้นใน Control Panel
ดู ตัวอย่างคำขอในแชท ใน ส่งข้อความจาก AI client ของคุณ ด้านล่าง
AI client ที่เข้ากันได้
Anchor link toเซิร์ฟเวอร์ Messaging MCP ทำงานร่วมกับ client ที่เข้ากันได้กับ MCP ใดก็ได้ รวมถึง:
- Claude Desktop โดย Anthropic
- Cursor และ Windsurf
- Cline และ Continue
- Custom agents ที่สร้างขึ้นตามข้อกำหนดของ MCP
เชื่อมต่อเซิร์ฟเวอร์ MCP
Anchor link toขั้นตอนที่ 1. ตรวจสอบให้แน่ใจว่าคุณมีบัญชี Pushwoosh และ API token
Anchor link toเซิร์ฟเวอร์ Messaging MCP ยืนยันตัวตนด้วย Pushwoosh Server API token
ใน Pushwoosh Control Panel ไปที่ Settings → API Access, คลิก Generate New Token, เลือก Server, และบันทึก token คุณจะต้องเพิ่ม token นี้ลงในการกำหนดค่าของ client ในขั้นตอนถัดไป
Token จะสืบทอดสิทธิ์ของบัญชีของคุณ จำกัดสิทธิ์ให้เฉพาะแอปพลิเคชัน ที่คุณต้องการให้ agent ส่งข้อความผ่าน
ขั้นตอนที่ 2. เพิ่มเซิร์ฟเวอร์ไปยัง AI client ของคุณ
Anchor link toใช้ endpoint ต่อไปนี้:
https://manymoney-messaging.pushwoosh.com/mcpเพิ่มเซิร์ฟเวอร์ไปยังไฟล์กำหนดค่า Claude Desktop ของคุณ (claude_desktop_config.json):
{ "mcpServers": { "pushwoosh-messaging": { "url": "https://manymoney-messaging.pushwoosh.com/mcp", "headers": { "Authorization": "Token YOUR_API_TOKEN" } } }}รีสตาร์ท Claude Desktop หลังจากบันทึก
เพิ่มเซิร์ฟเวอร์ไปยัง .cursor/mcp.json ของคุณ (หรือไฟล์ที่เทียบเท่าใน Windsurf):
{ "mcpServers": { "pushwoosh-messaging": { "url": "https://manymoney-messaging.pushwoosh.com/mcp", "headers": { "Authorization": "Token YOUR_API_TOKEN" } } }}โหลด editor ใหม่หลังจากบันทึก
ชี้ client ของคุณไปที่ https://manymoney-messaging.pushwoosh.com/mcp และตั้งค่า header ของคำขอเป็น Authorization: Token YOUR_API_TOKEN โปรดดูเอกสารของ client ของคุณสำหรับการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลพร้อม header ที่กำหนดเอง
ขั้นตอนที่ 3. ลองใช้งาน
Anchor link toเปิดแชทใหม่ใน AI client ของคุณและถามคำถามที่เจาะจง:
“ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่ง push ไปยังอุปกรณ์ทดสอบของฉันด้วยหัวข้อ ‘สวัสดีจาก agent’ และเนื้อหา ‘นี่คือข้อความทดสอบ’”
ก่อนที่คุณจะอนุมัติการดำเนินการของ agent ให้ยืนยันกลุ่มเป้าหมายและเนื้อหาข้อความ
หากการเชื่อมต่อทำงานได้ agent จะส่งข้อความและส่งคืนรหัสข้อความของ Pushwoosh เช่น PW-12345-67890
ส่งข้อความจาก AI client ของคุณ
Anchor link toagent จะส่งข้อความหนึ่งข้อความต่อหนึ่งคำขอ
สิ่งที่ต้องใส่ในคำขอของคุณ
Anchor link toอธิบายรายละเอียดด้านล่างในแชทของคุณเพื่อให้ agent รู้ว่าต้องส่งอะไร, ใครควรได้รับ, และเมื่อไหร่ ใช้ภาษาธรรมดา (ตัวอย่างเช่น “แอป XXXXX-XXXXX”, “segment cart-abandonment”)
| สิ่งที่ต้องใส่ | คำอธิบาย |
|---|---|
application | รหัสแอปพลิเคชัน (XXXXX-XXXXX) |
platforms | รหัสช่องทาง ที่จะส่งผ่าน (push, อีเมล, SMS, ฯลฯ) |
target | รหัส Segment, นิพจน์ segment, หรือรายการ user, hwid, หรือ push token ที่ระบุอย่างชัดเจน (การกำหนดเป้าหมายแบบ transactional) |
message_payload | Push: หัวข้อและเนื้อหา, หรือ push preset, พร้อมเสียง, ป้าย, และการกระทำเมื่อเปิด (open action) ที่เป็นตัวเลือก อีเมล: หัวเรื่อง, เนื้อหา หรือ เทมเพลต, ไฟล์แนบ SMS และแอปส่งข้อความ: ข้อความตัวอักษรหรือเทมเพลตที่ได้รับอนุมัติ |
schedule | ส่งในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาของผู้ใช้ |
dynamic_content_placeholders | ค่าสำหรับ placeholder เช่น {{first_name}} หรือ {{promo_code}} |
campaign | รหัสแคมเปญ เพื่อระบุว่าข้อความนี้เป็นของแคมเปญใด |
frequency_capping | การจำกัดความถี่ จะจำกัดความถี่ที่ผู้ใช้แต่ละคนจะได้รับข้อความภายในช่วงเวลาที่กำหนด |
วิธีที่ agent ส่งข้อความ
Anchor link toagent ใช้เครื่องมือ Notify เพื่อสร้างและส่งข้อความหนึ่งข้อความ รองรับโหมดการกำหนดเป้าหมายสองโหมด:
| โหมด | ควรใช้เมื่อไหร่ |
|---|---|
| Segment | ส่งข้อความถึงผู้ใช้ทุกคนที่ตรงกับ segment หรือ นิพจน์ segment รองรับ การตั้งเวลา, การจำกัดความถี่, อัตราการส่ง, และ กลุ่มควบคุม |
| Transactional | ส่งไปยังรายชื่อที่ระบุของ users, hwids, หรือ push tokens เหมาะสำหรับข้อความที่ถูกทริกเกอร์หรือเป็นส่วนตัว |
ตัวอย่าง prompt
Anchor link toPush ไปยัง segment:
ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่ง push ไปยัง segmentcart-abandonmentบน iOS และ Androidหัวข้อ: “ยังคิดอยู่หรือเปล่า?” เนื้อหา: “ตะกร้าสินค้าของคุณกำลังรออยู่ นี่คือส่วนลด 10%”
ตั้งเวลาส่ง 15:00 น. ตามเขตเวลาท้องถิ่นของผู้ใช้แต่ละคน ใช้รหัสแคมเปญ
spring-promo
อีเมลถึงผู้ใช้หนึ่งราย:
ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่งอีเมลไปยังผู้ใช้uid-123โดยใช้เทมเพลตอีเมลwelcome-flow-v2พร้อมกับตั้งค่า placeholder{{first_name}}เป็น Alex
SMS ไปยัง segment:
ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่ง SMS ไปยัง segmentvip-usersด้วยเนื้อหา “ข้อเสนอสุดพิเศษของคุณจะสิ้นสุดในคืนนี้” ส่งทันที
Telegram ไปยัง segment:
ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่งข้อความ Telegram ไปยัง segmentsubscribers-monthlyด้วยเนื้อหา “สวัสดี{{first_name}}ใบแจ้งหนี้เดือนพฤษภาคมของคุณพร้อมแล้ว — ดาวน์โหลดได้จากบัญชีของคุณ” ตั้งเวลาส่งพรุ่งนี้เวลา 10:00 น. UTC
การยืนยันตัวตน
Anchor link toเซิร์ฟเวอร์ Messaging MCP รองรับวิธีการยืนยันตัวตนสามวิธี:
| วิธีการ | วิธีใช้ |
|---|---|
| API token | เพิ่ม Authorization: Token YOUR_API_TOKEN ในทุกคำขอ แนะนำสำหรับ agent และไปป์ไลน์อัตโนมัติ |
| Session token (SSO) | เพิ่ม Authorization: Bearer YOUR_SSO_TOKEN สำหรับการผสานรวมแบบโปรแกรมที่ใช้ Pushwoosh OAuth2 SSO เพื่อดำเนินการภายใต้เซสชันผู้ใช้ที่ระบุ ไม่จำเป็นสำหรับการตั้งค่า agent ทั่วไป — ให้ใช้ Server API token แทน |
| OAuth 2.0 (dynamic client registration) | สำหรับ MCP client ที่ใช้ ข้อกำหนดการอนุญาตของ MCP แทน header แบบคงที่ ขอบเขตจะสะท้อนเซสชัน Pushwoosh SSO ของผู้ใช้ที่เข้าสู่ระบบ (ไม่จำกัดเฉพาะแอปพลิเคชันที่ระบุ), access token มีอายุ 7 วัน, และ refresh token มีอายุ 30 วัน ดู ขั้นตอนการเข้าสู่ระบบ OAuth 2.0 ด้านล่าง |
คำขอที่ไม่มี token หรือ token ไม่ถูกต้องจะถูกปฏิเสธด้วย HTTP 401
ขั้นตอนการเข้าสู่ระบบ OAuth 2.0
Anchor link toClient ที่รองรับขั้นตอน OAuth ของข้อกำหนด MCP (ตัวอย่างเช่น การเข้าสู่ระบบเซิร์ฟเวอร์ระยะไกลของ Claude Desktop) ไม่จำเป็นต้องใช้ token ที่วางด้วยตนเอง — client จะค้นพบเซิร์ฟเวอร์การอนุญาต, ลงทะเบียนตัวเอง, และนำผู้ใช้ผ่านขั้นตอนการเข้าสู่ระบบ Pushwoosh SSO และการให้ความยินยอม:
- การค้นพบ (Discovery) Client จะดึงข้อมูลจาก
/.well-known/oauth-protected-resourceและ/.well-known/oauth-authorization-serverบนโฮสต์ของ MCP endpoint เพื่อค้นหา endpointauthorize,token, และregister - การลงทะเบียน client แบบไดนามิก (DCR) Client จะ
POSTไปยัง/registerเพื่อรับclient_idโดยไม่ต้องตั้งค่าใดๆ ใน Control Panel ด้วยตนเอง - การอนุญาตด้วย PKCE Client จะส่งผู้ใช้ไปยัง
/authorizeพร้อมกับcode_challengeโดยใช้code_challenge_method=S256PKCE เป็นข้อบังคับ — token endpoint จะไม่ยืนยันตัวตนของ client ด้วยวิธีอื่นใด ดังนั้นคำขอที่ไม่มี challenge S256 ที่ถูกต้องจะถูกปฏิเสธ - การเข้าสู่ระบบ Pushwoosh SSO และการให้ความยินยอม ผู้ใช้จะเข้าสู่ระบบผ่าน Pushwoosh SSO จากนั้นยืนยันการเข้าถึงของ client บนหน้าจอ
/oauth/consentก่อนที่จะมีการออกรหัสการอนุญาต - การแลกเปลี่ยน Token Client จะแลกเปลี่ยนรหัสและตัวตรวจสอบ PKCE ที่
/tokenเพื่อรับ access token จากนั้นส่งเป็นAuthorization: Bearerในคำขอ MCP
คุณไม่จำเป็นต้องกำหนดค่าสิ่งเหล่านี้ด้วยตัวเอง — จะมีความสำคัญก็ต่อเมื่อคุณกำลังแก้ไขปัญหา client ที่ใช้ขั้นตอนแตกต่างจากที่คาดไว้
เคล็ดลับและแนวทางปฏิบัติที่ดีที่สุด
Anchor link to- ตรวจสอบการส่งแต่ละครั้งอย่างรอบคอบก่อนอนุมัติเสมอ นี่คือการจัดส่งจริง และจะถูกส่งออกเมื่อคุณอนุมัติหรือตามเวลาที่กำหนด ตรวจสอบให้แน่ใจว่าแอป, กลุ่มเป้าหมาย, ช่องทาง, และข้อความใน client ตรงกับที่คุณตั้งใจไว้
- ใช้ Server API token เฉพาะสำหรับ agent สร้าง Server API token แยกต่างหากใน Settings → API Access และ จำกัดสิทธิ์ให้เฉพาะแอปพลิเคชัน ที่ agent ควรจะส่งจาก ด้วยวิธีนี้ การเข้าถึงของ agent จะถูกจำกัดไว้เฉพาะแอปเหล่านั้น
- ใช้การกำหนดเป้าหมายแบบ transactional สำหรับข้อความที่ถูกทริกเกอร์ เมื่อคุณส่งไปยัง user ID ที่รู้จักหลังจากเกิดเหตุการณ์ (จัดส่งคำสั่งซื้อ, รีเซ็ตรหัสผ่าน), ให้ใช้โหมด
transactionalพร้อมกับusers: [userId]อย่าสร้าง segment ที่มีคนเดียวสำหรับการส่งเดียวกัน ดู NotifyTransactional - ทดสอบบนอุปกรณ์ทดสอบก่อนการส่งครั้งใหญ่ ก่อนที่จะส่งไปยัง segment จริง ให้ขอให้ agent ส่งไปยัง อุปกรณ์ทดสอบที่ลงทะเบียนไว้ ของคุณก่อน ตัวอย่างเช่น: “ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่ง push ไปยังอุปกรณ์ทดสอบของฉันด้วยหัวข้อ ‘ทดสอบ’ และเนื้อหา ‘ตรวจสอบข้อความที่นี่’” การทำเช่นนี้จะส่งข้อความไปยังอุปกรณ์ที่คุณเพิ่มไว้ใน Settings → Test Devices เท่านั้น เมื่อตัวอย่างดูถูกต้องแล้ว ให้ขอส่งไปยัง segment หรือกลุ่มเป้าหมายจริง - ระบุชื่อแคมเปญในคำขอของคุณ รวม รหัสแคมเปญ ในแชท (ตัวอย่างเช่น
spring-promo) เพื่อให้ผลลัพธ์ปรากฏภายใต้แคมเปญที่ถูกต้องใน Pushwoosh Control Panel - ยืนยันก่อนส่งข้อความแบบ broadcast กำหนดค่า AI client ของคุณให้ขอการยืนยันอย่างชัดเจนก่อนอนุมัติการเรียกใช้เครื่องมือใดๆ ที่กำหนดเป้าหมายเป็น segment การส่งข้อความแบบ broadcast ไปยังกลุ่มเป้าหมายขนาดใหญ่ไม่สามารถย้อนกลับได้
- ใช้ placeholder สำหรับการปรับแต่งให้เป็นส่วนตัว ส่งค่าสำหรับ placeholder เช่น
{{first_name}}หรือ{{promo_code}}ในคำขอแชทของคุณ แทนที่จะสร้างข้อความแยกต่างหากสำหรับผู้ใช้แต่ละคน