Send a message

Verified API reference for secure server-side integration. Credentials stay server-side.

Current API gateway: https://sms-retail.io/

Use international phone format without +. The verified contract accepts WhatsApp, Telegram, IMO and Viber; image_url is documented only for WhatsApp.

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

Response

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

Create a campaign

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

Personalized campaign

Use {f1} in the message and provide f1 per recipient.

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