---
title: Del AMS al Companion: cómo se conecta todo
section: Cody Academy / Cody Companion
updated: 2026-10-27
source: https://docs.cody-tech.com/academy/companion/como-se-conecta-todo
markdown: https://docs.cody-tech.com/academy/companion/como-se-conecta-todo.md
---

# Del AMS al Companion: cómo se conecta todo

> **Guía de Cody Academy · Cody Companion.** 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.
>
> Para administradores, líderes y equipos de integración · Ejemplos ficticios de Grupo Aurora.
>
> Versión web, con las capturas de pantalla: https://docs.cody-tech.com/academy/companion/como-se-conecta-todo

## 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](https://ams.cody-tech.com) para administrar y el [Companion](https://companion.cody-tech.com) para vivir la experiencia del equipo. El equipo que conecta tus sistemas puede consultar la [documentación de la Public API](https://api.public.cody-tech.com/api/docs).

- 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](https://docs.cody-tech.com/academy/ams/credenciales-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.

### Paso 1. Prepara temporada y misión

En [Gamificación del AMS](https://docs.cody-tech.com/academy/ams/gamificacion), prepara la temporada, la misión y su audiencia por organigrama. También puedes crearla mediante [Misiones y resultados por API](https://docs.cody-tech.com/academy/public-api/misiones-y-resultados). En [Misiones en Companion admin](https://docs.cody-tech.com/academy/companion/misiones-y-ranking) consultas el progreso y quién la completó.

### Paso 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](https://docs.cody-tech.com/academy/companion/quest) muestra su recorrido por semanas y permite consultar el ranking, es decir, la clasificación.

### Paso 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](https://docs.cody-tech.com/academy/public-api/misiones-y-resultados). Para extraer conversaciones de una misión, usa [Exportación de datos](https://docs.cody-tech.com/academy/public-api/exportacion-de-datos).

**Recorrido: Misiones.** De una actividad con audiencia al cumplimiento y los puntos de experiencia.

```mermaid
sequenceDiagram
    autonumber
    participant AMS as Administrador en AMS
    participant CODY as Cody
    participant PERSONA as Companion de la persona
    participant LIDER as Líder en Companion
    participant SISTEMA as Tu sistema vía Public API
    AMS->>CODY: Prepara temporada, misión y audiencia
    CODY->>PERSONA: Presenta la misión disponible
    PERSONA->>CODY: Realiza la actividad con el coach
    CODY->>LIDER: Permite consultar cumplimiento y ranking
    SISTEMA->>CODY: Consulta calendario, resultados o conversaciones
```

| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
| --- | --- | --- | --- |
| [AMS → Gamificación](https://docs.cody-tech.com/academy/ams/gamificacion) o [Public API → Misiones y resultados](https://docs.cody-tech.com/academy/public-api/misiones-y-resultados) | [Inicio](https://docs.cody-tech.com/academy/companion/inicio), [Misiones](https://docs.cody-tech.com/academy/companion/misiones) y [Quest](https://docs.cody-tech.com/academy/companion/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](https://docs.cody-tech.com/academy/public-api/misiones-y-resultados) y [exportación](https://docs.cody-tech.com/academy/public-api/exportacion-de-datos). |

## 4. Anuncios: Anuncios

De una publicación con audiencia a la lectura y su seguimiento.

### Paso 1. Publica para tu audiencia

Crea el mensaje en [Anuncios del AMS](https://docs.cody-tech.com/academy/ams/anuncios) o [Comunicación de Companion admin](https://docs.cody-tech.com/academy/companion/comunicacion). Elige personas o áreas del organigrama y decide si lo acompañas con una notificación push (un aviso al celular).

### Paso 2. El equipo abre el comunicado

La publicación aparece en el **Centro de anuncios** de [Inicio](https://docs.cody-tech.com/academy/companion/inicio). La persona abre su texto, imagen o video. Recibir un aviso al celular no equivale a haber leído el anuncio.

### Paso 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](https://docs.cody-tech.com/academy/public-api/anuncios); para los avisos al celular, consulta [Push Notifications](https://docs.cody-tech.com/academy/public-api/push-notifications).

**Recorrido: Anuncios.** De una publicación con audiencia a la lectura y su seguimiento.

```mermaid
sequenceDiagram
    autonumber
    participant AMS as Administrador en AMS
    participant CODY as Cody
    participant PERSONA as Companion de la persona
    participant LIDER as Líder en Companion
    participant SISTEMA as Tu sistema vía Public API
    AMS->>CODY: Publica anuncio para una audiencia
    LIDER->>CODY: También puede publicar desde Comunicación
    CODY->>PERSONA: Muestra el anuncio; aviso al celular si se eligió
    PERSONA->>CODY: Abre y lee el anuncio
    CODY->>LIDER: Presenta los lectores y pendientes
    SISTEMA->>CODY: Administra anuncios o envía avisos por API
```

| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
| --- | --- | --- | --- |
| [AMS → Anuncios](https://docs.cody-tech.com/academy/ams/anuncios) o [Companion admin → Comunicación](https://docs.cody-tech.com/academy/companion/comunicacion) | [Inicio → Centro de anuncios](https://docs.cody-tech.com/academy/companion/inicio); aviso al celular si se envió. | Detalle del anuncio y seguimiento de lectores en AMS o Companion admin. | `announcement/*` y `push-notification/*`. Consulta [Anuncios](https://docs.cody-tech.com/academy/public-api/anuncios) y [Push Notifications](https://docs.cody-tech.com/academy/public-api/push-notifications). |

## 5. Tareas: Tareas

De un pendiente con responsable al avance con comentarios y evidencia.

### Paso 1. Crea el pendiente

Crea una tarea en [Tareas del AMS](https://docs.cody-tech.com/academy/ams/tareas), desde una acción sugerida del Analizador o con **Crea una tarea** junto a un mensaje del [coach](https://docs.cody-tech.com/academy/companion/coach). También puedes crearla desde el tablero personal de Companion. En todos los casos revisa el título y el responsable.

### Paso 2. La persona actualiza el trabajo

La persona responsable abre [Tareas](https://docs.cody-tech.com/academy/companion/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.

### Paso 3. Sigue el avance o intégralo

Usa el tablero del AMS o el [resumen de tareas del equipo en Companion](https://docs.cody-tech.com/academy/companion/tareas-del-equipo). Desde ese resumen, **Ver tablero** permite abrir el trabajo concreto. Para crear y consultar pendientes desde otro sistema, sigue [Tareas por API](https://docs.cody-tech.com/academy/public-api/tareas).

**Recorrido: Tareas.** De un pendiente con responsable al avance con comentarios y evidencia.

```mermaid
sequenceDiagram
    autonumber
    participant AMS as Administrador en AMS
    participant CODY as Cody
    participant PERSONA as Companion de la persona
    participant LIDER as Líder en Companion
    participant SISTEMA as Tu sistema vía Public API
    AMS->>CODY: Crea pendiente con responsable
    PERSONA->>CODY: También puede crear tarea desde el coach o tablero
    CODY->>PERSONA: Muestra la tarea asignada
    PERSONA->>CODY: Comenta, adjunta evidencia y actualiza estatus
    CODY->>LIDER: Presenta indicadores y seguimiento según su alcance
    SISTEMA->>CODY: Crea o consulta tareas por API
```

| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
| --- | --- | --- | --- |
| [AMS → Tareas](https://docs.cody-tech.com/academy/ams/tareas), acción del Analizador o [coach y tablero de Companion](https://docs.cody-tech.com/academy/companion/tareas) | [Companion → Tareas](https://docs.cody-tech.com/academy/companion/tareas) de la persona responsable. | AMS: tablero. [Companion admin: resumen y Ver tablero](https://docs.cody-tech.com/academy/companion/tareas-del-equipo). | `task/*`. Sigue [Tareas por API](https://docs.cody-tech.com/academy/public-api/tareas) para filtros, creación y actualización. |

## 6. Analizador: Analizador

De las conversaciones a resultados con citas y una acción sugerida.

### Paso 1. Configura lo que quieres encontrar

En el [Analizador del AMS](https://docs.cody-tech.com/academy/ams/analizador), define qué buscar, de quién y a qué administradores entregar los resultados.

### Paso 2. Consulta y decide

Los destinatarios revisan resultados en el AMS o en [Companion admin → Analizador](https://docs.cody-tech.com/academy/companion/panel-y-analizador). Lee las citas que respaldan el hallazgo y, si existe una acción sugerida, conviértela en tarea con responsable.

### Paso 3. Extrae las conversaciones para tu reporte

La [Exportación de datos](https://docs.cody-tech.com/academy/public-api/exportacion-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: Analizador.** De las conversaciones a resultados con citas y una acción sugerida.

```mermaid
sequenceDiagram
    autonumber
    participant AMS as Administrador en AMS
    participant CODY as Cody
    participant PERSONA as Companion de la persona
    participant LIDER as Líder en Companion
    participant SISTEMA as Tu sistema vía Public API
    AMS->>CODY: Define análisis, audiencia y destinatarios
    PERSONA->>CODY: Conversa con su coach
    CODY->>AMS: Entrega los resultados a destinatarios en AMS
    CODY->>LIDER: Permite consultar los resultados recibidos en Companion
    LIDER->>CODY: Crea una tarea desde la acción sugerida
    SISTEMA->>CODY: Exporta mensajes de conversaciones para su reporte
```

| Dónde se crea | Dónde lo ve tu equipo | Dónde das seguimiento | Cómo lo extraes por API |
| --- | --- | --- | --- |
| [AMS → Analizador](https://docs.cody-tech.com/academy/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](https://docs.cody-tech.com/academy/companion/panel-y-analizador): resultados y citas. | Conversaciones mediante `data/messages/export`: [Exportación de datos](https://docs.cody-tech.com/academy/public-api/exportacion-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.

### Paso 1. Elige el recurso según tu objetivo

| Quieres | Consulta |
| --- | --- |
| Crear y consultar pendientes | [Tareas por API](https://docs.cody-tech.com/academy/public-api/tareas) |
| Consultar misiones, calendario y resultados | [Misiones y resultados](https://docs.cody-tech.com/academy/public-api/misiones-y-resultados) |
| Administrar publicaciones | [Anuncios](https://docs.cody-tech.com/academy/public-api/anuncios) |
| Enviar avisos al celular | [Push Notifications](https://docs.cody-tech.com/academy/public-api/push-notifications) |
| Extraer conversaciones y mensajes | [Exportación de datos](https://docs.cody-tech.com/academy/public-api/exportacion-de-datos) |

### Paso 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.

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