A resposta curta: POST /v1/sms/messages/batch recebe muitas mensagens num só pedido, cada uma com o seu número e, se quiser, o seu texto. Não há limite de mensagens, só de tamanho do pedido (1 MB). A resposta traz, em results, o que aconteceu a cada uma.
Como é o pedido
curl https://api.mozout.co.mz/v1/sms/messages/batch \
-H "Authorization: Bearer sandbox_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: avisos-vencimento-2026-11-17" \
-d '{"text": "A sua factura vence amanhã.",
"send_at": "2026-11-20T08:00:00+02:00",
"messages": [{"number": "841234567"},
{"number": "OUTRO_NUMERO", "text": "Olá Ana, a sua factura vence amanhã."}]}'
| Campo |
Para que serve |
| text |
O texto de todas as mensagens que não tragam o seu. |
| sender |
Opcional: um remetente aprovado para todas. Sem ele, sai o grátis, NETMSG. |
| send_at |
Opcional: agenda todas para a mesma hora, como num envio simples. |
| messages |
A lista. Cada entrada tem number e, se quiser, text próprio. |
O que acontece depois
| 1 |
Cada mensagem é conferida com as mesmas regras de um envio simples: número válido, texto, remetente, palavras não permitidas, números que não recebem.
|
|
| 2 |
Até 20 saem logo; as outras entram na fila, que envia todos os minutos.
|
|
| 3 |
Se o saldo acabar ou chegar ao limite diário a meio da lista, as mensagens seguintes são recusadas.
|
|
| 4 |
Em results vê o que aconteceu a cada uma, com os mesmos motivos de erro do envio simples.
|
|
|
Leia sempre results. Um pedido em lote pode correr bem para a maioria e falhar para algumas. Guarde no seu sistema o resultado de cada número, para não repetir as que saíram nem esquecer as que falharam.
|
Lote ou um pedido por mensagem?
| Situação |
O que usar |
| Um aviso de cada vez, quando algo acontece |
POST /v1/sms/messages |
| Os lembretes do dia, a lista de vencimentos, um alerta a toda a equipa |
POST /v1/sms/messages/batch |
| Uma campanha preparada à mão |
A página SMS do Meu MozOut, com um grupo de contactos |
O lote também poupa pedidos: a conta tem um limite de pedidos por minuto, e uma lista enviada num pedido conta como um. O envio simples está em enviar SMS pela API.
|
Personalize no seu sistema. Como cada entrada pode ter o seu text, monte o texto de cada cliente (nome, valor, data) antes de enviar o lote. Com uma chave sandbox_, nada sai nem é cobrado.
|
PRODUTO RECOMENDADO Hospedagem de sites com cPanel Domínio e SSL incluídos, cópias diárias e o painel que já conhece. desde 396,00 MT/mês (plano de 3 anos, com cupão) Ver planos |
Português
English
