No se ha encontrado nada

Canal SMS

El objeto del canal SMS. Se incluye en el objeto channel bajo la clave sms; consulte Cascada. El SMS también es el canal que se utiliza cuando channel se omite por completo en la solicitud.

El objeto es el mismo para Advanced transactional y Advanced promotional.

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

Objeto SMS

NOMBRE DEL PARÁMETRO VALOR OBLIGATORIO VALOR PREDETERMINADO
text Texto del mensaje SMS (máx. 612 caracteres, o 268 caracteres si se utiliza Unicode), codificación UTF-8. Sustituye al text de nivel superior, consulte Qué texto se utiliza No null
sender_id Tipo de ID de remitente, consulte Tipo de ID de remitente No gSystem
sender_id_value Valor correspondiente a sender_id: gOwn (p. ej. "420 777 777 777"), gText (p. ej. "BulkGate"), gProfile (p. ej. "423"), gMobile o gPush (KEY) No null
unicode yes/true/1/on para SMS Unicode, no/false/0/off para SMS de 7 bits No false

Puede añadir a text variables del array variables del mismo modo que al texto de nivel superior: Hola <first_name> <last_name>.

Tipo de ID de remitente sender_id

VALOR DESCRIPCIÓN
gSystem Número del sistema
gShort Short Code
gText Remitente de texto
gMobile Mobile Connect
gPush Mobile Connect push: envía una notificación a la aplicación Mobile Connect
gOwn Número propio (requiere la verificación del número)
gProfile ID de perfil de BulkGate
<int> ID de perfil de BulkGate

Indicar un número entero como sender_id es un atajo para el perfil: "sender_id": 423 se interpreta como "sender_id": "gProfile" con "sender_id_value": "423".

Nota

El parámetro flash se sigue aceptando por compatibilidad con versiones anteriores, pero no tiene ningún efecto sobre el mensaje.

Artículos relacionados del centro de ayuda

  • Tipo de remitente: número del sistema, short code, remitente de texto, número propio
  • Unicode: signos diacríticos y caracteres especiales, y por qué reducen el mensaje a 268 caracteres
  • Concatenación de mensajes: cómo se divide un SMS largo en partes y cuántos caracteres caben en una

Ejemplo de solicitud completa

Mensaje a dos números, enviado desde un remitente de texto y codificado como Unicode. <first_name> se sustituye por el valor del array 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 } } }

Mensaje a dos grupos de la agenda de contactos, enviado desde un ID de perfil. same_number evita que se envíe un segundo mensaje a un número que ya está en la campaña.

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 respuesta es la misma para todos los canales: consulte Advanced transactional o Advanced promotional.

¿Le ha resultado útil esta página?