Envio de SMS único – HTTP – WebService

Descrição
Enviar uma mensagem SMS para um único celular de destino.
[HTTP | WebService]

 

[SISTEMA CLIENTE] ←→[ZENVIA]

 

Parâmetros de entrada
Parâmetro Obrigatório Formato Descrição
account Sim String (20) Nome da conta utilizada pelo cliente.
code Sim String (20) Senha de integração da conta.
dispatch Sim Nome da operação(send) Deve conter o valor send, indicando o envio de um SMS.
from Não String (20) Nome do remetente. Se não informado, utiliza-se o remetente-padrão da conta.
to Sim código de país + código de área + número (até 15 dígitos) Celular de destino. Exemplo: 555199887766.
msg Sim String (160) Texto do SMS. Junto com o parâmetro “from”, deve ter no máximo 160 caracteres (140 para destinatários Nextel).
schedule Não dd/mm/aaaa hh:mm:ss Detalhes ou observações extras.
id Não String (50) Identificador único para o SMS.
callbackOption Não 0 – nenhuma resposta (padrão)
1 – envia o status final da mensagem (recomendado)
2 – envia status intermediários e final da mensagem
Opção para habilitar a notificação do status do SMS ao sistema do cliente, em uma URL de retorno personalizada.
Obs.: para habilitar o retorno de status, é preciso utilizar o parâmetro ID e configurar uma URL de retorno na conta utilizada.

 

Retorno da chamada
Retorno Descrição
Envio com sucesso
000 – Message sent SMS enviado com sucesso
Erro no envio do SMS
010 – Empty message content Conteúdo do SMS vazio. Verifique parâmetro “msg”.
012 – Message content overflow Conteúdo do SMS muito longo. Verifique se o tamanho dos parâmetros “msg” e “from” juntos não ultrapassam 160 caracteres.
013 – Incorrect or incomplete ‘to’ mobile number Celular destinatário está incompleto ou inválido. Verifique o formato do parâmetro “to”, conforme tabela acima.
014 – Empty ‘to’ mobile number Celular destinatário vazio. Verifique o formato do parâmetro “to”, conforme tabela acima.
015 – Scheduling date invalid or incorrect Data de agendamento mal formatada. Verifique o formato do parâmetro “schedule”, conforme tabela acima.
016 – ID overflow Identificador com tamanho maior que o limite máximo. Verifique o parâmetro “id”, conforme tabela acima.
080 – Message with same ID already sent Identificador do SMS já foi utilizado nas últimas 24 horas.
141 – International sending not allowed A conta não permite o envio de SMS internacional.
Erros gerais
900 – Authentication error Erro de autenticação. Verifique os parâmetros “account” e “code”.
990 – account limit reached O limite de créditos de sua conta foi atingido. Contate nosso suporte para verificação/liberação.
998 – Wrong operation requested Operação de chamada inexistente. Verifique o parâmetro “dispatch”, conforme tabela acima.
999 – Unknown error Erro desconhecido. Por favor, contate nosso suporte.