# Meteor Developers

> Infraestructura agéntica como servicio: ejecuta Mets (agentes), gestiona el CRM (contactos + WhatsApp), integraciones MCP, colecciones de datos, webhooks y tareas — todo por API REST, SDK (TypeScript / Python) o MCP. Server-side: te autenticas con una API key `met_` en `Authorization: Bearer`. Base de la API: https://api.met.meteor.com.co/api/v1.

## Empezar

- [Quickstart](https://developers.meteor.com.co/)
  primer request en menos de 5 minutos
- [Referencia de la API](https://developers.meteor.com.co/reference.html)
  spec OpenAPI completo e interactivo
- [Servidor MCP](https://developers.meteor.com.co/mcp.html)
  la misma API como tools para agentes MCP
- [Changelog](https://developers.meteor.com.co/changelog.html)
  cambios del contrato público

## Guías

(Cada guía se sirve también como markdown: la misma URL con `.md` en vez de `.html`.)

- [Cómo construir un agente de IA](https://developers.meteor.com.co/guias/construir-un-agente.html)
  Qué es un agente, en qué se diferencia de un chatbot de flujos, y los cinco pasos para tener uno atendiendo por WhatsApp con acceso a los datos de tu negocio.
- [Autenticación](https://developers.meteor.com.co/guias/autenticacion.html)
  Cómo crear tu API key, qué son los scopes y cómo mantener la key segura.
- [Ejecutar Mets (Runs)](https://developers.meteor.com.co/guias/ejecutar-agentes.html)
  Ejecuta el Met de tu workspace por API, con memoria opcional, y lee el resultado.
- [Apps OAuth de terceros](https://developers.meteor.com.co/guias/oauth-apps.html)
  Conecta tu app con autorización del usuario, PKCE S256 y tokens rotativos, sin pedir API keys.
- [Streaming (SSE)](https://developers.meteor.com.co/guias/streaming.html)
  Recibe los eventos del run en vivo, evento por evento, con Server-Sent Events.
- [Tareas](https://developers.meteor.com.co/guias/tareas.html)
  Procedimientos repetibles que un Met ejecuta paso a paso, con pausas para que decida una persona.
- [Funciones y flujos](https://developers.meteor.com.co/guias/funciones-y-flujos.html)
  Haz que tu Met llame a tu propio backend: una Función con handler HTTP o un flujo, vinculada al Met.
- [Automatizaciones](https://developers.meteor.com.co/guias/automatizaciones.html)
  El *cuándo* de tu workspace: conecta un evento con una acción y deja que Meteor la dispare sin que nadie llame a la API.
- [Mets y sus herramientas](https://developers.meteor.com.co/guias/mets-y-herramientas.html)
  Crea y ajusta Mets, mira qué herramientas ve cada uno y controla a qué colecciones puede acceder.
- [Skills](https://developers.meteor.com.co/guias/skills.html)
  Dale capacidades nuevas a un Met — actívalas del catálogo, guarda sus credenciales y vincúlalas.
- [Imágenes](https://developers.meteor.com.co/guias/imagenes.html)
  Genera, edita y anima imágenes por Meteor — misma key, debitando Energía, sin proveedor externo.
- [Variables del workspace](https://developers.meteor.com.co/guias/variables.html)
  Guarda valores y secretos del workspace (como el token de una Función HTTP) y descubre los campos del CRM.
- [Datos: colecciones e ítems](https://developers.meteor.com.co/guias/colecciones-e-items.html)
  Guarda datos estructurados en colecciones, créalos, búscalos por texto y contrólalos.
- [Integraciones MCP](https://developers.meteor.com.co/guias/integraciones-mcp.html)
  Registra tu propio servidor MCP HTTP y ejecuta sus tools desde tus Mets.
- [Eventos en vivo](https://developers.meteor.com.co/guias/eventos.html)
  Escucha los eventos del workspace en tiempo real por SSE, sin montar un webhook.
- [CRM y contactos](https://developers.meteor.com.co/guias/contactos.html)
  Crea contactos, mándales mensajes de WhatsApp, etiquétalos y recorre tu base.
- [Webhooks entrantes](https://developers.meteor.com.co/guias/webhooks.html)
  Registra endpoints que disparan tareas o emiten eventos, con firma HMAC.
- [Errores, idempotencia y paginación](https://developers.meteor.com.co/guias/errores-e-idempotencia.html)
  Errores tipados, reintentos seguros con idempotencia, y cómo paginar.
- [Límites y cuotas](https://developers.meteor.com.co/guias/limites.html)
  Rate limits por key, headers de rate limit, cuota mensual y cómo los SDKs reintentan solos.
- [Plantillas (Snapshots)](https://developers.meteor.com.co/guias/snapshots.html)
  Descubre e instala implementaciones completas (Mets, flujos, colecciones, integraciones) en un workspace con una API key.
- [CLI (met)](https://developers.meteor.com.co/guias/cli.html)
  Ejecuta Mets, escucha eventos y reenvíalos a tu app local desde la terminal.
- [Operación del workspace](https://developers.meteor.com.co/guias/operacion-del-workspace.html)
  Consumo y facturación, archivos, conversaciones, recordatorios, autopiloto y grupos de agentes — lo que se consulta cuando ya estás en producción.
- [Versionado y deprecación](https://developers.meteor.com.co/guias/versionado.html)
  Qué cambios puedes esperar sin avisar, cómo se anuncia un endpoint que se va a retirar y qué headers te lo dicen.
- [Aprovisionamiento de cuentas](https://developers.meteor.com.co/guias/aprovisionamiento.html)
  Crea cuentas de Met desde tu propio producto y cárgales energía, con una API key de partner.
- [Un agente que contesta WhatsApp](https://developers.meteor.com.co/guias/receta-whatsapp.html)
  De un mensaje que entra por WhatsApp a una respuesta del Met, con tu lógica en el medio y el traspaso a una persona cuando hace falta.
- [Sincronizar tu sistema con colecciones](https://developers.meteor.com.co/guias/receta-sincronizar-datos.html)
  Espeja un catálogo, un inventario o una lista de precios dentro de Meteor para que tus Mets lo consulten sin que programes un endpoint por cada consulta.
- [Recibir eventos firmados en tu backend](https://developers.meteor.com.co/guias/receta-webhooks-firmados.html)
  Un endpoint que recibe los eventos de tu workspace, verifica la firma y sobrevive a los reintentos sin procesar nada dos veces.
- [Ejecutar un Met desde GitHub Actions](https://developers.meteor.com.co/guias/receta-github-actions.html)
  Poner un Met dentro de tu pipeline — resumir un despliegue, revisar un cambio o correr una tarea— con el código de salida reflejando el resultado.
- [Mostrar un run en vivo en tu UI](https://developers.meteor.com.co/guias/receta-streaming.html)
  Pasar el stream del Met desde tu backend hasta el navegador, palabra por palabra, sin exponer la key y sin perder el resultado si el stream se corta.
- [Una tarea que pide aprobación humana](https://developers.meteor.com.co/guias/receta-aprobacion-humana.html)
  Dejar que un Met haga el trabajo y se detenga a pedir permiso antes del paso que no se puede deshacer, con la decisión entrando desde tu propio sistema.

## Preguntas frecuentes

### ¿Cómo construyo un agente de IA que conteste por WhatsApp?

Conectas el canal de WhatsApp al workspace, defines el prompt y las herramientas del agente (Met), y lo ejecutas con una llamada a POST /workspaces/{id}/runs. El agente responde en el mismo hilo del contacto. Fuera de la ventana de 24 horas desde el último mensaje de la persona, WhatsApp solo permite escribir con plantillas aprobadas por Meta: eso no es un límite de la plataforma sino de Meta, y no se puede saltear.

Detalle: https://developers.meteor.com.co/guias/ejecutar-agentes.html

### ¿Necesito entrenar un modelo para tener un agente?

No. Un agente se define con un prompt, un conjunto de herramientas y acceso a datos; el modelo de lenguaje es un componente intercambiable. Lo que determina si el agente sirve no es el modelo sino qué herramientas tiene y a qué datos llega.

Detalle: https://developers.meteor.com.co/guias/mets-y-herramientas.html

### ¿Cuál es la diferencia entre un agente y un chatbot de flujos?

Un flujo ejecuta pasos que alguien definió por adelantado; un agente decide qué herramienta usar según lo que pasa. Los dos se necesitan: el agente atiende lo que no se puede prever y el flujo garantiza lo que no puede improvisarse, como un cobro o un envío. En Meteor conviven y se llaman entre sí.

Detalle: https://developers.meteor.com.co/guias/funciones-y-flujos.html

### ¿Cómo le doy a mi agente acceso a los datos de mi negocio?

Con colecciones: son tablas del workspace que el agente puede leer y escribir sin que programes un endpoint por cada una. También puedes conectar integraciones MCP para que use herramientas de sistemas externos.

Detalle: https://developers.meteor.com.co/guias/colecciones-e-items.html

### ¿Puedo usar Meteor desde Claude, Cursor u otro cliente MCP?

Sí. Meteor expone un servidor MCP remoto sobre streamable-http en https://api.met.meteor.com.co/api/v1/mcp, con un catálogo de herramientas met_* que cubre ejecución de agentes, CRM, tareas, datos y plantillas. El catálogo se filtra por los scopes de tu API key: una herramienta cuyo scope no tienes no aparece.

Detalle: https://developers.meteor.com.co/mcp.html

### ¿Cuánto cuesta ejecutar un agente?

Se cobra por tarea ejecutada, con el consumo medido en Energía y consultable por API en GET /billing/consumption y GET /billing/executions. Las API keys de prueba (met_test_) ejecutan sin costo, con un tope diario por workspace.

Detalle: https://developers.meteor.com.co/guias/limites.html

### ¿Qué lenguajes tienen SDK oficial?

TypeScript (@meteor.ia/sdk) y Python (meteor-ia) tienen paquetes oficiales. Consulta la versión publicada y sus ejemplos antes de elegir tu cliente; también hay un CLI (met) y la API REST directa con OpenAPI publicado.

Detalle: https://developers.meteor.com.co/guias/autenticacion.html

### ¿Cómo pruebo sin afectar datos reales?

Con una API key de prueba (met_test_). Las tareas ejecutadas quedan marcadas con livemode: false, no debitan Energía y los scopes que producen efectos reales están restringidos, así que no hay forma de mandar un mensaje de verdad por accidente.

Detalle: https://developers.meteor.com.co/guias/autenticacion.html

## SDKs

- TypeScript — `npm i @meteor.ia/sdk`
- Python — `pip install meteor-ia`
- CLI — `met` (`npm i -g @meteor.ia/cli`)

## Partners

- [API de Partners](https://developers.meteor.com.co/partners.html)
  superficie `partner:*` para operar los workspaces de tus clientes con atribución (solo keys de partner)
- [Referencia Partners API](https://developers.meteor.com.co/reference-partners.html)
  la misma superficie como referencia interactiva, generada del contrato OpenAPI