Dokumentation

Eine API, die Sie ohne PDF-Lektüre verstehen.

Alles, was Sie brauchen, um Ihre erste SMS in 5 Minuten zu senden. Endpunkt, Request-Felder, Fehlercodes und Webhooks – mit Beispielen in 5 Sprachen.

API-Spezifikation als PDF v1.3 herunterladen

Quickstart

1. Konto erstellen

Registrierung per E-Mail. 100 SMS gratis zum Start, keine Kreditkarte erforderlich.

2. Bearer-Token generieren

Den Token generieren Sie im Kundenpanel (oder über den Kundenservice). Bewahren Sie ihn sicher auf.

3. Erste SMS senden

POST /api/sms mit JSON-Payload. Code-Beispiele unten.

Endpoint: POST /api/sms

Haupt-Sendeendpunkt. Bearer-Token-Autorisierung, JSON-Body (application/json). Gibt die Nachrichtenkennung zurück (message_id, 16 Hex-Zeichen).

Base URL

https://api.sendly.link

Request-Felder

tostring (9–11 Ziffern)erforderlich
Empfängernummer – numerische Zeichenkette, 9–11 Zeichen (z. B. 48732129001).
bodystringerforderlich
Nachrichtentext, min. 1 Zeichen. UCS-2-Kodierung, alle 67 Zeichen geteilt; optional GSM-7 (eine Nachricht, max. 160 Zeichen) – im Panel aktivierbar.
fromstring (9–11 Ziffern)
Optional. Die virtuelle Mobilnummer in SENDLY (numerische Zeichenkette, 9–11 Zeichen).

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

Antwort (200)

{ "message_id": "a906cff7719bd889" }

Massenversand: POST /api/sms-multi

Dieselbe Nachricht an mehrere Nummern (1 bis 100). Aktivierung ausschließlich über den Kundenservice. Alles-oder-nichts-Validierung – jede Nummer muss eine gültige polnische Mobilnummer sein und die Nummern müssen eindeutig sein; andernfalls wird die gesamte Anfrage abgelehnt. Die Antwort enthält ein message_ids-Array mit number + message_id-Paaren.

Base URL

https://api.sendly.link

Request-Felder

tostring[] (9–11 Ziffern, 1–100)erforderlich
Array von Empfängernummern – jeweils eine numerische Zeichenkette mit 9–11 Zeichen, 1 bis 100 Elemente, Nummern müssen eindeutig sein.
bodystringerforderlich
Nachrichtentext, min. 1 Zeichen.
fromstring (9–11 Ziffern)
Optional. Die virtuelle Mobilnummer in SENDLY (numerische Zeichenkette, 9–11 Zeichen).

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

Antwort (200)

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

Fehlercodes

403

Autorisierungsfehler

Fehlendes oder ungültiges Bearer-Token (Details in errors.token).

422

Validierungsfehler

Ungültige Daten – Details in errors.to / errors.body (und errors.from, falls angegeben). Jedes Feld ist ein Array von Meldungen.

429

Zu viele Anfragen

Zu viele Anfragen in kurzer Zeit – warten und erneut versuchen.

Webhooks

Sendly sendet Status und eingehende SMS nicht von allein. Im Panel (SMS-Gateway → Diensteinstellungen) aktivierst du die Zustellung und trägst eine öffentliche URL ein. Beide Schritte sind nötig. Danach senden wir POST application/json – bis zu 36 Versuche, ohne Redirects und ohne eigene Auth, von der aktuellen IP von api.sendly.link. 200 OK beendet die Wiederholungen; 404 und 418 ebenfalls.

Zustellung

Im Kundenpanel, SMS-Gateway → Diensteinstellungen, aktivierst du die Zustellung (Statusberichte zum Versand).

URL

Am selben Ort trägst du einen öffentlich erreichbaren Endpoint ein, der POST entgegennimmt.

Ohne beide Schritte – Zustellung aktivieren und URL eintragen – feuert der Webhook nicht. Es kommt weder DLR noch eingehende SMS.

Webhooks – bis zu 36 Zustellversuche

MESSAGE und NOTIFICATION werden erneut zugestellt, bis der Webhook mit 200 OK antwortet oder das Limit erreicht ist. Auch 404 (Not Found) und 418 (I’m A Teapot) beenden die Wiederholungen. Sendly folgt keinen Redirects und authentifiziert sich nicht am Webhook.

Bereich	Intervall
Benachrichtigungen 1–10	Jede Minute
Benachrichtigungen 11–20	Alle 3 Minuten
Benachrichtigungen 21–30	Alle 10 Minuten
Benachrichtigungen 31–35	Jede Stunde
Benachrichtigung 36	12 Stunden nach der letzten Benachrichtigung

type: MESSAGEEingehende Nachricht – Felder: from (Nummer oder Absender-ID), to, body.

type: NOTIFICATIONSendestatus – Felder: message_id und status: DELIVERED oder ERROR.

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

Checkliste: SMS API + Webhook

Konto angelegt und angemeldet auf app.sendly.link
Im Panel: SMS-Gateway → Diensteinstellungen → SMS API – aktiv
Bearer Token im Authorization-Header
Aufrufe an https://api.sendly.link/api/sms (oder /api/sms-multi)
Im Panel: Zustellung – aktiv
Im Panel: öffentliche Webhook-URL, die POST application/json entgegennimmt
Der Endpoint verarbeitet NOTIFICATION (Sendestatus) und MESSAGE (eingehende SMS)

Wie prüfe ich, ob eine SMS zugestellt wurde

Die Sendeantwort enthält message_id – speichere sie. Nach der Statusänderung sendet Sendly eine NOTIFICATION an deinen Webhook mit derselben message_id und DELIVERED oder ERROR. Damit ordnest du den Callback der Nachricht zu. So lässt sich jede ausgehende SMS verfolgen.

3CX SMS API

Ein alternativer Modus zum Senden und Empfangen von SMS, kompatibel mit der aktuellen Spezifikation des 3CX Phone System. Um ihn zu aktivieren, wählen Sie im Kundenpanel beide Optionen: SMS API und 3CX SMS API. Die Aktivierung kann auch der Kundenservice vornehmen.

Ausgehend

Geben Sie im SMS-Bereich in 3CX den im Kundenpanel generierten Token sowie die URL an: https://api.sendly.link/api/tcx

Eingehend

Geben Sie im Kundenpanel den in Ihrer 3CX-Anlage verfügbaren Webhook an (bei Aktivierung über den Kundenservice geben Sie den Webhook an und erhalten im Gegenzug einen Token).

Beginnen Sie heute mit dem SMS-Versand.

100 SMS gratis. Keine Kreditkarte. Kein Abo. Aktivierung in 30 Sekunden.

Kostenloses Konto erstellen Sprechen Sie mit uns