Para qué sirve#
Esta página lista las 20 herramientas que ve tu asistente de IA cuando conectas WinChange (cómo conectarlo, en Conecta tu IA a WinChange). No hace falta usarlas a mano: le preguntas a la IA en lenguaje natural y ella elige la herramienta y rellena los parámetros. Sirve para saber qué puede contestar, por qué a veces te pide un dato y qué significan los nombres que aparecen en el registro de tu asistente.
Los nombres de las herramientas (winchange_…) y de sus parámetros son los que ves en tu cliente de IA. Las respuestas llegan en castellano y en formato de datos, con notas que explican a la IA cómo leerlas.
Cómo se leen#
- Permiso. Cada herramienta pertenece a uno de los cuatro permisos que eliges al autorizar. La IA solo ve las de los permisos que marcaste.
winchange_proyectosestá siempre disponible. proyecto_id. Todas, salvowinchange_proyectos, lo piden: es el número del proyecto que devuelvewinchange_proyectos. Si se pide un proyecto que no está en la conexión, la herramienta lo rechaza y dice cuáles hay.- Formato. Las fechas van como
AAAA-MM-DDy los números, como números enteros. Si la IA manda otra cosa ("el mes pasado", "la siguiente"), la herramienta la rechaza explicando qué esperaba, en vez de ignorarla. - Paginación. Las listas largas llegan por páginas con un recuento que dice cuántas filas hay en total y si quedan más.
Herramientas de consulta#
Permiso Consultar datos agregados del programa. Ninguna devuelve nombres de personas.
winchange_proyectos#
Los proyectos de los que eres administrador y que incluye esta conexión, con su número y su nombre. La IA la llama primero. Sin parámetros.
winchange_participacion#
La foto del programa: personas registradas y activas (hoy, en 7 y 14 días y en el mes), acciones completadas en la última semana frente a la anterior y en 28 días, entregas pendientes de aprobar y de validar, acciones fuera de plazo, puntos otorgados, noticias y comentarios recientes, canjes de la tienda y una lista de recomendaciones. Parámetros: solo proyecto_id.
winchange_ubicaciones#
La participación por centro o ubicación: personas, cuántas han entrado en los últimos 28 días, el porcentaje y las acciones completadas en cada una. Viene ordenada de mejor a peor y marca las que van rezagadas. Cada fila trae el número de ubicación con el que la IA puede pedir después la lista de esas personas a winchange_personas. Parámetros: solo proyecto_id.
winchange_acciones#
El catálogo de acciones del proyecto: nombre, puntos, forma de completarse, grupo, itinerario, insignia, plazo y a quién va dirigida. Es la herramienta que da el número de cada acción, que piden winchange_personas y winchange_notificar.
| Campo | Qué hace | Valores |
|---|---|---|
estado | Qué acciones salen. | activas (publicadas y sin archivar) o todas (incluye borradores y archivadas). Por defecto: activas. |
pagina | Página de la lista. | Número desde 1. Por defecto: 1. |
por_pagina | Filas por página. | Número. Por defecto: 50; máximo 100. |
Dos lecturas que la respuesta explica: una acción dirigida a todo el proyecto es lo normal, no una acción sin destinatarios; y con fechas relativas el plazo se cuenta desde la asignación de cada persona, así que no hay una fecha común.
winchange_acciones_atascadas#
Qué acciones no se están completando y dónde se atascan: sin actividad, por forma de completarse y por grupo, más las que sí funcionan. Parámetros: solo proyecto_id.
winchange_evolucion#
Si el proyecto va a mejor o a peor: las últimas cuatro semanas, la última frente a la anterior, el alcance (personas distintas) y la actividad que alimenta el programa (noticias, comentarios, puntos). Parámetros: solo proyecto_id.
winchange_serie#
Acciones completadas y personas activas, día a día, en el periodo que pidas, junto con el mismo periodo inmediatamente anterior para comparar.
| Campo | Qué hace | Valores |
|---|---|---|
desde | Primer día incluido. | Fecha AAAA-MM-DD. Por defecto: 27 días antes de hasta. |
hasta | Último día incluido. | Fecha AAAA-MM-DD. Por defecto: hoy. |
Como mucho 92 días por consulta.
winchange_comentarios#
La conversación del proyecto: volumen de comentarios, hilos sin respuesta, cola de moderación, reacciones, en qué contenidos se comenta y qué ubicaciones participan. Ojo: los hilos sin responder miran 90 días y el resto, 28. Parámetros: solo proyecto_id.
winchange_puntos#
Lo que cuesta el programa: puntos emitidos, canjeados y saldo pendiente desde el principio, su equivalencia en euros con el factor de tu empresa, el ritmo de los últimos 30 días, lo pendiente de entregar, de dónde salen los puntos, la evolución por meses y el catálogo de la tienda visto por precio. Parámetros: solo proyecto_id.
winchange_tienda#
El catálogo de premios artículo a artículo: precio en puntos y en euros, unidades disponibles, canjes, entregados y pendientes de entregar, límite por persona y qué acciones lo desbloquean (hay que tenerlas todas aprobadas para poder canjearlo) o lo regalan (al aprobarse, la persona recibe un pedido automático a 0 puntos). No dice quién ha canjeado qué ni si una persona concreta ve el artículo. Parámetros: solo proyecto_id.
winchange_contenido#
Qué contenido tienen las acciones y cuáles están mal configuradas: reparto por tipo de contenido y por forma de completarse, piezas de la biblioteca y alarmas (acciones publicadas a las que les falta lo que necesitan para poder completarse). Parámetros: solo proyecto_id.
winchange_logros#
El reconocimiento: cuánta gente hay en cada nivel de la escalera, las medallas de acción, los certificados emitidos y alarmas como un proyecto sin escalera de niveles. Se calcula en el momento: no hay histórico. Parámetros: solo proyecto_id.
winchange_pulso#
El ánimo del equipo: el índice del último mes cerrado (de 0 a 100, a partir de la media de la escala 1–5) y la tendencia de doce meses. Solo meses naturales cerrados con al menos cinco personas distintas; un mes sin muestra suficiente sale vacío, no a cero. No incluye comentarios, preguntas, repartos ni desglose por centro o área.
| Campo | Qué hace | Valores |
|---|---|---|
dias | No cambia los meses que se publican. | Número de 30 a 180. Por defecto: 90. |
winchange_encuestas#
El catálogo de cuestionarios con sus oleadas y, para una oleada cerrada, el resultado de cada pregunta. Solo se publican oleadas cerradas con al menos cinco personas; una pregunta se oculta entera si alguna de sus opciones no llega a cinco personas distintas. El texto libre no se entrega nunca.
| Campo | Qué hace | Valores |
|---|---|---|
encuesta_id | Qué cuestionario abrir. | Número del catálogo. Por defecto: el último lanzado. |
oleada_id | Qué oleada abrir. | Número de la lista de oleadas. Por defecto: la última lanzada. |
Herramientas de personas#
Permiso Consultar nombres y fichas de personas. Ninguna devuelve correos, y no se puede buscar a nadie por nombre.
winchange_personas#
Quién hay detrás de un número del panel: la lista con nombre y apellidos, ubicación y dos datos que cambian según la lista (por ejemplo, la última vez que entró y los días sin entrar).
| Campo | Qué hace | Valores |
|---|---|---|
tipo | Qué lista. | at_risk (llevan tiempo sin entrar), registered (todas las altas), pending_approval (entregas esperando aprobación; incluye quién tiene que aprobar), overdue (acciones fuera de plazo), location (personas de una ubicación), action (quién ha hecho una acción), action_status (en qué estado está cada persona en una acción), action_group (avance en un grupo de acciones). Obligatorio. |
ref_id | La ubicación, la acción o el grupo. | Número. Obligatorio con location, action, action_status y action_group. |
pagina | Página de la lista. | Número desde 1. Por defecto: 1. |
por_pagina | Filas por página. | Número. Por defecto: 50; máximo 100. |
winchange_persona#
La ficha de una persona: puesto, ubicación y unidad, si es administradora o manager, actividad en la app (última vez, días sin entrar, accesos), acciones asignadas y completadas, el reparto por estado, las pendientes con su plazo (hasta 20) y las completadas recientes. No incluye correo, saldo ni movimientos de puntos, ni nada sobre encuestas.
| Campo | Qué hace | Valores |
|---|---|---|
persona_id | Qué persona. | El número de persona que devuelve winchange_personas. Obligatorio (o persona_uuid). |
persona_uuid | Alternativa a persona_id. | El identificador público de la persona, si la lista lo trae. |
Herramientas que escriben#
Ninguna puede editar ni borrar lo que ya existe. Lo que crean queda en el registro de auditoría con el usuario que autorizó la conexión.
winchange_notificar#
Permiso Preparar y enviar notificaciones tras confirmar destinatarios y texto. Manda una notificación push a uno de los grupos de winchange_personas, en dos pasos:
- Ensayo (sin
confirmacion): no envía nada. Devuelve el texto, a cuántas personas iría, cuántas tienen la app instalada y un código de confirmación. - Envío (con ese código): envía. El código caduca a los diez minutos y solo vale para el mismo texto, grupo, selección y destinatarios del ensayo, en la misma conexión. Repetir el envío con el mismo código devuelve el mismo resultado sin reenviar.
| Campo | Qué hace | Valores |
|---|---|---|
tipo | A qué grupo se avisa. | Los mismos de winchange_personas. Con pending_approval, el aviso va a quien tiene que aprobar, no a quien entregó. Y uno más, solo de esta herramienta: pending_validation, un recordatorio a quienes tienen pendiente validar la acción de un compañero (no a quien pidió la validación). Obligatorio. |
ref_id | La ubicación, la acción o el grupo. | Número. Obligatorio con location, action, action_status y action_group. Con pending_validation es opcional: la acción cuyas validaciones quieres recordar. |
titulo | Título del aviso: lo que se lee en la pantalla bloqueada. | Texto, hasta 120 caracteres. Obligatorio. |
mensaje | Cuerpo del aviso. | Texto, hasta 500 caracteres. Obligatorio. |
personas_ids | Avisar solo a algunas personas del grupo. | Lista de números de persona. Se cruza con el grupo: no lo amplía. |
confirmacion | El código del ensayo. | Vacío para ensayar. |
La respuesta distingue destinatarios (personas) de filas del segmento (una persona puede salir en varias filas), y dice si se ha enviado. Enviado significa que el servicio de notificaciones lo ha aceptado, no que haya llegado a cada móvil.
winchange_crear_itinerario#
Permiso Crear borradores de acciones, grupos e itinerarios. Crea un itinerario vacío. No lo ve nadie hasta que contiene acciones publicadas y asignadas. Se rechaza si ya hay uno con el mismo nombre en el proyecto.
| Campo | Qué hace | Valores |
|---|---|---|
nombre | Nombre del itinerario, el que lee la gente. | Texto. Obligatorio. |
descripcion | Una o dos frases sobre el itinerario. | Texto. Opcional. |
orden | Posición entre los itinerarios en el panel, de menor a mayor. | Número de 0 a 999. Por defecto: 0. |
winchange_crear_grupo#
Mismo permiso. Crea un grupo de acciones vacío, dentro de un itinerario o suelto. Se rechaza si ya hay uno con el mismo nombre en el proyecto.
| Campo | Qué hace | Valores |
|---|---|---|
nombre | Nombre del grupo, la cabecera que la gente ve encima de sus acciones. | Texto. Obligatorio. |
descripcion | Contexto bajo el nombre. | Texto. Opcional. |
itinerario | Itinerario del que cuelga, por su nombre exacto. | Texto. Opcional: vacío deja el grupo suelto. Si no existe, se rechaza y la respuesta dice cuáles hay. |
orden | Posición dentro del itinerario, de menor a mayor. | Número de 0 a 999. Por defecto: 0. |
winchange_crear_accion#
Mismo permiso. Crea una acción en borrador, sin publicar y sin asignación automática, con su contenido en una sola llamada. La audiencia queda sin acotar, que en WinChange significa todo el proyecto cuando se publique. Admite dos formas de contenido, nunca las dos a la vez: una lección (bloques) o un protocolo recurrente (checklist). Si algo no es válido, la respuesta lista todos los problemas y no se crea nada.
| Campo | Qué hace | Valores |
|---|---|---|
nombre | Nombre de la acción. | Texto. Obligatorio. |
descripcion | Frases de contexto bajo el nombre. | Texto. Opcional. |
puntos | Puntos que paga al completarse (en un protocolo, en cada periodo cumplido). | Número de 0 a 1.000. Por defecto: 0. |
umbral | Nota mínima para aprobar el test. | Número de 0 a 100. Por defecto: 0. Exige al menos una pregunta; no vale en un protocolo. |
grupo | Grupo de acciones, por su nombre exacto. La acción hereda el itinerario del grupo. | Texto. Opcional. Si no existe o está inactivo, se rechaza y dice cuáles hay. |
categoria | Categoría, por su nombre exacto. | Texto. Opcional. |
plazo_dias | Días de plazo desde la asignación. | Número de 0 a 365; 0 = sin plazo. No vale en un protocolo. |
inicio_dias | Días desde la asignación hasta que se puede empezar. | Número de 0 a 365, no mayor que plazo_dias. No vale en un protocolo. |
bloques | La lección, en orden. | Lista de bloques: texto (text, con título y antetítulo opcionales), cita (quote, con autor) y pregunta (quiz: enunciado, al menos dos opciones, la correcta por su posición empezando en 0 y una explicación opcional). No admite imágenes. |
checklist | Las comprobaciones de un protocolo recurrente. | Lista de 1 a 20 comprobaciones, cada una con texto, detalle opcional y si es obligatoria (por defecto, sí). Al menos una obligatoria. |
recurrencia | Cada cuánto se abre un periodo nuevo del protocolo. | dia o semana (de lunes a domingo). Solo con checklist. |
dias_semana | Qué días toca un protocolo diario. | Números del 1 (lunes) al 7 (domingo) separados por comas. Vacío: todos los días. |
completa_accion | En un protocolo, si cumplir el primer periodo deja además la acción completada. Útil cuando el protocolo es requisito de otra cosa. | Sí o no. Por defecto: no (el protocolo nunca completa la acción). Solo con checklist. |
zona_horaria | Huso en el que cambia el día o la semana. | Europe/Madrid (por defecto), Atlantic/Canary, Europe/Lisbon, Europe/London, Europe/Paris y algunas de América. |
La respuesta dice en qué grupo, itinerario y categoría ha quedado, y cómo se completa:
- Con
bloques: se aprueba sola al superar el test y paga los puntos en ese momento. - Sin contenido: queda como acción que aprueba un manager.
- Con
checklist: la persona marca la checklist en cada periodo y cobra los puntos cada vez, sin revisión. Un periodo que se deja pasar se cierra como no cumplido. Concompleta_accion, el primer periodo cumplido deja también la acción completada.
Para que el borrador llegue a alguien, en Acciones acotas la audiencia en el paso Asignación, pulsas Publicar acción y aplicas las asignaciones con Ver cambios de asignación, que antes te dice a cuántas personas llegará.
Avisos#
- Lo que se crea no se corrige desde el conector. Revisa el contenido en la conversación antes de pedir que lo cree. Para corregir, publicar, archivar o borrar, usa Acciones, Grupos de Acción e Itinerarios.
- Un push no se retira. El ensayo existe para que lo leas: comprueba el texto y el número de personas antes de dar el sí.
- Los datos personales se quedan en tu asistente. Lo que devuelven las herramientas de personas pasa a la conversación de tu asistente de IA.
Relacionado#
- Conecta tu IA a WinChange: conexión, permisos y desconexión.
- Panel de administración: las mismas cifras en el panel.
- Push - Enviar notificaciones: avisos push desde el panel.