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

# Obtener URL de autorización Microsoft

> Operacion: Obtener URL de autorización Microsoft.



## OpenAPI

````yaml /generated/specs/communications.json get /api/omnichannel/auth/microsoft
openapi: 3.0.0
info:
  title: Raul API - Comunicaciones
  description: Inbox, omnichannel, bandejas compartidas, email sync, WhatsApp, spam y tags.
  version: 2.0.0
  contact: {}
servers:
  - url: https://api.raul.ugps.io
    description: Production
security: []
tags: []
paths:
  /api/omnichannel/auth/microsoft:
    get:
      tags:
        - Omnichannel
      summary: Obtener URL de autorización Microsoft
      description: 'Operacion: Obtener URL de autorización Microsoft.'
      operationId: MicrosoftAuthController_getAuthUrl
      parameters:
        - name: account_type
          required: false
          in: query
          description: Tipo de cuenta a conectar
          schema:
            default: personal
            type: string
            enum:
              - personal
              - shared
        - name: account_label
          required: false
          in: query
          description: 'Etiqueta para la cuenta (ej: "Soporte", "Ventas")'
          schema:
            type: string
      responses:
        '200':
          description: URL de autorización generada
          content:
            application/json:
              schema:
                type: object
                properties:
                  authUrl:
                    type: string
                    example: https://login.microsoftonline.com/...
        '400':
          description: Parámetros inválidos
        '401':
          description: No autenticado
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: Bearer token authentication

````