E-mails

As mensagens que chegaram nas suas inboxes, seu conteúdo já interpretado e o estado de processamento. Veja o modelo Email para a máquina de estados received → approved | rejected → processing → processed | failed.

Comando	HTTP	Descrição
emails list	GET /emails	Lista e-mails recebidos. Os corpos não são incluídos.
emails get	GET /emails/{id}	Busca um e-mail, incluindo os corpos em texto e HTML.
emails eml	GET /emails/{id}/eml	Obtém uma URL pré-assinada de curta duração para o .eml original — expira em 60 segundos.
emails reprocess	POST /emails/{id}/reprocess	Reenfileira um e-mail para seu agent. Só a partir de approved, processed ou failed.
emails delete	DELETE /emails/{id}	Soft-delete.

Exemplos

# Listar, filtrado por status e inbox
kobana inbox emails list \
  --params '{"status": "processed", "inbox_id": "INBOX_ID", "limit": 25}' \
  --fields "id,subject,from,status,received_at"

# Buscar um, com os corpos
kobana inbox emails get \
  --params '{"id": "EMAIL_ID"}' \
  --fields "id,subject,text_body,status"

# Obter a URL pré-assinada do .eml e salvar a resposta
kobana inbox emails eml \
  --params '{"id": "EMAIL_ID"}' \
  --output eml-url.json

# Reprocessar com um agent diferente
kobana inbox emails reprocess \
  --params '{"id": "EMAIL_ID"}' \
  --json '{"agent_id": "AGENT_ID"}'

# Soft-delete
kobana inbox emails delete --params '{"id": "EMAIL_ID"}' --dry-run

Próximos passos

• Agents — o processador que rodou sobre um e-mail.
• System events — o rastro de eventos que um e-mail produziu.