message-dispatcher
이메일 및 카카오톡 알림톡 통합 발송 관리
When & Why to Use This Skill
The Message Dispatcher skill is a robust multi-channel communication hub designed to automate and manage the delivery of emails and KakaoTalk notifications. By integrating SendGrid and Solapi, it allows Claude agents to handle transactional messaging, scheduled updates, and document distribution (like PDFs) with real-time status tracking and fallback options.
Use Cases
- Automated Customer Acknowledgments: Instantly send confirmation messages or 'Wish Ack' notifications via KakaoTalk and Email when a user submits a request.
- Scheduled Content Delivery: Programmatically schedule the dispatch of generated reports, PDF roadmaps, or newsletters to be sent at specific dates and times.
- Emergency Alerting: Trigger high-priority 'Red Alert' notifications across multiple channels to ensure immediate visibility for critical system events or urgent updates.
- Transactional Messaging with Attachments: Manage the delivery of magic links, receipts, and personalized documents with integrated tracking and delivery confirmation.
| name | message-dispatcher |
|---|---|
| description | 이메일 및 카카오톡 알림톡 통합 발송 관리 |
| version | 2.0.0 |
| trigger | "메시지 발송" |
| updated | 2025-12-30 |
Message Dispatcher 스킬
🎯 역할
생성된 콘텐츠를 소원이에게 발송:
- 이메일 발송: SendGrid 연동
- 카카오톡 발송: Solapi 알림톡
- 스케줄링: 예약 발송 관리
📥 입력
{
"recipient": {
"name": "소원이 이름",
"phone": "010-0000-0000",
"email": "sowoni@example.com"
},
"channel": "kakao|email|both",
"content": {
"type": "message|pdf|magic-link",
"body": "메시지 내용",
"attachments": []
},
"schedule": "2025-12-22T09:00:00+09:00"
}
📤 출력
{
"success": true,
"messageId": "msg_123456",
"channel": "kakao",
"sentAt": "2025-12-22T09:00:01+09:00",
"status": "delivered"
}
📡 발송 채널
카카오톡 (Solapi) ✅ 구현 완료
구현 파일: services/solapiService.js
채널 정보:
- 채널명: 하루하루의 기적
- 채널 ID: @dailymiracles
- URL: http://pf.kakao.com/_xfxhcWn
API 함수:
// 알림톡 발송
sendKakaoAlimtalk(to, templateId, variables)
// SMS 발송 (fallback)
sendSMS(to, text)
// 소원 ACK 발송 (통합)
sendWishAck(phone, wishData)
// RED 신호 긴급 알림
sendRedAlert(wishData)
환경변수:
SOLAPI_API_KEY= # Solapi API 키
SOLAPI_API_SECRET= # Solapi API 시크릿
SOLAPI_PFID= # 카카오 채널 ID
SENDER_PHONE=18996117 # 발신번호
SOLAPI_TEMPLATE_WISH_ACK= # 소원 ACK 템플릿 ID (승인 후)
CRO_PHONE= # RED 알림 수신자 (재미)
메시지 템플릿: config/messageTemplates.js
generateWishAckMessage()- 소원 접수 ACKgenerateRedAlertMessage()- RED 신호 긴급 알림
이메일 (SendGrid)
- HTML 템플릿
- PDF 첨부 가능
- 열람 추적
⚡ 속도 기준
- 목표: 3초
- 최대: 5초
🔗 의존
← wish-writer (메시지) ← roadmap-generator (PDF) → comi-orchestrator (발송 로그)