Documentação
Configure o ChatMade, tela por tela.
37 páginas escritas para quem atende cliente, não para quem programa. O painel do produto está em inglês: aqui o rótulo real vem primeiro e a tradução entre parênteses.
Comece por aqui
Início rápido
Do primeiro acesso até o chat respondendo no seu site, em sete passos.
Esta documentação é para quem vai configurar e operar o ChatMade — normalmente a pessoa que responde o cliente hoje, não uma pessoa de tecnologia. O único momento em que você precisa de alguém técnico é para colar uma linha de código no site, e mesmo isso está explicado passo a passo.
O ChatMade é um atendimento com IA que responde a partir do que você ensinou para ele, e que chama um humano quando a conversa pede. Ele vive em app.chatmade.com.br.
Antes de começar, três coisas
O painel está em inglês. Não existe tradução do painel. Todos os botões, abas e campos aparecem em inglês. Nesta documentação, o rótulo real vem primeiro e a tradução vem entre parênteses — assim: AI Configuration (“Configuração de IA”). Procure sempre pelo texto em inglês na tela.
A resposta ao cliente sai em português. Isso não é o painel traduzido: é o modelo de IA respondendo no idioma de quem escreveu. Quem manda mensagem em português recebe resposta em português.
A chave do provedor de IA é sua. O ChatMade não vende crédito de IA. Você cria uma conta no provedor que preferir, gera uma chave e cola no painel. O consumo é cobrado direto pelo provedor.
Atalhos para as seções
12 seções · 37 páginas
Comece aqui
1 página-
Início rápido
Do primeiro acesso até o chat respondendo no seu site, em sete passos.
Primeiros passos
3 páginas-
Sua organização
Nome, domínio, fuso horário e horário comercial — e por que o horário comercial é a configuração que mais muda o comportamento do agente.
-
Usuários e acesso
Como criar as contas do seu time, definir a senha de cada pessoa e escolher o que cada papel enxerga.
-
Provedor de IA
Os 7 provedores aceitos, como colar a sua chave e por que essa escolha vale para a organização inteira.
O agente
5 páginas-
Personalidade e instruções
O campo de instruções é onde você define o jeito de falar, o que o agente pode prometer e o que ele deve fazer quando não sabe.
-
Escopo e guardrails
As três camadas que impedem o agente de virar uma IA de uso geral, de obedecer visitante mal-intencionado e de entregar a própria configuração.
-
Transferir para um atendente
A regra exata que decide entre chamar uma pessoa e prometer retorno — e as duas condições que precisam ser verdadeiras ao mesmo tempo.
-
Workflows sem código
Montar um roteiro de conversa arrastando blocos — os nove blocos disponíveis, o que cada um faz de verdade e o que ainda não existe.
-
Ferramentas MCP
Conectar o agente a servidores MCP externos para que ele consulte sistemas de verdade em vez de só ler documentos.
Conhecimento
2 páginas-
Base de conhecimento
Ensinar o agente a partir do seu site, de PDFs e de texto colado — com os limites reais e a parte que quase ninguém tem: editar depois de importar.
-
Central de ajuda
Uma página pública de perguntas e respostas, gerada a partir da sua base de conhecimento e servida no seu próprio domínio.
Widget
4 páginas-
Instalar o widget
O trecho de código que coloca o chat no seu site, onde encontrá-lo e como conferir se funcionou.
-
Aparência do widget
Os 8 estilos de chat, as cores, os textos de boas-vindas e as quatro formas de posicionar o widget na página.
-
Conversas identificadas
Quando o visitante já está logado no seu site, o widget pode saber quem ele é — e essa ligação exige um passo no seu servidor.
-
Anexos de arquivo
Deixar o cliente enviar print, PDF e planilha na conversa — com os tipos, os tamanhos e o momento exato em que isso é liberado.
Chamados
4 páginas-
Chamados
O sistema de chamados do ChatMade — 9 status, prioridade, severidade, SLA, CSAT e triagem automática por IA, tudo dentro do painel.
-
Investigação automática
A IA levanta hipóteses, testa cada uma nos seus dados e escreve o laudo — dentro de um orçamento fixo e do nível de autonomia que você escolher.
-
Conectores de banco
Como dar ao investigador acesso somente-leitura ao seu banco, com lista branca de tabelas, colunas mascaradas e escopo por cliente.
-
Abrir chamado por alerta
Aponte o webhook do Grafana, do Alertmanager, do Datadog ou do seu próprio script para o ChatMade e o alerta vira chamado com investigação automática.
Leads e CRM
3 páginas-
Captura de leads
O agente coleta nome, e-mail e o que mais você pedir durante a conversa, sem formulário, e escreve um resumo de qualificação.
-
HubSpot
Conecte o HubSpot e cada lead capturado vira um contato com uma nota contendo o resumo da IA — envio numa direção só.
-
Pipedrive
Conecte o Pipedrive e cada lead capturado vira Pessoa, Organização, Lead e nota — sem sobrescrever nada que já estava preenchido.
Canais
8 páginas-
Canais de atendimento
Os nove lugares por onde o seu cliente fala com o agente — como cada um se conecta, o que têm em comum e o que nenhum deles faz.
-
WhatsApp
Conecte um número do WhatsApp Business ao seu agente — pela Meta ou colando as credenciais — e entenda a janela de 24 horas e os modelos aprovados.
-
Telegram
O canal mais rápido de ligar — cria o bot no BotFather, cola o token e pronto. Sem aprovação, sem janela de 24 horas.
-
Messenger e Instagram
Os dois canais da Meta que não são WhatsApp — como conectar cada um, por que o Instagram herda do Messenger e por que a janela de 24 horas aqui não tem saída.
-
Slack
O canal mais completo dos nove — menções em canal viram conversa em tópico, mensagem direta vira atendimento privado, e há uma aba própria do app no Slack.
-
E-mail
Aponte a caixa de suporte para o ChatMade e o agente responde e-mail com encadeamento correto, sem citar a mensagem anterior e sem responder resposta automática.
-
SMS
Seis provedores de SMS implementados — Twilio, Vonage, Plivo, MessageBird, Brevo e AWS SNS — com as credenciais de cada um e onde colar a URL de entrada.
-
LINE
Conecte uma Conta Oficial do LINE colando o segredo do canal e o token de acesso — o webhook é configurado sozinho.
Integrações
2 páginas-
Jira
Conecte o Jira e o agente passa a abrir, consultar e conferir chamados lá — e os chamados do ChatMade escalam automaticamente acima da prioridade que você escolher.
-
Shopify
O agente sabe consultar produto e pedido da sua loja — mas a jornada de instalação pela loja não está disponível nesta versão. Leia o aviso antes de planejar.
Equipe
3 páginas-
Atendentes e grupos
Como criar as pessoas do seu time, organizá-las em times e entender por que aqui não existe convite por e-mail.
-
Papéis e permissões
As 25 permissões do ChatMade, os dois papéis que vêm prontos, como montar um papel sob medida e qual permissão abre qual tela.
-
Caixa de entrada
Onde a sua equipe acompanha o que a IA está atendendo, assume uma conversa, repassa para um colega e encerra.
Análises
1 página-
Métricas e avaliações
As quatro abas de análise do ChatMade — volume, desempenho por agente, por cliente e sentimento — e a diferença entre avaliação de conversa e CSAT de chamado.
Implantação
1 página-
Instalar com Docker
O passo a passo real para subir o ChatMade na sua própria máquina ou no seu servidor, com Docker Compose, Postgres com pgvector e Redis.
Não achou o que procurava?
Mande a dúvida no WhatsApp. Se a resposta faltar aqui, ela vira página.