Discord¶
Integre seu código com o Discord para enviar mensagens, arquivos e muito mais.
Instalação¶
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.
Enviando uma mensagem simples¶
Aqui está a saída esperada:
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¶
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)