Pular para o conteúdo

API de SMS

createSMSMessage Obsoleto

Anchor link to

Usado para enviar notificações por SMS para os usuários

POST https://api.pushwoosh.com/json/1.3/createSMSMessage

Corpo da solicitação

Anchor link to
NomeObrigatórioTipoDescrição
auth*SimstringToken de acesso à API do Painel de Controle da Pushwoosh.
application*SimstringCódigo do aplicativo Pushwoosh
notifications*SimarrayConfigurações de conteúdo. Array JSON de parâmetros da mensagem. Veja os detalhes abaixo.

Parâmetros de notificação

NomeObrigatórioTipoDescrição
send_date*SimstringData e hora para enviar a notificação. Use o formato YYYY-MM-DD HH:mm ou now para enviar imediatamente.
content*SimstringConteúdo de texto da mensagem SMS.
devices*SimarrayNúmero de telefone do cliente (deve estar associado a um UserId usando /registerDevice e especificado no parâmetro hwid ou use use_auto_registration). Apenas um número pode ser especificado aqui.
use_auto_registrationNãobooleanSe definido como true, o número de telefone especificado no parâmetro devices será registrado automaticamente.
dynamic_content_placeholdersNãoobjectPlaceholders de conteúdo dinâmico para personalizar o conteúdo da mensagem. Cada placeholder será substituído pelos valores dinâmicos correspondentes.
presetNãostringCódigo de Preset de SMS do seu Painel de Controle.

Exemplo de solicitação

Anchor link to
{
"request": {
"application": "12345-67891", // obrigatório. Código do aplicativo Pushwoosh.
"auth": "yxoPUlwqm…………pIyEX4H", // obrigatório. Token de acesso à API do Painel de Controle da Pushwoosh.
"notifications": [{
"send_date": "now", // obrigatório. YYYY-MM-DD HH:mm OU "now".
"content": "Hello!", // obrigatório. Texto do SMS (string).
"devices": ["+1234567890"], // obrigatório. Número de telefone do cliente (deve estar associado a
// um UserId usando /registerDevice e especificado no
// parâmetro "hwid" ou use "use_auto_registration").
// Apenas um número pode ser especificado aqui.
"preset": "XXXXX-XXXXX", // opcional. Código de Preset de SMS do seu Painel de Controle.
"use_auto_registration": true // opcional. Registra automaticamente o número de telefone especificado
// no parâmetro "devices".
}]
}
}

Exemplo de resposta

Anchor link to
{
"status_code": 200,
"status_message": "OK",
"response": {
"Messages": [
"9648-0B10ECB6-0D9F214D"
]
}
}

Resposta de erro

Anchor link to
{
"status_code": 210,
"status_message": "Invalid devices list. \"devices\" must be an array.",
"response": {
"Messages": []
}
}

Para obter estatísticas de SMS, use o método totalsByIntervals.

Você também pode visualizar as estatísticas de cada mensagem na seção Histórico de Mensagens.