Pular para o conteúdo

Slack

Sua equipe fica sabendo no canal dela quando um cliente abre, aprova ou paga, sem abrir o Cord.

Como funciona

O Cord publica no Slack com um Incoming Webhook: um endereço que o Slack gera para um canal específico. Com Adicionar ao Slack, você escolhe o canal no Slack e o Cord recebe esse endereço sozinho. Os avisos e as mensagens de workflows saem apenas nesse canal.

Ao autorizar, o Slack mostra as permissões que o aplicativo do Cord pede: publicar no canal que você escolheu, ver e completar os links do Cord colados no seu workspace (para a pré-visualização), receber o comando /cord e ler o nome e o e-mail de quem clica em um botão de aprovação. Nenhuma delas permite que o Cord leia suas mensagens.

Há duas formas de receber mensagens, e você pode usar as duas:

Avisos de Notificações Ação de workflow
O que publica Uma mensagem padrão por evento de orçamento. O texto que você escrever, com dados do evento.
Quando Nos eventos que você marcar em Configurações › Notificações. Com qualquer um dos 48 gatilhos de eventos ou com o gatilho agendado, com condições e esperas.
Onde se configura Configurações › Notificações Workflows

Requisitos

Onde O que você precisa
Cord A permissão de Configurações. Qualquer plano.
Slack Poder instalar aplicativos no seu workspace. Se o seu workspace restringe a instalação, um administrador do Slack precisará aprovar o aplicativo do Cord.
Botões de aprovação Aprovações internas, que são do plano Scale ou superior, e que quem clicar no botão use no Slack o mesmo e-mail que no Cord e tenha a permissão de Aprovações.

1. Conecte seu canal

  1. Acesse Configurações › Integrações e toque em Slack.
  2. Clique em Adicionar ao Slack. O Slack se abre: escolha o canal onde você quer os avisos e clique em Permitir.
  3. Quando você volta, o cartão mostra Conectado a #seu-canal. Clique em Enviar teste: no canal deve aparecer uma mensagem de um orçamento de teste “ORC-TESTE”.

O Slack adiciona ao seu workspace um aplicativo chamado Cord; é ele que assina as mensagens. Se o seu workspace restringe a instalação de aplicativos, um administrador do Slack precisará aprová-lo.

Alternativa: um webhook próprio

Se você prefere que as mensagens saiam com o nome e o ícone do seu próprio aplicativo do Slack, abra Usar um webhook próprio no mesmo cartão:

  1. Em api.slack.com/apps, crie um aplicativo do zero, abra Incoming Webhooks, ative-os e clique em Add New Webhook to Workspace para escolher o canal.
  2. Copie a URL (ela começa com https://hooks.slack.com/services/), cole-a no Cord e clique em Salvar.
  3. Clique em Enviar teste. O teste usa a URL salva, não a que está digitada no campo.

2. Ative os avisos

Conectar o Slack não ativa nenhum aviso por si só. Acesse Configurações › Notificações e marque a coluna do Slack nos eventos que quiser:

Evento Quando o aviso é enviado
Seu cliente visualizou o orçamento Quando o cliente abre o link público.
Orçamento aprovado O cliente aceitou a proposta.
Orçamento recusado O cliente o recusou.
Pagamento recebido O pagamento online foi registrado.
Orçamento prestes a expirar 3 dias antes da data de validade.
Pagamento vencido Uma conta a receber passou da data.

Alguém entrou na equipe só é avisado por e-mail; não tem opção de Slack.

O que cada aviso contém

Cada aviso de Notificações é uma mensagem curta com:

  • O número do orçamento e o que aconteceu (visualizado, aprovado, recusado, pago, prestes a expirar, com pagamento vencido).
  • O cliente e o total com a moeda.
  • Um link Ver orçamento que abre o orçamento no Cord.

Os avisos de Notificações são de orçamentos: se um evento não tiver número, ele não é publicado no Slack.

Pré-visualizações, comando /cord e aprovações

Este recurso é novo e pode ainda não estar habilitado na sua conta. Se você não o vir, escreva para nós.

Com Adicionar ao Slack, o aplicativo do Cord também faz isto no seu workspace:

  • Pré-visualização de links. Um link público de orçamento colado no Slack se abre como um cartão com o número, o cliente, o status, o total e um botão Abrir no Cord. Isso só acontece com orçamentos da sua própria organização.
  • Comando /cord. Digite /cord e o número de um orçamento ou o nome de um cliente, por exemplo /cord COT-0152. Só você vê a resposta, que traz até 5 orçamentos.
  • Botões de aprovação. Quando um orçamento pede aprovação interna, ele chega ao canal com os botões Aprovar, Recusar e Abrir no Cord. Os botões só funcionam se a sua conta do Slack usar o mesmo e-mail que a sua conta do Cord e você tiver a permissão de Aprovações; caso contrário, o Slack diz para você decidir pelo Cord. As aprovações internas exigem o plano Scale ou superior.

Se você conectou o Slack antes de esses recursos existirem, o cartão pede que você reconecte: clique em Trocar de canal e autorize de novo. Com um webhook próprio, eles não estão disponíveis.

Mensagens próprias com workflows

Com a ação Enviar uma mensagem no Slack do Cord Workflows, você mesmo escreve a mensagem, com dados do evento, e decide quando ela sai. Exemplos:

  • Quando entra uma entrada: “{{cliente}} pagou a entrada de {{folio}}: {{monto}}. Saldo: {{saldo_pendiente}}.”
  • Quando uma contestação é aberta: “Contestação em {{folio}} de {{monto}}. Responder antes de {{fecha_limite}}.”
  • Quando uma venda grande é aprovada, só se o total passar de um certo valor.

Essa ação publica no mesmo canal e funciona mesmo que os avisos de Notificações estejam desativados.

O que circula e em que direção

Direção O que circula Quando
Do Cord para o Slack Os avisos que você marcar em Notificações: número, o que aconteceu, cliente, total com a moeda e o link Ver orçamento. Quando o evento acontece.
Do Cord para o Slack O texto que você escrever na ação Enviar uma mensagem no Slack de um workflow. Quando o workflow é executado.
Do Cord para o Slack O cartão de pré-visualização de um link de orçamento da sua organização, e a resposta do /cord, que só quem digitou o comando vê. Quando alguém cola o link ou usa o comando.
Do Slack para o Cord A decisão dos botões Aprovar ou Recusar de uma solicitação de aprovação interna. Quando alguém com permissão clica no botão.
Do Slack para o Cord Nada mais. O Cord não lê as mensagens dos seus canais. —

Limites

Limite Valor
Canais por organização Um por vez, o que você escolheu ao conectar
Mensagens a partir de workflows 120 por hora por organização
Tamanho da mensagem de um workflow 1.000 caracteres
Resultados do /cord Até 5 orçamentos
Pré-visualização de links Só orçamentos da sua própria organização
Avisos de Notificações Só eventos de orçamentos com número

Trocar de canal ou desconectar

  • Trocar de canal: clique em Trocar de canal no cartão e escolha outro no Slack. Com um webhook próprio, crie outro no Slack e cole a URL nova.
  • Desconectar: clique em Desconectar no cartão (com um webhook próprio, apague a URL e salve). O Cord deixa de publicar e o status volta a Não conectado. Os workflows com a ação do Slack começarão a falhar com “Conecte o Slack em Configurações › Integrações para usar esta ação.”
  • Revogar pelo Slack: se você excluir o webhook ou o aplicativo no Slack, a URL deixa de funcionar na hora, mesmo que continue salva no Cord.

O Cord só pode publicar em um canal por vez. Se você quiser avisos em vários canais, uma opção é usar o Make com os webhooks do Cord.

Problemas

Mensagem Causa O que fazer
A URL deve ser de hooks.slack.com Você colou outra URL, por exemplo a do canal ou a do aplicativo. Copie a URL do Incoming Webhook, a que começa com https://hooks.slack.com/.
Não há um webhook do Slack conectado. Cole a URL e salve primeiro. Você clicou em Enviar teste sem salvar. Clique em Salvar e depois teste.
O Slack não aceitou a mensagem. Verifique a URL do webhook. O Slack recusou a mensagem: o webhook foi excluído, o aplicativo foi removido ou a URL está incompleta. Crie um webhook novo e cole a URL completa.
Não foi possível enviar Erro de rede ao testar. Tente novamente.
O teste chega, mas os avisos não Os eventos não têm o Slack marcado. Verifique Configurações › Notificações.

Trate a URL do webhook como uma senha: qualquer pessoa que a tiver pode publicar no seu canal. Se achar que ela vazou, exclua-a no Slack e crie uma nova.

Relacionadas