Quando o volume de chamados de suporte aumenta vertiginosamente devido a lançamentos de produtos, campanhas de vendas ou expansão da base de clientes, as equipes de atendimento enfrentam um gargalo operacional crítico. Atendentes de linha de frente passam horas respondendo a dúvidas repetitivas — como redefinição de senhas, rastreamento de entregas, políticas de reembolso e alterações de cadastro —, enquanto problemas técnicos complexos e contas de alto valor se acumulam na fila de espera. O HubSpot Breeze Customer Agent (anteriormente conhecido como Service Agent no Service Hub) foi projetado exatamente para eliminar essa sobrecarga operacional.
Diferente dos chatbots tradicionais baseados em árvores rígidas de decisão que falham assim que o cliente sai do roteiro pré-programado, o Breeze Customer Agent atua integrado nativamente ao HubSpot CRM e ao Help Desk. Utilizando geração aumentada por recuperação (RAG), o agente analisa documentações verificadas, páginas públicas e o histórico de tickets fechados para fornecer respostas autônomas, contextuais e embasadas em fontes reais, 24 horas por dia, 7 dias por semana. Este guia orienta gerentes de suporte, líderes de RevOps e administradores do Service Hub na configuração completa do agente, na integração das fontes de conhecimento, na mineração de tickets anteriores e no desenho de regras seguras de escalonamento e transbordo para atendentes humanos (Ticket Escalation & Handoff).
1. Pré-requisitos, permissões e modelo de cobrança
Antes de iniciar a configuração no painel do HubSpot, certifique-se de atender aos requisitos administrativos e operacionais:
- Assentos e permissões de usuário: Criar, treinar e publicar o Customer Agent requer um assento pago atribuído (Sales Seat ou Service Seat) e a permissão de usuário Customer agent editor (Editor de agente de clientes). Para editar regras de roteamento de tickets e fluxos de trabalho durante o transbordo, são necessárias permissões de Account Access (Acesso à conta) ou Super Admin (Superadministrador).
- Canais de suporte conectados: O portal precisa ter pelo menos um canal ativo conectado ao Help Desk ou à Caixa de Entrada de Conversas (como Live Chat, e-mail de suporte, WhatsApp, Facebook Messenger, formulários ou canal de chamadas em versão beta). Caso utilize o chat em sites externos não hospedados no HubSpot, verifique se o código de rastreamento do HubSpot está instalado nas páginas.
- Ajustes de IA e acesso a dados: Em Settings > AI Settings, confirme se o acesso a ferramentas de IA generativa está ativado e se as permissões para dados de CRM, dados de conversão de clientes e dados de arquivos estão habilitadas.
- Modelo de créditos do HubSpot (HubSpot Credits):
- Cobrança somente por resolução confirmada: Ao ser publicado em canais em tempo real, o Customer Agent consome créditos do HubSpot. Os créditos não são descontados por mensagem enviada, mas apenas quando o agente conclui uma resolução bem-sucedida: ele apresenta uma fonte de conteúdo verificada ou executa uma ação cadastrada, e nenhuma solicitação de transferência feita pelo cliente ocorre dentro de uma janela de avaliação de 72 horas.
- Modo assistido sem consumo de créditos: No Help Desk, sua equipe pode ativar as recomendações de resposta (Reply Recommendations). Nesse formato, o agente apenas gera rascunhos de resposta para os analistas humanos revisarem e enviarem, consumindo zero créditos.
- Período de teste de 14 dias: Novas contas podem ativar um período gratuito de 14 dias, durante o qual as resoluções autônomas não deduzem créditos.
2. Configuração inicial: Identidade do agente e persona de marca
O tom de voz do agente define as expectativas do cliente desde a saudação inicial:
- Na sua conta HubSpot, acesse Service > Customer Agent (ou localize a opção no menu More).
- Clique em Continue to agent setup.
- Nomeie o agente: Escolha um nome claro e reconhecível (por exemplo, "Assistente Virtual Acme"). Na janela de conversa com o cliente, o nome será acompanhado pela etiqueta Powered by AI.
- Selecione a personalidade (Personality):
- Friendly (Amigável): Tom acolhedor, caloroso e encorajador.
- Professional (Profissional): Linguagem direta, estruturada e formal (ideal para B2B e suporte técnico especializado).
- Casual (Casual): Comunicação leve, ágil e moderna.
- Empathetic (Empático): Calmo, acolhedor e compreensivo, indicado para tratativas de cancelamento, disputas e reclamações.
- Witty (Espirituoso): Espontâneo e bem-humorado, voltado para marcas de consumo e estilo de vida.
- Use my brand voice (Usar voz da marca): Caso sua empresa já tenha configurado um perfil de Brand Voice com IA no HubSpot, selecione esta opção para espelhar as diretrizes corporativas globais.
- Suporte multimarca: Organizações que gerenciam marcas distintas no mesmo portal do HubSpot podem criar agentes dedicados para cada unidade, com bases de conhecimento e filas de atendimento completamente separadas.
3. Conectando fontes de conhecimento: Artigos, URLs públicas e arquivos
A exatidão do Breeze Customer Agent depende diretamente das fontes vinculadas. O agente segue diretrizes estritas de fundamentação e só gera respostas a partir de dados verificados.
Acesse Train > Knowledge no menu lateral esquerdo e clique em Add content:
A. Base de conhecimento nativa e páginas do HubSpot
- Clique em From HubSpot para selecionar conteúdos já cadastrados no portal.
- Marque as caixas de seleção correspondentes a Knowledge Base articles (artigos da base de conhecimento), Website pages (páginas do site), Landing pages (páginas de destino) e Blog posts (artigos do blog).
- Sincronização automática em tempo real: Sempre que um autor editar e publicar uma atualização em um artigo da base de conhecimento do Service Hub, o Customer Agent sincronizará a versão mais recente imediatamente de forma automática.
B. URLs públicas externas e subdomínios
Se suas documentações técnicas estiverem hospedadas no Notion, GitBook, Zendesk ou em portais proprietários:
- Clique em Import from public URLs, insira o endereço público e clique em Add.
- Ative o botão Import related URLs para rastrear e sincronizar até 5.000 páginas secundárias sob o mesmo domínio.
- Defina o escopo do rastreamento em Which pages to import:
- All pages on this domain: Rastreia o domínio principal e todos os subdomínios.
- Pages matching this path: Limita o rastreamento a uma pasta ou caminho específico (ex.:
docs.empresa.com.br/suporte/). - This subdomain only: Restringe a leitura estritamente àquele subdomínio (ex.:
ajuda.empresa.com.br).
- Utilize o filtro de caminhos (Path filtering) para incluir diretórios essenciais (como
/artigos/) e excluir áreas irrelevantes (como/blog/ou/vagas/). As páginas externas são sincronizadas semanalmente de forma automática. É possível forçar a atualização imediata clicando em Refresh ou bloquear páginas antigas com Exclude from refresh.
C. Upload de arquivos e manuais internos
- Clique em Upload a file para anexar manuais técnicos em PDF, planilhas CSV, tabelas de preços ou Procedimentos Operacionais Padrão (SOPs) em formatos como
.pdf,.docx,.csv,.txt,.json,.md,.pptx,.htmle.xml. - Privacidade de citações (Citations Toggle): Ao carregar documentações internas confidenciais que não devem ser expostas diretamente aos clientes, desative o interruptor Citations. O agente utilizará as informações técnicas para solucionar a dúvida, mas não exibirá links para o arquivo nem revelará o nome do documento na resposta.
D. Respostas curtas exatas (Short Answers)
Para respostas críticas que exigem precisão absoluta e conformidade regulatória (como prazos legais de devolução ou horários de atendimento em feriados), clique em Create a short answer. O editor suporta formatação de texto, hiperlinks e diagramas explicativos.
4. Minerando o histórico de tickets para gerar conhecimento com IA
Se a sua empresa ainda não possui uma base de artigos extensa, mas conta com milhares de atendimentos já resolvidos, a ferramenta Generate knowledge permite transformar esse histórico em material de consulta.
- Em Train > Knowledge, clique em Add content > Generate knowledge.
- Defina a fonte de análise:
- Tickets: Escolha All tickets (avalia todos os tickets encerrados nos últimos 90 dias) ou selecione A specific ticket segment (segmento específico, como "Tickets resolvidos de Nível 1").
- Inbox: Analise as conversas dos últimos 90 dias de todas as caixas ou de uma caixa de entrada específica.
- File upload: Envie arquivos de histórico de conversas em lote.
- Configuração de limites de tópicos (Guardrails):
- No campo Include topics, insira assuntos prioritários (ex.: "Desbloqueio de acesso", "Emissão de nota fiscal", "Integração via API").
- No campo Exclude topics, exclua temas sensíveis ou não padronizáveis (ex.: "Contratos customizados", "Acordos jurídicos", "Reclamações da diretoria").
- Clique em Generate knowledge.
- Revisão e homologação de rascunhos:
- O processamento leva alguns minutos. Ao concluir, uma barra no topo indicará Review drafts.
- A IA agrupa os achados em cartões de tópicos, exibindo sugestões estruturadas de Perguntas e Respostas (Q&A).
- Abra cada cartão para ajustar o texto, refinar a resposta ou inserir links.
- Clique em Accept para transformar o par em fonte ativa de conhecimento imediata, Skip para adiar ou Decline para descartar.
5. Estabelecendo diretrizes de diálogo e barreiras de segurança (Guidelines & Guardrails)
Diretrizes bem estruturadas evitam alucinações de modelo e mantêm o atendimento dentro dos parâmetros definidos:
- Acesse Train > Guidelines no menu lateral.
- Estilo de comunicação (Communication style): Clique em + Add Communication style. Nomeie a regra e aplique-a globalmente ou a segmentos específicos de clientes (por exemplo, adotando abordagens diferentes para clientes Corporativos e contas gratuitas). Insira instruções diretas: "Apresente passos de solução técnica sempre em listas numeradas; mantenha respostas objetivas com menos de 150 palavras; nunca especule sobre funcionalidades que ainda não foram lançadas oficialmente".
- Barreiras de segurança (Guardrails): Indique os tópicos expressamente proibidos. Caso o usuário mencione disputas judiciais, comparações agressivas com concorrentes ou solicitação de descontos especiais, instrua o agente: "Explique educadamente que esse assunto demanda atendimento especializado e transfira o chamado imediatamente para um atendente humano."
- Teste o comportamento clicando em Test no canto superior direito e clique em Publish para salvar.
6. Escalonamento de tickets e regras de transferência para atendimento humano (Handoff)
A eficiência de um agente de IA depende de sua capacidade de passar o bastão para um profissional humano no momento certo.
Gatilhos de transferência (Handoff Triggers)
Em Train > Human handoff, o Customer Agent transfere o atendimento automaticamente sob três condições padrão:
- Baixa confiança / Pergunta sem resposta: A documentação não contém a resposta para a dúvida do usuário.
- Solicitação explícita: O cliente digita termos como "humano", "atendente", "falar com suporte" ou "pessoa".
- Agente pausado: O agente foi desativado temporariamente ou os créditos da conta terminaram.
No campo Handoff guidelines, configure termos e regras personalizadas de escalonamento:
"Se o cliente manifestar insatisfação grave ou utilizar qualquer uma das seguintes expressões, inicie o transbordo para um atendente humano imediatamente: 'Cancelar assinatura', 'Solicitar reembolso', 'Sistema fora do ar', 'Falha de segurança', 'Falar com financeiro'."
Selecionando a modalidade de transbordo (Edit handoff process)
- Live handoff to a human agent (Transferência em tempo real): Repassa a conversa diretamente para o próximo atendente humano conectado e disponível no momento.
- Async handoff to a human agent (Transferência assíncrona): Registra o chamado e informa ao cliente que a equipe retornará por e-mail ou notificação assim que possível.
- Don't handoff to anyone (Não transferir): Mantém o agente tentando resolver; adequado apenas para canais de autoatendimento secundários e desassistidos.
Roteamento de destino: Direto vs. Fluxos automatizados
- Distribuição unificada: Selecione I want to hand off all issues to the same users or teams, escolha o Help Desk ou caixa de entrada de destino e defina os usuários ou equipes em rodízio (necessitam de assento de Sales ou Service).
- Roteamento condicional por fluxos de trabalho (Workflows): Selecione I want to hand off issues to different users or teams based on a set of conditions.
- Para canais do Help Desk, vincule um Ticket-based workflow (fluxo baseado em tickets).
- Para canais de Inbox, vincule um Conversation-based workflow (fluxo baseado em conversas).
- Utilize o modelo oficial do HubSpot: Reassign Tickets for Customer Agent Handoff, que lê a origem do ticket, a prioridade e o perfil da empresa para atribuir o chamado ao time técnico adequado, atualizar o SLA e ajustar a severidade.
Ciclo de vida do status do ticket (Customer Agent ticket status)
Durante a interação e a transferência, o HubSpot atualiza automaticamente a propriedade de CRM Customer Agent ticket status:
| Valor do status | Estado do sistema | Ação operacional necessária |
|---|---|---|
| Pending | O agente está interagindo ativamente com o cliente; nenhum transbordo foi solicitado. | Nenhuma ação necessária da equipe humana. |
| Awaiting Human Assignment | O transbordo foi acionado e o ticket foi criado no Help Desk, mas ainda aguarda atribuição a um analista. | Monitorar a fila; analistas podem assumir o chamado manualmente. |
| Handed off | O ticket foi transferido e atribuído com sucesso a um atendente humano em expediente. | O analista assume a conversa e revisa o histórico do chat. |
Reconhecimento de jornada de trabalho e mensagens de espera
- Disponibilidade individual dos analistas: O Customer Agent verifica a escala de trabalho e o status real de atendimento dos agentes no Help Desk (User Availability), e não apenas o horário global do widget do site.
- Mensagens traduzidas automaticamente: Defina mensagens para momentos de atendimento ativo e fora do horário de expediente (ex.: "Estamos conectando você a um de nossos especialistas..."). O HubSpot traduz o texto automaticamente conforme o idioma do navegador do cliente.
7. Homologação prévia e publicação gradual
Antes de liberar o agente de IA para a totalidade das interações, realize testes estruturados e limite o tráfego inicial:
1. Testes interativos e painel de análise (Testing Insights)
- Clique em Test [Nome do agente] no canto superior direito.
- Alterne a pré-visualização entre os modos Live Chat e Email.
- Abra o menu Unknown e selecione Test as CRM contact ou Test as a segment para verificar como o agente responde de forma personalizada utilizando campos reais do contato e da empresa.
- Abra o painel Testing Insights para verificar a cadeia de raciocínio do modelo: quais artigos da base de conhecimento foram citados, quais diretrizes foram ativadas e os motivos de eventuais transferências. Ajuste rapidamente usando o botão Coach your agent.
2. Testes em lote (Batch Testing)
Submeta uma lista de perguntas reais de atendimentos anteriores para avaliar a taxa de resolução, precisão de respostas e segurança de transbordo antes de ir para produção.
3. Publicação em canais e controle de tráfego
- Acesse Deploy > Channels e clique em Deploy agent.
- Selecione o canal desejado (ex.: Chat do site ou E-mail de suporte).
- Configure o Working Hours: Atendimento 24 horas, durante horários pré-determinados ou somente "fora do horário comercial" (excelente estratégia para cobrir noites e fins de semana).
- Porcentagem de cobertura de conversas (Conversation coverage): Configure uma porcentagem inicial moderada (entre 10% e 20%). O HubSpot distribuirá aleatoriamente essa fatia das conversas para o Customer Agent, enviando o restante para os operadores humanos. Conforme os indicadores se provarem estáveis, aumente gradualmente para 80% ou 100%.
- Em canais de e-mail, utilize Contact lists to include / exclude para filtrar grupos de teste e excluir contas estratégicas nos primeiros dias de operação.
- Clique em Deploy.
8. Monitoramento contínuo e evolução da base de conhecimento
Após a publicação, acompanhe os relatórios em Service > Customer Agent > Analyze:
- Taxa de resolução e desvio (Resolution Rate & Deflection): Acompanhe a proporção de chamados solucionados de ponta a ponta sem transbordo dentro do período de 72 horas.
- Lacunas de conhecimento (Knowledge Gaps): O relatório identifica automaticamente os tópicos onde o agente não encontrou respostas na documentação. Essa lista funciona como um roteiro prático para a equipe redigir novos artigos no Help Desk.
- Artigos mais referenciados: Audite periodicamente os artigos mais citados para garantir que continuem alinhados com as versões atuais do produto.
- Acompanhamento de créditos: Verifique o consumo em Account & Billing > Usage & Limits. Em momentos de grande reformulação de produtos, é possível pausar o agente temporariamente com um clique.
Ao integrar conteúdos estruturados, minerar tickets anteriores, blindar o sistema com regras firmes e orquestrar o transbordo pelo Help Desk do Service Hub, sua operação de atendimento converte picos de chamados em uma experiência de suporte ágil, econômica e altamente satisfatória.