SMS · SMS-API

SMS-API: SMS aus Ihrer Software mit einer einzigen Anfrage.

Senden Sie SMS aus Ihrem CRM, ERP, E-Commerce-System oder Ihrer eigenen Anwendung, fragen Sie den Zustellstatus ab und empfangen Sie eingehende Nachrichten und Abmeldungen. REST und JSON; Authentifizierung mit Bearer-Schlüssel, Ereignisse per HMAC-signiertem Webhook.

Wir rufen zu Geschäftszeiten an. Ihre Nummer wird nur für dieses Gespräch verwendet · KVKK
# personalisierte SMS-Massenversendung curl -X POST https://api.buluthat.com/api/sms.php?action=send \ -H "Authorization: Bearer bt_xxx" -H "Content-Type: application/json" \ -d '{"header":"FIRMAADI","message":"Merhaba {ad}, siparişiniz kargoda.", "recipients":[{"phone":"05321234567","name":"Ayşe"}]}' # Antwort {"ok":true,"data":{"campaign_id":152,"status":"queued","recipients":1,"credits":1}} # Zustellereignis (Webhook, HMAC-signiert) X-Buluthat-Event: sms.delivery {"event":"delivery","data":{"campaign_id":152,"status":"delivered"}}
Was enthalten ist

Funktionen

Senden mit einer einzigen Anfrage

Aktion send: einzelne Nummer, Liste oder personalisierte, unterschiedliche Texte; Platzhalter werden aus den Empfängerfeldern gefüllt.

Zustellbericht

Fragen Sie mit status über die Sendenummer oder Ihre eigene Referenz (custom_ref) den Status jeder Nachricht ab.

Signierter Webhook

Zustell-, Eingangs- und Abmeldeereignisse werden mit X-Buluthat-Signature (HMAC-SHA256) signiert an Ihre Adresse gesendet; bei Fehlschlag wird mit Backoff erneut versucht.

Guthaben- und Absenderkennungsabfrage

balance liefert das verbleibende SMS- / OTP-Guthaben und Ablaufdaten, headers Ihre freigegebenen Absenderkennungen.

Geplanter Versand und Stornierung

Mit send_at bis zu 90 Tage in die Zukunft; mit cancel werden nicht gesendete Nachrichten storniert, das Guthaben wird erstattet.

Sperrliste

Gleichen Sie Ihre eigene Abmeldeliste mit blacklist_add / blacklist_remove ab.

OTP-Endpunkte

Verwalten Sie Bestätigungscodes mit otp_send, otp_verify und otp_status ohne eigene Tabelle.

İYS und Ratenbegrenzung

Mit is_commercial durchläuft eine kommerzielle Nachricht die İYS-Prüfung; mit rate_per_minute begrenzen Sie die Sendungen pro Minute.

Antrag

Starten Sie in 4 Schritten mit dem SMS-Versand

Sie laden Ihre Unterlagen im Panel hoch; die Freigabe der Absenderkennung verfolgen wir.

01
Beantragen Sie

Füllen Sie das Formular aus und wählen Sie das gewünschte Paket. Sobald Ihr Konto eröffnet ist, kommt Ihr Panel-Passwort per E-Mail.

02
Unterlagen hochladen

Übermitteln Sie Firmendaten, Steuerbescheinigung, Ausweis des Bevollmächtigten, Unterschriftenverzeichnis und Verpflichtungserklärung über das Panel.

03
Freigabe der Absenderkennung

Ihre SMS-Absenderkennung (3-11 Zeichen) wird bei vollständigen Unterlagen innerhalb von 1-3 Werktagen freigegeben.

04
Senden Sie

Senden Sie aus dem Panel per Excel oder Telefonbuch im Massenversand oder verbinden Sie Ihre Software per SMS-API.

FAQ

Über die SMS-API

Auf der SMS-API-Seite im Bereich Entwickler; mit Beispielanfrage, Antwort und Fehlercodes.

Sie erzeugen ihn im Panel unter SMS-Massenversand > API und Einstellungen; Ihre Webhook-Adresse tragen Sie auf demselben Bildschirm ein.

Eine im selben Request wiederholte Nummer wird nur einmal gesendet; bei aktivem Duplikatschutz geht derselbe Text am selben Tag nicht zweimal an dieselbe Nummer.