Fonte de dados: Discord


1Apresentação

Discord é um serviço de comunicação inicialmente dedicado a jogadores, e cujo uso se ampliou desde então.

É possível enviar mensagens dentro de um canal de comunicação, para notificar os usuários de forma automatizada.

Se você configurou corretamente os parâmetros de conexão do Discord, o Temma cria automaticamente um objeto do tipo \Temma\Datasources\Discord, com o qual você pode enviar notificações. Por convenção, vamos considerar que você nomeou essa conexão disc no arquivo etc/temma.php (veja a documentação de configuração).

Nos controladores, a conexão ao Discord fica então disponível ao escrever:

$discord = $this->disc;

Em outros objetos gerenciados pelo componente de injeção de dependências, a conexão ao Discord é acessível ao escrever:

$discord = $loader->dataSources->disc;
$discord = $loader->dataSources['disc'];

2Configuração

Para enviar mensagens para o Discord, você deve primeiro criar um webhook. Cada webhook está vinculado a um canal no qual pode publicar mensagens.

No arquivo etc/temma.php (veja a documentação de configuração), você declara o DSN (Data Source Name) usado para se conectar ao Discord.

O DSN usado para se conectar ao Discord pode ser escrito como discord://WEBHOOK

Sendo WEBHOOK o valor da URL do webhook, sem o prefixo https://.
Exemplo: discord.com/api/webhooks/ABC/XYZ


3Conteúdo das notificações

As notificações podem conter texto (até 2000 caracteres), que aceita uma variante da sintaxe Markdown.


4Chamadas unificadas

4.1Acesso como array

// envia uma mensagem simples
$discord[''] = "Mensagem a enviar";

4.2Método avançado

// envia uma mensagem simples
$discord->set('', "Mensagem a enviar");