Guias, tutoriais e referência
Documentação RunBots
Do primeiro comando às automações da sua comunidade. Explore guias visuais, conceitos e referências da plataforma.
Criar e preparar um bot Discord
Separe a aplicação no Discord, a instalação no servidor e a configuração no RunBots.
Introdução
1 artigoPrimeiros passos
2 artigosDashboard
5 artigosMeus apps
Escolha o bot certo antes de editar, publicar ou investigar uma falha.
Overview e indicadores
Veja presença, uso e saúde do bot em uma leitura compacta, com detalhes para investigar quando precisar.
Gerenciar comunidades
Pesquise a presença real do bot e diferencie saída, blacklist e destino de publicação.
Versões e histórico
Rascunhos, publicações e deployments têm papéis diferentes.
Uso, planos e limites
Consulte o catálogo efetivo da conta sem confundir limites com capacidade da hospedagem.
Comandos
1 artigoBuilder visual
2 artigosMensagens e interações
2 artigosDados e variáveis
2 artigosTutoriais
6 artigosSeu primeiro comando
Construa uma resposta pequena e confirme cada estágio até o Discord.
Responder usando argumentos
Transforme os campos do comando em dados úteis na primeira ação.
Montar um atendimento com tickets
Planeje configuração, abertura e gestão como caminhos distintos.
Criar uma mensagem interativa
Faça um botão ou Select levar a uma resposta clara.
Consultar dados com HTTP
Use uma resposta externa com caminhos explícitos de sucesso e falha.
Planejar verificação com cargos
Uma receita revisada, ainda sem aceitação real de ponta a ponta.
Publicação e hospedagem
1 artigoConta e configurações
1 artigoAjuda
1 artigoReferência de gatilhos
29 artigosComando /
Entradas, configuração e restrições de Comando /.
Menu de contexto
Entradas, configuração e restrições de Menu de contexto.
Comando de prefixo
Entradas, configuração e restrições de Comando de prefixo.
Menção ao bot
Entradas, configuração e restrições de Menção ao bot.
Mensagem
Entradas, configuração e restrições de Mensagem.
Mensagem criada
Entradas, configuração e restrições de Mensagem criada.
Mensagem editada
Entradas, configuração e restrições de Mensagem editada.
Mensagem apagada
Entradas, configuração e restrições de Mensagem apagada.
Reação adicionada
Entradas, configuração e restrições de Reação adicionada.
Reação removida
Entradas, configuração e restrições de Reação removida.
Entrada em canal de voz
Entradas, configuração e restrições de Entrada em canal de voz.
Saída de canal de voz
Entradas, configuração e restrições de Saída de canal de voz.
Mudança de canal de voz
Entradas, configuração e restrições de Mudança de canal de voz.
Canal criado
Entradas, configuração e restrições de Canal criado.
Canal removido
Entradas, configuração e restrições de Canal removido.
Canal atualizado
Entradas, configuração e restrições de Canal atualizado.
Cargo criado
Entradas, configuração e restrições de Cargo criado.
Cargo removido
Entradas, configuração e restrições de Cargo removido.
Membro banido
Entradas, configuração e restrições de Membro banido.
Banimento removido
Entradas, configuração e restrições de Banimento removido.
Botão
Entradas, configuração e restrições de Botão.
Menu
Entradas, configuração e restrições de Menu.
Formulário
Entradas, configuração e restrições de Formulário.
Entrada de membro
Entradas, configuração e restrições de Entrada de membro.
Saída de membro
Entradas, configuração e restrições de Saída de membro.
Mudança de cargo
Entradas, configuração e restrições de Mudança de cargo.
Agendamento
Entradas, configuração e restrições de Agendamento.
Webhook autenticado
Entradas, configuração e restrições de Webhook autenticado.
Chamada de Behavior
Entradas, configuração e restrições de Chamada de Behavior.
Referência de ações
54 artigosGerar texto aleatório
Gera texto criptograficamente aleatório com caracteres e comprimento configuráveis, para identificadores temporários e automações.
Criar desafio
Emite desafio de uso único para o usuário atual, com escopo, código personalizado ou aleatório, expiração e tentativas.
Validar desafio
Verifica a resposta do desafio e devolve sucesso ou falha sem executar automaticamente outras ações.
Liberar cargo após desafio
Concede cargo comum somente após confirmação válida e autorizada do desafio, com opção de remover o cargo inicial.
Gerenciar agendamento
Ativa, pausa, retoma, cancela ou consulta um agendamento deste comportamento. Cancelamentos aguardam a execução em andamento.
Requisição HTTP
Consulta uma API HTTPS pública com limites e credenciais protegidas.
Consultar ou alterar no Discord
Escolha uma operação de mensagens, canais, conversas, cargos, membros, moderação, convites, eventos, mídia, voz ou webhooks.
Compor valor tipado
Compõe um valor tipado usando dados disponíveis neste caminho.
Condição tipada
Escolhe um caminho a partir de uma expressão tipada.
Disponibilizar resultados
Devolve os resultados declarados pela ação reutilizável.
Usar uma das minhas ações
Chama uma ação reutilizável publicada com parâmetros e resultados tipados.
Sequência
Organiza uma sequência de passos sem executar uma operação externa.
Repetir com limite
Repete os passos de um caminho com limite explícito.
Para cada item
Executa os passos para cada item de uma lista com limite explícito.
Tentar / tratar erro
Oferece um caminho para tratar falhas dos passos internos.
Confirmar alterações juntas
Cria, incrementa, altera ou exclui registros numa única transação. Se uma condição falhar, todas as alterações são desfeitas.
Criar registro
Cria um registro na coleção declarada.
Consultar registro
Busca um registro por sua identidade na coleção.
Buscar registros
Consulta registros com filtros, ordenação e paginação limitada.
Atualizar registro
Atualiza um registro verificando a revisão esperada.
Excluir registro
Exclui um registro verificando a revisão esperada.
Contar registros
Conta registros que correspondem aos filtros.
Registro existe?
Verifica se há um registro correspondente aos filtros.
Responder
Responde no contexto do comando ou da interação atual.
Enviar mensagem
Envia uma mensagem em um canal escolhido ou recebido de uma etapa anterior.
Editar mensagem
Atualiza uma mensagem existente no canal indicado.
Excluir mensagem
Exclui uma mensagem com verificação de acesso e permissões.
Criar canal
Cria um canal de texto e disponibiliza o canal para os próximos passos.
Excluir canal
Exclui o canal escolhido; exige permissão do bot e da pessoa.
Renomear canal
Altera o nome de um canal existente.
Criar conversa
Cria uma conversa dentro de um canal de texto.
Arquivar conversa
Arquiva uma conversa existente.
Adicionar cargo
Adiciona um cargo à pessoa do contexto, respeitando a hierarquia.
Remover cargo
Remove um cargo da pessoa do contexto, respeitando a hierarquia.
Alterar apelido
Altera o apelido da pessoa do contexto.
Condição
Escolhe um caminho a partir de uma condição.
Aguardar
Aguarda por um intervalo curto dentro da execução atual.
Calcular valor
Calcula um valor sem executar código arbitrário.
Se o cálculo for verdadeiro
Escolhe um caminho a partir de um cálculo verdadeiro ou falso.
Consultar informação guardada
Consulta uma informação salva no escopo escolhido.
Guardar informação
Salva uma informação no escopo escolhido.
Aumentar ou diminuir valor
Soma ou subtrai um número de forma atômica.
Limitar frequência
Conta ações numa janela persistente e separada pelo escopo escolhido.
Apagar informação guardada
Apaga uma informação no escopo escolhido.
Trocar valor se não mudou
Troca uma informação somente se o valor anterior ainda corresponde.
Consultar dado compartilhado
Consulta uma configuração ou valor disponibilizado por qualquer comando ou automação deste bot.
Salvar dado compartilhado
Salva um valor tipado para que outros comandos e automações deste bot possam utilizá-lo.
Somar em dado compartilhado
Soma ou subtrai um número compartilhado com proteção contra atualizações simultâneas.
Redefinir dado compartilhado
Remove o valor atual e volta para o valor inicial configurado, quando existir.
Atualizar dado se não mudou
Atualiza um valor compartilhado somente quando ele ainda corresponde ao valor esperado.
Aguardar e continuar depois
Salva a execução para continuar depois, inclusive após reiniciar o Runtime.
Interromper repetição
Interrompe a repetição atual e continua depois dela, sem encerrar a execução inteira.
Encerrar
Encerra este caminho de execução.
Abrir formulário
Abre um formulário em uma interação que ainda permite essa resposta.
Operações Discord
76 artigosBuscar mensagem
Consulta uma mensagem no canal acessível ao bot e à pessoa.
Listar mensagens
Busca até100 mensagens; use a última mensagem como Antes para a próxima página.
Fixar mensagem
Fixa uma mensagem no canal autorizado.
Desafixar mensagem
Remove a fixação da mensagem.
Adicionar reação
Use um emoji Unicode ou o ID de um emoji do servidor.
Remover a reação do bot
Remove somente a reação que o próprio bot colocou.
Apagar mensagens recentes
O lote aceita mensagens com menos de14 dias. Mensagens mais antigas são preservadas.
Encaminhar mensagem
Encaminha uma cópia referenciada para outro canal permitido.
Criar enquete
Envia uma enquete com2 a10 respostas, sem menções automáticas.
Consultar canal
Retorna o canal e suas propriedades disponíveis.
Listar canais
Lista somente canais visíveis ao bot e à pessoa executora.
Criar canal de outro tipo
Cria texto, categoria, anúncios, voz ou fórum conforme as capacidades do servidor.
Editar propriedades do canal
Altera somente as propriedades configuradas, sem substituir permissões.
Definir acesso de um cargo no canal
Define ou remove uma única sobrescrita de permissão para um cargo administrável.
Definir acesso de uma pessoa no canal
Define ou remove uma única sobrescrita de permissão para uma pessoa do servidor.
Consultar conversa
Consulta uma thread pertencente ao servidor.
Listar conversas ativas
Lista as threads ativas que a pessoa e o bot podem acessar.
Editar conversa
Renomeia, arquiva, desarquiva, bloqueia ou desbloqueia a thread.
Adicionar pessoa à conversa
Adiciona um membro real do servidor à thread.
Remover pessoa da conversa
Remove a pessoa da thread, mantendo o membro no servidor.
Excluir conversa
Exclui a thread e seu conteúdo.
Consultar cargo
Consulta um cargo do servidor.
Listar cargos
Lista cargos do servidor em páginas limitadas.
Criar cargo
Cria um cargo sem conceder permissões superiores às disponíveis.
Editar cargo
Altera um cargo abaixo do bot e da pessoa executora; cargos gerenciados são protegidos.
Excluir cargo
Exclui um cargo administrável. O cargo de todos e cargos gerenciados são protegidos.
Adicionar cargo a uma pessoa
Seleciona a pessoa explicitamente, preservando quem iniciou a execução.
Remover cargo de uma pessoa
Remove um cargo administrável da pessoa escolhida.
Consultar membro
Consulta dados disponíveis de um membro real do servidor.
Verificar cargo da pessoa
Confere o cargo atual do membro.
Verificar permissão da pessoa
Confere uma permissão no servidor ou no canal selecionado.
Alterar apelido de uma pessoa
Escolhe a pessoa e o apelido; texto vazio remove o apelido.
Aplicar timeout
Impede temporariamente a comunicação por até28 dias.
Remover timeout
Remove a restrição de comunicação da pessoa administrável.
Expulsar membro
Expulsa uma pessoa abaixo do bot e da pessoa executora.
Banir pessoa
Bane um usuário; a exclusão de mensagens anteriores é opcional e limitada.
Remover banimento
Remove o banimento do usuário selecionado.
Consultar servidor
Retorna informações disponíveis do servidor da execução.
Consultar auditoria recente
Lista uma página limitada do registro nativo de auditoria sem expor dados fora do servidor.
Listar banimentos
Lista uma página limitada de usuários banidos e os motivos disponíveis.
Listar regras do AutoMod
Consulta as regras nativas do Discord sem copiar palavras ou padrões para os resultados do fluxo.
Consultar regra do AutoMod
Consulta uma regra nativa pelo ID e retorna somente metadados seguros.
Criar regra de palavras
Cria uma regra nativa de bloqueio por palavras com listas limitadas e mensagem opcional.
Editar regra de palavras
Atualiza somente os campos configurados de uma regra de palavras gerenciável.
Excluir regra do AutoMod
Exclui uma regra nativa gerenciável pelo ID.
Criar convite
Cria um convite no canal, com duração e usos limitados configuráveis.
Consultar convite
Consulta somente um convite pertencente ao servidor.
Listar convites
Lista convites do servidor sem consultar convites externos.
Revogar convite
Revoga somente um convite encontrado neste servidor.
Listar eventos do servidor
Lista eventos agendados do Discord.
Consultar evento do servidor
Consulta um evento pelo ID retornado pelo Discord.
Criar evento externo
Cria um evento externo com local, início e término; não substitui o início Agendamento do RunBots.
Editar evento externo
Altera somente nome, descrição, local e horários de um evento externo agendado.
Excluir evento
Exclui um evento administrável do servidor.
Listar pessoas interessadas
Consulta uma página limitada de pessoas inscritas no evento.
Listar emojis do servidor
Retorna os emojis e URLs de mídia fornecidos pelo Discord.
Listar stickers do servidor
Retorna stickers disponíveis; a URL aponta para a mídia do Discord.
Consultar estado de voz
Informa o canal e as restrições atuais. Não captura nem reproduz áudio.
Mover ou desconectar pessoa
Escolha um canal de voz ou Nenhum para desconectar uma pessoa já conectada.
Silenciar ou liberar pessoa
Altera o silêncio imposto pelo servidor, sem mudar a escolha pessoal de microfone.
Ensurdecer ou liberar pessoa
Altera o bloqueio de áudio imposto pelo servidor.
Listar webhooks do canal
Lista IDs e nomes, sem expor tokens ou URLs secretas.
Criar webhook no canal
Cria o webhook e retorna sua identificação pública. O segredo permanece no Runtime.
Renomear webhook
Renomeia somente um webhook do canal autorizado.
Excluir webhook
Exclui somente um webhook do canal autorizado.
Enviar pelo webhook
Usa um webhook do canal autorizado, sem aceitar URL ou token na autoria e sem menções automáticas.
Consultar emoji
Consulta um emoji deste servidor.
Criar emoji
Cria um emoji com PNG estático de128×128 pixels, até256 KiB, a partir de um anexo do Discord.
Renomear emoji
Renomeia um emoji editável deste servidor.
Excluir emoji
Exclui um emoji editável deste servidor.
Consultar figurinha
Consulta uma figurinha deste servidor.
Criar figurinha
Cria uma figurinha com PNG estático de320×320 pixels, até512 KiB, a partir de um anexo do Discord.
Editar figurinha
Edita somente os campos configurados de uma figurinha deste servidor.
Excluir figurinha
Exclui uma figurinha deste servidor.
Editar mensagem do webhook
Edita uma mensagem do webhook autorizado no mesmo canal, sem menções automáticas.
Excluir mensagem do webhook
Exclui uma mensagem do webhook autorizado no mesmo canal.
Para mantenedores
5 artigosArquitetura para mantenedores
Responsabilidades do Engine, Contracts, compilador e Runtime.
Runtime e ciclo de implantação
Fila, atribuição, Worker, leases e Discord READY sem confundir estados.
Versão do produto e rastreabilidade
Como interpretar versão, pré-release, build e commit.
Desenvolvimento local
Iniciar com isolamento, porta consistente e segredos fora do Git.
Testes e evidências
O que cada nível de teste comprova e como manter a documentação confiável.
Atalhos do guia anterior
Seus links salvos continuam disponíveis. Cada assunto agora tem seu próprio guia.