Dokumentation
Anmelden Kostenlos testen
 Servicestatus
Deutsch (Deutsch) Englisch (English) Französisch (Français) Norwegisch (Norsk) Portugiesisch (Português) Slowakisch (Slovenčina) Spanisch (Español) Tschechisch (Čeština)

Nichts gefunden

Anmelden Kostenlos testen

SMS-Kanal

Das Objekt des SMS-Kanals. Es gehört in das Objekt channel unter den Schlüssel sms - siehe Kanalkaskade. SMS ist auch der Kanal, der verwendet wird, wenn channel in der Anfrage ganz fehlt.

Das Objekt ist für Advanced – transaktionale Nachrichten und Advanced – Werbenachrichten gleich.

{ "sms": { "sender_id": "gText", "sender_id_value": "BulkGate" } }

SMS-Objekt

PARAMETERNAME WERT PFLICHT STANDARDWERT
text Text der SMS-Nachricht (max. 612 Zeichen bzw. 268 Zeichen bei Verwendung von Unicode), Kodierung UTF-8. Überschreibt den text der obersten Ebene, siehe Welcher Text verwendet wird Nein null
sender_id Absendertyp, siehe Absendertyp Nein gSystem
sender_id_value Wert zu sender_id - gOwn (z. B. "420 777 777 777"), gText (z. B. "BulkGate"), gProfile (z. B. "423"), gMobile oder gPush (KEY) Nein null
unicode yes/true/1/on für Unicode-SMS, no/false/0/off für 7-Bit-SMS Nein false

Variablen aus dem Array variables können Sie in text genauso einfügen wie in den Text der obersten Ebene: Guten Tag <first_name> <last_name>.

Absendertyp sender_id

WERT BESCHREIBUNG
gSystem Systemnummer
gShort Short Code
gText Textabsender
gMobile Mobile Connect
gPush Mobile Connect Push - sendet eine Benachrichtigung an die App Mobile Connect
gOwn Eigene Nummer (erfordert eine Verifizierung der Nummer)
gProfile BulkGate Profile ID
<int> BulkGate Profile ID

Die Übergabe einer ganzen Zahl als sender_id ist eine Abkürzung für das Profil: "sender_id": 423 wird als "sender_id": "gProfile" mit "sender_id_value": "423" gelesen.

Hinweis

Der Parameter flash wird aus Gründen der Abwärtskompatibilität weiterhin akzeptiert, hat aber keine Auswirkung auf die Nachricht.

Verwandte Artikel der Hilfe

  • Absendertyp — Systemnummer, Short Code, Textabsender, eigene Nummer
  • Unicode — Diakritika und Sonderzeichen und warum sie eine Nachricht auf 268 Zeichen kürzen
  • Verkettung von Nachrichten — wie eine lange SMS in Teile aufgeteilt wird und wie viele Zeichen in einen Teil passen

Beispiel einer vollständigen Anfrage

Nachricht an zwei Nummern, gesendet von einem Textabsender und als Unicode kodiert. <first_name> wird aus dem Array variables ersetzt.

POST /api/2.0/advanced/transactional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "number": ["420777777777", "420777777778"], "text": "Hello <first_name>, your order has been shipped.", "variables": {"first_name": "John"}, "country": "cz", "channel": { "sms": { "sender_id": "gText", "sender_id_value": "BulkGate", "unicode": true } } }

Nachricht an zwei Gruppen aus dem Adressbuch, gesendet von einer Profile ID. same_number verhindert eine zweite Nachricht an eine Nummer, die bereits in der Kampagne enthalten ist.

POST /api/2.0/advanced/promotional HTTP/1.1 Host: portal.bulkgate.com Content-Type: application/json { "application_id": 451, "application_token": "NKN02TWE6NfBkfl-your-secret-token-Wf05GaqLIWLW4aBj", "groups": [974, 975], "text": "Hello <first_name>, our spring sale starts today.", "duplicates_check": "same_number", "channel": { "sms": { "sender_id": "gProfile", "sender_id_value": "423" } } }

Die Antwort ist für alle Kanäle gleich - siehe Advanced – transaktionale Nachrichten bzw. Advanced – Werbenachrichten.

War diese Seite hilfreich?
KI fragen Kopiert