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.

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 60 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

Die Webhook-URL konfigurieren Sie im Kundenpanel. Wir senden ein POST (application/json) – ein Versuch, ohne Weiterleitungen zu folgen, ohne Authentifizierung, von der aktuellen IP-Adresse von api.sendly.link.

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

type: NOTIFICATIONStatusbestätigung – Feld status: DELIVERED oder ERROR.

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

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