Português
English
A resposta curta: POST /v1/email/messages/batch envia muitos e-mails num só pedido. Os campos de fora de messages valem para todos, e cada mensagem tem o seu to e as suas variables. Não há limite de mensagens, só de tamanho do pedido (8 MB). Em results vem o que aconteceu a cada uma.
Um exemplo
curl https://api.mozout.co.mz/v1/email/messages/batch \
-H "Authorization: Bearer sandbox_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: facturas-2026-11" \
-d '{"from": "A Sua Empresa <facturas@asuaempresa.co.mz>",
"template_id": 12,
"messages": [
{"to": "ana@example.com", "variables": {"nome": "Ana", "numero": "FT 214"}},
{"to": "rui@example.com", "variables": {"nome": "Rui", "numero": "FT 215"}}]}'
Os campos comuns são from, subject, html, text, template_id, reply_to e send_at. Cada mensagem pode mudar qualquer um deles, e segue as mesmas regras de um envio normal.
Ler a resposta
| Campo | O que diz |
| total | Quantas mensagens vinham no pedido |
| accepted / rejected | Quantas foram aceites e quantas recusadas |
| credits | Os créditos gastos |
| results | Uma linha por mensagem, pela ordem do pedido: index, id, status e, se falhou, error e field |
Uma mensagem com um endereço inválido vem com "status": "rejected" e "error": "invalid_recipient", e as outras seguem na mesma. Use o index para saber qual corrigir.
O que sai logo e o que vai para a fila
As primeiras 20 mensagens saem logo; as restantes entram na fila, que corre a cada minuto. Por isso um lote grande demora uns minutos a sair por completo: acompanhe cada id no registo ou pelo webhook.
| Sem créditos ou no limite diário, o resto é recusado. Se o saldo acabar ou chegar ao limite diário a meio, as mensagens que faltam vêm como rejected, com o motivo insufficient_credits ou daily_limit_reached. Confira o saldo antes de um lote grande: créditos e limite diário. |
| Lote é para mensagens individuais. Cada pessoa recebe a sua factura ou o seu aviso. Uma novidade igual para toda a lista é uma campanha, com ligação de cancelar: veja e-mail marketing. |
|
Quer enviar as facturas do mês todas de uma vez? Veja a página da API. Ver a página da API |
PRODUTO RECOMENDADO E-mail profissional no seu domínio Caixas com o nome da sua empresa, sem publicidade, com filtro de spam. desde 396,00 MT/mês (plano de 3 anos, com cupão) Ver planos |
