Documentation
Se connecter Essayer gratuitement
 État du service
Allemand (Deutsch) Anglais (English) Espagnol (Español) Français (Français) Norvégien (Norsk) Portugais (Português) Slovaque (Slovenčina) Tchèque (Čeština)

Aucun résultat

Se connecter Essayer gratuitement

Canal SMS

L'objet du canal SMS. Il se place dans l'objet channel sous la clé sms - voir Cascade. Le SMS est également le canal utilisé lorsque channel est entièrement omis de la requête.

L'objet est le même pour Advanced transactional et Advanced promotional.

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

Objet SMS

NOM DU PARAMÈTRE VALEUR OBLIGATOIRE VALEUR PAR DÉFAUT
text Texte du message SMS (max. 612 caractères, ou 268 caractères si Unicode est utilisé), encodage UTF-8. Remplace le text de premier niveau, voir Quel texte est utilisé Non null
sender_id Type d'expéditeur, voir Type d'expéditeur Non gSystem
sender_id_value Valeur associée à sender_id - gOwn (par ex. « 420 777 777 777 »), gText (par ex. « BulkGate »), gProfile (par ex. « 423 »), gMobile ou gPush (KEY) Non null
unicode yes/true/1/on pour un SMS Unicode, no/false/0/off pour un SMS 7 bits Non false

Vous pouvez ajouter des variables du tableau variables dans text de la même manière que dans le texte de premier niveau : Hello <first_name> <last_name>.

Type d'expéditeur sender_id

VALEUR DESCRIPTION
gSystem Numéro système
gShort Code court (Short Code)
gText Expéditeur texte
gMobile Mobile Connect
gPush Mobile Connect push - envoie une notification dans l'application Mobile Connect
gOwn Numéro propre (nécessite la vérification du numéro)
gProfile ID de profil BulkGate
<int> ID de profil BulkGate

Indiquer un nombre entier comme sender_id est un raccourci pour le profil : "sender_id": 423 est interprété comme "sender_id": "gProfile" avec "sender_id_value": "423".

Note

Le paramètre flash est toujours accepté pour des raisons de rétrocompatibilité, mais il n'a aucun effet sur le message.

Articles associés du centre d'aide

  • Type d'expéditeur — numéro système, code court, expéditeur texte, numéro propre
  • Unicode — diacritiques et caractères spéciaux, et pourquoi ils limitent un message à 268 caractères
  • Concaténation des messages — comment un SMS long est découpé en parties et combien de caractères tiennent dans une seule

Exemple de requête complète

Message à deux numéros, envoyé depuis un expéditeur texte et encodé en Unicode. <first_name> est remplacé à partir du tableau variables.

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 } } }

Message à deux groupes du carnet d'adresses, envoyé depuis un ID de profil. same_number empêche l'envoi d'un second message à un numéro qui figure déjà dans la campagne.

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" } } }

La réponse est la même pour tous les canaux - voir Advanced transactional ou Advanced promotional.

Cette page vous a-t-elle été utile ?
Demander à l'IA Copié