Slack

Esta página é para quem quer o agente dentro do Slack — atendendo o próprio time, ou um canal compartilhado com cliente. O Slack é o canal mais desenvolvido do ChatMade: tópicos, indicador de digitando, sugestões de pergunta e uma aba própria do aplicativo.

O que você precisa antes

• Um espaço de trabalho no Slack onde você possa instalar aplicativo.
• Um aplicativo criado em api.slack.com/apps.
• Numa instalação própria, três variáveis no .env do backend: SLACK_CLIENT_ID, SLACK_CLIENT_SECRET e SLACK_SIGNING_SECRET.
• No aplicativo do Slack, a URL de retorno {BACKEND_URL}/api/v1/channels/slack/callback cadastrada em Redirect URLs.
• Um administrador do ChatMade com a permissão manage_organization.

Atenção: sem o SLACK_SIGNING_SECRET, todo webhook que o Slack mandar é recusado com 403. A verificação de assinatura falha fechada, de propósito. Se o agente conectar e nunca responder, comece por essa variável.

Onde pegar cada credencial

No painel do seu aplicativo em api.slack.com/apps, tela Basic Information:

Variável	Onde está
SLACK_CLIENT_ID	Bloco App Credentials, campo Client ID
SLACK_CLIENT_SECRET	Bloco App Credentials, campo Client Secret
SLACK_SIGNING_SECRET	Bloco App Credentials, campo Signing Secret

Conectar

O Slack é o único canal sem formulário de credencial no painel. É OAuth e só.

1. No painel, abra Settings → Integrations (“Configurações → Integrações”).
2. Ache o cartão Slack, com a descrição “Connect a Slack workspace so users can chat with your AI agent via @mentions and DMs.”
3. Clique em Connect (“Conectar”). O navegador vai para a tela de autorização do Slack.
4. Escolha o espaço de trabalho e autorize.

Os escopos pedidos são quatro, e só eles: app_mentions:read, chat:write, im:history e users:read.

5. Você volta para as integrações com o aviso “Slack connected — choose which agent should answer.” e o modal já aberto, com a linha “Choose which AI agent answers your Slack mentions and DMs.”
6. Escolha o agente e clique em Assign agent (“Atribuir agente”).

Não há URL de webhook para copiar: o endereço de eventos é fixo e o Slack já sabe dele pela instalação. A autenticação é a assinatura X-Slack-Signature, com janela de 5 minutos contra reenvio.

Como o atendimento funciona no Slack

Menção em canal. Alguém escreve @ChatMade ... num canal e o agente responde no tópico. Cada tópico é uma conversa separada — mencionar de novo em outro tópico abre outro atendimento.

Mensagem direta. Uma DM comum é uma conversa contínua, sem tópicos. Tudo o que a pessoa mandar entra no mesmo histórico.

Barra lateral do assistente. Abrindo o aplicativo pelo assistente da barra superior, cada conversa é um tópico próprio.

O que o Slack tem que os outros não têm

Indicador de digitando. O Slack não tem API de “bot digitando”, então o ChatMade contorna: publica uma mensagem temporária _typing…_ e depois edita essa mesma mensagem, trocando o texto pela resposta real. Se a edição falhar, a mensagem temporária é apagada.

Estado do assistente. Enquanto pensa, a barra do assistente mostra is getting ready….

Sugestões de pergunta. Sob o título Try asking: (“Experimente perguntar:”), o Slack oferece até 4 sugestões — o limite é da API. As duas que vêm de fábrica são “What can you help with?” e “Talk to a human”.

Boas-vindas. A primeira mensagem que a pessoa recebe é:

Hi! I’m {nome do agente}. 👋 Ask me anything and I’ll help right away — I answer from your team’s knowledge and can bring in a human when you need one.

Sem agente atribuído, o texto muda para avisar exatamente isso: “No agent is connected to this workspace yet.”

Aba do aplicativo (App Home). O aplicativo tem uma aba própria dentro do Slack, com o cabeçalho ChatterMate, a explicação do que ele faz e o bloco How to use me (“Como me usar”):

• @mention ChatterMate in any channel — I reply in the thread • Send me a direct message for a private conversation • Open me from the assistant in the top bar for a side-by-side chat

A aba mostra também o estado do agente — 🟢 Online ou ⚪ Offline — e um link Open the ChatterMate dashboard →.

Bom saber: a aba do aplicativo é só leitura. Não há botão para clicar nem formulário para preencher — a interatividade foi deixada de fora de propósito. O que se faz ali é ler e entender; o atendimento acontece na conversa.

Testar

Não há botão de teste. Vá até um canal onde o aplicativo esteja, mencione o bot e veja a resposta aparecer no tópico.

Limites

• Resposta cortada em 12.000 caracteres — bem abaixo do teto duro de 40 mil do Slack.
• Tempo limite de 15 segundos por chamada ao Slack.
• Sugestões de pergunta: no máximo 4.
• A instrução do agente mostrada na aba do aplicativo é cortada em 250 caracteres.
• A janela de autorização OAuth dura 600 segundos.
• A mensagem temporária de “digitando” vive 300 segundos antes de ser esquecida.
• A verificação de assinatura recusa evento com mais de 300 segundos.
• Trava contra evento duplicado de 1 hora.

Atenção: o Slack não recebe nem envia mídia neste sistema. Arquivo, imagem e trecho de código enviados como anexo são descartados — só o texto da mensagem passa.

O ChatMade converte a marcação da resposta para o formato do Slack: **negrito** vira o asterisco simples que o Slack entende.

Desinstalação

Se alguém desinstalar o aplicativo pelo lado do Slack, ou revogar o token do bot, o ChatMade recebe o aviso e apaga a conexão sozinho.

Desconectar

Botão Disconnect (“Desconectar”) no cartão, com a confirmação listando o que para de funcionar.

Próximo passo

Se o seu suporte também entra por e-mail, veja E-mail.