Aparelho
Sem contato
Nenhum aparelho consultou a fila desta empresa.
VISÃO GERAL
Sua operação, em um só lugar.
Acompanhe a conexão do aparelho e o andamento dos envios.
Na fila · últimas 100
0Na lista recente, aguardando o Android
Chaves ativas
0Envio e aparelho
CONEXÃO DA EMPRESA
Prepare seu primeiro envio
Crie uma chave
Habilite o uso no celular para conectar o Android.
Conecte o aparelho
Informe o endereço do gateway e a chave no app Android.
Acompanhe os envios
Consulte os resultados na lista de mensagens.
Crie uma chave com uso no celular e informe no Android.
Acesso rápido
| Horário | Destinatário | Mensagem | Status |
|---|
Dados do envio
O pedido entra na fila desta empresa e sai pelo chip do aparelho.
Sem contato
Nenhum celular consultou a fila desta empresa.
Chaves desta empresa
Nova chave
Marque envio, celular ou os dois. A mesma chave vale em cada uso marcado.
Enviar SMS de outra aplicação
A outra aplicação autentica com uma chave que tenha uso de envio. A senha do painel não serve neste pedido. Uma chave só de celular também não. O texto entra na fila e sai pelo chip do Android.
Enviar
POST /v1/messages. O telefone é internacional, com + e de 8 a 15 dígitos. A API aceita de 1 a 500 caracteres, mas o Android envia um único segmento. O tamanho disponível depende da codificação; textos maiores podem falhar. Não há divisão automática em vários SMS.
Resposta
HTTP 202 devolve o identificador e o estado atual. Guarde o id para achar o resultado depois.
{ "id": "…", "status": "queued" }
Idempotência
O cabeçalho Idempotency-Key tem de 8 a 128 caracteres: letras, números, ponto, underline ou hífen. A mesma chave com o mesmo telefone e o mesmo texto devolve a mensagem que já existe. Outro conteúdo com a mesma chave responde 409. Cada SMS novo precisa de uma chave nova.
Consultar
GET na mesma rota, com uma chave que tenha uso de envio, devolve as 100 mensagens mais recentes e o último contato do aparelho, em milissegundos, ou nulo.
Estados
| Estado | Significado |
|---|---|
| queued | Na fila. O aparelho ainda não retirou. |
| claimed | O aparelho retirou. Se permanecer assim, o resultado não voltou. |
| sent | O Android reportou o envio. |
| delivered | Entrega confirmada, quando o aparelho consegue ler o relatório da rede. |
| failed | O envio falhou. |
| uncertain | O aparelho não conseguiu confirmar o resultado. |
| expired | Ficou na fila por mais de 24 horas. |
Erros
O corpo é {"error":"…"}. 401 é chave ausente, revogada ou sem uso de envio. 400 é telefone, texto ou idempotência fora do formato. 409 é a mesma idempotência com outro conteúdo.
Use sempre HTTPS e mantenha as chaves no servidor da sua aplicação, nunca em código público. Em caso de resultado incerto, confira o histórico antes de tentar novamente para evitar duplicidade.