Pular para o conteúdo

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 artigo

Primeiros passos

2 artigos

Dashboard

5 artigos

Comandos

1 artigo

Builder visual

2 artigos

Mensagens e interações

2 artigos

Dados e variáveis

2 artigos

Tutoriais

6 artigos

Publicação e hospedagem

1 artigo

Conta e configurações

1 artigo

Ajuda

1 artigo

Referência de gatilhos

29 artigos

Comando /

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 artigos

Gerar 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 artigos

Buscar 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 artigos

Atalhos do guia anterior

Seus links salvos continuam disponíveis. Cada assunto agora tem seu próprio guia.