Ir para o conteúdo

Discord

Integre seu código com o Discord para enviar mensagens, arquivos e muito mais.

Instalação

pip install botcity-discord-plugin

Configurando o WebHook

Para usar este plugin, você precisa de um WebHook do Discord.

Siga as instruções neste artigo para aprender a obter um WebHook.

Importando o plugin

Depois de instalar este pacote, a próxima etapa é importar o pacote para o seu código e começar a usar as funções.

from botcity.plugins.discord import BotDiscordPlugin

Enviando uma mensagem simples

from botcity.plugins.discord import BotDiscordPlugin

url = 'https://discord.com/api/webhooks/95811659/y6uu4douh'
discord = BotDiscordPlugin(urls = url, username = "Nome do Bot Discord")

# Envie uma mensagem
resposta = discord.send_message(content='Hello!')

Aqui está a saída esperada:

mensagem-simples

Enviando uma mensagem complexa

Você pode compor e enviar mensagens complexas com a classe EmbeddedMessage.

from botcity.plugins.discord import BotDiscordPlugin, EmbeddedMessage, Author, Footer, Field, Color

# Instanciando a mensagem incorporada
mensagem = EmbeddedMessage (
    title = 'Titulo incorporado',
    description = 'Descriçao longa',
    color = Color.ORANGE
)

# Defina o autor
mensagem.author = Author(
    name = 'botcity',
    url = 'https://github.com/botcity-dev',
    icon_url = 'https://avatars.githubusercontent.com/u/72993825?s=200&v=4'
)

# Defina o rodapé
mensagem.footer = Footer(
    text = 'Exemplo de texto do rodapé',
    icon_url ='https://avatars.githubusercontent.com/u/1525981?s=200&v=4'
)

# Adicione campos extras
mensagem.fields = [
    Field(name = 'campo 1', value = 'valor 1'),
    Field(name = 'campo 2', value = 'valor 2')
]

# Defina a miniatura
mensagem.thumbnail = 'https://i.imgur.com/0QGx79x.png'

# Adicione uma imagem
mensagem.image = 'https://avatars.githubusercontent.com/u/1965106?s=200&v=4'

# Configure o plugin
url = 'https://discord.com/api/webhooks/95811659/y6uu4douh'
discord = BotDiscordPlugin(urls = url, username = "Nome do Bot Discord")

# Envie a mensagem
resposta = discord.send_embedded_message(mensagem)

Aqui está a saída esperada:

Editando uma mensagem

from botcity.plugins.discord import BotDiscordPlugin

url = 'https://discord.com/api/webhooks/95811659/y6uu4douh'
discord = BotDiscordPlugin(urls = url, username = "Nome do Bot Discord")
resposta_primeira_mensagem = discord.send_message(content = 'Hello!')

resposta_mensagem_atualizada = discord.edit_message(resposta_primeira_mensagem, 'Novo conteúdo.')

Aqui está a saída esperada:

Carregando um arquivo

from botcity.plugins.discord import BotDiscordPlugin

url = 'https://discord.com/api/webhooks/95811659/y6uu4douh'
discord = BotDiscordPlugin(urls = url, username="Nome do Bot Discord")

# Envie um arquivo
resposta = discord.send_file(files = ['caminho-da-imagem'])

Aqui está a saída esperada:

Excluindo uma mensagem ou arquivo

Info

Este método obtem a resposta de uma ação.

import time
from botcity.plugins.discord import BotDiscordPlugin

url = 'https://discord.com/api/webhooks/95811659/y6uu4douh'
discord = BotDiscordPlugin(urls = url, username = "Nome do Bot Discord")

# Envie uma mensagem
resposta = discord.send_message(content='Hello!')

# Aguarde a mensagem ser enviada
time.sleep(5)

# Exclua a mensagem
discord.delete_message(resposta)