Português
English
A resposta curta: junte ao envio o campo send_at, com a data, a hora e o fuso horário em ISO 8601, por exemplo 2026-11-20T09:30:00+02:00. A data tem de ser no futuro e, no máximo, daqui a 365 dias. A mensagem fica scheduled, e os créditos só são descontados quando ela sai.
Um pedido agendado
curl https://api.interweb.co.mz/v1/sms/messages \
-H "Authorization: Bearer sandbox_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: consulta-5812-vespera" \
-d '{"number": "841234567", "text": "Lembrete: tem consulta amanhã às 10h00.", "send_at": "2026-11-20T09:30:00+02:00"}'
A resposta traz o id da mensagem, o estado scheduled e a hora marcada em scheduled_for. Guarde o id no seu sistema, junto da marcação ou da factura: é com ele que consulta o aviso e o cancela, se for preciso.
O fuso horário
O fim da data diz de que fuso é a hora. Moçambique está em +02:00 e Angola em +01:00: a mesma hora «09:30» escrita com o fuso errado sai uma hora antes ou depois. Se o seu sistema guarda as datas em UTC, pode enviar a hora em UTC com o fim Z, desde que a conta esteja certa.
O que acontece até à hora marcada
| Momento | O que se passa |
| Ao agendar | A API só confere se o saldo chega. Nada é descontado: o campo charged fica false. |
| Entretanto | A consulta do saldo mostra em scheduled_credits o que está agendado e ainda não foi descontado. |
| Na hora | A mensagem sai e os créditos são descontados. |
| Na hora, sem saldo | A mensagem não sai e fica failed, com o erro insufficient_credits. |
Erros ao agendar
| Motivo (details.reason) | O que quer dizer |
| invalid_send_at | A data não está num formato válido. Confira o ISO 8601 e o fuso. |
| send_at_in_past | A data já passou. Se quer que saia logo, envie sem send_at. |
| send_at_too_far | A data está a mais de 365 dias. |
Estes erros chegam com o código 422. Os outros erros do SMS estão em erros e estados na API de SMS.
| Mantenha saldo para os avisos já agendados. Um lembrete marcado há semanas falha na hora se entretanto o saldo acabou. Veja como vigiar o saldo em quanto custam os avisos automáticos. |
| Teste com uma chave sandbox_. A API confere tudo, devolve a resposta, e não envia nem cobra nada. |
|
Quer que os seus avisos saiam sozinhos na hora certa? Veja a página da API. Ver a página da API |
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 |
