Documentação
Iniciar sessão Experimentar gratuitamente
 Estado do serviço
Alemão (Deutsch) Eslovaco (Slovenčina) Espanhol (Español) Francês (Français) Inglês (English) Norueguês (Norsk) Português (Português) Tcheco (Čeština)

Nada encontrado

Iniciar sessão Experimentar gratuitamente

Canal SMS

O objeto do canal SMS. Coloca-se no objeto channel, na chave sms - consulte Cascata. O SMS é também o canal utilizado quando channel é totalmente omitido do pedido.

O objeto é igual para Advanced transactional e Advanced promotional.

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

Objeto SMS

NOME DO PARÂMETRO VALOR OBRIGATÓRIO VALOR PREDEFINIDO
text Texto da mensagem SMS (máx. 612 caracteres, ou 268 caracteres se for utilizado Unicode), codificação UTF-8. Substitui o text de nível superior, consulte Que texto é utilizado Não null
sender_id Tipo de remetente, consulte Tipo de remetente Não gSystem
sender_id_value Valor correspondente a sender_id - gOwn (p. ex. "420 777 777 777"), gText (p. ex. "BulkGate"), gProfile (p. ex. "423"), gMobile ou gPush (CHAVE) Não null
unicode yes/true/1/on para SMS Unicode, no/false/0/off para SMS de 7 bits Não false

Pode adicionar variáveis do array variables a text da mesma forma que ao texto de nível superior: Olá <first_name> <last_name>.

Tipo de remetente sender_id

VALOR DESCRIÇÃO
gSystem Número do sistema
gShort Short Code
gText Remetente de texto
gMobile Mobile Connect
gPush Mobile Connect push - Envia uma notificação para a aplicação Mobile Connect
gOwn Número próprio (requer verificação do número)
gProfile ID de perfil BulkGate
<int> ID de perfil BulkGate

Indicar um número inteiro como sender_id é um atalho para o perfil: "sender_id": 423 é interpretado como "sender_id": "gProfile" com "sender_id_value": "423".

Nota

O parâmetro flash continua a ser aceite por motivos de retrocompatibilidade, mas não tem qualquer efeito na mensagem.

Artigos relacionados do centro de ajuda

  • Tipo de remetente — número do sistema, short code, remetente de texto, número próprio
  • Unicode — diacríticos e caracteres especiais, e porque reduzem uma mensagem para 268 caracteres
  • Concatenação de mensagens — como um SMS longo é dividido em partes e quantos caracteres cabem em cada uma

Exemplo de pedido completo

Mensagem para dois números, enviada a partir de um remetente de texto e codificada como Unicode. <first_name> é substituído a partir do 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 } } }

Mensagem para dois grupos da agenda de contactos, enviada a partir de um ID de perfil. same_number impede uma segunda mensagem para um número que já consta da campanha.

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

A resposta é igual para todos os canais - consulte Advanced transactional ou Advanced promotional.

Esta página foi útil?
Perguntar à IA Copiado