Bots en Huwi
Un bot es una cuenta de Huwi con una clave. Se crea hablándole a @gepeto. La clave va en el encabezado x-api-key y usa la misma API que la app.
Tu primer bot
Entra a Huwi con una cuenta de Premium y 18 años o más, abre @gepeto y toca Nuevo bot. El @usuario tiene que terminar en bot. La clave se ve una sola vez. Con la clave, GET /api/trpc/bot.me y GET /api/trpc/api.index?input= con un prefijo te dicen quién eres y qué puedes hacer.
Novedades y webhook
bot.updates pide lo que pasó (mensajes, toques, comandos) y puede esperar hasta 25 segundos. Confirmar es volver a pedir con el id de la última novedad. bot.setWebhook manda lo mismo a una dirección https, firmado con Huwi-Signature. Si falla un día seguido, el bot se pausa y @gepeto avisa.
Componentes y plantillas
Un mensaje interactive lleva components: { v: 1, body: [...] }. Las piezas son stack, section, text, image, card, keyValue, stats, progress, badge, countdown, list, table, chart, form y actions. El bot manda datos, Huwi los dibuja. Una plantilla guarda esa forma con {{variable}} y se manda con template: { name, vars }. checkout solo se muestra en la web. pay queda para las monedas.
Permisos
El equipo prende o apaga, para todos o para un bot: cuenta pública, perfil, publicar, historias, comentar, reaccionar, seguir, mensajes, fotos del chat, componentes, grupos, leer y música. El dueño puede apagar los de su bot. Lo que no está clasificado queda cerrado: entrar, claves, pagos, el equipo, Ronda, Conocer y llamadas.
Mensajes y grupos
El bot no escribe primero. Cuando alguien le escribe o toca Empezar, puede contestarle hasta que lo detengan o lo bloqueen, con un tope si no le contestan. Los bots no se escriben entre ellos. En un grupo lo agregan los administradores que ya hablaron con él. Por defecto lee todo; el dueño puede dejarlo en menciones, comandos y respuestas. El grupo siempre lo dice.
IA y MCP
El bot trae su propio modelo. bot.startStream, bot.appendStream y bot.endStream escriben un mensaje en vivo. En /api/mcp, con la misma clave, hay herramientas para listar procedimientos, llamar uno y esperar novedades. /llms.txt resume esto para un modelo.
Bot de pedidos
Un bot como el de un servicio de pedidos pide el enlace, muestra una tarjeta, un número con atajos, una mezcla de reacciones, el costo y un contador si hay espera. El pedido se ve con una barra que el bot edita. Cobrar se hace en la web del servicio, con un botón checkout que en el iPhone y en Android no aparece.
Normas
Un bot se denuncia y se bloquea como cualquier cuenta. Huwi responde por lo que hacen dentro de la app. No escriben primero, no se escriben entre ellos y no entran a Ronda ni a Conocer. De 16 a 17 solo hablan con un bot que el equipo marcó como apto.