Saltar al contenido
CodyCody
Cody Academy · Cody Companion

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.

1

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ó.

2

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.

3

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.

Recorrido: MisionesDe una actividad con audiencia al cumplimiento y los puntos de experiencia.Administrador en AMSCodyCompanion de la personaLíder en CompanionTu sistema vía Public API1Prepara temporada, misión y audiencia2Presenta la misión disponible3Realiza la actividad con el coach4Permite consultar cumplimiento y ranking5Consulta calendario, resultados o conversaciones
  • Solicitud
  • Respuesta
  • Ocurre en segundo plano
Dónde ocurre cada paso: Misiones
Dónde se creaDónde lo ve tu equipoDónde das seguimientoCómo lo extraes por API
AMS → Gamificación o Public API → Misiones y resultadosInicio, Misiones y QuestAMS: 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.

1

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).

2

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.

3

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.

Recorrido: AnunciosDe una publicación con audiencia a la lectura y su seguimiento.Administrador en AMSCodyCompanion de la personaLíder en CompanionTu sistema vía Public API1Publica anuncio para una audiencia2También puede publicar desde Comunicación3Muestra el anuncio; aviso al celular si se eligió4Abre y lee el anuncio5Presenta los lectores y pendientes6Administra anuncios o envía avisos por API
  • Solicitud
  • Respuesta
  • Ocurre en segundo plano
Dónde ocurre cada paso: Anuncios
Dónde se creaDónde lo ve tu equipoDónde das seguimientoCómo lo extraes por API
AMS → Anuncios o Companion admin → ComunicaciónInicio → 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.

1

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.

2

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.

3

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.

Recorrido: TareasDe un pendiente con responsable al avance con comentarios y evidencia.Administrador en AMSCodyCompanion de la personaLíder en CompanionTu sistema vía Public API1Crea pendiente con responsable2También puede crear tarea desde el coach o tablero3Muestra la tarea asignada4Comenta, adjunta evidencia y actualiza estatus5Presenta indicadores y seguimiento según su alcance6Crea o consulta tareas por API
  • Solicitud
  • Respuesta
  • Ocurre en segundo plano
Dónde ocurre cada paso: Tareas
Dónde se creaDónde lo ve tu equipoDónde das seguimientoCómo lo extraes por API
AMS → Tareas, acción del Analizador o coach y tablero de CompanionCompanion → 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.

1

Configura lo que quieres encontrar

En el Analizador del AMS, define qué buscar, de quién y a qué administradores entregar los resultados.

2

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.

3

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.

Recorrido: AnalizadorDe las conversaciones a resultados con citas y una acción sugerida.Administrador en AMSCodyCompanion de la personaLíder en CompanionTu sistema vía Public API1Define análisis, audiencia y destinatarios2Conversa con su coach3Entrega los resultados a destinatarios en AMS4Permite consultar los resultados recibidos en Companion5Crea una tarea desde la acción sugerida6Exporta mensajes de conversaciones para su reporte
  • Solicitud
  • Respuesta
  • Ocurre en segundo plano
Dónde ocurre cada paso: Analizador
Dónde se creaDónde lo ve tu equipoDónde das seguimientoCó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.

1

Elige el recurso según tu objetivo

Guías de integración
QuieresConsulta
Crear y consultar pendientesTareas por API
Consultar misiones, calendario y resultadosMisiones y resultados
Administrar publicacionesAnuncios
Enviar avisos al celularPush Notifications
Extraer conversaciones y mensajesExportación de datos
2

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.

Revisiones por síntoma
Lo que vesQué hacer
La misión no apareceRevisa perfil, audiencia, periodo y horario de la misión.
El anuncio sigue pendiente de lecturaConfirma que la persona abrió el anuncio; el aviso al celular no confirma lectura.
El líder puede comentar pero no editar una tareaLa edición corresponde al creador y al responsable; la línea de mando permite consultar y comentar.
No hay resultados del AnalizadorRevisa los destinatarios y si ya existe una entrega.
Un reporte no coincide con la pantallaCompara 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