Desenvolvedores

Construa com o Hidesay

O código do app é aberto, os bots têm uma API pública e existe uma biblioteca para Python que faz a criptografia para você.

Um bot que responde, com o hidesay-bot
from hidesay_bot import Bot

bot = Bot()  # lê o token de HIDESAY_BOT_TOKEN


@bot.command("start", description="Dizer oi")
async def start(message):
    await message.reply("Oi! Escreva para mim e eu repito.")


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


bot.run()

O código do app é aberto

Como o app tranca, abre e assina as mensagens você não precisa acreditar na nossa palavra: o código é público e você pode ler.

  • O cliente, ou seja, o app que roda no seu telefone, está no GitHub
  • A criptografia acontece ali: é ali que você pode verificar
  • Quem sabe ler código confere, quem não sabe pode contar com quem confere
Link para o repositório em breve

A Bot API

Um bot é uma conta controlada por um programa seu. Você cria pelo app, recebe um token e a partir daí ele fala com o servidor por uma API HTTP documentada.

  • Recebe as mensagens por long polling ou por webhook
  • Escreve, edita e apaga mensagens, também com botões embaixo
  • Tem o próprio menu de comandos, os que começam com /
  • Pode publicar a própria chave PGP: as conversas privadas com o bot ficam protegidas como as conversas entre pessoas
  • Tem uma especificação OpenAPI: gere o cliente na linguagem que preferir

hidesay-bot, a biblioteca para Python

Toda a Bot API em Python, com a criptografia já pronta: as mensagens chegam aos seus handlers em texto puro e as respostas saem trancadas para quem deve lê-las.

  • Todas as operações da Bot API, síncronas e assíncronas
  • Comandos, botões, long polling e webhooks
  • OpenPGP automático: abre, verifica, tranca e assina as mensagens para você
  • Novas tentativas sem duplicatas e esperas certas quando o servidor pede
  • Licença MIT

Seu primeiro bot

  1. Crie o bot

    No app, escreva para @bot e toque em Criar um bot.

  2. Copie o token

    Você só vê uma vez: guarde em uma variável de ambiente, nunca no código nem em uma conversa.

  3. Execute

    Instale o hidesay-bot, salve o exemplo como bot.py, execute e escreva para o seu bot pelo app.