En esta sección
Guías / Rutinas y grupos

Rutinas y grupos

Lee qué rutinas puede aprenderse tu equipo de Mets, en qué grupos trabajan las personas con sus Mets, y de dónde nació cada tarea.

Actualizada el Ver .md

Tu equipo de Mets no solo responde: aprende rutinas. Una rutina es un proceso del negocio —crear y publicar en tus redes, anunciar lo que vendes, hacer seguimiento a tus clientes— que el equipo repite cada vez: tres pasos y, en cada paso, dos caminos para elegir. Esas rutinas corren en grupos, donde las personas del negocio y sus Mets conversan y trabajan juntos (en Met, «Conversaciones» → «Grupos»). Y cada vez que una rutina corre, deja una tarea.

Con la API lees las tres cosas, y en un grupo también escribes, como tú. Empezar una rutina, elegir un camino, crear un grupo o sumar a alguien se hace en Met.

Antes de empezar

Tu key necesita routines:read para las rutinas, groups:read para los grupos y sus mensajes, y groups:write para escribir en ellos. Las keys emitidas antes de que existieran no los traen: agrégalos en Ajustes › Desarrolladores o emite una nueva. Con una key de test (met_test_) se lee todo y se puede escribir en un grupo, pero no mencionar a un Met: su respuesta gasta Energía real, así que esa llamada responde 403 test_mode_restricted. Los mensajes se leen y se escriben solo como la persona misma: una key de partner responde 403 acting_as_another_person. El campo origin de las tareas no pide nada nuevo: va con tasks:read, como el resto de la tarea.

Las rutinas del negocio

import { Met } from '@meteor.ia/sdk';

const met = new Met(process.env.METEOR_API_KEY!);

const { data: rutinas } = await met.routines.list();
for (const r of rutinas) {
  console.log(r.id, '—', r.name);
  for (const paso of r.steps) {
    console.log(`  ${paso.number}. ${paso.title}:`, paso.paths.map((c) => `${c.title} (${c.done_by})`).join(' / '));
  }
}

Cada rutina trae:

Por qué los caminos dicen quién los hace. Una rutina gasta IA solo donde hace falta: elegir un camino es un botón y no llama a ningún modelo, el encargo al Met se arma con una plantilla, cada paso con IA es una sola delegación a un solo Met, su salida se valida antes de mostrarse, lo que publica o gasta pauta espera la aprobación de una persona, y al cerrar se ve la Energía de toda la corrida. Es el mismo patrón que puedes armar con tus flujos: lo explica Arquitectura: cuándo flujo, cuándo Met y cómo combinarlos.

Solo salen las rutinas disponibles en tu negocio. Algunas se abren de a poco: mientras una no esté disponible para ti, no aparece en la lista y met.routines.retrieve(id) responde 404.

Los ids son texto, no una lista cerrada. Hoy las rutinas abiertas son redes, anuncios y seguimiento (y hay otras en piloto), pero el producto suma rutinas y caminos cada semana. Trata un id que no conoces como uno más, no como un error.

Los grupos

for await (const g of met.groups.iterate()) {
  const personas = g.members.people.map((p) => `${p.name} (${p.role})`);
  const mets = g.members.mets.map((m) => (m.main ? `${m.name} ★` : m.name));
  console.log(g.title, '·', g.purpose ?? 'sin propósito', '·', personas.join(', '), '·', mets.join(', '));
}

Cada grupo trae para qué es (purpose), la rutina que corre en él (routine, el id de una rutina, o null) y sus miembros, separados:

Solo ves tus grupos. La lista trae los grupos de los que eres parte —o de los que es parte la persona que representa tu key—. Los de otras personas no se ven, tampoco con una key de administrador: es la misma regla de las conversaciones.

Una conversación de a dos no es un grupo. Si solo están dos personas, sin propósito ni rutina, la app la muestra como la conversación con esa persona, y aquí no aparece: ni en la lista ni en el detalle (404). Basta con darle un propósito, sumar a alguien más o a un Met para que sea un grupo.

La lista es siempre { data, has_more, next_cursor }, del grupo más nuevo al más viejo: pasa next_cursor en starting_after hasta que has_more sea false, o usa iterate().

Los mensajes de un grupo

const pagina = await met.groups.messages(1714, { limit: 20 });
for (const m of pagina.data) {
  console.log(m.created_at, m.author?.name ?? '—', m.origin?.client ? `(desde ${m.origin.client})` : '', m.text);
}

La primera página son los mensajes más recientes, en orden cronológico; pasa next_cursor en starting_after para traer los anteriores. Cada mensaje trae:

Escribir como tú

await met.groups.sendMessage(1714, { text: 'Las fotos del local ya están en la carpeta' });
// Un Met responde solo si lo mencionas:
const r = await met.groups.sendMessage(1714, { text: '@Met arma tres ideas para el post del viernes' });
console.log(r.mentioned_mets.map((m) => m.name)); // ['Met']

El mensaje queda firmado por ti —la persona de la sesión o la que representa la key, nunca otra— y en el grupo se ve con la marca de dónde llegó: «desde Claude» o «desde ChatGPT» (se reconocen por a dónde vuelve la autorización de la app, no por su nombre), «desde una app conectada» o «desde la API». Escribir «hazlo» o «apruebo» desde aquí no aprueba nada: las aprobaciones se deciden en Met.

Un Met responde solo si lo mencionas, con @ y su nombre en el texto (al principal también con «@Met») o con su id en mention_met_ids. Sin mención el mensaje es para las personas del grupo: no responde ningún Met y no se consume Energía. Con mención, mentioned_mets dice quiénes empezaron a trabajar; su respuesta llega después como otro mensaje del grupo (léela con messages) y consume Energía como en Met. Mencionar por id a un Met que no está en el grupo responde 400 met_not_in_group; escribir en un grupo que no es tuyo, 404.

De dónde nació una tarea

Cada tarea suma origin:

const tarea = await met.tasks.retrieve('b3e1c0d2-4f5a-4e6b-8c7d-9a0b1c2d3e4f');
if (tarea.origin?.type === 'routine') {
  console.log('La dejó la rutina', tarea.origin.routine, 'en el grupo', tarea.origin.group_id);
}
origin.typeQué quiere decir
routineLa corrida de una rutina (o su programación semanal). routine dice cuál.
groupLa dejó un Met mientras trabajaba en un grupo.
conversationLa dejó un Met en una conversación con Mets.

group_id y conversation_id solo llegan si puedes ver ese grupo o esa conversación; si no, llegan null y el resto del origen se mantiene. origin: null quiere decir que la tarea no guarda de dónde nació: la creó una persona, la API o una automatización. Si en una respuesta no se pudo averiguar, el campo no viene. type también crece: trata un valor que no conoces como «otro origen».

Desde el conector MCP

El conector tiene met_list_routines, met_list_groups, met_get_group, met_get_group_messages y met_send_group_message. Desde el 29-oct sus scopes (groups:read, groups:write) se piden al conectar la URL de siempre:

https://api.met.meteor.com.co/api/v1/mcp

Si ya tenías Meteor conectado antes, reconéctalo para recibirlos: reconectar suma permisos y no quita los que ya tenías. La URL https://api.met.meteor.com.co/api/v1/mcp/groups sigue funcionando y pide lo mismo.

Lo que no se puede (todavía)

Todo eso sigue en Met.