문서

메시지 발송

메시지 발송. 안전한 서버 연동을 위한 검증된 API 문서입니다.

하나의 글로벌 요금 발송 전 고객 확인 실제 수량 기준 과금

안전한 서버 연동을 위한 검증된 API 문서입니다. 인증 정보는 서버에만 보관됩니다.

현재 API 게이트웨이: https://sms-retail.io/

메시지 발송

+ 없이 국제 전화번호 형식을 사용합니다. 검증된 계약은 WhatsApp, Telegram, IMO, Viber를 지원하며 image_url은 WhatsApp에만 문서화되어 있습니다.

POST /ext/api/v1/messages/send
{
  "messages": [
    {"phone": "79001112233", "text": "Order confirmed", "type": "viber"},
    {"phone": "79004445566", "text": "Order shipped", "type": "imo"}
  ]
}

응답

{
  "success": true,
  "message": "Messages are being processed in the background.",
  "messages": [{"id": 10001, "phone": "79001112233"}]
}

캠페인 생성

POST /ext/api/v1/campaigns/send
{"name":"Order updates","message":"Your order is ready","phones":["79001112233"],"type":"viber"}

개인화 캠페인

메시지에 {f1}을 사용하고 수신자별 f1 값을 전달합니다.

POST /ext/api/v1/campaigns/send-variable
{"name":"Personal links","message":"Your link: {f1}","phones":[{"phone":"79001112233","f1":"https://example.com/a"}],"type":"viber"}