เซิร์ฟเวอร์ 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) ใดก็ได้ แล้ว agent ของคุณจะสามารถส่งพุชไปยัง segment หรือส่งอีเมลส่วนตัวไปยังผู้ใช้ที่ต้องการได้ ทั้งหมดนี้ทำได้จากคำขอภาษาธรรมชาติเพียงครั้งเดียว
ช่องทางที่รองรับ
Anchor link to| ช่องทาง | ประเภทข้อความ |
|---|---|
| Push — iOS | การแจ้งเตือนแบบมาตรฐาน, แบบเงียบ, และแบบสำคัญ, VoIP pushes, และ Live Activities |
| Push — Android | พุชมาตรฐาน, รวมถึง 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 ของคุณเพียงครั้งเดียว (ดู เชื่อมต่อเซิร์ฟเวอร์ MCP ด้านล่าง)
- ในไคลเอนต์ AI ของคุณ เปิดแชทใหม่และอธิบายการส่งด้วยภาษาธรรมดา ระบุแอปพลิเคชัน, กลุ่มเป้าหมาย (segment หรือผู้ใช้ที่ต้องการ), ข้อความ, และเวลาที่จะส่งหากไม่ใช่การส่งทันที ดู สิ่งที่ต้องระบุในคำขอของคุณ ด้านล่าง คุณไม่จำเป็นต้องสร้างคำขอ API หรือ JSON ด้วยตัวเอง
- เมื่อ agent พร้อมที่จะส่ง ให้ตรวจสอบรายละเอียดและอนุมัติการดำเนินการในไคลเอนต์ของคุณ
- หลังจากที่คุณอนุมัติ Pushwoosh จะส่งข้อความและส่งคืน message code ใช้รหัสนี้ใน Message history เพื่อค้นหาการส่งและติดตามการจัดส่งและสถิติ
สิ่งที่ agent ของคุณสามารถทำได้
Anchor link toหลังจากการตั้งค่า agent สามารถ:
- ส่งผ่านช่องทางที่รองรับได้ทุกช่องทาง: push (iOS, Android, Web), อีเมล, SMS, WhatsApp, Telegram, LINE, หรือ Kakao
- เข้าถึง segment: ส่งข้อความถึงทุกคนใน segment
- เข้าถึงผู้ใช้ที่ต้องการ: ส่งไปยัง user IDs หนึ่งรายหรือมากกว่าหลังจากเกิดเหตุการณ์ (เช่น อัปเดตคำสั่งซื้อ, รีเซ็ตรหัสผ่าน, และอื่นๆ)
- ตั้งเวลาการจัดส่ง: ส่งทันที, ในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาท้องถิ่นของผู้ใช้แต่ละคน
- ปรับแต่งเนื้อหาให้เป็นส่วนตัว: เติมค่าในตัวยึดตำแหน่งของเทมเพลต เช่น
{{first_name}}หรือ{{promo_code}}สำหรับผู้รับแต่ละราย - นับการส่งเป็นส่วนหนึ่งของแคมเปญ: บอก agent ว่าจะใช้ campaign code ใด การจัดส่งและการมีส่วนร่วมสำหรับการส่งนั้นจะแสดงภายใต้แคมเปญนั้นใน Control Panel
ดู ตัวอย่างคำขอแชท ใน ส่งข้อความจากไคลเอนต์ AI ของคุณ ด้านล่าง
ไคลเอนต์ AI ที่เข้ากันได้
Anchor link toเซิร์ฟเวอร์ Messaging MCP ทำงานร่วมกับไคลเอนต์ที่เข้ากันได้กับ 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 นี้ลงในไฟล์กำหนดค่าของไคลเอนต์ในขั้นตอนถัดไป
Token จะสืบทอดสิทธิ์ของบัญชีของคุณ จำกัดสิทธิ์ให้เข้าถึงเฉพาะแอปพลิเคชัน ที่คุณต้องการให้ agent ส่งข้อความได้
ขั้นตอนที่ 2. เพิ่มเซิร์ฟเวอร์ไปยังไคลเอนต์ AI ของคุณ
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" } } }}รีโหลดเอดิเตอร์หลังจากบันทึก
ชี้ไคลเอนต์ของคุณไปที่ https://messaging-api.svc-nue.pushwoosh.com/mcp และตั้งค่า request header Authorization: Token YOUR_API_TOKEN โปรดดูเอกสารประกอบของไคลเอนต์ของคุณสำหรับการเพิ่มเซิร์ฟเวอร์ MCP ระยะไกลพร้อม custom headers
ขั้นตอนที่ 3. ลองใช้งาน
Anchor link toเปิดแชทใหม่ในไคลเอนต์ AI ของคุณและถามคำถามที่เฉพาะเจาะจง:
“ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่งพุชไปยังอุปกรณ์ทดสอบของฉันด้วยหัวข้อ ‘สวัสดีจาก agent’ และเนื้อหา ‘นี่คือข้อความทดสอบ’”
ก่อนที่คุณจะอนุมัติการดำเนินการของ agent ให้ยืนยันกลุ่มเป้าหมายและเนื้อหาข้อความ
หากการเชื่อมต่อทำงานได้ agent จะส่งข้อความและส่งคืน Pushwoosh message code เช่น PW-12345-67890
ส่งข้อความจากไคลเอนต์ AI ของคุณ
Anchor link toAgent จะส่งข้อความหนึ่งข้อความต่อหนึ่งคำขอ
สิ่งที่ต้องระบุในคำขอของคุณ
Anchor link toอธิบายรายละเอียดด้านล่างในแชทของคุณเพื่อให้ agent รู้ว่าจะส่งอะไร, ใครควรได้รับ, และเมื่อไหร่ ใช้ภาษาธรรมดา (เช่น “แอป XXXXX-XXXXX”, “segment cart-abandonment”)
| สิ่งที่ต้องระบุ | คำอธิบาย |
|---|---|
application | Application code (XXXXX-XXXXX) |
platforms | Channel IDs ที่จะส่งผ่าน (push, email, SMS, ฯลฯ) |
target | Segment code, segment expression, หรือรายการ user, hwid, หรือ push token ที่ระบุอย่างชัดเจน (transactional targeting) |
message_payload | Push: หัวข้อและเนื้อหา, หรือ push preset, พร้อมเสียง, badge, และ open action ที่เป็นตัวเลือก Email: หัวเรื่อง, เนื้อหา หรือ template, ไฟล์แนบ SMS และ messengers: ข้อความหรือเทมเพลตที่ได้รับการอนุมัติ |
schedule | ส่งในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาของผู้ใช้ |
dynamic_content_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 เหมาะสำหรับข้อความที่ถูกทริกเกอร์หรือข้อความส่วนตัว |
ตัวอย่างคำสั่ง
Anchor link toพุชไปยัง segment:
ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่งพุชไปยัง segmentcart-abandonmentบน iOS และ Androidหัวข้อ: “ยังคิดอยู่หรือเปล่า?” เนื้อหา: “ตะกร้าสินค้าของคุณกำลังรออยู่ นี่คือส่วนลด 10%”
ตั้งเวลาส่ง 15:00 น. ตามเขตเวลาท้องถิ่นของผู้ใช้แต่ละคน ใช้ campaign code
spring-promo
อีเมลถึงผู้ใช้คนเดียว:
ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่งอีเมลไปยังผู้ใช้uid-123โดยใช้เทมเพลตอีเมลwelcome-flow-v2พร้อมตั้งค่าตัวยึดตำแหน่ง{{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 ในทุกคำขอ แนะนำสำหรับ agents และ pipelines อัตโนมัติ |
| Session token (SSO) | เพิ่ม Authorization: Bearer YOUR_SSO_TOKEN สำหรับการผสานรวมทางโปรแกรมที่ใช้ Pushwoosh OAuth2 SSO เพื่อดำเนินการภายใต้เซสชันผู้ใช้ที่ระบุ ไม่จำเป็นสำหรับการตั้งค่า agent ทั่วไป — ให้ใช้ Server API token แทน |
คำขอที่ไม่มี token หรือ token ไม่ถูกต้องจะถูกปฏิเสธด้วย HTTP 401
เคล็ดลับและแนวทางปฏิบัติที่ดีที่สุด
Anchor link to- ตรวจสอบการส่งแต่ละครั้งอย่างรอบคอบก่อนที่จะอนุมัติเสมอ นี่คือการจัดส่งจริง และจะถูกส่งออกเมื่อคุณอนุมัติหรือตามเวลาที่กำหนดไว้ ตรวจสอบให้แน่ใจว่าแอป, กลุ่มเป้าหมาย, ช่องทาง, และข้อความในไคลเอนต์ตรงกับที่คุณตั้งใจไว้
- ใช้ Server API token เฉพาะสำหรับ agent สร้าง Server API token แยกต่างหากใน Settings → API Access และ จำกัดสิทธิ์ให้เข้าถึงเฉพาะแอปพลิเคชัน ที่ agent ควรจะส่งจากได้ ด้วยวิธีนี้ การเข้าถึงของ agent จะถูกจำกัดอยู่แค่ในแอปเหล่านั้น
- ใช้ transactional targeting สำหรับข้อความที่ถูกทริกเกอร์ เมื่อคุณส่งไปยัง user ID ที่รู้จักหลังจากเกิดเหตุการณ์ (เช่น สินค้าถูกจัดส่ง, รีเซ็ตรหัสผ่าน) ให้ใช้โหมด
transactionalพร้อมกับusers: [userId]อย่าสร้าง segment สำหรับคนเดียวเพื่อการส่งเดียวกัน ดู NotifyTransactional - ทดสอบบนอุปกรณ์ทดสอบก่อนการส่งครั้งใหญ่ ก่อนที่จะส่งไปยัง segment จริง ให้ขอให้ agent ส่งไปยัง อุปกรณ์ทดสอบที่ลงทะเบียนไว้ ของคุณก่อน ตัวอย่างเช่น: “ในแอปพลิเคชัน
XXXXX-XXXXXให้ส่งพุชไปยังอุปกรณ์ทดสอบของฉันด้วยหัวข้อ ‘Test’ และเนื้อหา ‘Check text here’” การทำเช่นนี้จะส่งข้อความไปยังอุปกรณ์ที่คุณเพิ่มไว้ใน Settings → Test Devices เท่านั้น เมื่อตัวอย่างดูถูกต้องแล้ว ค่อยขอให้ส่งไปยัง segment หรือกลุ่มเป้าหมายจริง - ระบุชื่อแคมเปญในคำขอของคุณ รวม campaign code ในแชท (เช่น
spring-promo) เพื่อให้ผลลัพธ์ปรากฏภายใต้แคมเปญที่ถูกต้องใน Pushwoosh Control Panel - ยืนยันก่อนการส่งแบบ broadcast กำหนดค่าไคลเอนต์ AI ของคุณให้ขอการยืนยันอย่างชัดเจนก่อนที่จะอนุมัติการเรียกใช้เครื่องมือใดๆ ที่กำหนดเป้าหมายเป็น segment การส่งแบบ broadcast ไปยังกลุ่มเป้าหมายขนาดใหญ่ไม่สามารถย้อนกลับได้
- ใช้ตัวยึดตำแหน่งสำหรับการปรับแต่งส่วนบุคคล ส่งค่าสำหรับตัวยึดตำแหน่งเช่น
{{first_name}}หรือ{{promo_code}}ในคำขอแชทของคุณ แทนที่จะสร้างข้อความแยกต่างหากสำหรับผู้ใช้แต่ละคน