Consulta de status de SMS único – HTTP

Descrição
Para realizar a consulta, é necessário que tenha sido utilizado o Identificador (Id) no momento do envio.O retorno é uma linha de texto contendo o resultado da operação.

Importante: a consulta a um SMS fica disponível por até 24 horas após seu envio. Após esse período, será retornado “180 – message Id not found”.
[HTTP]

 

[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(check) Deve conter o valor check, indicando a consulta de status de um SMS.
Id Sim String (50) Identificador único do SMS a ser consultado.

 

Retorno de cada linha consultada
Retorno Descrição
SMS agendado na plataforma Zenvia para envio em data e hora futura (ainda não enviado à operadora).
100 – Message queued SMS aguardando envio.
SMS processado com sucesso.
110 – Message sent to operator Ainda aguardando informações detalhadas da operadora.
111 – Message reception unavailable Sem informação – operadora não retornou informações detalhadas sobre o SMS.
120 – Message received by mobile Recebido – operadora confirma o recebimento pelo celular de destino.
140 – Mobile number not covered Não recebido – operadora confirma o não recebimento do SMS pelo celular de destino
145 – Mobile number inactive
150 – Message expired in operator
160 – Operator network error
161 – Message rejected by operator
162 – Message cancelled or blocked by operator
170 – Bad message
171 – Bad number
SMS não enviado à operadora – SMS registrado na plataforma Zenvia, porém bloqueado por nossas ferramentas de inteligência de envio.
130 – Message blocked Celular destinatário inválido (número não existe).
131 – Message blocked by predictive cleansing Celular destinatário bloqueado por nosso exclusivo algoritmo de limpeza preditiva de base (para mais informações, consulte nossa equipe).
141 – International sending not allowed A conta não permite o envio de SMS internacional.
Erros na consulta
180 – Message Id not found Não foi encontrado SMS com o Id fornecido como parâmetro.
190 – Unknown error Erro desconhecido. Por favor, contate nosso suporte.
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.