Fragen und Antworten zur Bulk SMS API

Eine Bulk SMS API für Entwickler: Senden Sie einen Text oder einen Batch mit bis zu 10.000 Nummern pro Anfrage an 227 Länder über REST, verfolgen Sie jede Nachricht mit signierten Webhooks und zahlen Sie pro Nachricht von einem Prepaid-Guthaben. Eine Web-Konsole sendet Kampagnen aus einer eingefügten Liste oder CSV ohne Code.

Produkt- und Entwicklungsteams, die Texte aus ihren eigenen Systemen versenden: Login- und Anmeldecode, Bestell- und Lieferaktualisierungen, Terminerinnerungen, Zahlungsbenachrichtigungen, Dienstmitteilungen und Marketingkampagnen. Jeder, der eine HTTPS-Anfrage stellen kann, kann sie nutzen.

227 Länder und Gebiete, aufgelistet mit ihren Preisen auf der Preis- und Länder-Seiten. Eine Anfrage kann Länder mischen: Jede Nummer wird nach dem Land, zu dem sie gehört, berechnet.

Nein. Sie zahlen pro Nachrichtensegment von einem Prepaid-Guthaben, und es gibt keine monatliche Gebühr, Einrichtungsgebühr oder Mindestvolumen. Das Guthaben hat kein Verfallsdatum.

Konten beginnen mit einem Guthaben von Null, und die erste Aufladung öffnet alles. Die erste Aufladung fügt einen Bonus von bis zu 40% hinzu, sodass die ersten Nachrichten weniger kosten. Die Preise sind öffentlich, und der Estimate-Endpunkt sowie die Konsole zeigen die genauen Kosten an, bevor etwas gesendet wird.

POST /v1/batches nimmt bis zu 10.000 Nummern pro Anfrage, entweder einen Text für alle oder einen persönlichen Text pro Nummer. Die Konsole nimmt 50.000 Nummern pro Kampagne. Größere Listen werden in mehrere Anfragen aufgeteilt.

Die Warteschlange läuft alle zwei Sekunden und übergibt bis zu 1.200 Nachrichten pro Minute pro Konto an das Netzwerk, in der Reihenfolge, in der sie akzeptiert wurden. Eine einzelne Nachricht wird normalerweise innerhalb weniger Sekunden nach der Anfrage versendet.

International E.164: ein Pluszeichen, die Vorwahl und die nationale Nummer, z.B. +14155550123. Leerzeichen, Bindestriche, Klammern und ein 00-Präfix werden automatisch bereinigt; Duplikate und Nummern, die nicht gelesen werden können, werden aussortiert und nicht berechnet.

Bis zu 10 Segmente: 1.530 Zeichen in GSM-7 oder 670 in Unicode. Ein Segment enthält 160 GSM-7 oder 70 Unicode-Zeichen; längere Texte werden in Teile von 153 oder 67 Zeichen aufgeteilt und auf dem Telefon wieder zusammengefügt.

Ein Zeichen außerhalb des GSM-7-Alphabets, wie ein geschweiftes Anführungszeichen, ein Emoji oder ein Buchstabe wie á oder ç, schaltet den gesamten Text auf Unicode mit 70 Zeichen pro Segment um. Der Konsolen-Editor nennt diese Zeichen, und POST /v1/estimates gibt die Kodierung zurück, bevor Sie senden.

Ja. Fügen Sie send_at zu einer API-Anfrage hinzu oder wählen Sie eine Zeit in der Konsole, von 2 Minuten bis zu 45 Tagen im Voraus. Ein geplanter Batch kann bis zum Start storniert werden, und die vollen Kosten werden dem Guthaben gutgeschrieben.

Ja. Über die API senden Sie einen Batch mit Nachrichten, eine {to, text} pro Empfänger. In der Konsole fügen Sie eine Liste mit zusätzlichen Spalten ein oder laden sie hoch und verwenden Sie Platzhalter {{1}} bis {{9}} im Text.

Legen Sie Ihre Opt-out-Formulierung einmal in den Einstellungen fest, z.B. einen Link oder eine E-Mail-Adresse, und die Konsole fügt sie zu Kampagnentexten hinzu, wenn Sie das Kästchen ankreuzen. Über die API kontrollieren Sie den gesamten Text, fügen Sie die Zeile also selbst zu Marketingnachrichten hinzu. Nummern auf Ihrer Nicht-Senden-Liste werden von der Konsole und der API übersprungen und nicht berechnet.

Ja. Die Konsole hat einen Testversand an eine Nummer vor einer Kampagne, und über die API können Sie eine einzelne Nachricht an Ihr eigenes Telefon mit POST /v1/messages senden.

Jede Nachricht durchläuft die Status queued, sent, delivered oder failed. Fügen Sie in der Konsole eine Webhook-URL hinzu, um signierte Ereignisse für jeden Endstatus zu erhalten, oder nutzen Sie GET /v1/messages/{id} und GET /v1/batches/{id}.

Im Standard Webhooks-Format: Header webhook-id, webhook-timestamp und webhook-signature, wobei die Signatur HMAC-SHA256 von id, Timestamp und Rohdaten mit Ihrem whsec_-Geheimnis ist. Die Dokumentation enthält Verifizierungscode für Node.js, Python, PHP und Go.

Jedes Ereignis erhält 10 Zustellversuche über etwa 24 Stunden, jeder Versuch wird in der Konsole mit HTTP-Status protokolliert. Sie können die Nachrichten-Endpoints auch jederzeit abfragen.

Das Handy könnte zu lange ausgeschaltet sein, die Nummer möglicherweise nicht mehr in Betrieb oder das Netzwerk könnte die Nachricht ablehnen. Der fehlgeschlagene Status enthält einen Fehlercode, und der Preis wird erstattet.

Batches, Nachrichten und das Guthaben-Ledger bleiben in Ihrem Konto und der API erhalten. Das Anfrageprotokoll speichert die letzten 500 API-Aufrufe, das Webhook-Protokoll die letzten 500 Zustellungen.

Ja. In der Konsole können Sie Nummern einfügen oder eine CSV-Datei mit bis zu 50.000 Zeilen hochladen, den Text mit Platzhaltern schreiben, die Vorschau für jeden Empfänger und die Kosten pro Land prüfen und sofort oder zu einem festgelegten Zeitpunkt senden.

Guthaben, aktuelle Batches mit Live-Zählern, jedes Batch mit seinen Nachrichten und Status, Aufladungen und Buchungen, API-Schlüssel, Webhook-Einstellungen und Zustellungen, das Anfrageprotokoll, die Preisliste, Support-Tickets und Einstellungen.

Über die Support-Seite der Konsole. Zahlungsfragen können ab dem ersten Tag gestellt werden; andere Themen sind nach der ersten erfolgreichen Aufladung verfügbar.