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
- Acesse Configurações › Integrações e toque em Slack.
- Clique em Adicionar ao Slack. O Slack se abre: escolha o canal onde você quer os avisos e clique em Permitir.
- 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:
- 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.
- Copie a URL (ela começa com
https://hooks.slack.com/services/), cole-a no Cord e clique em Salvar. - 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/corde 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
- Microsoft Teams
- Notificações
- Ações de workflows
- Ideias prontas para usar: com o Slack conectado, os avisos delas à equipe saem pelo Slack.