Desarrolladores

Construye con Hidesay

El código de la app es abierto, los bots tienen una API pública y hay una biblioteca para Python que hace el cifrado por ti.

Un bot que responde, con hidesay-bot
from hidesay_bot import Bot

bot = Bot()  # lee el token de HIDESAY_BOT_TOKEN


@bot.command("start", description="Saluda")
async def start(message):
    await message.reply("¡Hola! Escríbeme y te lo repito.")


@bot.on_message()
async def echo(message):
    await message.reply(message.text)


bot.run()

El código de la app es abierto

Cómo la app cierra, abre y firma los mensajes no tienes que creerlo de palabra: el código es público y lo puedes leer.

  • El cliente, es decir, la app que funciona en tu teléfono, está en GitHub
  • El cifrado ocurre ahí: es ahí donde lo puedes verificar
  • Quien sabe leer código lo comprueba, quien no, puede contar con quien lo hace
Enlace al repositorio próximamente

La Bot API

Un bot es una cuenta manejada por un programa tuyo. Lo creas desde la app, recibes un token y desde ahí habla con el servidor a través de una API HTTP documentada.

  • Recibe los mensajes con long polling o con un webhook
  • Escribe, edita y elimina mensajes, también con botones debajo
  • Tiene su propio menú de comandos, los que empiezan por /
  • Puede publicar su propia clave PGP: los chats privados con el bot quedan protegidos como los que hay entre personas
  • Tiene una especificación OpenAPI: el cliente lo generas en el lenguaje que prefieras

hidesay-bot, la biblioteca para Python

Toda la Bot API en Python, con el cifrado ya hecho: los mensajes llegan a tus handlers en claro y las respuestas salen cerradas para quien debe leerlas.

  • Todas las operaciones de la Bot API, síncronas y asíncronas
  • Comandos, botones, long polling y webhooks
  • OpenPGP automático: abre, verifica, cierra y firma los mensajes por ti
  • Reintentos sin duplicados y esperas justas cuando el servidor lo pide
  • Licencia MIT

Tu primer bot

  1. Crea el bot

    En la app, escribe a @bot y toca Crear un bot.

  2. Copia el token

    Lo ves una sola vez: guárdalo en una variable de entorno, nunca en el código ni en un chat.

  3. Ejecútalo

    Instala hidesay-bot, guarda el ejemplo como bot.py, ejecútalo y escríbele a tu bot desde la app.