Mensagens recebidas (inbound)

Se um domínio verificado estiver configurado para receber e-mail, mensagens recebidas ficam disponíveis por aqui.

Listar mensagens recebidas

GET /v1/inbound-messages

Query params (todos opcionais):

Param	Descrição
cursor	RFC3339 — veja Paginação
limit	Default 50
domain_id	Filtra por domínio (UUID)
search	Busca por assunto/remetente/destinatário
period	7d ou 30d
has_attachments	true ou false

Resposta — 200:

{
  "messages": [
    {
      "id": "uuid",
      "domain_id": "uuid",
      "from_address": "remetente@externo.com",
      "to_address": "contato@meudominio.com",
      "subject": "Assunto",
      "attachment_count": 1,
      "is_feedback_report": false,
      "received_at": "..."
    }
  ]
}

Consultar uma mensagem recebida

GET /v1/inbound-messages/{id}

Além dos campos acima, retorna:

{
  "attachments": [
    {
      "filename": "nota-fiscal.pdf",
      "content_type": "application/pdf",
      "size_bytes": 45213,
      "download_url": "https://.../presigned-url"
    }
  ],
  "raw_message_url": "https://.../presigned-url-eml"
}

download_url e raw_message_url são URLs assinadas com validade de 15 minutos — gere uma nova chamada a este endpoint se precisar baixar o conteúdo novamente depois desse prazo. Podem vir vazias ("") em caso raro de falha ao gerar a URL assinada.

404 se a mensagem não existir ou pertencer a outro tenant.