# Huwi Developers > Documentación de Huwi (https://huwi.app) para quienes construyen sobre la plataforma. Hoy: bots. Un bot es una cuenta de Huwi con una clave `hwk_` que se usa con el encabezado `x-api-key` por la misma API tRPC que la app (`https://huwi.app/api/trpc/`). English: documentation for building on Huwi. A bot is a Huwi account driven with an `x-api-key` header over the same tRPC HTTP API as the app. Create one by messaging @gepeto. ## Páginas - [IA y MCP](https://developers.huwi.app/docs/bots/ai): Conecta un modelo de IA a tu bot. Respuestas que se van escribiendo y el servidor MCP de Huwi con la misma clave del bot. - [Referencia de la API](https://developers.huwi.app/docs/bots/api): Cómo se llama la API de Huwi con la clave de un bot, la forma de las respuestas y los errores, los procedimientos principales con su entrada y salida, y la lista completa por permiso. - [Buenas prácticas y preguntas frecuentes](https://developers.huwi.app/docs/bots/best-practices): Errores comunes al hacer un bot de Huwi y cómo evitarlos. Idempotencia con clientId, confirmar novedades, guardar la clave, webhooks y respuestas a las dudas más comunes. - [Cambios de la API](https://developers.huwi.app/docs/bots/changelog): Los cambios de la API de Huwi que ven los bots, del más nuevo al más viejo. Salen del registro oficial de Huwi. - [Componentes](https://developers.huwi.app/docs/bots/components): Galería de los componentes que un bot puede mandar en un chat, con su JSON y una vista previa en vivo dibujada igual que en Huwi. - [Conversaciones](https://developers.huwi.app/docs/bots/conversations): Las reglas de un chat con un bot. Nunca escribe primero, Empezar manda /start, contesta por turnos y la persona lo puede detener. - [Ejemplos](https://developers.huwi.app/docs/bots/examples): Ejemplos listos para copiar en curl, TypeScript y Python. Novedades, mensajes, tarjetas con botones, comandos, webhooks, publicar, grupos y texto en vivo. - [Grupos](https://developers.huwi.app/docs/bots/groups): Cómo funciona un bot en un grupo de Huwi. Quién lo agrega, qué lee, qué puede mandar y cuáles son los límites. - [Bots en Huwi](https://developers.huwi.app/docs/bots): Qué es un bot, qué puede hacer y qué no, con casos de uso concretos. Cuentas con clave que atienden chats, mandan tarjetas con botones, avisan y publican. - [Límites y errores](https://developers.huwi.app/docs/bots/limits): Todos los topes de los bots de Huwi (mensajes, turnos, publicaciones, componentes, webhooks) y los códigos de error de la API con lo que significan. - [Permisos](https://developers.huwi.app/docs/bots/permissions): Qué puede y qué no puede hacer un bot, con la lista real de permisos de Huwi, quién los define y qué queda cerrado para siempre. - [Primeros pasos](https://developers.huwi.app/docs/bots/quickstart): Crea tu primer bot en minutos. Habla con @gepeto, guarda la clave, haz tu primera llamada con curl, recibe un mensaje y contéstalo. - [Webhooks](https://developers.huwi.app/docs/bots/webhooks): Recibe las novedades de tu bot en tu servidor, firmadas con Huwi-Signature. Cómo verificar la firma, qué reintentos hay y cuándo se pausa el bot. - [Documentación](https://developers.huwi.app/docs): Todo lo que puedes construir sobre Huwi. Empieza por los bots. ## Lo esencial - Crear un bot: hablarle a @gepeto en Huwi (Premium, 18 años o más). El @usuario termina en `bot`. La clave se ve una sola vez. - Llamadas: `GET https://huwi.app/api/trpc/?input=` para lecturas y `POST` con `{"json": entrada}` para escrituras. La respuesta viene en `result.data.json`. - Lista viva de procedimientos de una clave: `api.index` (con `prefix` trae su entrada y salida en JSON Schema). Servidor MCP: `POST https://huwi.app/api/mcp`. - El bot no escribe primero. Contesta por turnos: 5 mensajes por cada mensaje o toque de botón de la persona; sin turno nuevo, 10 por día por chat. - Novedades: `bot.updates` (pedido largo, hasta 25 s) o un webhook firmado con `Huwi-Signature`. - Los componentes del chat son JSON (`v: 1`): Huwi los dibuja, el bot nunca manda código.