A resposta curta: são três passos. Active o Email Center na página E-mail transaccional do Meu Interweb, verifique o seu domínio com os registos DNS que lhe damos e envie com um pedido POST /v1/email/messages. Antes de ir a sério, teste com uma chave de Sandbox: nada sai e nada se cobra.
O que precisa
| 1 |
O Email Center activo na sua conta. Activa-se no Meu Interweb, na página E-mail transaccional. Sem ele, a API responde 403 com o motivo email_account_required.
|
|
| 2 |
Uma chave da API com a permissão email_center:write para enviar e alterar, e email_center:read para consultar. Atenção: email:read e email:write são outras permissões, para as caixas de correio da hospedagem.
|
|
| 3 |
Um domínio seu, onde possa mudar o DNS. Os domínios de correio gratuito, como o gmail.com, não são aceites como remetente.
|
|
Passo a passo
| 1 |
Active o serviço. Abra a página E-mail transaccional do Meu Interweb e active-o. A página tem as secções de que vai precisar: domínios, envio, modelos, histórico, estatísticas e bloqueados.
|
|
| 2 |
Junte o domínio e publique no DNS os registos que aparecem: três CNAME de DKIM (obrigatórios), um TXT de SPF e um TXT de DMARC (recomendados). Pormenores em juntar um domínio remetente.
|
|
| 3 |
Carregue em Verificar (ou chame POST /v1/email/domains/{domain}/verify). O DNS pode levar algumas horas a propagar. Quando os registos DKIM estiverem no ar, o domínio passa a verificado.
|
|
| 4 |
Crie a chave da API no Meu Interweb, só com as permissões do Email Center. Comece por uma chave de Sandbox.
|
|
| 5 |
Faça o primeiro pedido com o remetente, o destinatário, o assunto e o conteúdo. Veja o exemplo abaixo.
|
|
| 6 |
Confira o resultado no histórico da página ou com GET /v1/email/messages/{id}.
|
|
O primeiro pedido
curl https://api.interweb.co.mz/v1/email/messages \
-H "Authorization: Bearer sandbox_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: fatura-2026-214" \
-d '{"from": "Facturas <facturas@asuaempresa.co.mz>",
"to": ["ana@example.com"],
"subject": "A sua factura está disponível",
"text": "Olá Ana, a sua factura já está disponível."}'
A resposta traz o id do e-mail e o estado. Com a chave de Sandbox o estado é simulated; com uma chave de Produção, e sem send_at, o e-mail sai logo e a resposta traz o estado real. Todos os campos estão em os campos do POST /v1/email/messages.
|
Use sempre o cabeçalho Idempotency-Key, com um valor único por e-mail (o número da factura, por exemplo). Se a ligação cair e o seu sistema repetir o pedido, o e-mail não sai duas vezes.
|
|
Quer pôr a sua aplicação a enviar e-mails do seu domínio? Veja a API e fale connosco sobre o Email Center.
Ver a página da API
|
PRODUTO RECOMENDADO Registe o seu domínio .co.mz Garanta o nome da sua empresa antes que outro o registe. a partir de 3.751,20 MT/ano Pesquisar domínio |
Português
English
