> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ugps.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Importar un correo de Outlook a un negocio, empresa, contacto, ticket o factura

> Copia asunto, cuerpo, destinatarios, fecha y adjuntos del correo como actividad del negocio o de la empresa y, en un negocio, pasa a «Enviada» las cotizaciones en borrador que se indiquen. Si el correo ya está en Raúl (por ejemplo, en un hilo de la Bandeja), lo asocia sin duplicarlo.



## OpenAPI

````yaml /generated/specs/communications.json post /api/omnichannel/mailbox/import
openapi: 3.0.0
info:
  title: Raul API - Comunicaciones
  description: >-
    Conversations (threads, mensajes, channel accounts), inbox, omnichannel,
    email sync, WhatsApp, social, spam, tags y solicitudes de borrador con IA.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.raul.ugps.io
    description: Production
security: []
tags: []
paths:
  /api/omnichannel/mailbox/import:
    post:
      tags:
        - Omnichannel
      summary: >-
        Importar un correo de Outlook a un negocio, empresa, contacto, ticket o
        factura
      description: >-
        Copia asunto, cuerpo, destinatarios, fecha y adjuntos del correo como
        actividad del negocio o de la empresa y, en un negocio, pasa a «Enviada»
        las cotizaciones en borrador que se indiquen. Si el correo ya está en
        Raúl (por ejemplo, en un hilo de la Bandeja), lo asocia sin duplicarlo.
      operationId: MailboxImportController_import
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ImportMailboxMessageDto'
      responses:
        '200':
          description: Correo importado o asociado
        '404':
          description: El correo no está en el buzón
        '409':
          description: El correo ya es de otro negocio
      security:
        - bearerAuth: []
components:
  schemas:
    ImportMailboxMessageDto:
      type: object
      properties:
        message_ref:
          type: string
          description: Id del mensaje que devolvió la búsqueda en el buzón (`messageId`).
        mailbox:
          type: string
          description: >-
            Buzón compartido o cuenta personal donde se buscó; sin él, la cuenta
            personal.
        opportunity_id:
          type: string
          description: >-
            Negocio al que se asocia el correo. Se indica el negocio o la
            empresa, no ambos.
        client_id:
          type: string
          description: >-
            Empresa a la que se asocia el correo cuando no es de un negocio
            (#3002).
        contact_id:
          type: string
          description: >-
            Contacto al que se asocia el correo cuando no es de un negocio ni de
            una empresa (#3003).
        ticket_id:
          type: string
          description: >-
            Ticket al que se vincula el correo (#3004); queda también con el
            cliente del ticket.
        invoice_id:
          type: string
          description: >-
            Factura a la que se asocia el correo (#3005); queda también con la
            empresa de la factura.
        quote_ids:
          description: >-
            Cotizaciones del negocio que el correo envió; las que estén en
            borrador pasan a «Enviada».
          type: array
          items:
            type: string
      required:
        - message_ref
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Token de sesión Better Auth para rutas de backoffice; las rutas de
        portal usan su token propio.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.