Mas primeiramente o que é o slack?

Saiba mais sobre isso no nosso post sobre a ferramenta clicando aqui.

Primeiros passos

Antes de iniciamos a configuração, temos que criar uma conta no slack, para isso acesse aqui.

Após termos criados a nossa conta, vamos criar um novo token de autorização dentro do slack, com esse token vamos postar as mensagens enviadas do protheus para o nosso canal, para isso siga as etapas abaixo.

1. Crie um novo aplicativo na app management page;
2. Clique no botão create a new app, seremos redirecionados a pagina de configuração.
   1. Informe um nome para seu aplicativo ex. ERPProtheus
   2. Seleciona o workspace que esse app pertencerá]

3. Criar Webhooks de entrada para o Slack,

   1. Na pagina de seus aplicativos, selecionar o novo app criado.
   2. Seleciona a opção, adicionar novas funcionalidades.
   3. Seleciona a opção webhook de entrada e a ative.
   4. Clique em adicionar novo webhook ao workspace(onde vamos informar em que canal serão enviadas as informações)
   5. Nesse momento o sistema ira gerar uma URL única, copie e guarde, vamos precisar dela no nosso fonte.

   6. resumindo o webhooks de entrada são um jeito simples de compartilhar informações de fontes externas com seu workspace. Mais informações aqui.

Após a criação do nosso app no slack, temos que configurar o protheus para enviar informações, abaixo um exemplo para ler o errorl.log e enviar os novos erros para o slack, altere e use da maneira que for sua necessidade.

#Include "Protheus.ch"
#INCLUDE "fileio.ch"
/*/{Protheus.doc} SPSLACK
(long_description)
@type Function
@author user
@since 22/01/2020
@version version
@param param_name, param_type, param_descr
@return return_var, return_type, return_description
@example
(examples)
@see (links_or_references)
/*/
user Function SPSLACK()
Local cUrl := ''//TODO insira aqui a sua url do slack, similar a https://hooks.slack.com/services/TSN3MSKFD/BTG0YNAMQ/M1bSfoBKUEyUX4uc7DezlC
Local nTimeOut := 120
Local aHeadOut := {}
Local cHeadRet := ""
Local sPostRet := ""
Local _ni := 0
Local aMsg := u_FSLERLOG() //get messages
//aadd(aHeadOut,'User-Agent: Mozilla/4.0 (compatible; Protheus '+GetBuild()+')')
aadd(aHeadOut,'Content-type: application/json')
For _ni := 1 to len(aMsg)
sPostRet := HttpPost(cUrl,,'{"text":"'+aMsg[_ni]+'"}',nTimeOut,aHeadOut,@cHeadRet)
next
if !empty(sPostRet)
conout("HttpPost Ok")
varinfo("WebPage", sPostRet)
else
conout("HttpPost Failed.")
varinfo("Header", cHeadRet)
Endif
Return .T.
/*/{Protheus.doc} User Function FSLERLOG
(long_description)
@type Function
@author user
@since 22/01/2020
@version version
@param param_name, param_type, param_descr
@return return_var, return_type, return_description
@example
(examples)
@see (links_or_references)
/*/
User Function FSLERLOG(cLogFile)
Local aMensagem as Array
Local cDelimt as Character
default cLogFile := '\system\error.log'
aMensagem := {}
cDelimt := 'SP_JA_ENVIADO'
nHdl := fOpen(cLogFile, FO_READWRITE + FO_SHARED) //fopen('\sigaadv\error.log' , FO_READWRITE + FO_SHARED )
If nHdl == -1
IF FERROR()== 516
ALERT("Feche a planilha que gerou o arquivo.")
EndIF
EndIf
//+---------------------------------------------------------------------+
//| Verifica se foi poss�vel abrir o arquivo |
//+---------------------------------------------------------------------+
If nHdl == -1
cMsg := "O arquivo de nome "+cLogFile+" nao pode ser aberto! Verifique os parametros."
MsgAlert(cMsg,"Atencao!")
Return
Endif
//+---------------------------------------------------------------------+
//| Posiciona no Inicio do Arquivo |
//+---------------------------------------------------------------------+
FSEEK(nHdl,0,0)
//+---------------------------------------------------------------------+
//| Traz o Tamanho do Arquivo TXT |
//+---------------------------------------------------------------------+
nTamArq:=FSEEK(nHdl,0,2)
//+---------------------------------------------------------------------+
//| Posicona novamemte no Inicio |
//+---------------------------------------------------------------------+
FSEEK(nHdl,0,0)
//+---------------------------------------------------------------------+
//| Fecha o Arquivo |
//+---------------------------------------------------------------------+
fClose(nHdl)
FT_FUse(cLogFile) //abre o arquivo
FT_FGOTOP() //posiciona na primeira linha do arquivo
nTamLinha := Len(FT_FREADLN()) //Ve o tamanho da linha
FT_FGOTOP()
//+---------------------------------------------------------------------+
//| Verifica quantas linhas tem o arquivo |
//+---------------------------------------------------------------------+
nLinhas := nTamArq/nTamLinha
nCont := 0
lAchou := .F.
lAchou2 := .F.
aDados:={}
While !FT_FEOF() //Ler todo o arquivo enquanto n�o for o final dele
//Se achou o delimetador, zera array pq as inform��es ja foram enviadas
If cDelimt $ FT_FREADLN()
aMensagem := {}
lAchou2 := .T.
Endif
//rava o erro para ser postado no Slack
If 'THREAD ERROR' $ FT_FREADLN()
aAdd(aMensagem," ") //Adcionar uma nova mensagem
lAchou := .T.
Endif
If lAchou .and. nCont <= 8 //gravar 8 linhas
aMensagem[len(aMensagem)] += FT_FREADLN() +CHR(13)+CHR(10)+CHR(13)+CHR(10)
nCont ++
else
lAchou := .F.
nCont := 0
Endif
clinha := FT_FREADLN()
conout(clinha)
FT_FSKIP()
EndDo
FT_FUse()
fClose(nHdl)
If !lAchou2
nHdl := fOpen(cLogFile, FO_READWRITE + FO_SHARED) //fopen('\sigaadv\error.log' , FO_READWRITE + FO_SHARED )
//add delimetador
FSeek(nHdl, 0, FS_END) // Posiciona no fim do arquivo
fWrite(nHdl,cDelimt + chr(13)+chr(10) )
fClose(nHdl)
Endif
Return aMensagem

Esse e outros exemplos você encontra em nosso git.

Até a próxima

O post Integrar Protheus ao Slack apareceu primeiro em Sem Preju.

Há quatro coisas principais a serem observadas no Slack:

1. O nome da instância do Slack.
2. A lista de canais dos quais você é membro.
3. A lista de pessoas para as quais você enviou mensagens diretamente.
4. A janela de bate-papo.

Quando um cliente deseja começar a usar o Slack, ele escolhe um nome para sua instância do Slack . Isso então se torna parte do URL exclusivo. 

Os canais do Slack podem ser públicos, o que significa que qualquer membro pode ver e ingressar nesse canal, ou privado, ou seja, apenas os membros desse canal podem vê-lo ou convidar outras pessoas a participar. 

A janela de bate-papo é onde toda a comunicação real acontece. Você pode ler qualquer resposta às mensagens, usar reações emoji, adicionar gifs, ver feeds RSS, definir lembretes, receber notificações de complementos e vários outros sinos e assobios. Mas, mais do que tudo, é aqui que você fala com as pessoas.

O que há de tão bom no Slack?

Quando o Slack apareceu, não havia concorrentes reais no mercado. Isso não quer dizer que não havia outros aplicativos de bate-papo, mas o Slack combinou uma interface de usuário intuitiva com mensagens de grupo e de pessoa para pessoa. Ele também permite que as empresas tenham um certo controle sobre quem pode usá-lo através do sistema de convites. Outras ferramentas poderiam fazer o mesmo, mas sem a mesma usabilidade (o Campfire , agora BaseCamp, era óbvio). Nenhum dos fornecedores tradicionais (Microsoft, Apple, IBM, Sun e assim por diante) tinha algo comparável ao Slack.

Essa falta de tamanho corporativo também foi um benefício. O Slack era pequeno o suficiente para ser ágil e rápido quando se tratava de adicionar novos recursos, como reações emoji (ótimas para usuários) e  autenticação de dois fatores (ótima para administradores). Para alguns usuários, o fato de o Slack não pertencer a um grande fornecedor tradicional foi beneficiado o suficiente, mas isso não explica por que o Slack é tão popular.

O Slack faz duas coisas muito bem: projetar e entender as necessidades de seus usuários. Esses dois pilares são a base da maioria dos bons produtos, mas são surpreendentemente difíceis de executar, como muitos aplicativos falharão. O design inicial bruto foi criado pelo fundador do Slack, Stewart Butterfield (o mesmo cara que fundou o Flickr no início dos anos 2000) e sua equipe, e depois entregue a um terceiro chamado MetaLab para polir. Andrew Wilkinson, da MetaLab, explicou :

“Para chamar a atenção em um mercado lotado, tivemos que encontrar uma maneira de chamar a atenção das pessoas. A maioria dos softwares empresariais parece um traje de baile barato dos anos 70 – azuis e cinzas suaves em todos os lugares – então, começando com o logotipo, fizemos com que o Slack parecesse um canhão de confete. Azul elétrico, amarelos, roxos e verdes por toda parte. Demos a ele o esquema de cores de um videogame, não um produto de colaboração empresarial … cores vibrantes, um tipo de letra sans-serif cheio de curvas, ícones amigáveis ​​e rostos sorridentes e emojis em todos os lugares. ”

Wilkinson fala sobre o quão bem construído o Slack se sente quando você o usa – o que faz – e como o conteúdo, como carregar mensagens, é informal e geralmente muito engraçado, concluindo: “É o mesmo cliente de bate-papo corporativo por baixo , mas é divertido, divertido de usar e tudo o que se junta para fazer com que pareça um personagem em sua vida. ”

Quantas empresas você sabe onde todos têm que trabalhar uma mudança regular no suporte para garantir que compreendem os pontos negativos do cliente?

O Slack também decidiu desde o início impulsionar um ecossistema de integrações de aplicativos. Os usuários podem integrar praticamente qualquer aplicativo que desejarem, desde ferramentas de desenvolvimento, como GitHub, Jenkins e StackOverflow, até ferramentas de negócios, como Google Analytics, ServiceNow, MailChimp ou SalesForce. Existem  mais de 1500 aplicativos com os quais o  Slack pode se integrar, por isso, se não puder fazer algo que você precisa, provavelmente há um aplicativo que pode. Isso transforma o Slack em um poderoso aplicativo de hub que os usuários podem abrir em uma tela enquanto trabalham em outra. Em essência, o Slack se tornou um balcão único para muitos usuários.

Os dois pilares do design e da compreensão das necessidades de seus usuários tornaram o Slack popular. Esta pesquisa fornece uma boa descrição do que os usuários pensam do Slack, e as descobertas são quase universalmente positivas.

O Slack é tão popular que Atlassian – o gigante australiano de bilhões de dólares por trás de aplicativos de produtividade extremamente bem-sucedidos, como Jira e Confluence – admitiu a derrota em 2018 e vendeu seus dois esforços em um aplicativo de bate-papo , HipChat e Stride, para o Slack – base de usuários e tudo.

Se você quer saber como usar o Slack, dê uma olhada neste guia de referências rápidas, um tutorial Slack para iniciantes:

Crie times

Para começar a usar o Slack você precisa criar um time, que normalmente será por onde você gerenciará a comunicação interna de sua empresa ou startup. É possível criar mais de um time dentro do Slack, caso sua empresa seja dividida em unidades de negócios, por exemplo.

Crie canais

Para cada time você cria canais com seus assuntos de interesse. Por exemplo: criação, atendimento ao cliente, produção, desenvolvimento, suporte etc.

Esses canais podem ser públicos, com acesso de todos os participantes da empresa, ou fechados, o que pode ser útil quando se está desenvolvendo um projeto específico, por exemplo.

Mensagens diretas

Quer falar diretamente com alguém? Você pode trocar mensagens diretamente com uma pessoa ou grupo sem que o canal inteiro participe e não precisa recorrer ao WhatsApp ou Skype para isso, faz diretamente no Slack.

Comandos Slach

O Slack tem uma série de comandos para facilitar sua vida. Por exemplo, se quer citar uma pessoa, use @nomedapessoa, ou se quer notificar um canal, use #nomedocanal, quando estiver digitando sua mensagem.

Além disso, existem os “comandos Slash”, iniciados por uma barra como esta “/”.

Digitando /remind, você pode receber um lembrete do Slack do que precisa fazer mais tarde, por exemplo: /remind in 3 hours to iniciar a reunião com o cliente.

Outros comandos muito usados:

• /call: para abrir uma chamada de voz
• /collapse: esconde as imagens de uma conversa, para ficar mais fácil de entender o que rolou
• /expand: para desfazer o comando acima
• /away: alterar seu status para que todos saibam que está ocupado
• /msg ou /dm @nomedapessoa: para mandar uma mensagem direta para alguém

E estes são apenas alguns deles.

Compartilhamento de arquivos

Além de poder simplesmente arrastar e soltar imagens para suas mensagens, o Slack permite o compartilhamento de arquivos dos mais diversos tipos e ainda te ajuda a entender do que se trata, pois ele cria um ícone explicativo de qual é o formato do arquivo, seu tamanho, nome e outros dados.

Aplicativo Slack para Smartphone

O Slack também funciona em smartphones, o que pode ser bom por um lado, mas se tornar um vício, por outro.

Para baixar o app Slack em português, escolha o link correspondente ao seu aparelho: : iOS, Android e Windows Phone.

Recomendamos que você  crie um espaço de trabalho e experimente o Slack para verificar se ele atende às suas necessidades.

Até a próxima

O post O que é Slack e por que as pessoas adoram? apareceu primeiro em Sem Preju.