Développeurs

Créez avec Hidesay

Le code de l’appli est ouvert, les bots ont une API publique et il existe une bibliothèque Python qui fait le chiffrement à votre place.

Un bot qui répond, avec hidesay-bot
from hidesay_bot import Bot

bot = Bot()  # lit le jeton dans HIDESAY_BOT_TOKEN


@bot.command("start", description="Dire bonjour")
async def start(message):
    await message.reply("Salut ! Écris-moi et je te le répète.")


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


bot.run()

Le code de l’appli est ouvert

Comment l’appli verrouille, déverrouille et signe les messages, vous n’avez pas à nous croire sur parole : le code est public et vous pouvez le lire.

  • Le client, c’est-à-dire l’appli qui tourne sur votre téléphone, est sur GitHub
  • Le chiffrement se fait là : c’est là que vous pouvez le vérifier
  • Ceux qui savent lire le code vérifient, les autres peuvent compter sur eux
Lien vers le dépôt bientôt disponible

La Bot API

Un bot est un compte piloté par votre propre programme. Vous le créez depuis l’appli, recevez un jeton, et à partir de là il parle au serveur via une API HTTP documentée.

  • Reçoit les messages en long polling ou via un webhook
  • Écrit, modifie et supprime des messages, avec des boutons dessous
  • A son propre menu de commandes, celles qui commencent par /
  • Peut publier sa propre clé PGP : les discussions privées avec le bot restent protégées comme celles entre personnes
  • A une spécification OpenAPI : générez le client dans le langage de votre choix

hidesay-bot, la bibliothèque Python

Toute la Bot API en Python, avec le chiffrement déjà fait : les messages arrivent en clair dans vos handlers et les réponses partent verrouillées pour ceux qui doivent les lire.

  • Toutes les opérations de la Bot API, synchrones et asynchrones
  • Commandes, boutons, long polling et webhooks
  • OpenPGP automatique : ouvre, vérifie, verrouille et signe les messages à votre place
  • Nouvelles tentatives sans doublons et attentes justes quand le serveur le demande
  • Licence MIT

Votre premier bot

  1. Créez le bot

    Dans l’appli, écrivez à @bot et touchez Créer un bot.

  2. Copiez le jeton

    Vous ne le voyez qu’une fois : gardez-le dans une variable d’environnement, jamais dans le code ni dans une discussion.

  3. Lancez-le

    Installez hidesay-bot, enregistrez l’exemple sous bot.py, lancez-le et écrivez à votre bot depuis l’appli.