Przejdź do treści
SENDLY by ACTIOSENDLY by ACTIO
Документація

API, яке зрозумієте без читання PDF.

Усе потрібне, щоб надіслати перший SMS за 5 хвилин. Повна референція, готові бібліотеки, приклади в 5 мовах.

Quickstart

1. Створіть акаунт

Реєстрація через e-mail. 100 SMS безкоштовно на старт, без введення картки.

2. Згенеруйте Bearer Token

Панель → Налаштування → API → Згенерувати. Збережіть токен у безпечному місці.

3. Надішліть перший SMS

POST на /api/sms з payload JSON. Code samples нижче.

Endpoint: POST /api/sms

Основний endpoint надсилання. Приймає JSON, повертає message ID і статус. Idempotency Key опціональний.

Base URL

https://msg-api.actio.pl

Pola request

  • fromstringrequired

    Sender ID (алфавітно-цифровий до 11 символів або номер у форматі E.164).

  • tostringrequired

    Номер отримувача у форматі E.164 без '+' (напр. 48732129000).

  • bodystringrequired

    Текст SMS. UTF-8. Максимум 1530 символів (10 сегментів).

  • scheduled_atISO 8601

    Надсилання, заплановане в майбутньому.

  • idempotency_keystring

    UUID v4. Гарантує, що той самий запит надішле SMS лише раз.

curl -X POST https://msg-api.actio.pl/api/sms \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "FirmaXYZ",
    "to": "48732129000",
    "body": "Twój kod logowania: 482910"
  }'

Коди помилок

401
Unauthorized
Відсутній або недійсний Bearer Token.
402
Insufficient Credits
Немає коштів на акаунті. Поповніть у панелі.
422
Validation Error
Недійсний номер, задовгий body, неприпустимі символи в sender.
429
Rate Limit Exceeded
Забагато запитів. Дивіться заголовок Retry-After.
500
Internal Server Error
Проблема на нашому боці. Спробуйте за 30с. Якщо повторюється — напишіть.

Webhooks

Налаштовуєте URL у панелі. Надсилаємо POST з payload JSON при кожній зміні статусу SMS.

sms.deliveredSMS доставлено отримувачу.
sms.failedНевдала доставка — із зазначеним reason.
sms.expiredSMS не доставлено протягом 48 годин.
sms.bouncedНомер неактивний або недосяжний.
{
  "event": "sms.delivered",
  "message_id": "msg_01HQX7Z8RNQK5ZF8TBPNT2YFKA",
  "to": "48732129000",
  "delivered_at": "2026-05-15T14:23:47.291Z",
  "operator": "Orange Polska",
  "segments": 1
}

Почніть надсилати SMS вже сьогодні.

100 повідомлень безкоштовно. Без кредитної картки. Без абонплати. Активація за 30 секунд.

Створити безкоштовний акаунтЗв'язатися з нами