Pular para o conteúdo
ChatMade
Entrar Falar com a gente

Início rápido

Do primeiro acesso até o chat respondendo no seu site, em sete passos.

Este é o caminho mais curto entre não ter nada e ter um agente de IA atendendo no seu site. São sete passos. Se você já tem o conteúdo do que quer responder e uma conta em um provedor de IA, dá para fazer numa manhã.

Você vai precisar de três coisas antes de começar:

  • Acesso ao painel em app.chatmade.com.br.
  • Uma conta em um provedor de IA com cartão cadastrado — OpenAI, Anthropic, Google Gemini, Mistral, xAI, DeepSeek ou Groq. A chave é sua e o consumo é cobrado por eles.
  • Acesso para editar o seu site, ou alguém que tenha. É uma linha de código, colada uma vez.

Bom saber: o painel do ChatMade está em inglês, sem tradução. Nesta documentação o rótulo real vem primeiro e a tradução entre parênteses — assim: AI Agents (“Agentes de IA”). Procure sempre pelo texto em inglês na tela. A resposta que chega ao seu cliente sai em português: o modelo responde no idioma de quem escreveu.

1. Criar a organização

Na primeira vez que alguém abre o painel, ele leva direto para a tela de configuração inicial, com o título Welcome to ChatterMate e o subtítulo Let’s get your organization set up.

Preencha, na ordem:

  1. Organization Name (“Nome da organização”) — o nome pelo qual o cliente conhece o negócio.
  2. Domain (“Domínio”) — o site, no formato suaempresa.com.br.
  3. Timezone (“Fuso horário”).
  4. Business Hours (“Horário comercial”) — cada dia da semana tem uma chave e dois horários. O padrão é segunda a sexta, das 09:00 às 17:00.
  5. Admin Name, Admin Email e Admin Password — os seus dados de acesso. A senha precisa de 8 caracteres, uma maiúscula, uma minúscula, um número e um caractere especial.

Clique em Create Organization (“Criar organização”).

Guarde essa senha. Não existe recuperação por e-mail no ChatMade — se você perder a senha do único administrador, não há como entrar. Anote em um gerenciador de senhas antes de seguir.

O horário comercial não é enfeite: ele decide, mais tarde, se o agente oferece um atendente humano ou promete retorno. Detalhes em Sua organização.

2. Ligar o provedor de IA

Sem isso, nada responde.

  1. No menu lateral, em Settings (“Configurações”), clique em AI Configuration (“Configuração de IA”).
  2. Abra a aba Advanced — Bring Your Own Model (“Avançado — Traga seu próprio modelo”).
  3. Em AI Provider (“Provedor de IA”), escolha o cartão do seu provedor.
  4. Em Model Name (“Nome do modelo”), escolha um modelo da lista.
  5. Em API Key (“Chave de API”), cole a chave gerada no site do provedor. Há um link ao lado que leva direto à página de chaves dele.
  6. Clique em Save Configuration (“Salvar configuração”).

Salvar testa a chave de verdade, com uma chamada ao provedor. Se der erro, a chave ou o modelo estão errados e nada foi gravado. Se salvar sem reclamar, está funcionando.

Essa configuração vale para a organização inteira — não há modelo por agente. Veja Provedor de IA.

3. Ensinar o agente

Um agente sem base de conhecimento responde de forma genérica, e genérico não resolve atendimento.

  1. No menu lateral, clique em Knowledge (“Conhecimento”).
  2. Clique em Add source (“Adicionar fonte”).
  3. Escolha Website, informe o endereço do seu site e selecione o alcance em CRAWL SCOPE — comece por This site (“Este site”).
  4. Confirme.

O rastreamento roda no plano de fundo e traz até 25 páginas por fonte, descendo até 5 níveis. Acompanhe pelo estado na lista: Pending, Crawling, Synced.

Enquanto isso roda, acrescente o que não está escrito no site. Clique em Add source de novo, escolha Text e cole ali a regra de troca, a política de frete, a resposta que seu time repete dez vezes por dia. Esse costuma ser o conteúdo mais útil da base toda.

Se você tiver manual ou catálogo em PDF, use Document — até 25 MB por arquivo e 20 arquivos por envio.

Quando terminar, vale gastar meia hora apagando as páginas de menu, rodapé e política de cookies que o rastreamento trouxe junto. Como fazer isso está em Base de conhecimento.

4. Escrever as instruções

  1. No menu lateral, clique em AI Agents (“Agentes de IA”).
  2. Clique em Configure (“Configurar”) no cartão do agente.
  3. Na aba Agent (“Agente”), vá até Instructions (“Instruções”).

Escreva uma orientação por linha. Não existe seletor de tom — o jeito de falar se escreve aqui. Um ponto de partida:

Você atende os clientes da {seu negócio}, {o que vocês fazem}.
Trate o cliente por você. Frases curtas.
Responda sobre {os assuntos que vocês atendem}.
Quando não souber, diga que vai confirmar e chame um atendente.
Nunca prometa desconto, prazo ou exceção que não esteja na base de conhecimento.

Clique em Save Changes (“Salvar alterações”). Mais em Personalidade e instruções.

5. Configurar a transferência para humano

  1. Ainda na aba Agent, encontre Transfer to Human (“Transferir para humano”) e ligue a chave.
  2. Ligue também Ask for email at handoff (“Pedir e-mail na passagem”).
  3. Em Transfer Groups (“Grupos de transferência”), marque um grupo. Se não houver nenhum, use o atalho Create Group para criar um time em Human Agents e volte.
  4. Salve.

Sem grupo, o agente não transfere nunca. E a transferência só acontece quando duas coisas valem ao mesmo tempo: estar dentro do horário comercial e existir alguém com status Online. Veja Transferir para um atendente.

6. Testar antes de publicar

Abra a aba Test & Preview (“Testar e visualizar”). Ela mostra o chat exatamente como o visitante vai ver.

Faça três testes, nesta ordem:

  1. Uma pergunta que a base responde. Confirme que a resposta está certa e no tom que você pediu.
  2. Uma pergunta que a base não responde. O agente deve admitir que não sabe, não inventar.
  3. “Quero falar com uma pessoa.” Estando no horário e com alguém online, ele deve transferir.

Se a resposta vier errada, o problema quase sempre está na base de conhecimento, não nas instruções. Volte em Knowledge, ache a página que está errada e corrija.

Vale ligar também Show citations (“Mostrar citações”), na aba Chat Customization (“Personalização do chat”). Ela vem desligada; ligada, cada resposta mostra de qual página saiu — o que torna esse teste muito mais rápido.

7. Colocar no site

  1. Abra a aba Widget.
  2. Na seção Embed Code (“Código de incorporação”), clique no botão de copiar.
  3. Cole o trecho no HTML do seu site, logo antes da tag </body>, em todas as páginas.
  4. Publique o site.

O trecho tem duas partes e as duas precisam ir juntas:

<script>
  window.chattermateId = 'SEU-ID-DE-WIDGET';
  window.chattermateBaseUrl = 'https://SEU-SERVIDOR/api/v1';
</script>
<script src="https://app.chatmade.com.br/webclient/chattermate.min.js"></script>

Copie do painel, não daqui — lá os valores já vêm preenchidos com os seus.

Abra o site numa aba anônima e recarregue. O botão do chat aparece no canto inferior direito. Confira também que a chave no topo da tela do agente está em Online — em Offline, ele não atende.

Se não aparecer, a lista de causas prováveis está em Instalar o widget.

E depois

Com o chat no ar, três coisas costumam vir em seguida:

  • Ajustar o visual para combinar com o site — 8 estilos, cores, textos e posicionamento em Aparência do widget.
  • Dar acesso ao time para que atendam as conversas transferidas, em Usuários e acesso. Lembre que você define a senha de cada pessoa e entrega a ela.
  • Publicar uma central de ajuda com o mesmo conteúdo, em Central de ajuda.

Próximo passo

Comece por Sua organização, para conferir se o horário comercial está certo.