Solução de problemas com SMS

Quando você enviar um SMS, a SMS API retorna uma resposta em JSON que contém uma matriz de message objetos, um para cada mensagem:

{
    "message-count": "1",
    "messages": [
        {
            "to": "447700900000",
            "message-id": "0C000000217B7F02",
            "status": "0",
            "remaining-balance": "15.53590000",
            "message-price": "0.03330000",
            "network": "23410"
        }
    ]
}

O status O campo indica se a mensagem foi colocada na fila para envio com sucesso. Um status igual a zero indica sucesso; um valor diferente de zero significa que ocorreu algum problema.

Nota: A status O valor zero na resposta da API não significa que a Vonage tenha entregue sua mensagem. Consulte O que mais poderia ter dado errado?

Códigos de erro da SMS API

Se a SMS API retornar um valor diferente de zero status valor; em seguida, use a tabela a seguir para determinar o que deu errado:

status Significado Descrição
0 Sucesso A mensagem foi aceita com sucesso para entrega.
1 Limitado Você está enviando SMS a uma velocidade superior ao limite da conta (consulte Qual é o limite de capacidade de envio de SMS?).
2 Parâmetros ausentes Falta um dos parâmetros obrigatórios na sua solicitação: from, to, api_key, api_secret ou text.
3 Parâmetros inválidos O valor de um ou mais parâmetros é inválido.
4 Credenciais inválidas Sua chave e/ou segredo da API estão incorretos, inválidos ou desativados.
5 Erro interno Ocorreu um erro na plataforma durante o processamento desta mensagem.
6 Mensagem inválida A plataforma não conseguiu processar esta mensagem; por exemplo, um prefixo numérico não reconhecido.
7 Número bloqueado O número para o qual você está tentando enviar mensagens está na lista de números bloqueados.
8 Account do parceiro bloqueada Sua conta da Vonage foi suspensa. Entre em contato com apoio.
9 Violação da cota de parceiros Você não tem crédito suficiente para enviar a mensagem. Recarregue e tente novamente.
10 Existem muitas ligações O número de conexões simultâneas à plataforma excede a cota da sua conta.
11 Account não habilitada para HTTP Este account não está configurado para a SMS API; você deve usar o SMPP em vez disso.
12 Mensagem muito longa O comprimento da mensagem excede o máximo permitido.
14 Assinatura inválida Não foi possível verificar a assinatura fornecida.
15 Endereço do remetente inválido Você está usando um ID de remetente não autorizado no from área. Isso ocorre com mais frequência na América do Norte, onde é necessário um número virtual longo da Vonage ou um código curto.
22 Código de rede inválido O código de rede fornecido não foi reconhecido ou não corresponde ao país do endereço de destino.
23 URL de retorno de chamada inválida A URL de retorno fornecida era muito longa ou continha caracteres inválidos.
29 Destino fora da lista de permissões Sua conta da Vonage ainda está no modo de demonstração. Enquanto estiver nesse modo, você precisa adicionar os números de destino à sua lista de contatos autorizados. Recarregue sua conta para remover essa limitação.
32 Assinatura e segredo da API não permitidos Um pedido assinado não pode, além disso, apresentar um api_secret.
33 Número desativado O número para o qual você está tentando enviar mensagens está desativado e talvez não as receba.

O que mais poderia ter dado errado?

Se o valor de status é zero e sua mensagem ainda não chegou, então algo deu errado durante o processo de entrega propriamente dito. Para saber se sua mensagem chegou ao destinatário pretendido, você precisa de um recibo de entrega da transportadora.