# El WhatsApp de tus usuarios, dentro de un agente de Composio > Composio le da a un agente más de 1500 herramientas en una sola sesión. Circles le suma el WhatsApp de la propia persona, como toolkit Custom MCP: los chats que abre, listos para leer, y para escribir donde lo permite. **Para darle a un agente de Composio un WhatsApp personal:** crea un toolkit Custom MCP con la dirección `https://app.usecircles.app/api/mcp` y el encabezado `Authorization: Bearer {{generic_api_key}}`, y cada usuario se conecta con su propio token de Circles. El agente lee entonces los chats que ese usuario abrió en Circles: Free para 2 chats hasta 3 meses, Plus a MXN 179 y Pro a MXN 349 al mes por número, con 14 días de Pro gratis, a noviembre de 2026. Fuente: https://usecircles.app/es/agents/composio · Actualizado el 2026-11-01 ## ¿El toolkit de WhatsApp de Composio, o Circles? El toolkit de WhatsApp de Composio funciona con la API de WhatsApp Business, y su página dice que no admite cuentas personales (a noviembre de 2026). Es la opción correcta para un número de empresa: plantillas, mensajes a clientes a escala, la API oficial. Circles es para el número propio de una persona: los grupos, los chats de familia y los audios del teléfono que ya usa, entregados a su agente chat por chat. ## Cuatro pasos: dos para cada usuario, dos para ti 1. **Cada persona vincula su WhatsApp en Circles**: Tu usuario empieza su prueba en usecircles.app y vincula su número como dispositivo vinculado: un código en su teléfono o un QR en su computadora. Elige qué chats pueden leer los agentes y en cuáles pueden enviar. 2. **Crea un token**: En la página Agents de Circles: *New token*, elige Other, deja MCP y elige qué permite. El token empieza con `circ_` y se muestra una sola vez. 3. **Tú agregas Circles como toolkit Custom MCP, una vez**: En tu proyecto de Composio, crea un toolkit con la dirección de Circles y el encabezado `Authorization: Bearer {{generic_api_key}}`, compartido con `user_id="all"`. Composio pone el token de cada usuario cuando llama a Circles. 4. **Cada usuario se conecta y tu agente pregunta**: Composio le pide a cada usuario su token con su enlace de conexión, y las herramientas se sincronizan en la primera conexión. Agrega el slug del toolkit a una sesión; tu agente encuentra las herramientas con `COMPOSIO_SEARCH_TOOLS`. ## El código Python, con el SDK de Composio. En TypeScript las mismas llamadas están en `composio.experimental.customToolkits`. Pon en `mcp_url` la dirección exacta, sin ninguna clave dentro. Composio fija la dirección, el esquema de autenticación y `user_id` al crear el toolkit; para cambiar uno, bórralo y créalo de nuevo. Cuando Circles agregue una herramienta, sincroniza el toolkit otra vez. ``` from composio import Composio composio = Composio() # reads COMPOSIO_API_KEY # Once per project: Circles as a shared Custom MCP toolkit toolkit = composio.experimental.custom_toolkits.create( name="Circles (personal WhatsApp)", mcp_url="https://app.usecircles.app/api/mcp", auth_schemes=[{ "mode": "API_KEY", "headers": {"Authorization": "Bearer {{generic_api_key}}"}, }], user_id="all", ) print(toolkit.slug) # keep it: CUSTOM_CIRCLES... # Per user: a session with Circles beside your other toolkits session = composio.sessions.create(user_id="user_123", toolkits=[toolkit.slug]) tools = session.tools() ``` ## Conectarse por dirección en vez de con un token El Custom MCP de Composio también acepta OAuth con registro dinámico de clientes: `"mode": "DCR_OAUTH"` con `"discovery_url": "https://app.usecircles.app/.well-known/oauth-authorization-server"`. Circles registra clientes así, y cada persona aprueba en la página de Circles y elige si el agente puede enviar. Esta combinación todavía no se probó, así que usa un token mientras tanto. ## Lo que pueden preguntar tus usuarios Ejemplos inventados, con formas reales. - **"¿Qué me perdí en el grupo de la junta de vecinos?"**: `catch_up` en un grupo desde un momento, con los audios ya como texto. - **"Pasa a mi calendario las fechas del grupo de la escuela"**: Circles lee el grupo; tu toolkit de Google Calendar crea los eventos. - **"Busca la factura que mandó el contador y guárdala en Drive"**: `documents` la encuentra, `get_media` la trae y otro toolkit la guarda. - **"Dile al grupo de running que el jueves no voy"**: Solo si el token permite enviar y ese grupo está abierto para envío. ## Lo que puede y no puede hacer aquí un agente de Composio **El agente puede:** - Ver qué chats abriste y cuáles se movieron desde un momento, con cantidades y sin texto (`allowed_chats`, `activity`). - Ponerse al día y buscar, en un chat o en todos, con los remitentes por nombre (`catch_up`, `search`). - Ver con quién hablas y quién está en un grupo, por el nombre que guardaste, con su número donde WhatsApp lo muestra (`people`, `group_members`). - Listar los documentos enviados en tus chats y abrir una foto, un PDF o un archivo, hasta 50 MB (`documents`, `get_media`). El agente abre el archivo y lo lee. - Enviar un mensaje o un archivo en los chats abiertos para envío, que en un número nuevo son todos (`send`). **El agente no puede:** - Ver un chat oculto. No aparece en listas, no se puede buscar y nunca se nombra, ni siquiera en un rechazo. - Enviar en un chat que dejaste solo para lectura, llegar a un chat que ocultaste ni reintentar un envío solo. - Responder citando un mensaje ni reaccionar con un emoji. Eso existe solo en la [API HTTP](https://usecircles.app/en/whatsapp-api-personal-number). - Seguir con acceso después de que lo desconectes. Desconectar lo corta al instante, y cada solicitud que hizo queda en tu registro de actividad. Los audios se transcriben automáticamente, en el idioma en que se grabaron. ## Cambiar el acceso, planes e invitaciones **Cambiar lo que pueden hacer tus agentes.** Cada agente que conectas lee y escribe por defecto en los chats que dejas abiertos, desde el inicio. Para limitarlo, pon un chat en solo lectura u ocúltalo en la página de chats de la app de Circles, o escribe a Atención al Cliente de Circles, el servicio virtual del número de Circles: [wa.me/972553091640](https://wa.me/972553091640). Escríbele desde tu propio WhatsApp. Tu agente puede redactar el mensaje. No puede abrir, leer ni enviar en ese chat, porque contiene tus enlaces de acceso. **Planes.** Todos los planes leen y escriben y ven todo el historial disponible: 2 chats en Free, hasta 3 meses desde que vinculas, 10 en Plus y todos los chats que permitas en Pro. Cada registro empieza con 14 días de Pro, sin tarjeta. Nunca se cobra nada sin que elijas un plan. [Planes y precios](https://usecircles.app/es/pricing). **Invitaciones.** Un amigo que invitas tiene 28 días de Pro en lugar de 14, desde el día en que vincula su WhatsApp. Tú sumas 14 días cuando su agente lee por primera vez a través de Circles, hasta 10 amigos por semana. Pide tu enlace de invitación a Atención al Cliente de Circles. ## Preguntas y respuestas ### ¿Composio tiene un toolkit de WhatsApp? Sí, para cuentas de WhatsApp Business con la API Business, y su página dice que no admite cuentas personales (a noviembre de 2026). Circles agrega un número personal a Composio como toolkit Custom MCP. ### ¿Cada usuario puede conectar su propio WhatsApp? Sí. Comparte un toolkit de Circles con `user_id="all"`; cada usuario se conecta con su propio token de Circles, y su agente ve solo los chats que abrió en Circles. ### ¿Circles está en el catálogo de toolkits de Composio? Todavía no, a noviembre de 2026. Agrégalo como toolkit Custom MCP; según la documentación de Composio, los toolkits compartidos funcionan en todos sus planes. ### ¿Se puede conectar con OAuth en vez de un token? Composio admite OAuth con registro dinámico, y Circles también, pero todavía no se probaron juntos. Hasta entonces, usa un token. ### ¿El agente puede enviar mensajes de WhatsApp? Solo si el token del usuario permite enviar, y solo en chats abiertos para envío (todos, por defecto). Un envío nunca se reintenta solo. ### ¿Cuánto cuesta? Circles se cobra por número de WhatsApp: Free es gratis para 2 chats hasta 3 meses, Plus cuesta MXN 179 al mes y Pro MXN 349 ([consulta el precio de tu país](https://usecircles.app/es/pricing#countries)), con 14 días de Pro gratis. El plan de Composio es aparte. ## Sigue leyendo - [Cualquier cliente MCP](https://usecircles.app/en/agents/grok): La misma dirección y el mismo token, para clientes que aceptan un servidor remoto. - [La API HTTP](https://usecircles.app/en/whatsapp-api-personal-number): Los mismos chats en JSON, con respuestas citadas y reacciones. - [Lo que ve el agente](https://usecircles.app/es/security): Permisos por chat y el registro de actividad. --- 14 días para probarlo todo, gratis y sin tarjeta de crédito. Después eliges un plan según lo que de verdad usaste. Empieza aquí: https://usecircles.app/start?lang=es