Português
English
A resposta curta: cada envio pela API devolve um id. Guarde-o junto do evento que originou o SMS (a encomenda, o pagamento, a marcação) e terá sempre a resposta a «o cliente foi avisado?». Com esse id, GET /v1/sms/messages/{id} diz o estado, as partes, os créditos e se já foram descontados (charged).
A resposta de um envio, campo a campo
| Campo | O que diz |
| id | O identificador do SMS. É o que guarda no seu sistema. |
| status | O estado actual (ver a tabela seguinte). |
| to | O número, tapado: 25884****567. |
| sender | O remetente usado: o NETMSG ou o seu Sender ID. |
| parts e encoding | Em quantas partes saiu e com que alfabeto. |
| credits e charged | Quantos créditos custa, e se já saíram do saldo. |
| error | Quando falha, o motivo, por exemplo delivery_failed. |
| scheduled_for, created_at, sent_at | A hora marcada (se agendado), a hora do pedido e a hora de saída. |
Os estados
| Estado | O que quer dizer |
| scheduled | Agendado para mais tarde, com send_at. Ainda se pode cancelar. |
| queued | Na fila, à espera da vez. Veja porque a resposta diz queued. |
| sending | A sair neste momento. |
| sent | Saiu para a operadora. Não quer dizer que já foi lido. |
| failed | Não saiu. O motivo vem em error. |
| cancelled | Cancelado antes de sair. |
| simulated | Pedido feito com uma chave de Sandbox: nada saiu, nada se cobrou. |
Porque o número vem tapado
O número inteiro não aparece nas respostas para não ficar espalhado pelos registos do seu sistema e de quem os lê. Por isso, não procure SMS pelo número: ligue cada SMS ao seu cliente pelo id, que guardou no momento do envio. A lista GET /v1/sms/messages aceita filtros por estado, datas e número, e também devolve os números tapados.
Consultar ou ser avisado
Há duas formas de o seu sistema saber como acabou cada SMS: perguntar com GET /v1/sms/messages/{id} de vez em quando, ou registar um webhook e receber um aviso assinado quando cada SMS é enviado ou falha. Para poucos SMS, perguntar chega; com muitos, o webhook poupa pedidos. A diferença explica-se em relatórios de entrega.
| Mensagens simuladas só se vêem com a chave que as criou, e a lista não mostra os avisos da própria conta, os códigos de verificação nem as mensagens simuladas. Se uma mensagem «desapareceu», confirme com que chave foi enviada. |
|
Quer saber sempre se cada cliente foi avisado? Veja o SMS Transaccional. Ver o SMS Transaccional |
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 321,75 MT/mês (plano de 3 anos, com cupão) Ver planos |
