Del AMS al Companion: cómo se conecta todo
Mariana Ríos Ochoa prepara el trabajo de Grupo Aurora; Diego Ramírez Peña lo realiza con Coach Comercial; Carlos Méndez Luna le da seguimiento cuando tiene el acceso correspondiente. Aquí verás cómo se conectan las misiones, los anuncios, las tareas y el Analizador con tus sistemas.
Lectura estimada: 12 minutos · Para administradores, líderes y equipos de integración · Ejemplos ficticios de Grupo Aurora.
¿Prefieres tenerla a la mano?
Descarga esta guía en Markdown para consultarla sin conexión, compartirla con tu equipo o dársela a tu asistente de IA para que te acompañe paso a paso.
1 · Descripción
Una operación, varias formas de trabajar
Elige el lugar adecuado según lo que quieres hacer.
AMS: prepara y supervisa
El Agent Management System (AMS) es la consola donde administras Cody: prepara temporadas, audiencias, anuncios y analizadores y sigue las tareas.
Companion: realiza y acompaña
Tu equipo conversa con el coach y realiza el trabajo. Con rol de administrador también puedes entrar al panel de seguimiento desde el celular.
Public API: conecta tus sistemas
Una API es la conexión para que otro sistema consulte o envíe datos a Cody. Úsala para automatizar tareas y llevar datos a tus reportes.
2 · Antes de empezar
Confirma los accesos de cada participante
Ver una pantalla depende del rol, la audiencia y el lugar de cada persona en el organigrama.
Abre el AMS para administrar y el Companion para vivir la experiencia del equipo. El equipo que conecta tus sistemas puede consultar la documentación de la Public API.
- Mantén al día el organigrama y la asignación de personas y agentes.
- En Companion, Panel admin aparece con rol de administrador; Vista usuario te devuelve a la experiencia personal. Un puesto de líder por sí solo no habilita la administración.
- Los resultados del Analizador solo se muestran a sus destinatarios. En tareas, la línea de mando permite consultar y comentar; la edición depende de ser creador o responsable.
- Para conectar un sistema, prepara una credencial de Public API y sigue la guía de cada recurso.
3 · Misiones
Misiones
De una actividad con audiencia al cumplimiento y los puntos de experiencia.
Prepara temporada y misión
En Gamificación del AMS, prepara la temporada, la misión y su audiencia por organigrama. También puedes crearla mediante Misiones y resultados por API. En Misiones en Companion admin consultas el progreso y quién la completó.
La persona la realiza
Diego encuentra la misión en Inicio o Misiones, la abre y sigue la conversación con su coach. Al completarla, revisa los XP (puntos de experiencia) y el nivel. Quest muestra su recorrido por semanas y permite consultar el ranking, es decir, la clasificación.
Da seguimiento y conecta los resultados
Revisa calendario y cumplimiento en el AMS o Ver usuarios y Ranking en Companion admin. Para consultar temporadas, calendario, resultados y clasificaciones desde tu sistema, sigue Misiones y resultados por API. Para extraer conversaciones de una misión, usa Exportación de datos.
- Solicitud
- Respuesta
- Ocurre en segundo plano
| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
|---|---|---|---|
| AMS → Gamificación o Public API → Misiones y resultados | Inicio, Misiones y Quest | AMS: calendario y cumplimiento. Companion admin: Ver usuarios y Ranking. | gamification-challenge, gamification-calendar, gamification-result, gamification-ranking y data/threads?challenge_id. Sigue la guía de misiones y exportación. |
4 · Anuncios
Anuncios
De una publicación con audiencia a la lectura y su seguimiento.
Publica para tu audiencia
Crea el mensaje en Anuncios del AMS o Comunicación de Companion admin. Elige personas o áreas del organigrama y decide si lo acompañas con una notificación push (un aviso al celular).
El equipo abre el comunicado
La publicación aparece en el Centro de anuncios de Inicio. La persona abre su texto, imagen o video. Recibir un aviso al celular no equivale a haber leído el anuncio.
Consulta lectores y automatiza
Revisa quién lo leyó desde el detalle de la publicación. Para administrar publicaciones desde tu sistema, usa Anuncios por API; para los avisos al celular, consulta Push Notifications.
- Solicitud
- Respuesta
- Ocurre en segundo plano
| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
|---|---|---|---|
| AMS → Anuncios o Companion admin → Comunicación | Inicio → Centro de anuncios; aviso al celular si se envió. | Detalle del anuncio y seguimiento de lectores en AMS o Companion admin. | announcement/* y push-notification/*. Consulta Anuncios y Push Notifications. |
5 · Tareas
Tareas
De un pendiente con responsable al avance con comentarios y evidencia.
Crea el pendiente
Crea una tarea en Tareas del AMS, desde una acción sugerida del Analizador o con Crea una tarea junto a un mensaje del coach. También puedes crearla desde el tablero personal de Companion. En todos los casos revisa el título y el responsable.
La persona actualiza el trabajo
La persona responsable abre Tareas, comenta, agrega imágenes y actualiza el estatus. Los estados son Por hacer, En curso y Hechas. Solo creador y responsable pueden editar; otras personas con acceso pueden comentar.
Sigue el avance o intégralo
Usa el tablero del AMS o el resumen de tareas del equipo en Companion. Desde ese resumen, Ver tablero permite abrir el trabajo concreto. Para crear y consultar pendientes desde otro sistema, sigue Tareas por API.
- Solicitud
- Respuesta
- Ocurre en segundo plano
| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
|---|---|---|---|
| AMS → Tareas, acción del Analizador o coach y tablero de Companion | Companion → Tareas de la persona responsable. | AMS: tablero. Companion admin: resumen y Ver tablero. | task/*. Sigue Tareas por API para filtros, creación y actualización. |
6 · Analizador
Analizador
De las conversaciones a resultados con citas y una acción sugerida.
Configura lo que quieres encontrar
En el Analizador del AMS, define qué buscar, de quién y a qué administradores entregar los resultados.
Consulta y decide
Los destinatarios revisan resultados en el AMS o en Companion admin → Analizador. Lee las citas que respaldan el hallazgo y, si existe una acción sugerida, conviértela en tarea con responsable.
Extrae las conversaciones para tu reporte
La Exportación de datos permite obtener mensajes de conversaciones. Esa descarga es información de origen para tus reportes; no se presenta aquí como una descarga de los resultados del Analizador.
- Solicitud
- Respuesta
- Ocurre en segundo plano
| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
|---|---|---|---|
| AMS → Analizador: configuración y destinatarios. | La persona conversa con su coach; los resultados se dirigen a los administradores elegidos. | AMS: resultados recibidos. Companion admin → Analizador: resultados y citas. | Conversaciones mediante data/messages/export: Exportación de datos. |
7 · Datos por Public API
Lleva el seguimiento a tus sistemas
Comparte estas guías con quien conectará los datos de Grupo Aurora.
Elige el recurso según tu objetivo
| Quieres | Consulta |
|---|---|
| Crear y consultar pendientes | Tareas por API |
| Consultar misiones, calendario y resultados | Misiones y resultados |
| Administrar publicaciones | Anuncios |
| Enviar avisos al celular | Push Notifications |
| Extraer conversaciones y mensajes | Exportación de datos |
Confirma el alcance antes de automatizar
Revisa la credencial, los filtros y los límites descritos en la guía del recurso. Valida primero con un caso pequeño de Grupo Aurora y compara con la pantalla correspondiente antes de preparar un reporte recurrente.
8 · Si algo falla
Revisa el punto donde se corta el recorrido
Audiencia, permisos y filtros explican varias diferencias entre pantallas.
| Lo que ves | Qué hacer |
|---|---|
| La misión no aparece | Revisa perfil, audiencia, periodo y horario de la misión. |
| El anuncio sigue pendiente de lectura | Confirma que la persona abrió el anuncio; el aviso al celular no confirma lectura. |
| El líder puede comentar pero no editar una tarea | La edición corresponde al creador y al responsable; la línea de mando permite consultar y comentar. |
| No hay resultados del Analizador | Revisa los destinatarios y si ya existe una entrega. |
| Un reporte no coincide con la pantalla | Compara el mismo periodo, personas, misión y alcance de consulta. |
9 · Preguntas frecuentes
Dudas sobre el recorrido completo
Qué representa cada pantalla y cada conexión.
- ¿Mi equipo necesita usar el AMS?
- Para sus conversaciones, misiones, anuncios y tareas usa Companion. El AMS se utiliza para administrar y supervisar con los permisos correspondientes.
- ¿Ser líder habilita Panel admin?
- Necesitas rol de administrador. Además, el alcance de tareas y grupos depende de tu posición en el organigrama; los resultados del Analizador dependen de ser destinatario.
- ¿La API de mensajes devuelve los resultados del Analizador?
- La exportación documentada aquí devuelve conversaciones y mensajes. Los resultados del Analizador se consultan en las pantallas de los destinatarios.
¿Necesitas ayuda?
Si un dato no coincide, identifica primero la persona, el periodo y la pantalla de origen. Comparte esa información al pedir ayuda, sin incluir contraseñas ni credenciales.
El equipo de Cody