Como enviar notificações do Slack a partir de um Planilhas Google usando o Apps Script

Observação: Esta postagem foi publicada originalmente em nosso fórum da comunidade.

No local de trabalho moderno, a automação de tarefas rotineiras é fundamental para a eficiência. Uma tarefa comum é o envio de notificações com base em dados de planilhas, como aniversários ou datas comemorativas. O Slack, uma ferramenta de comunicação popular para equipes, pode ser integrado ao Google Sheets para enviar notificações automatizadas, facilitando a celebração de ocasiões especiais ou o lembrete de datas importantes aos membros da equipe.

Nesta postagem do blog, vamos orientá-lo no processo de configuração de notificações do Slack a partir de uma planilha do Google usando o Google Apps Script e como criar um aplicativo do Slack para essa finalidade.

Criação de um aplicativo Slack para notificações

Antes de mergulhar no script, você precisa configurar um aplicativo Slack para enviar notificações ao seu workspace. Veja como:

1. Comece visitando o site da API do Slack em https://api.slack.com/apps. Faça login se for solicitado.
2. Criar um novo aplicativo: Clique em “Create New App” (Criar novo aplicativo). Escolha “From scratch” (Do zero) e dê um nome ao seu aplicativo. Selecione o espaço de trabalho onde deseja instalar o aplicativo.
3. Ativar webhooks de entrada: Depois de criar seu aplicativo, vá para “Incoming Webhooks” na seção “Features” (Recursos) e ative-o. Isso permite que seu aplicativo envie mensagens para um canal do Slack.
4. Gerar um URL de webhook: Clique em “Add New Webhook to Workspace”, escolha um canal (como #general) para notificações e clique em “Allow”. Copie o URL do webhook fornecido.

Esse URL é o que você usará no seu script do Google Apps para enviar mensagens da sua planilha para o Slack.

Automatização de notificações do Slack com o Google Apps Script

Com o aplicativo Slack e o webhook prontos, a próxima etapa é automatizar as notificações de uma planilha do Google. Suponha que você tenha uma planilha com a coluna A para e-mails, a coluna B para nomes e a coluna C para aniversários.

1. Abra sua planilha: Vá para a planilha da qual deseja enviar notificações.
2. Acessar o Apps Script Editor: Clique em Extensões > Apps Script e limpar qualquer código existente.
3. Colar o script: Use o seguinte script do Google Apps, substituindo 'YOUR_WEBHOOK_URL_HERE' com sua URL real do webhook do Slack.

      function sendSlackNotifications() {
        var webhookUrl = 'YOUR_WEBHOOK_URL_HERE';
        var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName('Sheet1');
        var data = sheet.getDataRange().getValues();
        var today = new Date();
        today.setHours(0,0,0,0);
      
        data.forEach(function(row, index) {
          // Skip header row
          if (index === 0) return; 
          var email = row[0], name = row[1], birthday = new Date(row[2]);
          birthday.setHours(0,0,0,0);
      
          if (birthday.getTime() === today.getTime()) {
            var payload = JSON.stringify({ text: `🎉 Happy Birthday, ${name} (${email})! 🎉` });
            var options = { method: 'post', contentType: 'application/json', payload: payload };
            UrlFetchApp.fetch(webhookUrl, options);
          }
        });
      }

4. Salvar e executar o script: Clique no ícone do disco para salvar e, em seguida, clique no botão play para executar o script manualmente.
5. Automatize as notificações diárias: Para que esse script seja executado diariamente, clique no ícone do relógio (Triggers) e defina um acionador baseado em tempo para o script sendSlackNotifications função.

Considerações finais

A integração do Slack com o Google Sheets por meio do Apps Script é uma maneira poderosa de automatizar as notificações. Seja para comemorar aniversários, acompanhar marcos de projetos ou lembrar os membros da equipe de datas importantes, essa configuração simplifica a comunicação e garante que nenhuma ocasião especial passe despercebida. Lembre-se sempre de manter o URL do webhook seguro e de testar a configuração completamente antes de implementá-la para toda a sua equipe. Com um pouco de configuração, a comunicação da sua equipe pode se tornar mais eficiente e envolvente.