credencial secreta<\/strong>.<\/p>\nNo debemos publicarlo en una p\u00e1gina web, subirlo a un repositorio
\np\u00fablico ni incluirlo en un ejemplo que vayamos a compartir con otras
\npersonas.<\/p>\n
Cualquier persona que consiga un token v\u00e1lido podr\u00eda utilizar los
\npermisos asociados a nuestra aplicaci\u00f3n.<\/p>\n
Si accidentalmente hacemos p\u00fablico el token, debemos revocarlo y
\ngenerar unas credenciales nuevas.<\/p>\n
A\u00f1adir el bot al canal<\/h3>\n
Tambi\u00e9n necesitaremos un lugar en el que publicar las
\nnotificaciones.<\/p>\n
Podemos crear, por ejemplo, un canal llamado
\n#notificaciones<\/strong>.<\/p>\nUna vez hecho esto necesitaremos conocer el identificador del
\ncanal.<\/p>\n
Los identificadores de canales de Slack tienen un aspecto similar a
\nC0123456789<\/code>. Este identificador ser\u00e1 el que utilizaremos al llamar a la API.<\/p>\nSlack permite otras formas de organizar y enviar mensajes, pero para
\nun sistema personal de alertas un canal espec\u00edfico suele ser el enfoque
\napropiado.<\/p>\n
C\u00f3mo se env\u00eda un mensaje a
\nSlack<\/h3>\n
Slack proporciona el m\u00e9todo de su API
\nchat.postMessage<\/strong>.<\/p>\nLa petici\u00f3n se realiza mediante HTTPS utilizando la URL
\nhttps:\/\/slack.com\/api\/chat.postMessage<\/em>.<\/p>\nDebemos enviar nuestro token mediante la cabecera HTTP:<\/p>\n
Authorization: Bearer TOKEN<\/code><\/pre>\ny proporcionar como m\u00ednimo el canal y el contenido del mensaje.<\/p>\n
Conceptualmente enviaremos un documento JSON parecido a este:<\/p>\n
\n
{<\/span><\/span>\n \"channel\"<\/span>:<\/span> \"C0123456789\"<\/span>,<\/span><\/span>\n \"text\"<\/span>:<\/span> \"Copia de seguridad terminada correctamente\"<\/span><\/span>\n}<\/span><\/span><\/code><\/pre>\n<\/div>\nEsta operaci\u00f3n es independiente del lenguaje de programaci\u00f3n que
\nutilicemos.<\/p>\n
Por esta raz\u00f3n podemos realizar exactamente la misma petici\u00f3n desde
\nPHP, AppleScript, PowerShell, Python, Java, C# o pr\u00e1cticamente cualquier
\nentorno capaz de efectuar una petici\u00f3n HTTPS.<\/p>\n
Vamos a ver tres ejemplos.<\/p>\n
Enviar una
\nnotificaci\u00f3n a Slack desde PHP<\/h4>\n
Supongamos que tenemos una p\u00e1gina web alojada en un hosting PHP y
\nqueremos recibir una notificaci\u00f3n cuando sucede alg\u00fan
\nacontecimiento.<\/p>\n
Podr\u00eda tratarse de una tarea ejecutada mediante cron<\/code>, una copia de seguridad o un proceso interno de nuestra aplicaci\u00f3n.<\/p>\nUna implementaci\u00f3n sencilla utilizando cURL ser\u00eda la siguiente:<\/p>\n
\n
<?php<\/span><\/span>\n<\/span>\n$token<\/span> =<\/span> getenv<\/span>('SLACK_BOT_TOKEN'<\/span>);<\/span><\/span>\n$canal<\/span> =<\/span> 'C0123456789'<\/span>;<\/span><\/span>\n<\/span>\n$datos<\/span> =<\/span> [<\/span>\n 'channel'<\/span> => $canal<\/span>,<\/span><\/span>\n 'text'<\/span> => 'Mensaje enviado desde mi servidor PHP'<\/span><\/span>\n];<\/span><\/span>\n<\/span>\n$curl<\/span> =<\/span> curl_init<\/span>('https:\/\/slack.com\/api\/chat.postMessage'<\/span>);<\/span><\/span>\n<\/span>\ncurl_setopt_array<\/span>($curl<\/span>,<\/span> [<\/span>\n CURLOPT_POST<\/span> => true<\/span>,<\/span><\/span>\n CURLOPT_RETURNTRANSFER<\/span> => true<\/span>,<\/span><\/span>\n CURLOPT_HTTPHEADER<\/span> => [<\/span>\n 'Authorization: Bearer '<\/span> .<\/span> $token<\/span>,<\/span><\/span>\n 'Content-Type: application\/json; charset=utf-8'<\/span><\/span>\n ],<\/span><\/span>\n CURLOPT_POSTFIELDS<\/span> => json_encode<\/span>($datos<\/span>)<\/span>\n]);<\/span><\/span>\n<\/span>\n$respuesta<\/span> =<\/span> curl_exec<\/span>($curl<\/span>);<\/span><\/span>\n<\/span>\ncurl_close<\/span>($curl<\/span>);<\/span><\/span>\n<\/span>\necho<\/span> $respuesta<\/span>;<\/span><\/span><\/code><\/pre>\n<\/div>\nEl token se obtiene mediante:<\/p>\n
\n
getenv<\/span>('SLACK_BOT_TOKEN'<\/span>)<\/span><\/code><\/pre>\n<\/div>\nen lugar de escribirlo directamente en el c\u00f3digo.<\/p>\n
Siempre que nuestro hosting lo permita, resulta preferible almacenar
\ncredenciales y secretos mediante variables de entorno o mediante alg\u00fan
\nmecanismo de configuraci\u00f3n situado fuera del directorio p\u00fablico de
\nnuestra p\u00e1gina web.<\/p>\n
Crear una funci\u00f3n
\nPHP para enviar mensajes<\/h5>\n
Si vamos a utilizar Slack desde diferentes partes de nuestra
\naplicaci\u00f3n PHP, podemos encapsular el c\u00f3digo anterior en una
\nfunci\u00f3n:<\/p>\n
\n
function<\/span> enviarSlack($mensaje<\/span>)<\/span>\n{<\/span>\n $token<\/span> =<\/span> getenv<\/span>('SLACK_BOT_TOKEN'<\/span>);<\/span><\/span>\n $canal<\/span> =<\/span> 'C0123456789'<\/span>;<\/span><\/span>\n<\/span>\n $datos<\/span> =<\/span> [<\/span>\n 'channel'<\/span> => $canal<\/span>,<\/span><\/span>\n 'text'<\/span> => $mensaje<\/span><\/span>\n ];<\/span><\/span>\n<\/span>\n $curl<\/span> =<\/span> curl_init<\/span>('https:\/\/slack.com\/api\/chat.postMessage'<\/span>);<\/span><\/span>\n<\/span>\n curl_setopt_array<\/span>($curl<\/span>,<\/span> [<\/span>\n CURLOPT_POST<\/span> => true<\/span>,<\/span><\/span>\n CURLOPT_RETURNTRANSFER<\/span> => true<\/span>,<\/span><\/span>\n CURLOPT_HTTPHEADER<\/span> => [<\/span>\n 'Authorization: Bearer '<\/span> .<\/span> $token<\/span>,<\/span><\/span>\n 'Content-Type: application\/json; charset=utf-8'<\/span><\/span>\n ],<\/span><\/span>\n CURLOPT_POSTFIELDS<\/span> => json_encode<\/span>($datos<\/span>)<\/span>\n ]);<\/span><\/span>\n<\/span>\n $respuesta<\/span> =<\/span> curl_exec<\/span>($curl<\/span>);<\/span><\/span>\n<\/span>\n curl_close<\/span>($curl<\/span>);<\/span><\/span>\n<\/span>\n return<\/span> $respuesta<\/span>;<\/span><\/span>\n}<\/span><\/code><\/pre>\n<\/div>\nAhora podemos enviar una notificaci\u00f3n simplemente escribiendo:<\/p>\n
\n
enviarSlack('La copia de seguridad ha terminado correctamente.'<\/span>);<\/span><\/span><\/code><\/pre>\n<\/div>\nPara enviar una notificaci\u00f3n de que se ha terminado la copia de
\nseguridad ser\u00eda algo como:<\/p>\n
\n
if<\/span> ($copiaCorrecta<\/span>) {<\/span>\n enviarSlack('✅ Copia de seguridad terminada correctamente.'<\/span>);<\/span><\/span>\n} else<\/span> {<\/span>\n enviarSlack('⚠️ Se ha producido un error durante la copia de seguridad.'<\/span>);<\/span><\/span>\n