Documentação SMTP e API de email

Começar

Contrate um plano de Envio de Email e abra o serviço na área de cliente.
Em Domínios, acrescente o domínio de onde vai enviar e publique no DNS os registos indicados (DKIM, SPF e DMARC). Verificamos por si.
Em Utilizadores, crie um utilizador SMTP, um por site ou aplicação. Em API, crie uma chave se preferir enviar por HTTPS.

O remetente (From) tem de ser um endereço de um domínio já verificado. Mensagens de outros domínios são recusadas.

Ligação SMTP

Os dados exatos do seu serviço aparecem na área de cliente, no separador Integração, prontos a copiar.

Servidoro do seu painel

Porta587

EncriptaçãoSTARTTLS

AutenticaçãoObrigatória

Utilizadornome@identificador

Palavra-passeMostrada uma só vez

Não usamos a porta 25 nem SSL implícito (465). Máximo de destinatários por mensagem: o do seu plano. Para listas grandes, envie mensagens separadas.

Exemplos SMTP

Troque smtp.exemplo.com, o utilizador e a palavra-passe pelos do seu painel.

API HTTPS

Útil quando a sua aplicação ou o seu alojamento bloqueia a porta 587. Os limites do plano, o DKIM e a reputação são os mesmos do SMTP.

MétodoPOST

Endpointhttps://apihost.woomoza.com/api/v1/smtp/send

AutenticaçãoBearer wmz_…

Formatoapplication/json

Campos

Campo	Descrição
from *	Um email, ou `{"email","name"}`. Tem de ser de um domínio verificado.
to *	Um endereço ou uma lista. Cada endereço pode ser um email ou `{"email","name"}`.
cc, bcc	Opcionais, no mesmo formato de `to`.
reply_to	Opcional.
subject *	Até 255 caracteres.
text, html	Pelo menos um deles. Em conjunto, até 5 MB.
attachments	Lista de `{"filename","content"}` com o conteúdo em base64. Até 10 ficheiros e 5 MB no total. Executáveis e scripts são recusados.

Resposta

202 Accepted

{
  "id": "c8f1a2e4-7b9d-4c0e-9a1b-3d5f6e7a8b9c",
  "status": "queued"
}

Exemplos da API

Erros e limites

Código	Significado
202	Aceite para entrega. Acompanhe o resultado em Atividade no painel.
400	O corpo não é JSON válido em UTF-8.
401	Chave em falta, inválida ou revogada.
403	O serviço não está ativo (por exemplo, fatura por pagar).
413	A mensagem passa o máximo de 5 MB.
422	Dados inválidos: remetente fora de um domínio verificado, endereço mal escrito, falta assunto ou conteúdo.
429	Limite do plano atingido, ou demasiadas tentativas com chave inválida (espere um minuto).

Mantenha a lista de destinatários limpa. Muitos emails devolvidos baixam a reputação e, no limite, o envio é bloqueado para proteger os outros clientes.

Ainda sem plano?

Veja os planos de envio e comece hoje.

Ver planos

Envio de email: SMTP e API