Bots
Um bot é uma conta do Zynko controlada por um programa seu. Ele aparece com a marca BOT, entra em servidores, lê e manda mensagens, reage, cria canais e entra em salas de voz, dentro do que os cargos dele permitem. Usa a mesma API e o mesmo gateway do app.
Como funciona
- Crie o bot em dev.zynko.org, entrando com a sua conta do Zynko. Cada pessoa pode ter até 10 bots.
- Guarde o token. Ele aparece uma vez só, quando o bot é criado. Quem tem o token controla o bot, então guarde fora do código, numa variável de ambiente. Perdeu ou vazou? Gere outro no portal: o antigo para de funcionar na hora.
- Conecte no gateway com o token e receba os eventos em tempo real: mensagens, pessoas entrando, reações. Veja Seu primeiro bot.
- Coloque o bot num servidor pelo link de convite. Veja Convite e permissões.
O que um bot pode e não pode
Dentro de um servidor, um bot é um membro como qualquer outro: os cargos e as permissões de cada canal decidem o que ele faz. Fora disso:
- Bots não criam servidores, não fazem amizades, não criam outros bots e não usam links de convite de servidor (eles entram pelo convite de bot).
- Bots não têm senha nem e-mail. A conta só funciona com o token.
- Os limites de uso são os mesmos de uma pessoa: por exemplo, 10 mensagens a cada 10 segundos. Veja Visão geral da API.
Endereços
| API | https://zynko.org/api |
| Gateway | wss://zynko.org/api/gateway |
| Autenticação | cabeçalho Authorization: Bot <token> |
| Portal | dev.zynko.org |
Bibliotecas
- JavaScript e TypeScript:
zynko, com reconexão automática, cache e voz (tocar e ouvir áudio nas salas). Exemplo pronto: o bot de música. - Python, Go e Rust estão a caminho.
A API e o gateway também são simples de usar direto, sem biblioteca, como no primeiro bot.