# เซิร์ฟเวอร์ ManyMoney Messaging MCP
## ภาพรวม
เซิร์ฟเวอร์ ManyMoney Messaging MCP เป็นส่วนที่ใช้ในการส่งซึ่งทำงานคู่กับ [เซิร์ฟเวอร์ ManyMoney AI MCP](/th/product/pushwoosh-ai/manymoney-mcp-server/) ในขณะที่เซิร์ฟเวอร์ ManyMoney AI MCP ช่วยคุณวางแผนและสร้างแคมเปญ เซิร์ฟเวอร์ Messaging MCP จะมอบพลังให้ AI agent ของคุณสามารถ**ส่งข้อความได้จริง** — ไม่ว่าจะเป็น push notifications, อีเมล, SMS, WhatsApp, Telegram, LINE, Kakao และอื่นๆ — ตามความต้องการ จากคำสั่งที่เป็นภาษาธรรมชาติ
เชื่อมต่อกับ [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) client ใดก็ได้ แล้ว agent ของคุณจะสามารถส่ง push ไปยัง segment หรือส่งอีเมลส่วนตัวไปยังผู้ใช้ที่ต้องการได้ ทั้งหมดนี้ทำได้จากคำขอภาษาธรรมชาติเพียงคำขอเดียว
### ช่องทางที่รองรับ
| ช่องทาง | ประเภทข้อความ |
| --- | --- |
| **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 ที่กำหนดค่าไว้ในบัญชีของคุณ |
| **WhatsApp** | เทมเพลตที่ได้รับการอนุมัติจาก Meta สำหรับการส่งออก; ข้อความรูปแบบอิสระเฉพาะภายในหน้าต่าง 24 ชั่วโมงหลังจากผู้ใช้ส่งข้อความถึงคุณก่อน |
| **Telegram** | ข้อความตัวอักษรพร้อมตัวแปรเนื้อหา |
| **LINE** | ข้อความเนื้อหาและเทมเพลต |
| **Kakao** | ข้อความเนื้อหาและเทมเพลต |
### วิธีการทำงาน
1. เชื่อมต่อเซิร์ฟเวอร์ Messaging MCP กับ AI client ของคุณเพียงครั้งเดียว (ดู [เชื่อมต่อเซิร์ฟเวอร์ MCP](#connect-the-mcp-server) ด้านล่าง)
2. ใน AI client ของคุณ เปิดแชทใหม่และอธิบายการส่งด้วยภาษาธรรมดา ระบุแอปพลิเคชัน, กลุ่มเป้าหมาย (segment หรือผู้ใช้เฉพาะ), ข้อความ, และเวลาที่จะส่งหากไม่ใช่การส่งทันที ดู [สิ่งที่ต้องระบุในคำขอของคุณ](#what-to-include-in-your-request) ด้านล่าง คุณไม่จำเป็นต้องสร้างคำขอ API หรือ JSON ด้วยตัวเอง
3. เมื่อ agent พร้อมที่จะส่ง ให้ตรวจสอบรายละเอียดและอนุมัติการดำเนินการใน client ของคุณ
4. หลังจากที่คุณอนุมัติ Pushwoosh จะส่งข้อความและส่งคืน [message code](/th/developer/api-reference/api-identifiers/#message-code) ใช้รหัสนี้ใน [Message history](/th/product/statistics-and-analytics/message-history/) เพื่อค้นหาการส่งและติดตามการจัดส่งและสถิติ
### สิ่งที่ agent ของคุณทำได้
หลังจากการตั้งค่า agent สามารถ:
- **ส่งผ่านช่องทางที่รองรับ:** push (iOS, Android, Web), อีเมล, SMS, WhatsApp, Telegram, LINE, หรือ Kakao
- **เข้าถึง segment:** ส่งข้อความถึงทุกคนใน [segment](/th/product/audience-data-and-segmentation/segmentation/)
- **เข้าถึงผู้ใช้เฉพาะ:** ส่งไปยัง [user IDs](/th/developer/api-reference/api-identifiers/#user-id) หนึ่งรายหรือมากกว่าหลังจากเกิดเหตุการณ์ (เช่น การอัปเดตคำสั่งซื้อ, การรีเซ็ตรหัสผ่าน)
- **ตั้งเวลาการจัดส่ง:** ส่งทันที, ในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาท้องถิ่นของผู้ใช้แต่ละคน
- **ปรับแต่งเนื้อหา:** เติมค่าใน placeholder ของเทมเพลต เช่น `{{first_name}}` หรือ `{{promo_code}}` ตามผู้รับแต่ละราย
- **นับการส่งเป็นส่วนหนึ่งของแคมเปญ:** บอก agent ว่าจะใช้ [campaign code](/th/developer/api-reference/api-identifiers/#campaign-code) ใด การจัดส่งและการมีส่วนร่วมสำหรับการส่งนั้นจะแสดงภายใต้แคมเปญนั้นใน Control Panel
ดู [ตัวอย่างคำขอในแชท](#example-prompts) ใน [ส่งข้อความจาก AI client ของคุณ](#send-messages-from-your-ai-client) ด้านล่าง
### AI clients ที่เข้ากันได้
เซิร์ฟเวอร์ Messaging MCP ทำงานร่วมกับ client ที่เข้ากันได้กับ MCP ใดก็ได้ รวมถึง:
- **Claude Desktop** โดย Anthropic
- **Cursor** และ **Windsurf**
- **Cline** และ **Continue**
- **Custom agents** ที่สร้างขึ้นตามข้อกำหนดของ MCP
## เชื่อมต่อเซิร์ฟเวอร์ MCP
### ขั้นตอนที่ 1. ตรวจสอบให้แน่ใจว่าคุณมีบัญชี Pushwoosh และ API token
เซิร์ฟเวอร์ Messaging MCP ใช้ [Pushwoosh Server API token](/th/developer/api-reference/api-access-token/#server-api-token) ในการยืนยันตัวตน
ใน Pushwoosh Control Panel ไปที่ **Settings → API Access**, คลิก **Generate New Token**, เลือก **Server**, และบันทึก token คุณจะต้องเพิ่ม token นี้ในการกำหนดค่า client ในขั้นตอนถัดไป
Token จะสืบทอดสิทธิ์ของบัญชีของคุณ [จำกัดสิทธิ์ให้เฉพาะแอปพลิเคชัน](/th/developer/api-reference/api-access-token/#edit-token) ที่คุณต้องการให้ agent ส่งข้อความผ่าน
### ขั้นตอนที่ 2. เพิ่มเซิร์ฟเวอร์ไปยัง AI client ของคุณ
ใช้ endpoint ต่อไปนี้:
```
https://messaging-api.svc-nue.pushwoosh.com/mcp
```
เพิ่มเซิร์ฟเวอร์ไปยังไฟล์กำหนดค่า Claude Desktop ของคุณ (`claude_desktop_config.json`):
```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):
```json
{
"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. ลองใช้งาน
เปิดแชทใหม่ใน 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 ของคุณ
Agent จะส่งหนึ่งข้อความต่อหนึ่งคำขอ
### สิ่งที่ต้องระบุในคำขอของคุณ
อธิบายรายละเอียดด้านล่างในแชทของคุณเพื่อให้ agent รู้ว่าต้องส่งอะไร ใครควรได้รับ และเมื่อไหร่ ใช้ภาษาธรรมดา (ตัวอย่างเช่น "app XXXXX-XXXXX", "segment cart-abandonment")
| สิ่งที่ต้องระบุ | คำอธิบาย |
| --- | --- |
| `application` | [Application code](/th/developer/api-reference/api-identifiers/#application-code) (`XXXXX-XXXXX`) |
| `platforms` | [Channel IDs](/th/developer/api-reference/messaging-api-v2/notify/#platform-enum) ที่จะส่งผ่าน (push, email, SMS, etc.) |
| `target` | [Segment code](/th/developer/api-reference/api-identifiers/#segment--filter-code), [segment expression](/th/developer/api-reference/segmentation-filters-api/segmentation-language/), หรือรายการ [user](/th/developer/pushwoosh-knowledge-hub/users-userids/), [hwid](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid), หรือ [push token](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) ที่ระบุอย่างชัดเจน ([transactional targeting](/th/developer/api-reference/messaging-api-v2/notify/#notifytransactional)) |
| `message_payload` | **Push:** หัวข้อและเนื้อหา, หรือ [push preset](/th/product/content/push-presets/), พร้อมเสียง, badge, และ open action ที่เป็นตัวเลือก
**Email:** หัวเรื่อง, เนื้อหาหรือ [template](/th/product/content/email-content/), ไฟล์แนบ
**SMS and messengers:** ข้อความหรือเทมเพลตที่ได้รับอนุมัติ |
| `schedule` | ส่งในเวลาที่กำหนด, หลังจากหน่วงเวลา, หรือตามเขตเวลาของผู้ใช้ |
| `dynamic_content_placeholders` | ค่าสำหรับ placeholders เช่น `{{first_name}}` หรือ `{{promo_code}}` |
| `campaign` | [Campaign code](/th/developer/api-reference/api-identifiers/#campaign-code) เพื่อระบุว่าข้อความนี้เป็นของแคมเปญใด |
| `frequency_capping` | [Frequency capping](/th/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping) จำกัดความถี่ที่ผู้ใช้แต่ละคนจะได้รับข้อความภายในช่วงเวลาที่กำหนด |
### วิธีที่ agent ส่งข้อความ
Agent ใช้เครื่องมือ [`Notify`](/th/developer/api-reference/messaging-api-v2/notify/) เพื่อสร้างและส่งข้อความหนึ่งข้อความ รองรับโหมดการกำหนดเป้าหมายสองโหมด:
| โหมด | ใช้เมื่อไหร่ |
| --- | --- |
| **Segment** | ส่งข้อความถึงผู้ใช้ทั้งหมดที่ตรงกับ [segment](/th/product/audience-data-and-segmentation/segmentation/) หรือ [segment expression](/th/developer/api-reference/segmentation-filters-api/segmentation-language/) รองรับ [scheduling](/th/product/how-to-guides/how-to-schedule-a-message/), [frequency capping](/th/product/messaging-channels/global-frequency-capping/#enable-global-frequency-capping), [send rate](/th/product/messaging-channels/global-frequency-capping/#set-send-rate-limits), และ [control groups](/th/product/audience-data-and-segmentation/global-control-group/) |
| **Transactional** | ส่งไปยังรายการที่ระบุของ [users](/th/developer/pushwoosh-knowledge-hub/users-userids/), [hwids](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#hwid), หรือ [push tokens](/th/developer/pushwoosh-knowledge-hub/device-identifiers/#push-token) เหมาะสำหรับข้อความที่ถูกทริกเกอร์หรือข้อความส่วนบุคคล |
#### Example prompts
**Push to a segment:**
> In application `XXXXX-XXXXX`, send a push to the `cart-abandonment` segment 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 user `uid-123` using email template `welcome-flow-v2` with the placeholder `{{first_name}}` set to Alex.
**SMS to a segment:**
> In application `XXXXX-XXXXX`, send an SMS to segment `vip-users` with body "Your exclusive offer ends tonight." Send now.
**Telegram to a segment:**
> In application `XXXXX-XXXXX`, send a Telegram message to segment `subscribers-monthly` with body "Hi `{{first_name}}`, your May invoice is ready — download it from your account." Schedule it for tomorrow at 10:00 AM UTC.
## การยืนยันตัวตน
เซิร์ฟเวอร์ 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
## เคล็ดลับและแนวทางปฏิบัติที่ดีที่สุด
- **ตรวจสอบการส่งแต่ละครั้งอย่างรอบคอบก่อนที่จะอนุมัติ** นี่คือการจัดส่งจริง และจะถูกส่งออกเมื่อคุณอนุมัติหรือตามเวลาที่กำหนดไว้ ตรวจสอบให้แน่ใจว่าแอป, กลุ่มเป้าหมาย, ช่องทาง, และข้อความใน client ตรงกับที่คุณตั้งใจไว้
- **ใช้ Server API token เฉพาะสำหรับ agent** สร้าง [Server API token](/th/developer/api-reference/api-access-token/#server-api-token) แยกต่างหากใน **Settings → API Access** และ [จำกัดสิทธิ์ให้เฉพาะแอปพลิเคชัน](/th/developer/api-reference/api-access-token/#edit-token) ที่ agent ควรจะส่งจาก วิธีนี้จะทำให้การเข้าถึงของ agent ถูกจำกัดอยู่แค่ในแอปเหล่านั้น
- **ใช้ transactional targeting สำหรับข้อความที่ถูกทริกเกอร์** เมื่อคุณส่งไปยัง user ID ที่รู้จักหลังจากเกิดเหตุการณ์ (เช่น สินค้าถูกจัดส่ง, รีเซ็ตรหัสผ่าน) ให้ใช้โหมด `transactional` พร้อมกับ `users: [userId]` อย่าสร้าง segment สำหรับคนเดียวเพื่อการส่งเดียวกัน ดู [NotifyTransactional](/th/developer/api-reference/messaging-api-v2/notify/#notifytransactional)
- **ทดสอบบนอุปกรณ์ทดสอบก่อนการส่งครั้งใหญ่** ก่อนที่จะส่งไปยัง segment จริง ให้ขอให้ agent ส่งไปยัง [อุปกรณ์ทดสอบที่ลงทะเบียนไว้](/th/product/first-steps/start-with-your-project/test-your-integration/test-devices/) ของคุณก่อน ตัวอย่างเช่น: *"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](/th/developer/api-reference/api-identifiers/#campaign-code) ในแชท (ตัวอย่างเช่น `spring-promo`) เพื่อให้ผลลัพธ์ปรากฏภายใต้แคมเปญที่ถูกต้องใน Pushwoosh Control Panel
- **ยืนยันก่อนส่งแบบ broadcast** กำหนดค่า AI client ของคุณให้ขอการยืนยันอย่างชัดเจนก่อนที่จะอนุมัติการเรียกใช้เครื่องมือใดๆ ที่กำหนดเป้าหมายเป็น segment การส่งแบบ broadcast ไปยังกลุ่มเป้าหมายขนาดใหญ่ไม่สามารถย้อนกลับได้
- **ใช้ placeholders สำหรับการปรับแต่งส่วนบุคคล** ส่งค่าสำหรับ placeholders เช่น `{{first_name}}` หรือ `{{promo_code}}` ในคำขอแชทของคุณ แทนที่จะสร้างข้อความแยกสำหรับผู้ใช้แต่ละคน
## เกี่ยวข้อง