A primeira mensagem

Do domínio por verificar até uma mensagem entregue, em três passos.

Três passos, e o único que demora é o DNS.

1. Adiciona o teu domínio

No painel, em Domínios, carrega em Adicionar domínio. Usa um subdomínio dedicado ao envio, mail.aminhaempresa.pt e não aminhaempresa.pt: o que acontecer à reputação do envio não toca no resto do teu correio.

Escolhes a stream nesse momento, e ela não muda depois. Transaccional é o que uma pessoa está à espera de receber; Marketing é o que não pediu explicitamente, e obriga a cabeçalhos de cancelamento de subscrição.

2. Publica os registos de DNS

O painel mostra-te, por cada registo, o que está publicado neste momento e o que deve ficar lá. Copia o nome e o valor com os botões, não os escrevas à mão: o painel diz-te que um registo não resolve, mas não te diz qual foi o carácter errado.

DKIM assina as mensagens com a nossa chave, para que o destinatário confirme que saíram de ti.
SPF autoriza os nossos servidores a enviar em teu nome. Se já tens um registo SPF, o painel mostra-te o registo já juntado: publica um só, nunca dois.
DMARC diz ao destinatário o que fazer com mensagens que falhem a autenticação, e para onde nos enviar os relatórios.

Depois de publicares, carrega em Verificar registos. A propagação pode levar até 24 horas, mas na prática costuma ser minutos.

3. Envia

Cria uma chave em Chaves API. Aparece uma única vez; guarda-a no teu gestor de segredos.

curl -X POST https://app.c-connect.pt/v1/messages \
  -H "Authorization: Bearer $CCONNECT_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "notificacoes@mail.empresa.pt",
    "to": "alguem@example.org",
    "subject": "O teu recibo",
    "text": "Obrigado pela tua compra."
  }'

A resposta é 202 Accepted com o identificador da mensagem. Aceite não é entregue: a mensagem ainda não passou pelo relay, e é por isso que o passo seguinte existe.

O endereço antes do @ é teu: notificacoes@, geral@, noreply@, o que quiseres. Nós verificamos o domínio, nunca a caixa.

Da chave ao primeiro envio, e à linha que aparece no registo.

4. Vê o que aconteceu

Em Mensagens aparece a linha, com o estado e o que o destino respondeu. Clica na linha para abrir a cronologia completa: quando foi aceite, por que MX saiu, e o código SMTP que o destinatário devolveu.

Se quiseres esses eventos no teu sistema em vez de os ires buscar, configura um endpoint em Webhooks.