Sviluppatori

Costruisci con Hidesay

Il codice dell’app è aperto, i bot hanno un’API pubblica e c’è una libreria per Python che fa la crittografia al posto tuo.

Un bot che risponde, con hidesay-bot
from hidesay_bot import Bot

bot = Bot()  # legge il token da HIDESAY_BOT_TOKEN


@bot.command("start", description="Saluta")
async def start(message):
    await message.reply("Ciao! Scrivimi e te lo ripeto.")


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


bot.run()

Il codice dell’app è aperto

Come l’app chiude, apre e firma i messaggi non devi crederci sulla parola: il codice è pubblico e lo puoi leggere.

  • Il client, cioè l’app che gira sul tuo telefono, è su GitHub
  • La crittografia avviene lì: è lì che la puoi verificare
  • Chi sa leggere il codice controlla, chi non sa può contare su chi lo fa
Link al repository in arrivo

La Bot API

Un bot è un account guidato da un tuo programma. Lo crei dall’app, ricevi un token e da lì parla con il server attraverso un’API HTTP documentata.

  • Riceve i messaggi con il long polling o con un webhook
  • Scrive, modifica ed elimina messaggi, anche con i pulsanti sotto
  • Ha il suo menu di comandi, quelli che iniziano con /
  • Può pubblicare una sua chiave PGP: le chat private con il bot restano protette come quelle tra persone
  • Ha una specifica OpenAPI: il client lo generi nel linguaggio che preferisci

hidesay-bot, la libreria per Python

Tutta la Bot API in Python, con la crittografia già fatta: i messaggi arrivano ai tuoi handler in chiaro e le risposte partono chiuse per chi deve leggerle.

  • Tutte le operazioni della Bot API, sincrone e asincrone
  • Comandi, pulsanti, long polling e webhook
  • OpenPGP automatico: apre, verifica, chiude e firma i messaggi al posto tuo
  • Invii ripetuti senza doppioni e attese giuste quando il server lo chiede
  • Licenza MIT

Il tuo primo bot

  1. Crea il bot

    Nell’app scrivi a @bot e tocca Crea un bot.

  2. Copia il token

    Lo vedi una volta sola: tienilo in una variabile d’ambiente, mai nel codice o in una chat.

  3. Avvialo

    Installa hidesay-bot, salva l’esempio come bot.py, avvialo e scrivi al tuo bot dall’app.