Документація

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

Усе, що потрібно, щоб надіслати перший SMS за 5 хвилин. Ендпоінт, поля запиту, коди помилок і вебхуки — з прикладами 5 мовами.

Завантажити специфікацію PDF v1.3

Quickstart

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

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

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

Токен ви згенеруєте в клієнтській панелі (або через службу підтримки). Зберігайте його в безпечному місці.

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

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

Endpoint: POST /api/sms

Основний ендпоінт надсилання. Авторизація Bearer token, тіло JSON (application/json). Повертає ідентифікатор повідомлення (message_id, 16 hex-знаків).

Base URL

https://api.sendly.link

Поля запиту

tostring (9–11 цифр)обов'язкове
Номер отримувача — числовий рядок 9–11 знаків (напр. 48732129001).
bodystringобов'язкове
Текст повідомлення, мін. 1 знак. Кодування UCS-2 з поділом кожні 67 знаків; опційно GSM-7 (одне повідомлення, макс. 160 знаків) — вмикається в панелі.
fromstring (9–11 цифр)
Опційне. Віртуальний мобільний номер у SENDLY (числовий рядок 9–11 знаків).

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

Відповідь (200)

{ "message_id": "a906cff7719bd889" }

Масова розсилка: POST /api/sms-multi

Те саме повідомлення на кілька номерів (від 1 до 100). Активація лише через службу підтримки. Валідація «все або нічого» — кожен номер має бути коректним польським мобільним номером, а номери мають бути унікальними; інакше весь запит відхиляється. У відповіді — масив message_ids з парами number + message_id.

Base URL

https://api.sendly.link

Поля запиту

tostring[] (9–11 цифр, 1–100)обов'язкове
Масив номерів отримувачів — кожен числовий рядок 9–11 знаків, від 1 до 100 елементів, номери унікальні.
bodystringобов'язкове
Текст повідомлення, мін. 1 знак.
fromstring (9–11 цифр)
Опційне. Віртуальний мобільний номер у SENDLY (числовий рядок 9–11 знаків).

curl -X POST https://api.sendly.link/api/sms-multi \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "to": ["48732129001", "48732129002"],
    "body": "Test SENDLY"
  }'

Відповідь (200)

{
  "message_ids": [
    { "number": "48732129001", "message_id": "a906cff7719bd889" }
  ]
}

Коди помилок

403

Помилка авторизації

Відсутній або недійсний Bearer Token (деталі в errors.token).

422

Помилка валідації

Некоректні дані — деталі в errors.to / errors.body (та errors.from, якщо вказано). Кожне поле є масивом повідомлень.

429

Забагато запитів

Забагато запитів за короткий час — зачекайте та повторіть.

Вебхуки

Sendly не надсилає статуси й вхідні SMS самостійно. У панелі (Шлюз SMS → Налаштування послуги) вмикаєте доставку і вписуєте публічний URL. Обидва кроки обов'язкові. Далі надсилаємо POST application/json – до 36 спроб, без редиректів і без власної авторизації, з поточної IP api.sendly.link. Відповідь 200 OK завершує повтори; 404 і 418 також їх припиняють.

Доставка

У клієнтській панелі, розділ Шлюз SMS → Налаштування послуги, активуйте опцію доставки (звіти статусу відправлення).

URL

У тому самому місці впишіть загальнодоступний ендпоінт, який приймає POST.

Без обох кроків – активації доставки і введення адреси – вебхук не спрацює. Не буде ні DLR, ні вхідного SMS.

Повторні спроби вебхука – до 36

Виклики MESSAGE і NOTIFICATION повторюються, доки вебхук не відповість 200 OK або не буде вичерпано ліміт. Коди 404 (Not Found) і 418 (I’m A Teapot) також припиняють повтори. Sendly не переходить за редиректами й не авторизується на вебхуку.

Діапазон	Інтервал
Сповіщення 1–10	Щохвилини
Сповіщення 11–20	Кожні 3 хвилини
Сповіщення 21–30	Кожні 10 хвилин
Сповіщення 31–35	Щогодини
Сповіщення 36	Через 12 годин після попереднього сповіщення

type: MESSAGEВхідне повідомлення — поля: from (номер або підпис), to, body.

type: NOTIFICATIONСтатус відправлення – поля: message_id і status: DELIVERED або ERROR.

{
  "type": "NOTIFICATION",
  "message_id": "a906cff7719bd889",
  "status": "DELIVERED"
}

Чекліст: SMS API + вебхук

Обліковий запис створено і ви ввійшли на app.sendly.link
У панелі: Шлюз SMS → Налаштування послуги → SMS API – увімкнено
Згенерований Bearer Token у заголовку Authorization
Виклики на https://api.sendly.link/api/sms (або /api/sms-multi)
У панелі: опція доставки – увімкнена
У панелі: публічний URL вебхука, який приймає POST application/json
Ендпоінт обробляє NOTIFICATION (статус відправлення) і MESSAGE (вхідний SMS)

Як перевірити, чи SMS доставлено

Під час надсилання API повертає message_id – збережіть його. Після зміни статусу Sendly надсилає на вебхук NOTIFICATION з тим самим message_id і статусом DELIVERED або ERROR. Так зіставляєте колбек із конкретним повідомленням. Так можна відстежувати кожен надісланий SMS.

3CX SMS API

Альтернативний режим надсилання та отримання SMS, сумісний з актуальною специфікацією АТС 3CX Phone System. Щоб увімкнути його, у клієнтській панелі позначте обидві опції: SMS API та 3CX SMS API. Активацію також може виконати служба підтримки.

Вихідні

У розділі SMS у 3CX вкажіть токен, згенерований у клієнтській панелі, та адресу URL: https://api.sendly.link/api/tcx

Вхідні

У клієнтській панелі вкажіть вебхук, доступний у вашій АТС 3CX (у разі активації через службу підтримки ви вказуєте вебхук і у відповідь отримуєте токен).

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

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

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