- NodeJS - Servidor de Javascript
- Express.JS - Framework pra NodeJS
- @slack/bolt - Framework para criação de Slack Apps
- google-spreadsheet - Lib wrapper para a Google Sheets API
Antes de começar, verifique se você atendeu aos seguintes requisitos:
- Ter a versão do node
>=v14.19.1
instalada
Para usar o pridebot localmente, siga as seguintes etapas:
Instale as dependências
npm i
Crie um arquivo .env
touch .env
Preencha o arquivo .env com as chaves nescessárias:
SLACK_SIGNING_SECRET= <hash>
SLACK_BOT_TOKEN= <xoxb-key>
SLACK_APP_TOKEN= <xapp-key>
GOOGLE_KEY= <private-key>
GOOGLE_SHEET= <sheet-hash>
GOOGLE_EMAIL= <google-api-user-email>
Para configurar as keys referentes ao bot do slack, você precisa configurar o bot em seu workspace conforme a documentação do bolt nas sessões Create an app e Tokens and installing apps.
Pra configurar as keys do google sheets basta seguir esse tutorial de Google API pra Node
Hoje o Pridebot consome as informações de uma planilha Google pra que pessoas da empresa possam contribuir facilmente com pouco conhecimento técnico.
A API do google sheets espera 3 cabeçalhos que você pode configurar em services/gsServices.js
:
termos | explicacao | sugestao |
---|---|---|
Termos a serem corrigidos, aceita patterns de regex | explicação do porque precisamos substituir esses termos | sugestões de palavras novas pra utilizar |
A resposta do bot foi feita usando o Block Kit builder, com ela você pode construir respostas customizadas contento botões e até call to actions.
Esse projeto está sob licença MIT. Veja o arquivo LICENÇA para mais detalhes.