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

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

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

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 з поділом кожні 60 знаків; опційно 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

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

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

Webhooks

URL вебхука ви налаштовуєте в клієнтській панелі. Ми надсилаємо POST (application/json) — одна спроба, без переходу за редиректами й без авторизації, з поточної IP-адреси домену api.sendly.link.

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

type: NOTIFICATIONПідтвердження статусу — поле status: DELIVERED або ERROR.

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

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 секунд.

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