# Integración con Microsoft Teams

- [Integración de ServiceDesk Plus con Microsoft](#intro)
- [Requisitos previos para la integración](#pre-requisites)
- [Roles Requeridos](#roles)
- [Configuración en Microsoft Teams](#settingup)
- [Extensiones de Mensajes](#message-extensions)
- [Configurar Comandos del Bot](#bot-commands)
- [Crear Tarjetas en el Bot de ServiceDesk Plus](#create-cards)
- [Habilitar Notificaciones de Grupo](#notifications)
- [Solicitudes de Creación Rápida](#quickcreate)
- [Realizar Acciones de Aprobación en Solicitudes](#approve)
- [Usando la pestaña Vista de Solicitudes](#request-view-tab)
- [Migración a la versión 14000 y superior](#migrate-to-14000-and-above)
- [Actualizar / Remover](#update-remove-integration)
- [Funciones de IA](#ai-features)
- [Extensiones de Mensajes en Microsoft](#message-extensions-microsoft)
- [Puntos a tener en cuenta](#points)

## Integración de ServiceDesk Plus con Microsoft Teams

Configure la integración de ServiceDesk Plus con Microsoft Teams para aprovechar la aplicación de colaboración.

## Requisitos previos para la integración

La instancia de ServiceDesk Plus On Premise debe estar alojada públicamente con un certificado SSL válido. Consulte la guía para configurar Azure Application Proxy:

[enlace](https://www.manageengine.com/latam/service-desk/help/adminguide/setting-up-azure-application-proxy.html)

## Roles Requeridos

Para configurar la integración con Microsoft Teams, trabajará en la configuración con los siguientes roles:

- ServiceDesk Plus SDAdmin
- Administrador global de Azure / Administrador de Teams y Administrador de Aplicaciones de Azure

## Configuración en Microsoft Teams

Ahora que se han verificado todos los requisitos previos, puede configurar Microsoft Teams y el portal de Azure.

1. Navegue al **Portal de Desarrolladores** en MS Teams. Para localizar la aplicación Portal de Desarrolladores, haga clic en Aplicaciones.

![Portal de desarrolladores](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/792/2023_06_22_07_51_021.png)

2. Dentro del Portal de Desarrolladores, navegue a la **pestaña Aplicaciones** y elija **Importar aplicación**. Descargue el siguiente archivo e impórtelo:

[archivo zip de ServiceDesk Plus](https://workdrive.zohoexternal.in/external/16397c50005ffee0dd8fbb0d21038cb4ffa40e1f53420b74ddd77f0e5474cbcd)

![Importar aplicación](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2671/2023_06_22_07_51_022.png)

3. Una vez importada, será redireccionado a la página de configuración de la aplicación. Allí se mostrarán las características disponibles para **Pestaña Personal** o el **Bot**.

4. **Pestaña Personal**: Puede usarse para ver solicitudes abiertas en ServiceDesk Plus.  
   Vaya a **Elija Características de la aplicación** → **Cree su primera pestaña de aplicación personal**.

![Crear pestaña personal](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/869/2023_06_22_07_51_023.png)

5. Complete los detalles de su instancia de ServiceDesk Plus:

   - Proporcione un nombre.
   - Bajo **URL de Contenido**, use el siguiente formato:

   _<SDP_HOSTED_URL>/WOListView.do?externalframe=true_

   - Ejemplo si su dominio es `https://servicedeskplus.com`:
     ```
     https://servicedeskplus.com/WOListView.do?externalframe=true
     ```

6. Bajo **URL del Sitio Web**, proporcione la URL en el siguiente formato:

   ```
   <SDP_HOSTED_URL>/WOListView.do
   ```

7. Seleccione Alcance como `personal` y bajo Contexto, elija `personalTab`.

![Configuración de pestaña](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/9462/2023_06_22_07_51_024.png)

8. Haga clic en **Confirmar** y luego en **Guardar**.

9. Configure el bot:
   - Vaya a **Características de la aplicación** → **Bot**.
   - Haga clic en **Crear un nuevo**.

![Crear bot](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/4910/2023_06_22_07_51_025.png)

10. Haga clic en **+Nuevo Bot** y proporcione un nombre (por ejemplo, **Bot de ServiceDesk Plus**).

![Nuevo bot](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/7973/2023_06_22_07_51_026.png)

### Configurar cosas en Azure

1. Vaya al portal de Azure → **App registrations**:

   https://portal.azure.com/#view/Microsoft_AAD_IAM/ActiveDirectoryMenuBlade/~/RegisteredApps

2. Seleccione el bot creado.
3. En **Visión General**, copie:
   - ID de Aplicación (Cliente)
   - ID de Inquilino (Directorio)

![Azure overview](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/4979/2023_06_22_07_51_027.png)

4. En **Certificados y secretos** → **+Nuevo**, copie el **VALOR** del secreto.

![Certificados y secretos](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2509/2023_06_22_07_51_028.png)

5. En **Permisos de API** → **Agregar un permiso** → **Microsoft Graph** → **Permisos Delegados** → seleccione `openid`.

![Permisos API](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/6809/2023_06_22_07_51_029.png)

## Configurar cosas en ServiceDesk Plus

1. Vaya a **Admin** → **Integraciones** → **Terceros** → **Microsoft Teams**.
2. Especifique:
   - ID de Aplicación (Cliente)
   - ID de Inquilino
   - Contraseña de Aplicación (valor del secreto)

![Configuración SDP](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/6686/2023_06_22_07_51_0210.png)

Después de guardar, se proporcionarán:

- **URL de Redireccionamiento**
- **URL de Punto Final del Bot**

### Copiar URL de Redireccionamiento

1. En Azure → **Autenticación**
2. **Agregar una plataforma** → **Web**
3. Pegue el URL de Redireccionamiento
4. Marque **ID tokens**
5. Haga clic en **Configurar**

![Autenticación Azure](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/5547/2023_06_22_07_51_0212.png)

### Copiar URL del Punto Final del Bot

1. En Microsoft Teams → Portal → Herramientas → Gestión de Bots.
2. Pegue el URL del Punto Final del Bot.
3. Haga clic en **Guardar**.

![Endpoint bot](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/5126/2023_06_22_07_51_0213.png)

---

## Extensiones de Mensajes

Las Extensiones de Mensajes permiten realizar acciones clave desde Teams.

**Nota**: Disponible desde ServiceDesk Plus versión 15200 en adelante.

Para configurar:

- En Microsoft Teams → **Funciones de Aplicación**
- Seleccione **Extensión de Mensaje**
- Elija un bot existente
- Seleccione el bot creado y haga clic en **Guardar**

![Extensión mensaje](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_12_11_07_24_301.png)

## Opciones

![Opciones](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_12_11_07_24_302.png)

### Creación

Permite crear un nuevo incidente desde un mensaje de Teams.

![Creación incidente](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/Screenshot_2025-05-21_at_2_38_06_PM.png)

### Crear una Nueva

Presenta el formulario completo dentro de Teams.

![Formulario completo](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/Screenshot_2025-05-21_at_2_39_08_PM.png)

### Buscar en

Permite buscar solicitudes similares existentes.

**Configuraciones No ESM**

![Buscar no ESM](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_12_11_07_24_305.png)

**Configuraciones ESM**

![Buscar ESM](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/2025/2025_12_11_07_24_306.png)

---

## Subir la Aplicación

1. En el Portal de Desarrolladores → **Publicar en la Tienda**
2. Descargar paquete de la aplicación

![Descargar paquete](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/9360/2023_06_22_07_51_0216.png)

3. En Teams → **Aplicaciones** → **Subir una aplicación**
4. Seleccione el archivo zip descargado

![Subir aplicación](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/7631/2023_06_22_07_51_0217.png)

---

## Puntos a tener en cuenta

1. Use `/end chat` para finalizar conversaciones iniciadas desde Teams.
2. Si no aparece la opción **Subir una aplicación personalizada**, revise la política en:

https://admin.teams.microsoft.com/policies/app-setup

3. Si la pestaña Vista de Solicitudes no carga:
   - Asegúrese de usar HTTPS.
   - Configure el encabezado:
     ```
     Content-Security-Policy: frame-ancestors 'self' <dominio-servicedesk> teams.microsoft.com
     ```

![Configuración CSP](https://www.manageengine.com/userfiles/866/14262/ckfinder/images/qu/9769/Screenshot_20-06-2024_at_12_42.jpeg)

---