Dokumentacja

API, które rozumiesz bez czytania PDF-a.

Wszystko, czego potrzeba, żeby wysłać pierwszego SMS-a w 5 minut. Endpoint, pola żądania, kody błędów i webhooki – z przykładami w 5 językach.

Quickstart

1. Załóż konto

Rejestracja przez e-mail. 100 SMS gratis na start, bez podawania karty.

2. Wygeneruj Bearer Token

Token wygenerujesz w panelu klienta (lub przez biuro obsługi klienta). Zapisz go w bezpiecznym miejscu.

3. Wyślij pierwszy SMS

POST na /api/sms z payloadem JSON. Code samples niżej.

Endpoint: POST /api/sms

Główny endpoint wysyłki. Autoryzacja Bearer token, treść JSON (application/json). W odpowiedzi zwraca identyfikator wiadomości (message_id, 16 znaków hex).

Base URL

https://api.sendly.link

Pola request

tostring (9–11 cyfr)wymagane
Numer odbiorcy – numeryczny łańcuch 9–11 znaków (np. 48732129001).
bodystringwymagane
Treść wiadomości, min. 1 znak. Kodowanie UCS-2 dzielone co 60 znaków; opcjonalnie GSM-7 (jedna wiadomość, maks. 160 znaków) – do włączenia w panelu.
fromstring (9–11 cyfr)
Opcjonalne. Numer wirtualnego numeru komórkowego w SENDLY (numeryczny łańcuch 9–11 znaków).

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"
  }'

Odpowiedź (200)

{ "message_id": "a906cff7719bd889" }

Wysyłka masowa: POST /api/sms-multi

Ta sama wiadomość na wiele numerów (od 1 do 100). Aktywacja wyłącznie przez biuro obsługi klienta. Walidacja „wszystko albo nic" – każdy numer musi być poprawnym polskim numerem komórkowym, a numery muszą być unikalne; inaczej całe żądanie zostaje odrzucone. W odpowiedzi tablica message_ids z parami number + message_id.

Base URL

https://api.sendly.link

Pola request

tostring[] (9–11 cyfr, 1–100)wymagane
Tablica numerów odbiorców – każdy numeryczny łańcuch 9–11 znaków, od 1 do 100 elementów, numery unikalne.
bodystringwymagane
Treść wiadomości, min. 1 znak.
fromstring (9–11 cyfr)
Opcjonalne. Numer wirtualnego numeru komórkowego w SENDLY (numeryczny łańcuch 9–11 znaków).

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"
  }'

Odpowiedź (200)

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

Kody błędów

403

Błąd autoryzacji

Brak lub nieprawidłowy Bearer Token (szczegóły w errors.token).

422

Błąd walidacji

Nieprawidłowe dane – szczegóły w errors.to / errors.body (oraz errors.from, jeśli podano). Każde pole to tablica komunikatów.

429

Przekroczono limit żądań

Zbyt wiele żądań w krótkim czasie – odczekaj i ponów.

Webhooki

Adres webhooka konfigurujesz w panelu klienta. Wysyłamy POST (application/json) – jedna próba, bez śledzenia przekierowań i bez autoryzacji, z aktualnego adresu IP domeny api.sendly.link.

type: MESSAGEWiadomość przychodząca – pola: from (numer lub nadpis), to, body.

type: NOTIFICATIONPotwierdzenie statusu – pole status: DELIVERED (dostarczono) lub ERROR (błąd).

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

3CX SMS API

Alternatywny tryb wysyłki i odbioru SMS zgodny z aktualną specyfikacją centrali 3CX Phone System. Aby go włączyć, w panelu klienta zaznacz obie opcje: SMS API oraz 3CX SMS API. Aktywacji może dokonać także biuro obsługi klienta.

Wychodzące

W sekcji SMS w 3CX podaj token wygenerowany w panelu klienta oraz adres URL: https://api.sendly.link/api/tcx

Przychodzące

W panelu klienta podaj webhook dostępny w centrali 3CX (przy aktywacji przez biuro obsługi klienta podajesz webhook, a w odpowiedzi otrzymujesz token).

Zacznij wysyłać SMS-y dzisiaj.

100 wiadomości gratis. Bez karty kredytowej. Bez abonamentu. Aktywacja w 30 sekund.

Załóż darmowe konto Porozmawiaj z nami