Discord
Ler e executar ações em servidores, canais e mensagens do Discord.
O que faz
Integração completa com o Discord: mensagens, tópicos, canais, cargos, membros, convites e webhooks.
Quando usar: Use quando o seu fluxo precisar ler e executar ações em servidores, canais e mensagens do Discord.
Exemplo de situação: Enviar uma confirmação ao cliente ou à equipe no canal correto.
Antes de começar
Conexão necessária: Credencial protegida.
Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
Passo a passo
- Adicione Discord ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Escolha uma conexão ou credencial já cadastrada no workspace. Nunca cole senhas ou chaves em campos de texto comuns.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Operações
| Operação | O que faz |
|---|---|
| Enviar mensagem | Envia mensagem com o bloco Discord. |
| Obter mensagens do canal | Obtém mensagens do canal com o bloco Discord. |
| Obter informações do servidor | Obtém informações do servidor com o bloco Discord. |
| Obter informações do usuário | Obtém informações do usuário com o bloco Discord. |
| Editar mensagem | Edita mensagem com o bloco Discord. |
| Excluir mensagem | Exclui mensagem com o bloco Discord. |
| Adicionar reação | Adiciona reação com o bloco Discord. |
| Remover reação | Remove reação com o bloco Discord. |
| Fixar mensagem | Fixa mensagem com o bloco Discord. |
| Desafixar mensagem | Desafixa mensagem com o bloco Discord. |
| Criar tópico | Cria tópico com o bloco Discord. |
| Entrar no tópico | Entra no tópico com o bloco Discord. |
| Sair do tópico | Sae do tópico com o bloco Discord. |
| Arquivar tópico | Arquiva tópico com o bloco Discord. |
| Criar canal | Cria canal com o bloco Discord. |
| Atualizar canal | Atualiza canal com o bloco Discord. |
| Excluir canal | Exclui canal com o bloco Discord. |
| Obter canal | Obtém canal com o bloco Discord. |
| Criar cargo | Cria cargo com o bloco Discord. |
| Atualizar cargo | Atualiza cargo com o bloco Discord. |
| Excluir cargo | Exclui cargo com o bloco Discord. |
| Atribuir cargo | Atribui cargo com o bloco Discord. |
| Remover cargo | Remove cargo com o bloco Discord. |
| Expulsar membro | Expulsa membro com o bloco Discord. |
| Banir membro | Bane membro com o bloco Discord. |
| Revogar banimento de membro | Revoga banimento de membro com o bloco Discord. |
| Obter membro | Obtém membro com o bloco Discord. |
| Atualizar membro | Atualiza membro com o bloco Discord. |
| Criar convite | Cria convite com o bloco Discord. |
| Obter convite | Obtém convite com o bloco Discord. |
| Excluir convite | Exclui convite com o bloco Discord. |
| Criar webhook | Cria webhook com o bloco Discord. |
| Executar webhook | Executa webhook com o bloco Discord. |
| Obter webhook | Obtém webhook com o bloco Discord. |
| Excluir webhook | Exclui webhook com o bloco Discord. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Enviar mensagem · Obter mensagens do canal · Obter informações do servidor · Obter informações do usuário · Editar mensagem · Excluir mensagem · Adicionar reação · Remover reação · Fixar mensagem · Desafixar mensagem · Criar tópico · Entrar no tópico · Sair do tópico · Arquivar tópico · Criar canal · Atualizar canal · Excluir canal · Obter canal · Criar cargo · Atualizar cargo · Excluir cargo · Atribuir cargo · Remover cargo · Expulsar membro · Banir membro · Revogar banimento de membro · Obter membro · Atualizar membro · Criar convite · Obter convite · Excluir convite · Criar webhook · Executar webhook · Obter webhook · Excluir webhook
- Padrão:
- Enviar mensagem
Token do bot
ObrigatórioDado protegidoInforme o token do bot do Discord.
- Padrão:
- Segredo protegido
ID do servidor
ObrigatórioInforme o ID do servidor do Discord.
- Exemplo:
- id-do-recurso
ID do canal
Obrigatório conforme a operaçãoInforme o ID do canal do Discord.
- Aparece em:
- Enviar mensagem, Obter mensagens do canal, Editar mensagem, Excluir mensagem, Adicionar reação, Remover reação, Fixar mensagem, Desafixar mensagem, Criar tópico, Atualizar canal, Excluir canal, Obter canal, Criar convite, Criar webhook
- Exemplo:
- id-do-recurso
ID da mensagem
Obrigatório conforme a operaçãoInforme o ID da mensagem.
- Aparece em:
- Editar mensagem, Excluir mensagem, Adicionar reação, Remover reação, Fixar mensagem, Desafixar mensagem
- Exemplo:
- id-do-recurso
Conteúdo da mensagem
Informe o conteúdo da mensagem.
- Aparece em:
- Enviar mensagem, Editar mensagem
- Exemplo:
- Olá! Sua solicitação foi processada com sucesso.
Emoji
Obrigatório conforme a operaçãoDefine a reação enviada à mensagem; deixe vazio somente quando a operação permitir remover a reação.
- Aparece em:
- Adicionar reação, Remover reação
- Exemplo:
- 👍
ID do usuário
Obrigatório conforme a operaçãoInforme o ID do usuário do Discord.
- Aparece em:
- Obter informações do usuário, Atribuir cargo, Remover cargo, Expulsar membro, Banir membro, Revogar banimento de membro, Obter membro, Atualizar membro
- Exemplo:
- id-do-recurso
ID da conversa
Obrigatório conforme a operaçãoInforme o ID do tópico.
- Aparece em:
- Entrar no tópico, Sair do tópico, Arquivar tópico
- Exemplo:
- id-do-recurso
Nome
Obrigatório conforme a operaçãoInforme o nome.
- Aparece em:
- Criar tópico, Criar canal, Criar cargo, Criar webhook
- Exemplo:
- Exemplo de atendimento
ID do cargo
Obrigatório conforme a operaçãoInforme o ID do cargo.
- Aparece em:
- Atualizar cargo, Excluir cargo, Atribuir cargo, Remover cargo
- Exemplo:
- id-do-recurso
ID do webhook
Obrigatório conforme a operaçãoInforme o ID do webhook.
- Aparece em:
- Executar webhook, Obter webhook, Excluir webhook
- Exemplo:
- id-do-recurso
Token do webhook
Obrigatório conforme a operaçãoDado protegidoInforme o token do webhook.
- Aparece em:
- Executar webhook
- Padrão:
- Segredo protegido
Código do convite
Obrigatório conforme a operaçãoInforme o código do convite.
- Aparece em:
- Obter convite, Excluir convite
Arquivado
Define se este comportamento fica ativado ou desativado.
- Aparece em:
- Arquivar tópico
- Opções:
- Arquivar · Desarquivar
- Padrão:
- Arquivar
Tópico
Informe o assunto do canal (opcional).
- Aparece em:
- Criar canal, Atualizar canal
Cor
Informe a cor como número inteiro (ex.: 16711680 para vermelho).
- Aparece em:
- Criar cargo, Atualizar cargo
- Exemplo:
- 16711680 para vermelho
Apelido
Informe o novo apelido.
- Aparece em:
- Atualizar membro
Motivo
Informe o motivo desta ação.
- Aparece em:
- Expulsar membro, Banir membro, Revogar banimento de membro
Limite de mensagens
Número de mensagens (padrão: 10, máx.: 100).
- Aparece em:
- Obter mensagens do canal
- Exemplo:
- 10
Arquivar automaticamente após (minutos)
Escolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar tópico
- Opções:
- 1 hora (60 minutos) · 24 horas (1440 minutos) · 3 dias (4320 minutos) · 1 semana (10080 minutos)
- Padrão:
- 24 horas (1440 minutos)
- Exemplo:
- 1 hora (60 minutos)
Visibilidade do tópico
Em campos adicionaisEscolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar tópico
- Opções:
- Público — visível para todos no canal · Privado — só para convidados
- Padrão:
- Público — visível para todos no canal
Tipo de canal
Escolhe uma das opções aceitas por este campo.
- Aparece em:
- Criar canal
- Opções:
- Canal de texto · Canal de voz · Categoria · Canal de anúncios · Canal de palco · Canal de fórum
- Padrão:
- Canal de texto
ID da categoria pai
Informe o ID da categoria pai (opcional).
- Aparece em:
- Criar canal
- Exemplo:
- id-do-recurso
Exibir separadamente
Define se este comportamento fica ativado ou desativado.
- Aparece em:
- Criar cargo, Atualizar cargo
- Opções:
- Sim — exibir os membros do cargo separadamente · Não — não exibir separadamente
- Padrão:
- Não — não exibir separadamente
- Exemplo:
- Sim — exibir os membros do cargo separadamente
Mencionável
Define se este comportamento fica ativado ou desativado.
- Aparece em:
- Criar cargo, Atualizar cargo
- Opções:
- Sim — o cargo pode ser mencionado · Não — o cargo não pode ser mencionado
- Padrão:
- Sim — o cargo pode ser mencionado
Excluir histórico de mensagens
Informa o conteúdo de texto que será enviado ou processado.
- Aparece em:
- Banir membro
- Opções:
- Não excluir nenhuma mensagem · Excluir as mensagens do último dia · Excluir as mensagens dos últimos 7 dias
- Padrão:
- Não excluir nenhuma mensagem
Silenciar no servidor
Define se este comportamento fica ativado ou desativado.
- Aparece em:
- Atualizar membro
- Opções:
- Silenciar membro · Remover silenciamento do membro
- Exemplo:
- Silenciar membro
Ensurdecer no servidor
Define se este comportamento fica ativado ou desativado.
- Aparece em:
- Atualizar membro
- Opções:
- Ensurdecer membro · Remover ensurdecimento do membro
- Exemplo:
- Ensurdecer membro
Validade do convite
Define um valor numérico, quantidade ou limite da operação.
- Aparece em:
- Criar convite
- Opções:
- Nunca expira · 30 minutos · 1 hora · 6 horas · 12 horas · 1 dia · 7 dias
- Padrão:
- 1 dia
- Exemplo:
- Nunca expira
Máximo de usos
Número máximo de usos (0 = ilimitado).
- Aparece em:
- Criar convite
- Exemplo:
- 10
Associação temporária
Define se este comportamento fica ativado ou desativado.
- Aparece em:
- Criar convite
- Opções:
- Não — conceder associação permanente · Sim — expulsar ao desconectar se não tiver cargo
- Padrão:
- Não — conceder associação permanente
Substituir nome de usuário
Nome de usuário personalizado a exibir (opcional).
- Aparece em:
- Executar webhook
- Exemplo:
- Exemplo de atendimento
Anexos
Envie os arquivos a anexar.
- Aparece em:
- Enviar mensagem
- Exemplo:
- (selecione um arquivo de teste)
Arquivos anexos
Em campos adicionaisReferencie arquivos de blocos anteriores.
- Aparece em:
- Enviar mensagem
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <discord.message>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<discord.message> | string | Mensagem de status. |
<discord.files> | file[] | Arquivos anexados à mensagem. |
<discord.data> | json | Dados da resposta. |
Exemplo de uso
Objetivo: Enviar uma confirmação ao cliente ou à equipe no canal correto.
- Operação
- Enviar mensagem
- ID do servidor
- id-do-recurso
- ID do canal
- id-do-recurso
- Conteúdo da mensagem
- Olá! Sua solicitação foi processada com sucesso.
- Anexos
- (selecione um arquivo de teste)
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <discord.message>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Credencial ausente ou recusada
- Escolha uma conexão válida do workspace. Se a senha ou a chave mudou no serviço, atualize a conexão cadastrada em vez de colar o segredo no bloco.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- ArquivoEnviar um documento pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- ÁudioEnviar um áudio pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- Botões de açãoEnviar pelo WhatsApp (Z-API) uma mensagem com botões de abrir link, ligar ou copiar código.
- Catálogo e opçõesConsultar a instância Z-API ou enviar catálogo, botões de resposta e lista de opções.
- ContatoEnviar um cartão de contato pelo WhatsApp (Z-API) dentro de um fluxo de conversa.
- Copiar mensagem · TelegramCopiar mensagem usando a conexão Telegram deste workspace.