Microsoft Teams

Microsoft Teams es una plataforma empresarial que integra chat, reuniones, notas y archivos adjuntos en un espacio de trabajo. El Agente puede mostrarse como un Bot, que estará disponible dentro del espacio de la empresa.

Conexión

Configuración del bot en Microsoft Teams

En primer lugar, es necesario configurar en el lado de Microsoft Teams.

1. Inicie sesión en Microsoft Teams.

2. Vaya a la sección Apps.

⁠3. En la búsqueda, encuentre la aplicación Portal del Desarrollador y vaya a ella.

1. Ve a Herramientas → Gestión de bots y añade un nuevo bot.

1. Introduce el nombre del Bot y haz clic en Añadir.

1. En el campo Endpoint Address, especifique el webhook del Canal Proyecto (Chatbot webhook: campo URL), que puede recibir al configurar el Canal Proyecto en la Plataforma.

1. Ve a la sección Secretos de cliente, haz clic en el botón Añadir secreto de cliente para el bot y copia el valor del campo en algún lugar. Lo necesitarás cuando configures un Canal de Proyecto en la Plataforma.

1. Vuelve a la sección Herramientas → Gestión de bots y guarda el ID de bot. Lo necesitará cuando configure un canal de proyecto en la plataforma.

1. Vaya a la sección "Apps" en el Portal del Desarrollador. Haz clic en Añadir app. Elige Latest stable en el campo Manifest version.

1. Rellene los campos indicados a continuación y haga clic en Guardar.

   1. Breve descripción.

   2. Descripción detallada.

   3. Nombre del promotor o de la empresa.

   

   d. Sitio web (cualquier URL HTTPS válida).

   e. Política de privacidad (cualquier URL HTTPS válida).

   f. Condiciones de uso (cualquier URL HTTPS válida).

1. En la pestaña Características de la aplicación, seleccione Bot y elija el bot que ha creado. Marque las casillas utilizando la captura de pantalla como guía. Haga clic en Guardar.

1. Elige iconos para tu bot en la pestaña "Branding" (opcional).

2. Haga clic en Publicar en la esquina superior derecha y seleccione "Descargar el paquete de solicitud".

1. Ir al enlace https://admin.teams.microsoft.com/policies/manage-apps -> haz clic en "Acciones" → selecciona Subir nueva app.

1. Haga clic en Cargar una aplicación personalizada y elija el archivo cargado en el paso 12.

1. Haz clic en Añadir.

1. Ahora puedes encontrar tu solicitud en Chats y utilizar el bot.

Configuración del canal del proyecto en la plataforma

Debe crear y configurar un canal de proyectos con el conector de Microsoft Teams.

1. Vaya a la pestaña Canales del proyecto.

1. Pulse el botón Crear canal.

1. Se abrirá el panel de selección de canal final.

1. Seleccione Microsoft Teams.

2. Se abrirá el panel de creación del Canal Proyecto.

1. Opcionalmente, introduzca un título para este Canal de Proyectos en el campo Nombre con el marcador de posición Nuevo canal.

1. Especifique el webhook del canal del proyecto (campo URL del webhook del chatbot) como dirección del punto final en la configuración del bot en Microsoft Teams. Puede copiar la URL completa haciendo clic en el botón Copiar este webhook.

1. Establezca el ID del bot recibido en la configuración del bot de Microsoft Teams en el campo Token de Microsoft Teams de la ventana de configuración del agente.

2. Especifique el secreto de cliente para el bot en el campo URL del webhook de Microsoft Teams.

1. Para guardar el Canal Proyecto sin activarlo, pulse el botón CREAR.

1. Para guardar y activar el Canal Proyecto, haga clic en el botón CREAR Y ACTIVAR.

a. El Canal Proyecto se guardará y activará si:

i. Se publica el proyecto;

ii. El token del campo Token de Microsoft Teams es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. El webhook del canal se ha registrado correctamente.

b. El Canal Proyecto se guardará pero no se activará si no se cumplen una o varias condiciones.

1. Para cancelar la creación del Canal Proyecto, pulse el botón CANCELAR.

Editar y eliminar el canal del proyecto

Para editar un Canal de Proyectos, haga clic en su ficha en la lista de Canales de Proyectos.

1. Para editar cualquier campo, haga clic en él e introduzca un nuevo valor.

2. Para aplicar los cambios a un Canal Proyecto activado, pulse el botón APLICAR.

a. Los cambios se aplicarán si:

i. Se publica el proyecto;

ii. El token en el campo de token de Microsoft Teams es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. El webhook del canal se ha registrado correctamente.

b. Los cambios no se aplicarán si no se cumplen una o varias condiciones.

1. Para desactivar el Canal Proyecto, pulse el botón DESACTIVAR.

1. Para aplicar los cambios a un Canal Proyecto no activado, pulse el botón GUARDAR.

1. Para aplicar los cambios y activar el Canal Proyecto, pulse el botón GUARDAR Y ACTIVAR.

a. Los cambios se aplicarán y el Canal Proyecto se activará si:

i. Se publica el proyecto;

ii. El token del campo Token de Microsoft Teams es único (no hay canales activos del mismo tipo con el mismo token);

iii. La dirección del canal es accesible;

iv. Se puede registrar el webhook del canal.

b. Los cambios se aplicarán pero el Canal Proyecto no se activará si no se cumplen una o varias condiciones.

1. Para cancelar los cambios, pulse el botón CANCELAR.

1. Para eliminar el Canal Proyecto, pulse el botón ELIMINAR.

Comunicación

Asignación de variables de canal desde Microsoft Teams

Canal variable	Canal final	Variable en el cuerpo de una solicitud entrante de un canal	Peculiaridades
channel_visitor_id	Microsoft Teams	de.id
channel_conversation_id	Microsoft Teams	conversación.id
channel_visitor_firstname	Microsoft Teams	No
channel_visitor_lastname	Microsoft Teams	No
channel_visitor_account	Microsoft Teams	de.name
channel_visitor_phone	Microsoft Teams	No
channel_visitor_email	Microsoft Teams	No
channel_visitor_source	Microsoft Teams	No
channel_visitor_auth	Microsoft Teams	No
channel_visitor_location	Microsoft Teams	No
channel_message_id	Microsoft Teams	No
channel_message_recipient	Microsoft Teams	No
channel_webhook_url	Microsoft Teams	serviceUrl
channel_reply_to	Microsoft Teams	no

⁠Comunicación en Microsoft Teams

Funcionalidad	Canal	Disponibilidad	Descripción
channel_chat_id	Microsoft Teams	Sí	Formato: canal_visitante_id|equipos
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente	Microsoft Teams	Sí
Botones	Microsoft Teams	Sí
Transferencia al operador	Microsoft Teams	No	Microsoft Teams no dispone de esta funcionalidad
Transferencia de archivos como archivos del Agente	Microsoft Teams	Sí
Transferencia de archivos como enlaces desde el Agente	Microsoft Teams	Sí
Recepción de un archivo del Usuario Bot en un script	Microsoft Teams	Sí
Recibir geolocalización de un usuario Bot en un script	Microsoft Teams	No
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot	Microsoft Teams	Sí
Obtener un enlace a la fuente de información	Microsoft Teams	No
Uso de Markdown	Microsoft Teams	Sí
Envío con notificación	Microsoft Teams	No