API & Integrationen

Integrationen und Plugins

Für WooCommerce, Shopware 6 und JTL-Shop 5 gibt es offizielle Plugins. Ohne Programmierung binden Sie auch Make, Zapier, n8n oder einen CSV-Import an; für alles andere steht die REST-API mit Beispielen in sechs Sprachen bereit. Bei der Anbindung helfen wir kostenlos.

Was fertig ist und wie Sie anbinden

Ihr System fehlt hier? Schreiben Sie an info@topsms.cz, beschreiben Sie, was Sie einsetzen, und wir schlagen Ihnen den einfachsten Weg vor. Weitere Konnektoren ergänzen wir nach Nachfrage.

WooCommerce: offizielles Plugin

TopSMS – SMS-Benachrichtigungen für WooCommerce ist das offizielle TopSMS-Plugin für WordPress und WooCommerce. Ihre Kunden erhalten eine SMS, wenn ihre Bestellung eingegangen ist, versandt oder storniert wird, und Sie erhalten eine SMS zu jeder neuen Bestellung. Ohne Programmierung: ZIP installieren, API-Schlüssel eintragen und die Bestellstatus aktivieren, die eine SMS auslösen sollen.

Was das Plugin kann

• SMS an den Kunden bei Änderung des Bestellstatus. Eingegangen, Zahlung ausstehend, in Bearbeitung, abgeschlossen (an den Versanddienstleister übergeben), storniert, erstattet, Zahlung fehlgeschlagen und eigene Status. Jeden Status aktivieren Sie einzeln und passen seinen Text an. Jeder Status wird einmal pro Bestellung gemeldet, auch wenn die Bestellung zwischen Status hin- und herwechselt.
• SMS an den Shop-Betreiber bei neuer Bestellung. Bestellnummer, Betrag, Kundenname und Zahlungsart direkt nach Abschluss des Checkouts.
• Vorlagen mit Platzhaltern. Bestellnummer, Name, Betrag mit Währung, Status, Zahlungs- und Versandart, Datum, Name und Adresse des Shops.
• Eigener Absendername. Ein für Ihr TopSMS-Kundenkonto freigegebener Absendername (Sender ID), andernfalls der Standardabsender „TopSMS“.
• Rufnummern automatisch normalisiert. Nummern wie „608 123 456“, „0905 123 456“ oder „00420…“ werden anhand des Rechnungslandes ins internationale Format umgewandelt.
• Der Checkout wartet nicht. Der Versand läuft im Hintergrund über den Action Scheduler, der Teil von WooCommerce ist.
• Überblick über jede Nachricht. Eine Bestellnotiz (auch bei einem Gateway-Fehler) und ein Protokoll der letzten Nachrichten unter WooCommerce → SMS log. Das Protokoll bereinigt sich nach der eingestellten Frist von selbst.
• Test direkt in den Einstellungen. Schaltflächen „Verbindung prüfen“ und „Test-SMS senden“.
• Unterstützt High-Performance Order Storage (HPOS), den klassischen und den Block-Checkout. Tschechische Lokalisierung inklusive.

Installation und Einrichtung in zwei Minuten

1. Laden Sie die Plugin-ZIP herunter (Version 1.0.2, 37 kB).
2. Öffnen Sie in WordPress Plugins → Installieren → Plugin hochladen, wählen Sie die ZIP-Datei aus und aktivieren Sie das Plugin. WooCommerce muss aktiv sein.
3. Erstellen Sie im TopSMS-Dashboard, Bereich API, einen API-Schlüssel mit den Berechtigungen send und read. Das Kundenkonto ist kostenlos, Sie zahlen nur die gesendeten SMS.
4. Öffnen Sie WooCommerce → Einstellungen → TopSMS, tragen Sie den Schlüssel in der Form clientId:secret ein und klicken Sie auf Verbindung prüfen. Daraufhin wird Ihr Guthaben angezeigt.
5. Aktivieren Sie die Bestellstatus, die eine SMS auslösen sollen (voreingestellt sind „in Bearbeitung“ und „abgeschlossen“), und passen Sie bei Bedarf die Texte an.
6. Optional aktivieren Sie die SMS bei neuer Bestellung an Ihre eigene Nummer und senden sich eine Test-SMS.

Das Plugin ist für das WordPress.org-Verzeichnis eingereicht; bis es die Prüfung durchlaufen hat, installieren Sie es aus der ZIP-Datei oben. Aktualisierungen veröffentlichen wir auf dieser Seite.

Vorlagen und Platzhalter

Standardtext für den Status „in Bearbeitung“:

{shop_name}: dekujeme, prijali jsme vasi objednavku {order_number} ({total}) a pripravujeme ji k odeslani.

• {order_number} Bestellnummer
• {first_name}, {last_name} Vor- und Nachname aus der Rechnungsadresse
• {total} Gesamtbetrag inklusive Währung, z. B. 49,90 €
• {status} Name des Bestellstatus
• {payment_method}, {shipping_method} Zahlungs- und Versandart
• {order_date} Bestelldatum
• {shop_name}, {site_url} Name und Adresse des Shops

Eine Nachricht ohne Sonderzeichen fasst 160 Zeichen pro SMS, eine Nachricht mit Unicode-Zeichen (etwa Emoji oder tschechischen Buchstaben) 70 Zeichen. Längerer Text wird in mehrere Teile aufgeteilt und jeder Teil einzeln berechnet, deshalb halten wir die Standardvorlagen kurz.

Eigener Absender und Preis

Ihre Kunden sehen als Absender den Namen Ihres Shops (3 bis 11 Zeichen ohne Sonderzeichen). Den Absendernamen (Sender ID) beantragen Sie im Dashboard; für tschechische und slowakische Netze geben die Netzbetreiber neue Absendernamen gesammelt frei, in der Regel etwa einmal im Monat, rechnen Sie mit rund 3 Wochen. Bis zur Freigabe lassen Sie das Feld leer, dann wird der Standardabsender „TopSMS“ verwendet.

Das Plugin ist kostenlos, eine Grundgebühr gibt es nicht. Sie zahlen nur die gesendeten SMS aus dem Guthaben Ihres TopSMS-Kundenkontos gemäß Preisliste; eine Test-SMS wird wie jede andere berechnet.

Für Entwickler

• Voraussetzungen: WordPress 6.5+, WooCommerce 8.0+, PHP 7.4+. Lizenz GPLv2 oder neuer.
• Versand über as_enqueue_async_action; ohne Action Scheduler wird synchron gesendet.
• Filter topsms_wc_recipient_phone, topsms_wc_message_text und topsms_wc_should_send (Empfänger, Text, Unterdrücken einer Nachricht), Action topsms_wc_sms_sent nach jedem Versuch.
• Gateway-Fehler erscheinen zusätzlich unter WooCommerce → Status → Protokolle (Quelle topsms).
• Das Plugin ruft die REST-API-Endpoints /api/sms/send und /api/credit auf. Übertragen werden die Rufnummer des Empfängers, der Nachrichtentext, der Absendername und die Shop-Adresse, sonst nichts.
• Sie möchten kein Plugin? Weiter unten finden Sie das Code-Snippet für die functions.php.

Download

topsms-sms-for-woocommerce-1.0.2.zip (37 kB), veröffentlicht am 8. 11. 2026, getestet mit WordPress 7.1 und WooCommerce 11.1.

Änderungen in 1.0.2: deutsche Übersetzung (de_DE) einschließlich der Standardvorlagen für SMS. Version 1.0.0 war die erste Version: Kundenbenachrichtigungen nach Bestellstatus, SMS an den Shop-Betreiber bei neuer Bestellung, Vorlagen mit Platzhaltern, Absendername, Normalisierung der Rufnummern, Versand im Hintergrund, Protokoll, Test-Schaltfläche, tschechische Lokalisierung.

Probleme bei der Einrichtung? Schreiben Sie an info@topsms.cz oder eröffnen Sie ein Ticket im Dashboard, wir helfen kostenlos.

WooCommerce ohne Plugin

Ein kurzes Snippet in der functions.php Ihres Child-Themes genügt; es ruft beim Abschluss einer Bestellung unsere REST-API auf:

add_action('woocommerce_order_status_completed', function ($order_id) {
  $order = wc_get_order($order_id);
  $phone = str_replace(' ', '', $order->get_billing_phone()); // idealne +420...
  wp_remote_post('https://www.topsms.cz/api/sms/send', array(
    'headers' => array(
      'Authorization' => 'Bearer VAS_CLIENT_ID:VAS_SECRET',
      'Content-Type'  => 'application/json',
    ),
    'body' => wp_json_encode(array(
      'to'   => $phone,
      'text' => 'Objednavka c. ' . $order->get_order_number() . ' byla vyrizena.',
      'from' => 'SenderID',
    )),
  ));
});

• Den API-Schlüssel erstellen Sie im Dashboard unter API-Zugang
• Dasselbe Prinzip funktioniert für weitere Bestellstatus, zum Beispiel woocommerce_order_status_processing
• Das Snippet passen wir kostenlos für Sie an, schreiben Sie uns einfach

Shopware 6: Plugin

TopSMS – SMS für Shopware ist unser Plugin für Shopware 6.6 und 6.7. Ihre Kunden erhalten eine SMS, wenn ihre Bestellung eingegangen ist und wenn sich Bestell-, Versand- oder Zahlungsstatus ändern, und Sie erhalten eine SMS zu jeder neuen Bestellung. Version 1.0.0 ist noch nicht im Shopware Store; Sie installieren sie aus der ZIP-Datei unten.

Was das Plugin kann

• SMS an den Kunden. Bestellstatus „Offen“ (direkt nach dem Checkout), „In Bearbeitung“, „Abgeschlossen“ und „Storniert“; Versandstatus „Versandt“ und „Teilweise versandt“ mit Sendungsnummer; Zahlungsstatus „Bezahlt“. Jedes Ereignis aktivieren Sie einzeln und passen seinen Text an. Jedes Ereignis wird pro Bestellung höchstens einmal gesendet.
• SMS an den Shopbetreiber bei neuer Bestellung. Bestellnummer, Betrag und Kundenname direkt nach dem Checkout.
• Rufnummern automatisch normalisiert. Die Nummer aus der Rechnungsadresse wird anhand des Rechnungslandes (Deutschland, Österreich, Schweiz, Tschechien, Slowakei und weitere) ins internationale Format umgewandelt: Aus „0151 2345678“ wird bei einer deutschen Bestellung +491512345678.
• Der Checkout wartet nicht. Der Versand läuft im Hintergrund über die Shopware Message Queue. Vorübergehende Gateway-Fehler werden wiederholt, ein Idempotency-Key verhindert doppelte SMS.
• Überblick über jede Nachricht. Das Ergebnis steht im Shopware-Log und im Zusatzfeld „Letzte SMS“ der Bestellung. Im Testmodus werden die Texte erzeugt und protokolliert, aber nicht gesendet.
• Alle Einstellungen lassen sich pro Verkaufskanal abweichend festlegen. Einstellungen und Hilfetexte auf Deutsch und Englisch.

Shopware: Installation und Einrichtung

1. Laden Sie TopSmsShopware-1.0.0.zip herunter (Version 1.0.0, 29 kB, veröffentlicht am 7. 11. 2026).
2. Öffnen Sie in der Shopware-Administration Erweiterungen → Meine Erweiterungen → Erweiterung hochladen, wählen Sie die ZIP-Datei und klicken Sie auf Installieren und Aktivieren.
3. Erstellen Sie im TopSMS-Dashboard, Bereich API, einen API-Schlüssel mit den Berechtigungen send und read.
4. Öffnen Sie die Plugin-Konfiguration (… → Konfigurieren), tragen Sie API Client ID und API Secret ein, optional Ihren Absendernamen, aktivieren Sie die gewünschten Ereignisse und passen Sie die Texte an. Mit dem Testmodus prüfen Sie die Texte zuerst, ohne zu senden.
5. Stellen Sie sicher, dass die Shopware Message Queue abgearbeitet wird (Worker messenger:consume oder Admin-Worker), wie für die E-Mails von Shopware.

Eine Schaltfläche „Verbindung testen“ in der Administration hat Version 1.0.0 noch nicht. Die Verbindung prüfen Sie über die API-Route POST /api/_action/topsms/test, die Ihr Guthaben zurückgibt; den Aufruf zeigt die README in der ZIP-Datei. Fragen: info@topsms.cz.

Shopware: Vorlagen und Platzhalter

Standardtext für „Lieferung versandt“ (pro Verkaufskanal änderbar):

{shopName}: Ihre Bestellung {orderNumber} wurde versandt. Sendungsnummer: {trackingCode}

• {orderNumber} Bestellnummer
• {firstName}, {lastName} Vor- und Nachname aus der Rechnungsadresse
• {amountTotal}, {currency} Gesamtbetrag und Währungscode, z. B. 49,90 EUR
• {shopName} Shopname aus den Stammdaten von Shopware
• {trackingCode} Sendungsnummer der Lieferung; fehlt sie, entfällt der Satz mit dem Platzhalter

Das Plugin überträgt für jede Nachricht die Rufnummer des Empfängers, den Nachrichtentext und den Absendernamen an TopSMS, sonst nichts. Das Plugin ist kostenlos (MIT-Lizenz); Sie zahlen nur die gesendeten SMS gemäß Preisliste.

JTL-Shop 5: Plugin

TopSMS - SMS-Benachrichtigungen ist unser Plugin für JTL-Shop 5 ab Version 5.2. Ihre Kunden erhalten eine SMS, wenn ihre Bestellung eingegangen ist und wenn JTL-Wawi Versand, Zahlungseingang oder Stornierung meldet, und Sie erhalten eine SMS zu jeder neuen Bestellung. Version 1.0.0 ist noch nicht im JTL-Extension-Store; Sie installieren sie aus der ZIP-Datei unten.

Was das Plugin kann

• SMS an den Kunden. „Bestellung eingegangen“ direkt nach dem Checkout; „Versandt“ mit Sendungsnummer, „Teilversandt“, „Zahlung eingegangen“ und „Storniert“, sobald JTL-Wawi die Änderung beim Abgleich an den Shop meldet. Jedes Ereignis aktivieren Sie einzeln und passen seinen Text an. Jedes Ereignis wird pro Bestellung höchstens einmal gesendet.
• SMS an den Shopbetreiber bei neuer Bestellung. Bestellnummer, Betrag und Kundenname direkt nach dem Checkout.
• Rufnummern automatisch normalisiert. Die Mobilnummer (sonst die Telefonnummer) aus der Rechnungsadresse wird anhand des Rechnungslandes (Deutschland, Österreich, Schweiz, Tschechien, Slowakei und weitere) ins internationale Format umgewandelt: Aus „0151 2345678“ wird bei einer deutschen Bestellung +491512345678.
• Checkout und Wawi-Abgleich warten nicht. Die SMS werden am Ende der Anfrage gesendet, mit 10 Sekunden Zeitlimit; ein Idempotency-Key pro Bestellung und Ereignis verhindert doppelte SMS.
• Überblick über jede Nachricht. Der Tab „Status“ des Plugins zeigt die letzten 30 SMS mit Ergebnis und hat eine Schaltfläche „Verbindung testen“, die Ihr Guthaben anzeigt. Fehler stehen zusätzlich im JTL-Logbuch. Im Testmodus werden die Texte erzeugt und protokolliert, aber nicht gesendet.

JTL-Shop: Installation und Einrichtung

1. Laden Sie topsms_sms-jtl-1.0.0.zip herunter (Version 1.0.0, 30 kB, veröffentlicht am 7. 11. 2026).
2. Öffnen Sie im JTL-Shop-Backend den Plugin-Manager, laden Sie die ZIP-Datei im Reiter Upload hoch und installieren Sie im Reiter Vorhanden das Plugin TopSMS - SMS-Benachrichtigungen.
3. Erstellen Sie im TopSMS-Dashboard, Bereich API, einen API-Schlüssel mit den Berechtigungen send und read.
4. Öffnen Sie im Reiter Aktiviert die Einstellungen des Plugins, tragen Sie API Client ID und API Secret ein, optional Ihren Absendernamen, aktivieren Sie die gewünschten Ereignisse und passen Sie die Texte an. Mit dem Testmodus prüfen Sie die ersten Bestellungen, ohne zu senden.
5. Klicken Sie im Tab Status auf Verbindung testen. Daraufhin wird Ihr Guthaben angezeigt.

Versand-, Zahlungs- und Storno-SMS löst der Abgleich mit JTL-Wawi aus. Ändern Sie einen Status nur im Shop-Backend, geht keine SMS hinaus. Fragen: info@topsms.cz.

JTL-Shop: Vorlagen und Platzhalter

Standardtext für „Versandt“:

{shopName}: Ihre Bestellung {orderNumber} wurde versandt. Sendungsnummer: {trackingCode}

• {orderNumber} Bestellnummer
• {firstName}, {lastName} Vor- und Nachname aus der Rechnungsadresse
• {amountTotal}, {currency} Gesamtbetrag und Währungscode, z. B. 49,90 EUR
• {shopName} Shopname aus den globalen Einstellungen von JTL-Shop oder ein eigener Wert in den Plugin-Einstellungen
• {trackingCode} Sendungsnummer aus JTL-Wawi; fehlt sie, entfällt der Satz mit dem Platzhalter

Alle Standardtexte passen mit üblichen Werten in eine SMS mit 160 Zeichen. Das Plugin überträgt für jede Nachricht die Rufnummer des Empfängers, den Nachrichtentext und den Absendernamen an TopSMS, sonst nichts. Das Plugin ist kostenlos; Sie zahlen nur die gesendeten SMS gemäß Preisliste.

Make, Zapier und n8n ohne Programmierung

Make: Wir haben eine offizielle App. Fügen Sie sie über diesen Link mit einem Klick zu Ihrem Make-Konto hinzu, geben Sie in der Verbindung Client-ID und Secret aus dem Dashboard (API-Schlüssel) ein und verwenden Sie im Szenario das Modul Send an SMS (oder Send Bulk SMS für bis zu 500 Nummern). Das Modul Watch Delivery Reports startet ein Szenario, wenn eine Nachricht zugestellt wird oder fehlschlägt: Seine Webhook-URL tragen Sie im Dashboard beim API-Schlüssel ein. Außerdem stehen Get a Message Status, Get Credit Balance und Make an API Call für beliebige Endpoints bereit.

Zapier und n8n (und Make ohne unsere App): Ein HTTP-Modul genügt. Bei einem Ereignis in Ihrem System (neue Bestellung, Statusänderung, überfällige Rechnung) ruft es unseren Endpoint auf:

POST https://www.topsms.cz/api/sms/send
Authorization: Bearer VAS_CLIENT_ID:VAS_SECRET
Content-Type: application/json

{
  "to": "+420601234567",
  "text": "Vase objednavka #1024 je na ceste",
  "from": "SenderID"
}

• Senden Sie die Rufnummer im internationalen Format (E.164, z. B. +49…); bei tschechischen Nummern ohne Ländervorwahl ergänzen wir die Vorwahl automatisch
• Den Zustellstatus erhalten Sie per Webhook oder durch Abfrage des Nachrichtenstatus
• Einmalige und Marketing-Nachrichten brauchen keine Automatisierung: Kontakte als CSV exportieren und in TopSMS als Massenkampagne senden

Webhooks und Verify API

Webhooks liefern den Zustellbericht jeder Nachricht per HTTP POST an Ihre URL (zugestellt, fehlgeschlagen, abgelaufen), mit HMAC-Signatur, sodass Sie den Status nicht abfragen müssen. Die Webhook-URL legen Sie im Dashboard je API-Schlüssel fest. Payload, Signaturprüfung und Wiederholungsversuche beschreibt die Dokumentation unter Webhooks.

Die Verify API sendet und prüft Einmalcodes (OTP) für Anmeldung, Registrierung oder Bestellbestätigung in zwei Aufrufen, inklusive Gültigkeitsdauer, Versuchslimit und Begrenzung pro Rufnummer. Details unter Verify API in der Dokumentation.

Tschechischer Markt: Shoptet, Fakturoid, iDoklad

Für den tschechischen Markt bereiten wir ein TopSMS-Add-on für Shoptet im Shoptet-Partnerprogramm vor (Seite auf Tschechisch); bis zu seiner Veröffentlichung binden Sie Shoptet über Make oder die REST-API an.

Die tschechischen Rechnungsdienste Fakturoid und iDoklad sind direkt angebunden: Sie verbinden das Konto im Dashboard, und zu überfälligen Rechnungen geht automatisch eine SMS-Mahnung (Seite auf Tschechisch).

ERP, CRM, Buchhaltung und weitere Shops

Für ERP-, CRM- und Buchhaltungssysteme sowie für Shop-Plattformen ohne Plugin (Shopify, PrestaShop, Magento) haben sich zwei Wege bewährt: ein regelmäßiger Export der betreffenden Datensätze (überfällige Rechnungen, Bestellungen, Termine) als CSV und der Massenversand mit Variablen (Rechnungsnummer, Betrag), oder die direkte Anbindung des Systems an die REST-API. Der Versand einer SMS ist eine einzige HTTP-Anfrage; jedes System, das eine URL aufrufen kann, bekommt das hin.

• CSV-Export und Massenversand: ohne Eingriff in Ihr System
• REST-API: eine POST-Anfrage, Beispiele für curl, PHP, Python, Node.js, C# und Java
• Beschreiben Sie uns Ihr System unter info@topsms.cz, wir schlagen Ihnen den einfachsten Weg vor

Kostenloses Konto anlegen

10 Test-SMS zum Start, keine Kreditkarte und keine Grundgebühr.

English · Česky · API-Dokumentation · Zur Startseite