VK Teams

VK Teams es una super aplicación corporativa para la comunicación y el trabajo en equipo.

Conexión

Configuración en VK Teams

La creación de un Bot en el lado de VK Teams se describe en el artículo: https://teams.vk.com/botapi/tutorial/?lang=en.

1. Abre VK Teams e inicia sesión.

2. Busca el bot "metabot".

a. Envía al bot el comando /newbot.

b. En respuesta al mensaje del bot, introduce el nombre deseado para tu bot.

1. Copia el token recibido.

Configuración del canal del proyecto en la Plataforma

Debe crear y configurar un canal de proyecto con el conector VK 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. Selecciona VK 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. Opcionalmente, cambie el enlace en el campo URL del webhook de VK Teams.

2. Pega el token recibido en el campo token de VK Teams.

1. Opcionalmente, active la recepción de mensajes de servicio conmutando el interruptor basculante.

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. El Agente está entrenado;

ii. El token del campo token de VK 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.

Edición y eliminación del canal del agente

Para editar un Canal de Proyecto, haga clic en su icono en la tarjeta de Agente.

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. El Agente está entrenado;

ii. El token del campo token de VK 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. El Agente está entrenado;

ii. El token del campo token de VK 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

Comunicación en los chats

Para comunicarte con el Bot en los chats de VK Teams, tienes que permitir añadir el Bot a los chats. Para ello, sigue estos pasos:

1. Ir a @metabot

2. Envía el comando /setjoingroups al bot

3. Enviar el apodo o ID del bot

4. Envía la palabra "habilitar"

Después, podrás añadir el Bot a los chats.

Asignación de variables de canal de VK teams.

Canal variable	Canal final	Variable en el cuerpo de una solicitud entrante de un canal	Peculiaridades
channel_visitor_id	VK Teams	de.userId
channel_conversation_id	VK Teams	No
channel_visitor_firstname	VK Teams	de.firstName
channel_visitor_lastname	VK Teams	de.lastName
channel_visitor_account	VK Teams	No
channel_visitor_phone	VK Teams	No
channel_visitor_email	VK Teams	No
channel_visitor_source	VK Teams	No
channel_visitor_auth	VK Teams	No
channel_visitor_location	VK Teams	No
channel_message_id	VK Teams	msgId
channel_message_recipient	VK Teams	No
channel_webhook_url	VK Teams	No
channel_webhook_token	VK Teams	No
channel_service_data	VK Teams	No
channel_reply_to	VK Teams	no

Mensajes de servicio de VK Teams

Por el momento, no se admite la transferencia de mensajes de servicio de canal desde equipos VK.

Comunicación en VK teams

Funcionalidad	Canal	Disponibilidad	Descripción
channel_chat_id	VK Teams		Tiene formato chat.chatId|vk_teams
Los mensajes llegarán al Usuario Bot si el Agente escribe primero en un chat existente	VK Teams	Sí
Botones	VK Teams	Sí	Botones en línea, un botón en una fila, no más de 14 botones
Transferencia al operador	VK Teams	No
Transferencia de archivos como archivos del Agente	VK Teams	Parcialmente	El archivo adjunto se envía como un enlace desde el campo Fuente de la ranura de archivos adjuntos, que VK Teams convierte en un archivo.
Transferencia de archivos como enlaces desde el Agente	VK Teams	Sí
Recepción de un archivo del Usuario Bot en un script	VK Teams	Sí	Tiene formatofichero:tipo de fichero|identificación del fichero|enlace al fichero
Recibir geolocalización de un usuario Bot en un script	VK Teams	No
Entrega de mensajes de más de 1000 caracteres del Agente al Usuario Bot	VK Teams	Sí
Obtener un enlace a la fuente de información	VK Teams	No
Uso de Markdown	VK Teams	No
Envío con notificación	VK Teams	No