Enviar correo electrónico saliente

Enviar correo electrónico saliente

Propósito: poner en cola SMTP acciones de envío con piezas y archivos adjuntos en línea opcionales.

Flujo de interfaz de usuario

1. El usuario redacta el mensaje.
2. La interfaz de usuario captura destinatarios, asunto, cuerpo y archivos adjuntos.
3. La interfaz de usuario pone en cola POST /api/accounts/:account_id/smtp/messages.
4. La interfaz de usuario realiza un seguimiento de la tarea/trabajo resultante hasta su finalización.
5. La interfaz de usuario actualiza la lista de correo electrónico saliente.

Flujo de la biblioteca del cliente

const queued = await api.provider.smtp.sendMessage(accountId, {
  credential_id: smtpCredentialId,
  direction: "outbound",
  from_json: [{ address: "info@example.com" }],
  to_json: [{ address: "recipient@example.com" }],
  subject: "Status update",
  text_body: "Hello from Inbox Manager",
  html_body: "<p>Hello from Inbox Manager</p>",
  attachments: [
    {
      filename: "report.txt",
      content_type: "text/plain",
      content_b64: Buffer.from("report body").toString("base64"),
      disposition: "attachment",
    },
  ],
});
await api.jobs.waitForTask(accountId, queued.data.task_id);

Flujo HTTP/curl

API_BASE_URL="https://api.inbox-manager.com"

curl -sS -X POST "${API_BASE_URL}/api/accounts/${ACCOUNT_ID}/smtp/messages" \
  -H "authorization: Bearer ${BEARER_TOKEN}" \
  -H "content-type: application/json" \
  --data "{
    \"credential_id\":\"${SMTP_CREDENTIAL_ID}\",
    \"direction\":\"outbound\",
    \"from_json\":[{\"address\":\"${FROM_ADDRESS}\"}],
    \"to_json\":[{\"address\":\"${TO_ADDRESS}\"}],
    \"subject\":\"Status update\",
    \"text_body\":\"Hello from Inbox Manager\",
    \"attachments\":[
      {
        \"filename\":\"report.txt\",
        \"content_type\":\"text/plain\",
        \"content_b64\":\"${ATTACHMENT_B64}\",
        \"disposition\":\"attachment\"
      }
    ]
  }"

Notas

• El envío saliente es asíncrono y está respaldado por trabajos.
• El conjunto de destinatarios vacíos falla rápidamente.