เซิร์ฟเวอร์ 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, Baidu, และ 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 จะส่งข้อความและส่งคืน message code ใช้รหัสนี้ใน Message history เพื่อค้นหาการส่งและติดตามการจัดส่งและสถิติ
สิ่งที่ agent ของคุณทำได้
Anchor link toหลังจากการตั้งค่า agent สามารถ:
- ส่งผ่านช่องทางที่รองรับ: push (iOS, Android, Web), อีเมล, SMS, WhatsApp, Telegram, LINE, หรือ Kakao
- เข้าถึง segment: ส่งข้อความถึงทุกคนใน segment
- เข้าถึงผู้ใช้เฉพาะ: ส่งไปยัง user IDs หนึ่งรายหรือมากกว่าหลังจากเกิดเหตุการณ์ (เช่น การอัปเดตคำสั่งซื้อ, การรีเซ็ตรหัสผ่าน)
- ตั้งเวลาการจัดส่ง: ส่งทันที, ในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาท้องถิ่นของผู้ใช้แต่ละคน
- ปรับแต่งเนื้อหา: เติมค่าใน placeholder ของเทมเพลต เช่น
{{first_name}}หรือ{{promo_code}}ตามผู้รับแต่ละราย - นับการส่งเป็นส่วนหนึ่งของแคมเปญ: บอก agent ว่าจะใช้ campaign code ใด การจัดส่งและการมีส่วนร่วมสำหรับการส่งนั้นจะแสดงภายใต้แคมเปญนั้นใน Control Panel
ดู ตัวอย่างคำขอในแชท ใน ส่งข้อความจาก AI client ของคุณ ด้านล่าง
AI clients ที่เข้ากันได้
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://messaging-api.svc-nue.pushwoosh.com/mcpเพิ่มเซิร์ฟเวอร์ไปยังไฟล์กำหนดค่า Claude Desktop ของคุณ (claude_desktop_config.json):
{ "mcpServers": { "pushwoosh-messaging": { "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp", "headers": { "Authorization": "Token YOUR_API_TOKEN" } } }}รีสตาร์ท Claude Desktop หลังจากบันทึก
เพิ่มเซิร์ฟเวอร์ไปยัง .cursor/mcp.json ของคุณ (หรือไฟล์ที่เทียบเท่าใน Windsurf):
{ "mcpServers": { "pushwoosh-messaging": { "url": "https://messaging-api.svc-nue.pushwoosh.com/mcp", "headers": { "Authorization": "Token YOUR_API_TOKEN" } } }}โหลด editor ใหม่หลังจากบันทึก
ชี้ client ของคุณไปที่ https://messaging-api.svc-nue.pushwoosh.com/mcp และตั้งค่า request header Authorization: Token YOUR_API_TOKEN โปรดดูเอกสารของ client ของคุณสำหรับการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลพร้อม custom headers
ขั้นตอนที่ 3. ลองใช้งาน
Anchor link toเปิดแชทใหม่ใน AI client ของคุณและถามคำถามที่เฉพาะเจาะจง:
“In application
XXXXX-XXXXX, send a push to my test devices with the title ‘Hello from the agent’ and body ‘This is a test message.’”
ก่อนที่คุณจะอนุมัติการดำเนินการของ agent ให้ยืนยันกลุ่มเป้าหมายและเนื้อหาข้อความ
หากการเชื่อมต่อทำงานได้ agent จะส่งข้อความและส่งคืน Pushwoosh message code เช่น PW-12345-67890
ส่งข้อความจาก AI client ของคุณ
Anchor link toAgent จะส่งหนึ่งข้อความต่อหนึ่งคำขอ
สิ่งที่ต้องระบุในคำขอของคุณ
Anchor link toอธิบายรายละเอียดด้านล่างในแชทของคุณเพื่อให้ agent รู้ว่าต้องส่งอะไร ใครควรได้รับ และเมื่อไหร่ ใช้ภาษาธรรมดา (ตัวอย่างเช่น “app XXXXX-XXXXX”, “segment cart-abandonment”)
| สิ่งที่ต้องระบุ | คำอธิบาย |
|---|---|
application | Application code (XXXXX-XXXXX) |
platforms | Channel IDs ที่จะส่งผ่าน (push, email, SMS, etc.) |
target | Segment code, segment expression, หรือรายการ user, hwid, หรือ push token ที่ระบุอย่างชัดเจน (transactional targeting) |
message_payload | Push: หัวข้อและเนื้อหา, หรือ push preset, พร้อมเสียง, badge, และ open action ที่เป็นตัวเลือก Email: หัวเรื่อง, เนื้อหาหรือ template, ไฟล์แนบ SMS and messengers: ข้อความหรือเทมเพลตที่ได้รับอนุมัติ |
schedule | ส่งในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาของผู้ใช้ |
dynamic_content_placeholders | ค่าสำหรับ placeholders เช่น {{first_name}} หรือ {{promo_code}} |
campaign | Campaign code เพื่อระบุว่าข้อความนี้เป็นของแคมเปญใด |
frequency_capping | Frequency capping จำกัดความถี่ที่ผู้ใช้แต่ละคนจะได้รับข้อความภายในช่วงเวลาที่กำหนด |
วิธีที่ agent ส่งข้อความ
Anchor link toAgent ใช้เครื่องมือ Notify เพื่อสร้างและส่งข้อความหนึ่งข้อความ รองรับโหมดการกำหนดเป้าหมายสองโหมด:
| โหมด | ใช้เมื่อไหร่ |
|---|---|
| Segment | ส่งข้อความถึงผู้ใช้ทั้งหมดที่ตรงกับ segment หรือ segment expression รองรับ scheduling, frequency capping, send rate, และ control groups |
| Transactional | ส่งไปยังรายการที่ระบุของ users, hwids, หรือ push tokens เหมาะสำหรับข้อความที่ถูกทริกเกอร์หรือข้อความส่วนบุคคล |
Example prompts
Anchor link toPush to a segment:
In application
XXXXX-XXXXX, send a push to thecart-abandonmentsegment on iOS and Android.Title: “Still thinking it over?” Body: “Your cart is waiting, here’s 10% off.”
Schedule for 3 PM in each user’s local timezone. Use campaign code
spring-promo.
Email to one user:
In application
XXXXX-XXXXX, send an email to useruid-123using email templatewelcome-flow-v2with the placeholder{{first_name}}set to Alex.
SMS to a segment:
In application
XXXXX-XXXXX, send an SMS to segmentvip-userswith body “Your exclusive offer ends tonight.” Send now.
Telegram to a segment:
In application
XXXXX-XXXXX, send a Telegram message to segmentsubscribers-monthlywith body “Hi{{first_name}}, your May invoice is ready — download it from your account.” Schedule it for tomorrow at 10:00 AM UTC.
การยืนยันตัวตน
Anchor link toเซิร์ฟเวอร์ Messaging MCP รองรับวิธีการยืนยันตัวตนสองวิธี:
| วิธีการ | วิธีใช้ |
|---|---|
| API token | เพิ่ม Authorization: Token YOUR_API_TOKEN ในทุกคำขอ แนะนำสำหรับ agents และ pipelines อัตโนมัติ |
| Session token (SSO) | เพิ่ม Authorization: Bearer YOUR_SSO_TOKEN สำหรับการผสานรวมแบบโปรแกรมที่ใช้ Pushwoosh OAuth2 SSO เพื่อดำเนินการภายใต้เซสชันผู้ใช้ที่เฉพาะเจาะจง ไม่จำเป็นสำหรับการตั้งค่า agent ทั่วไป — ให้ใช้ Server API token แทน |
คำขอที่ไม่มี token หรือ token ไม่ถูกต้องจะถูกปฏิเสธด้วย HTTP 401
เคล็ดลับและแนวทางปฏิบัติที่ดีที่สุด
Anchor link to- ตรวจสอบการส่งแต่ละครั้งอย่างรอบคอบก่อนที่จะอนุมัติ นี่คือการจัดส่งจริง และจะถูกส่งออกเมื่อคุณอนุมัติหรือตามเวลาที่กำหนดไว้ ตรวจสอบให้แน่ใจว่าแอป, กลุ่มเป้าหมาย, ช่องทาง, และข้อความใน client ตรงกับที่คุณตั้งใจไว้
- ใช้ Server API token เฉพาะสำหรับ agent สร้าง Server API token แยกต่างหากใน Settings → API Access และ จำกัดสิทธิ์ให้เฉพาะแอปพลิเคชัน ที่ agent ควรจะส่งจาก วิธีนี้จะทำให้การเข้าถึงของ agent ถูกจำกัดอยู่แค่ในแอปเหล่านั้น
- ใช้ transactional targeting สำหรับข้อความที่ถูกทริกเกอร์ เมื่อคุณส่งไปยัง user ID ที่รู้จักหลังจากเกิดเหตุการณ์ (เช่น สินค้าถูกจัดส่ง, รีเซ็ตรหัสผ่าน) ให้ใช้โหมด
transactionalพร้อมกับusers: [userId]อย่าสร้าง segment สำหรับคนเดียวเพื่อการส่งเดียวกัน ดู NotifyTransactional - ทดสอบบนอุปกรณ์ทดสอบก่อนการส่งครั้งใหญ่ ก่อนที่จะส่งไปยัง segment จริง ให้ขอให้ agent ส่งไปยัง อุปกรณ์ทดสอบที่ลงทะเบียนไว้ ของคุณก่อน ตัวอย่างเช่น: “In application
XXXXX-XXXXX, send a push to my test devices with title ‘Test’ and body ‘Check text here.’” วิธีนี้จะส่งข้อความไปยังอุปกรณ์ที่คุณเพิ่มไว้ใน Settings → Test Devices เท่านั้น เมื่อตัวอย่างดูถูกต้องแล้ว ค่อยขอส่งไปยัง segment หรือกลุ่มเป้าหมายจริง - ระบุแคมเปญในคำขอของคุณ รวม campaign code ในแชท (ตัวอย่างเช่น
spring-promo) เพื่อให้ผลลัพธ์ปรากฏภายใต้แคมเปญที่ถูกต้องใน Pushwoosh Control Panel - ยืนยันก่อนส่งแบบ broadcast กำหนดค่า AI client ของคุณให้ขอการยืนยันอย่างชัดเจนก่อนที่จะอนุมัติการเรียกใช้เครื่องมือใดๆ ที่กำหนดเป้าหมายเป็น segment การส่งแบบ broadcast ไปยังกลุ่มเป้าหมายขนาดใหญ่ไม่สามารถย้อนกลับได้
- ใช้ placeholders สำหรับการปรับแต่งส่วนบุคคล ส่งค่าสำหรับ placeholders เช่น
{{first_name}}หรือ{{promo_code}}ในคำขอแชทของคุณ แทนที่จะสร้างข้อความแยกสำหรับผู้ใช้แต่ละคน