Discord

Interaja com o Discord

Discord é uma plataforma de comunicação poderosa que permite conectar com amigos, comunidades e equipes. Ela oferece uma gama de recursos para colaboração em equipe, incluindo canais de texto, canais de voz e chamadas de vídeo.

Com uma conta ou bot Discord, você pode:

Enviar mensagens: Enviar mensagens para um canal específico
Obter mensagens: Obter mensagens de um canal específico
Obter servidor: Obter informações sobre um servidor específico
Obter usuário: Obter informações sobre um usuário específico

No ZippyVendas, a integração com Discord permite que seus agentes acessem e aproveitem os servidores Discord da sua organização. Agentes podem recuperar informações de canais Discord, pesquisar usuários específicos, obter informações de servidor e enviar mensagens. Isso permite que seus workflows se integrem com suas comunidades Discord, automatizem notificações e criem experiências interativas.

Importante: Para ler conteúdo de mensagens, seu bot Discord precisa da "Message Content Intent" habilitada no Portal de Desenvolvedores Discord. Sem essa permissão, você ainda receberá metadados de mensagens, mas o campo de conteúdo aparecerá vazio.

Componentes Discord no ZippyVendas usam carregamento lazy eficiente, buscando dados apenas quando necessário para minimizar chamadas de API e prevenir limitação de taxa. A atualização de token acontece automaticamente em segundo plano para manter sua conexão.

Configurando Seu Bot Discord

Vá para o Portal de Desenvolvedores Discord
Crie uma nova aplicação e navegue para a aba "Bot"
Crie um bot e copie seu token de bot
Em "Privileged Gateway Intents", habilite a Message Content Intent para ler conteúdo de mensagens
Convide seu bot para seus servidores com as permissões apropriadas

Instruções de Uso

Integração Discord abrangente: mensagens, threads, canais, roles, membros, convites e webhooks.

Ferramentas

`discord_send_message`

Enviar uma mensagem para um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para enviar a mensagem
`content`	string	Não	O conteúdo de texto da mensagem
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`files`	file[]	Não	Arquivos para anexar à mensagem

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados da mensagem Discord

`discord_get_messages`

Recuperar mensagens de um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para recuperar mensagens
`limit`	number	Não	Número máximo de mensagens a recuperar (padrão: 10, máx: 100)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Container para dados de mensagens

`discord_get_server`

Recuperar informações sobre um servidor Discord (guild)

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Informações do servidor Discord (guild)

`discord_get_user`

Recuperar informações sobre um usuário Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	Token do bot Discord para autenticação
`userId`	string	Sim	O ID do usuário Discord

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Informações do usuário Discord

`discord_edit_message`

Editar uma mensagem existente em um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord contendo a mensagem
`messageId`	string	Sim	O ID da mensagem para editar
`content`	string	Não	O novo conteúdo de texto para a mensagem
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados da mensagem Discord atualizada

`discord_delete_message`

Deletar uma mensagem de um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord contendo a mensagem
`messageId`	string	Sim	O ID da mensagem para deletar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_add_reaction`

Adicionar um emoji de reação a uma mensagem Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord contendo a mensagem
`messageId`	string	Sim	O ID da mensagem para reagir
`emoji`	string	Sim	O emoji para reagir (emoji unicode ou emoji personalizado no formato name:id)
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_remove_reaction`

Remover uma reação de uma mensagem Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord contendo a mensagem
`messageId`	string	Sim	O ID da mensagem com a reação
`emoji`	string	Sim	O emoji para remover (emoji unicode ou emoji personalizado no formato name:id)
`userId`	string	Não	O ID do usuário cuja reação remover (omitir para remover reação própria do bot)
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_pin_message`

Fixar uma mensagem em um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord contendo a mensagem
`messageId`	string	Sim	O ID da mensagem para fixar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_unpin_message`

Desfixar uma mensagem em um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord contendo a mensagem
`messageId`	string	Sim	O ID da mensagem para desfixar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_create_thread`

Criar uma thread em um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para criar a thread
`name`	string	Sim	O nome da thread (1-100 caracteres)
`messageId`	string	Não	O ID da mensagem para criar uma thread (se criando de mensagem existente)
`autoArchiveDuration`	number	Não	Duração em minutos para auto-arquivar a thread (60, 1440, 4320, 10080)
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados da thread criada

`discord_join_thread`

Entrar em uma thread no Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`threadId`	string	Sim	O ID da thread para entrar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_leave_thread`

Sair de uma thread no Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`threadId`	string	Sim	O ID da thread para sair
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_archive_thread`

Arquivar ou desarquivar uma thread no Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`threadId`	string	Sim	O ID da thread para arquivar/desarquivar
`archived`	boolean	Sim	Se deve arquivar (true) ou desarquivar (false) a thread
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados da thread atualizada

`discord_create_channel`

Criar um novo canal em um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`name`	string	Sim	O nome do canal (1-100 caracteres)
`type`	number	Não	Tipo do canal (0=texto, 2=voz, 4=categoria, 5=anúncio, 13=stage)
`topic`	string	Não	Tópico do canal (0-1024 caracteres)
`parentId`	string	Não	ID da categoria pai para o canal

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do canal criado

`discord_update_channel`

Atualizar um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para atualizar
`name`	string	Não	O novo nome para o canal
`topic`	string	Não	O novo tópico para o canal
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do canal atualizado

`discord_delete_channel`

Deletar um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para deletar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_get_channel`

Obter informações sobre um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para recuperar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do canal

`discord_create_role`

Criar uma nova role em um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`name`	string	Sim	O nome da role
`color`	number	Não	Valor de cor RGB como inteiro (ex.: 0xFF0000 para vermelho)
`hoist`	boolean	Não	Se deve exibir membros da role separadamente de membros online
`mentionable`	boolean	Não	Se a role pode ser mencionada

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados da role criada

`discord_update_role`

Atualizar uma role em um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`roleId`	string	Sim	O ID da role para atualizar
`name`	string	Não	O novo nome para a role
`color`	number	Não	Valor de cor RGB como inteiro
`hoist`	boolean	Não	Se deve exibir membros da role separadamente
`mentionable`	boolean	Não	Se a role pode ser mencionada

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados da role atualizada

`discord_delete_role`

Deletar uma role de um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`roleId`	string	Sim	O ID da role para deletar

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_assign_role`

Atribuir uma role a um membro em um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`userId`	string	Sim	O ID do usuário para atribuir a role
`roleId`	string	Sim	O ID da role para atribuir

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_remove_role`

Remover uma role de um membro em um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`userId`	string	Sim	O ID do usuário para remover a role
`roleId`	string	Sim	O ID da role para remover

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_kick_member`

Expulsar um membro de um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`userId`	string	Sim	O ID do usuário para expulsar
`reason`	string	Não	Motivo para expulsar o membro

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_ban_member`

Banir um membro de um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`userId`	string	Sim	O ID do usuário para banir
`reason`	string	Não	Motivo para banir o membro
`deleteMessageDays`	number	Não	Número de dias para deletar mensagens (0-7)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_unban_member`

Desbanir um membro de um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`userId`	string	Sim	O ID do usuário para desbanir
`reason`	string	Não	Motivo para desbanir o membro

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_get_member`

Obter informações sobre um membro em um servidor Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`userId`	string	Sim	O ID do usuário para recuperar

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do membro

`discord_update_member`

Atualizar um membro em um servidor Discord (ex.: alterar apelido)

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`serverId`	string	Sim	O ID do servidor Discord (guild ID)
`userId`	string	Sim	O ID do usuário para atualizar
`nick`	string	Não	Novo apelido para o membro (null para remover)
`mute`	boolean	Não	Se deve mutar o membro em canais de voz
`deaf`	boolean	Não	Se deve ensurdecer o membro em canais de voz

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do membro atualizado

`discord_create_invite`

Criar um link de convite para um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para criar um convite
`maxAge`	number	Não	Duração do convite em segundos (0 = nunca expira, padrão 86400)
`maxUses`	number	Não	Número máximo de usos (0 = ilimitado, padrão 0)
`temporary`	boolean	Não	Se o convite concede associação temporária
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do convite criado

`discord_get_invite`

Obter informações sobre um convite Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`inviteCode`	string	Sim	O código do convite para recuperar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do convite

`discord_delete_invite`

Deletar um convite Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`inviteCode`	string	Sim	O código do convite para deletar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

`discord_create_webhook`

Criar um webhook em um canal Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`channelId`	string	Sim	O ID do canal Discord para criar o webhook
`name`	string	Sim	Nome do webhook (1-80 caracteres)
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do webhook criado

`discord_execute_webhook`

Executar um webhook Discord para enviar uma mensagem

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`webhookId`	string	Sim	O ID do webhook
`webhookToken`	string	Sim	O token do webhook
`content`	string	Sim	O conteúdo da mensagem para enviar
`username`	string	Não	Sobrescrever o nome de usuário padrão do webhook
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Mensagem enviada via webhook

`discord_get_webhook`

Obter informações sobre um webhook Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`webhookId`	string	Sim	O ID do webhook para recuperar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro
`data`	object	Dados do webhook

`discord_delete_webhook`

Deletar um webhook Discord

Entrada

Parâmetro	Tipo	Obrigatório	Descrição
`botToken`	string	Sim	O token do bot para autenticação
`webhookId`	string	Sim	O ID do webhook para deletar
`serverId`	string	Sim	O ID do servidor Discord (guild ID)

Saída

Parâmetro	Tipo	Descrição
`message`	string	Mensagem de sucesso ou erro

Notas

Categoria: tools
Tipo: discord

Datadog Dropbox

Monostate•hey@monostate.com•

On this page

On this page

Configurando Seu Bot Discord

Instruções de Uso

discord_send_message

discord_get_messages

discord_get_server

discord_get_user

discord_edit_message

discord_delete_message

discord_add_reaction

discord_remove_reaction

discord_pin_message

discord_unpin_message

discord_create_thread

discord_join_thread

discord_leave_thread

discord_archive_thread

discord_create_channel

discord_update_channel

discord_delete_channel

discord_get_channel

discord_create_role

discord_update_role

discord_delete_role

discord_assign_role

discord_remove_role

discord_kick_member

discord_ban_member

discord_unban_member

discord_get_member

discord_update_member

discord_create_invite

discord_get_invite

discord_delete_invite

discord_create_webhook

discord_execute_webhook

discord_get_webhook

discord_delete_webhook

Comece a automatizar hoje

Confiado por empresas em todo o Brasil.

Crie fluxos de automação de vendas com IA no WhatsApp de forma visual e intuitiva.

Começar grátis