Ingen treff

SMS-kanal

SMS-kanalobjektet. Det legges i objektet channel under nøkkelen sms – se Kaskade. SMS er også kanalen som brukes når channel er helt utelatt fra forespørselen.

Objektet er det samme for Advanced transactional og Advanced promotional.

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

SMS-objekt

PARAMETERNAVN VERDI OBLIGATORISK STANDARDVERDI
text Teksten i SMS-meldingen (maks. 612 tegn, eller 268 tegn hvis Unicode brukes), UTF-8-koding. Overstyrer text på toppnivå, se Hvilken tekst som brukes Nei null
sender_id Avsendertype, se Avsendertype Nei gSystem
sender_id_value Verdi som hører til sender_id – gOwn (f.eks. «420 777 777 777»), gText (f.eks. «BulkGate»), gProfile (f.eks. «423»), gMobile eller gPush (NØKKEL) Nei null
unicode yes/true/1/on for Unicode-SMS, no/false/0/off for 7-bits SMS Nei false

Du kan legge variabler fra matrisen variables inn i text på samme måte som i teksten på toppnivå: Hei <first_name> <last_name>.

Avsendertype sender_id

VERDI BESKRIVELSE
gSystem Systemnummer
gShort Kortnummer (Short Code)
gText Tekstavsender
gMobile Mobile Connect
gPush Mobile Connect push – sender et varsel til Mobile Connect-appen
gOwn Eget nummer (krever bekreftelse av nummeret)
gProfile BulkGate-profil-ID
<int> BulkGate-profil-ID

Et heltall som sender_id er en snarvei for profilen: "sender_id": 423 leses som "sender_id": "gProfile" med "sender_id_value": "423".

Merk

Parameteren flash godtas fortsatt av hensyn til bakoverkompatibilitet, men den har ingen effekt på meldingen.

Relaterte artikler i hjelpesenteret

  • Avsendertype — systemnummer, kortnummer, tekstavsender, eget nummer
  • Unicode — diakritiske tegn og spesialtegn, og hvorfor de korter ned meldingen til 268 tegn
  • Sammenslåing av meldinger — hvordan en lang SMS deles opp i deler, og hvor mange tegn som får plass i én

Eksempel på fullstendig forespørsel

Melding til to numre, sendt fra en tekstavsender og kodet som Unicode. <first_name> erstattes med verdien fra matrisen 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 } } }

Melding til to grupper fra adresseboken, sendt fra en profil-ID. same_number hindrer at det sendes en melding til et nummer som allerede er med i kampanjen.

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

Svaret er det samme for alle kanaler – se Advanced transactional eller Advanced promotional.

Var denne siden nyttig?