Angola
Brasil
Kenya
Moçambique
Nigeria
Portugal
South Africa
United Kingdom
United States
International
A resposta curta: queued quer dizer que o pedido foi aceite e a mensagem está na fila, à espera da vez. Não é um erro e não se repete o pedido. Sem agendamento, a API tenta enviar logo e responde com o estado real: sent se saiu, failed se falhou, ou queued se tiver de esperar. O seu sistema guarda o id e confirma o estado mais tarde.
Quando uma mensagem fica na fila
| Situação | O que acontece |
| Um envio isolado | Normalmente sai logo; se tiver de esperar a vez, volta queued. |
| Um envio em lote (POST /v1/sms/messages/batch) | As mensagens entram na fila, que sai de minuto a minuto; até 20 saem logo. As outras seguem nos minutos seguintes. |
| Uma mensagem que falha ao sair | É tentada mais 2 vezes, de 10 em 10 minutos. Se continuar a falhar, fica failed e os créditos voltam ao saldo. |
O que dizer ao cliente
No ecrã do seu site ou da sua aplicação, não escreva «enviámos-lhe um SMS» só porque o pedido foi aceite. Uma frase mais honesta funciona melhor: «Vai receber a confirmação por SMS dentro de momentos.» Se mais tarde o estado passar a failed, o seu sistema pode mostrar outra via, como o e-mail.
| Não volte a enviar só porque a resposta disse queued. A mensagem já está a caminho: um segundo pedido com outra Idempotency-Key dá dois SMS ao cliente e gasta créditos a dobrar. Se repetir por falha de ligação, use sempre a mesma chave. |
Como acompanhar até ao fim
|
|
|
|
Os estados, um a um, estão em acompanhar cada SMS transaccional.
| Avisos urgentes, um a um; avisos que podem esperar, em lote. Um envio isolado no momento do evento tenta sair logo; o lote serve para muitos avisos de uma vez, que seguem pela fila nos minutos seguintes. |
|
Quer avisos que saem sozinhos e um estado claro para cada um? Veja o SMS Transaccional. Ver o SMS Transaccional |
PRODUTO RECOMENDADO Alojamento de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde $6.60/mês (plano de 3 anos, com cupão) Ver planos |
