Fuente de datos: Discord


1Presentación

Discord es un servicio de comunicación inicialmente dedicado a los jugadores, cuyo uso se ha ampliado desde entonces.

Es posible enviar mensajes dentro de un canal de comunicación, para notificar a los usuarios de forma automatizada.

Si has configurado correctamente los parámetros de conexión a Discord, Temma crea automáticamente un objeto de tipo \Temma\Datasources\Discord, con el que puedes enviar notificaciones. Por convención, supondremos que has llamado a esta conexión disc en el archivo etc/temma.php (consulta la documentación de configuración).

En los controladores, la conexión a Discord está entonces disponible escribiendo:

$discord = $this->disc;

En otros objetos gestionados por el componente de inyección de dependencias, la conexión a Discord es accesible escribiendo:

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

2Configuración

Para enviar mensajes a Discord, primero debes crear un webhook. Cada webhook está vinculado a un canal en el que puede publicar mensajes.

En el archivo etc/temma.php (consulta la documentación de configuración), declaras el DSN (Data Source Name) usado para conectarte a Discord.

El DSN usado para conectarte a Discord se puede escribir como discord://WEBHOOK

Siendo WEBHOOK el valor de la URL del webhook, sin el prefijo https://.
Ejemplo: discord.com/api/webhooks/ABC/XYZ


3Contenido de las notificaciones

Las notificaciones pueden contener texto (hasta 2000 caracteres), que acepta una variante de la sintaxis Markdown.


4Llamadas unificadas

4.1Acceso tipo array

// enviar un mensaje simple
$discord[''] = "Mensaje a enviar";

4.2Método avanzado

// enviar un mensaje simple
$discord->set('', "Mensaje a enviar");