Bots en Huwi
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.
Un bot es una cuenta de Huwi que maneja un programa tuyo. No tiene login: se usa con una clave hwk_ en el encabezado x-api-key, por la misma API que usa la app. Lo que un bot hace se ve igual que lo que hace una persona, con un robotcito junto al nombre.
Para crear un bot
Hace falta una cuenta con Premium y 18 años o más, y puedes tener hasta 10 bots. El @usuario tiene que
terminar en bot (por ejemplo pedidos_bot). Se crea hablándole a @gepeto en Huwi: sigue la guía de inicio.
El responsable es el dueño
Quien maneja un bot es el responsable de lo que el bot dice y hace, y de cómo trata lo que la gente le escribe. Un bot se denuncia y se bloquea como cualquier cuenta.
Qué puede hacer un bot
Atender un chat
Conversa con quien le escribe o toca Empezar. Contesta por turnos y manda texto, fotos, tarjetas y botones.
Mandar tarjetas con botones
Pedidos, reservas, encuestas, reportes. Son JSON (v: 1): Huwi los dibuja, tu bot nunca manda código.
Publicar
Fotos, videos y textos en la cuenta del bot, con hashtags, ubicación y audiencia.
Estar en grupos
Un administrador que ya habló con el bot lo agrega. Lee todo o solo menciones, comandos y respuestas.
Reaccionar y comentar
Me gusta, reacciones, comentarios y seguir cuentas, con topes por día.
Conectarse a un modelo de IA
Tu bot trae su propio modelo. También hay un servidor MCP con la misma clave.
Ideas que ya funcionan
| Caso | Cómo se arma |
|---|---|
| Soporte al cliente | Un bot que contesta /start, /help y preguntas frecuentes, y avisa a tu equipo cuando hace falta una persona. Botones con kind: "reply" para atajos. |
| Avisos y alertas | Un servicio tuyo escribe cuando algo pasa (un pago, una alerta de servidor). Recuerda: el bot no escribe primero; la persona toca Empezar una vez. |
| Estado de un pedido | Tarjeta con card, progress y botones Rastrear y Cancelar. El toque llega como novedad action. |
| Encuestas y quizzes | Una pregunta por mensaje con botones callback. Cada toque es un turno: el bot puede contestar hasta 5 mensajes. |
| Publicador de contenido | Un script publica una foto o un texto por la API, a la hora que quieras, con post.create. |
| Ayudante de moderación en un grupo | Un bot con leer y mensajes que responde a comandos como /reglas o /reportar en el grupo. |
| Asistente con IA | Un modelo escribe las respuestas; el bot las manda y las va editando mientras llegan. Ver IA y MCP. |
| Reportes | Tarjetas con stats, table y chart para resumir ventas, métricas o resultados. |
Qué no puede hacer un bot
Lo importante
- No escribe primero. Solo contesta cuando alguien le escribió o tocó Empezar, y hasta que lo detengan.
- No habla con otros bots.
- No inicia sesión, no paga, no toca claves ni usa lo del equipo, Ronda, Conocer o las llamadas.
- No crea grupos ni agrega gente: lo agregan los administradores.
- Lo que Huwi no clasificó queda cerrado para los bots.
Mira el detalle en Permisos y las reglas de las conversaciones en Conversaciones.