SMS per API und Webhooks empfangen

Aktivieren Sie den API-Zugriff in Ihrem Profil, erzeugen Sie ein Token und rufen Sie damit die API auf. Damit eingehende SMS an Ihren Server gesendet werden, tragen Sie im selben Tab eine Webhook-URL ein.

Aktualisiert 2 Min. Lesezeit

Sie können Ihre Nachrichten lesen und Nummern aus Ihrem eigenen Code verwalten. Neue SMS erhalten Sie auf zwei Wegen: Sie fragen die API danach ab, oder ein Webhook sendet jede SMS an Ihren Server, sobald sie ankommt.

API-Token erzeugen

  1. Schritt 1. Den Tab API öffnen

    Gehen Sie zu Profile und öffnen Sie den Tab API.

    Den Tab API öffnen. Gehen Sie zu Profile und öffnen Sie den Tab API.
  2. Schritt 2. API-Zugriff aktivieren

    Stellen Sie API access auf Enabled. Mit demselben Schalter sperren Sie den gesamten API-Zugriff, falls Sie das einmal brauchen.

  3. Schritt 3. Token erzeugen

    Klicken Sie unter Personal access token auf Generate token. Das Token wird nur einmal angezeigt, kopieren Sie es also und bewahren Sie es sicher auf. Regenerate token stellt ein neues aus und widerruft das vorherige.

  4. Schritt 4. Die API aufrufen

    Senden Sie das Token als Bearer-Token im Header Authorization. Die Basis-URL und ein fertiges curl-Beispiel finden Sie im selben Tab.

Alle Aufrufe, Parameter und Antworten stehen in der API-Dokumentation.

SMS per Webhook empfangen

Bei einem Webhook senden wir eine POST-Anfrage an Ihren Server, wenn etwas passiert, sodass Sie nicht abfragen müssen. Sobald der API-Zugriff aktiv ist, erscheint darunter im selben Tab der Bereich Webhooks.

  1. Schritt 1. URL eintragen

    Füllen Sie Webhook URL aus, eine Adresse auf Ihrem Server, die innerhalb von 10 Sekunden mit einem 2xx-Status antwortet. Verwenden Sie möglichst https, denn bei einfachem http werden SMS-Text und Codes unverschlüsselt übertragen.

    URL eintragen. Füllen Sie Webhook URL aus, eine Adresse auf Ihrem Server, die innerhalb von 10 Sekunden mit einem 2xx-Status antwortet. Verwenden Sie möglichst https, denn bei einfachem http werden SMS-Text und Codes unverschlüsselt übertragen.
  2. Schritt 2. Ereignisse auswählen

    Wählen Sie aus New SMS received, Number is online after wake-up, Rent renewed, Rent not renewed: not enough balance und Rent ended.

  3. Schritt 3. Anlegen und testen

    Klicken Sie auf Create webhook, stellen Sie sicher, dass Send events eingeschaltet ist, und klicken Sie dann auf Send test event. Das Ergebnis und die letzten Zustellungen sehen Sie auf der Seite.

Jede Anfrage ist mit Ihrem Signing secret signiert, prüfen Sie die Signatur also auf Ihrer Seite. Fehlgeschlagene Zustellungen werden mehrere Stunden lang wiederholt.

Fragen zum Thema

In Profile, im Tab API. Nach dem Erzeugen wird das Token einmal angezeigt. Haben Sie es verloren, klicken Sie auf Regenerate token.

Nein. Sie können die API stattdessen abfragen. Webhooks ersparen Ihnen nur das Abfragen.

Wenn Ihr Server wiederholt nicht antwortet, werden die Zustellungen abgeschaltet. Beheben Sie den Endpunkt, schalten Sie Send events ein und speichern Sie.

Nein. Sie liest Nachrichten und verwaltet Nummern. Senden wird nicht angeboten.

Weiterlesen

Keine Antwort gefunden?

Schreiben Sie dem Support auf Telegram. Schicken Sie die Nummer und einen Screenshot mit, das geht schneller.

News Support