Principal Primeiros passos do administrador
🌱

Primeiros passos do administrador

Ian Kraskoff
Alexandre Machado
Por Ian Kraskoff and 11 outros
32 artigos

Como criar um novo usuário no Cloud Chat

Quando usar - Você precisa adicionar um novo agente, supervisor ou administrador ao Cloud Chat - Você está onboardando o time e precisa cadastrar várias pessoas - Você quer entender qual perfil escolher e o limite de atribuição automática Pré-requisitos - Estar logado como administrador no Cloud Chat - Ter o e-mail do agente em mãos Sobre este tutorial Neste artigo você aprende a criar um novo usuário no Cloud Chat e definir seu papel e credenciais. Passo a passo Etapa 1 — Acessar Configurações de agentes 1. Clique em Configurações 2. Clique em Agentes Etapa 2 — Adicionar o agente 1. Clique em Adicionar agente 2. Preencha: - Nome do agente - Papel — Administrador, Supervisor, Agente, Assistente ou CX Engineer - E-mail - Limite de atribuição automática — número máximo de tickets que pode ser atribuído 3. Se for um agente de IA, marque Marcar como Agente de IA 4. Clique em Adicionar agente :::info Para entender as diferenças entre cada papel: Tipos de permissões / perfis de usuários no Cloud Chat. ::: O que acontece após a criação - Sem acesso ao Cloud Hub — o agente recebe um e-mail solicitando que redefina a senha para fazer login - Já tem acesso ao Cloud Hub — o agente faz login no Cloud Chat com as mesmas credenciais que usa no hub Observações - Para definir uma senha temporária ao agente em vez do fluxo automático: Como definir uma senha temporária para um agente no Cloud Chat - Para entender o limite de atribuição automática e round robin: Como configurar limite de tickets por agente e atribuição via Round Robin - Para detalhes dos perfis de permissão: Tipos de permissões / perfis de usuários no Cloud Chat

Última atualização em May 21, 2026

Como criar campos customizados de contatos e conversas

Quando usar - Você precisa registrar dados específicos por conversa (ex: motivo do contato, categoria, prazo de resolução) - Você precisa registrar dados específicos por contato (ex: aniversário, plano, tier) - Você quer usar esses campos depois em automações, macros ou variáveis dinâmicas Pré-requisitos - Estar logado como administrador no Cloud Chat Sobre este tutorial Neste artigo você aprende a criar campos personalizados (atributos customizados) para contatos e conversas no Cloud Chat. Passo a passo Etapa 1 — Acessar Atributos Personalizados 1. Acesse Configurações 2. Selecione Atributos personalizados Você verá os campos personalizados de Conversas e Contatos: Etapa 2 — Criar o atributo personalizado 1. Clique em Criar o atributo personalizado 2. Escolha o escopo: Contato ou Conversa 3. Defina um nome (ex: "aniversário") e uma chave :::info A chave é gerada automaticamente a partir do nome, mas você pode alterá-la. Funciona como identificador único — recomendamos manter o gerado a menos que precise de algo específico. ::: :::info Se quiser criar campos em conversas que apareçam apenas em condições específicas (por exemplo, conforme o valor de outro campo), veja Atributos customizados condicionais de conversa. ::: Etapa 3 — Configurar tipo e descrição 1. Adicione uma descrição (ex: "essa é a data de aniversário do cliente") 2. Escolha o tipo do campo: - Texto - Número - Link - Data - Lista - Lista múltipla - Checkbox (sim ou não) 3. Clique em Criar :::success Seu campo personalizado está criado e disponível para uso em conversas/contatos, automações e macros. ::: Observações - Para validar o conteúdo do campo com expressão regular: Validação com expressões regulares (REGEX) em campos customizados - Para criar campos condicionais que aparecem só sob certas regras: Atributos customizados condicionais de conversa - Para usar esses campos em automações: Como gerenciar automações no Cloud Chat - Para usar em macros: Como usar macros com atributos customizados no Cloud Chat - Para atualizar valores de atributos via API: Como atualizar atributos customizados em conversas via API

Última atualização em May 21, 2026

Como validar campos customizados com expressões regulares (REGEX)

Quando usar - Você quer garantir o formato de um campo customizado (e-mail, telefone, CPF, data, senha) - Você quer evitar entradas inválidas que polurirão sua base - Você precisa de regras flexíveis que cubram múltiplos formatos com uma expressão única Sobre este artigo REGEX (expressões regulares) é uma ferramenta para procurar padrões em textos. Bastante usada para validar entradas de dados, garantindo o formato correto. No Cloud Chat, você pode aplicar REGEX em campos customizados para reforçar a qualidade dos dados. Como funciona a validação REGEX A validação REGEX usa padrões específicos para verificar se o texto inserido corresponde ao esperado. Se o texto não corresponde, é considerado inválido. É uma forma eficaz de evitar erros e entradas maliciosas. Exemplos práticos Validar e-mails ^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$ O e-mail deve começar com caracteres alfanuméricos (incluindo ._%+-), seguido de @, mais caracteres alfanuméricos, um ponto e 2 ou mais letras. Validar telefones ^\(\d{2}\)\s\d{4,5}-\d{4}$ O telefone deve estar entre parênteses com 2 dígitos, espaço, 4 ou 5 dígitos, traço e mais 4 dígitos. Exemplos: (11) 9999-9999 ou (11) 99999-9999. Validar CPF ^\d{3}\.\d{3}\.\d{3}-\d{2}$|^(\d{11})$ O CPF deve ter 11 dígitos, formatado com pontos e traço ou apenas dígitos. Validar datas (DD/MM/AAAA) ^(0[1-9]|[12][0-9]|3[01])/(0[1-9]|1[0-2])/\d{4}$ Aceita o formato DD/MM/AAAA com dia entre 01–31, mês entre 01–12 e ano de 4 dígitos. Validar senhas (forte) ^(?=.*[a-z])(?=.*[A-Z])(?=.*\d)[a-zA-Z\d]{8,}$ A senha deve ter no mínimo 8 caracteres, com pelo menos uma letra maiúscula, uma minúscula e um número. Como inserir um padrão REGEX Na maioria dos sistemas que suportam REGEX, você encontra um campo onde insere o padrão desejado. Sempre teste o padrão antes de aplicá-lo em produção. :::info Dica: o ChatGPT (ou qualquer LLM) é ótimo para gerar REGEX. Descreva o formato desejado e peça um validador. Cole o resultado em Regex101 para validar. ::: Como aprender mais sobre REGEX - Regex101 — testar e debugar expressões com explicação detalhada de cada parte do padrão - Cursos e tutoriais online (cobrem do básico ao avançado) Observações - Para criar campos customizados antes de aplicar REGEX: Como criar campos customizados de contatos e conversas - Para criar campos customizados que aparecem só sob certas condições: Atributos customizados condicionais de conversa

Última atualização em May 21, 2026

Como enviar mensagens via campanha no Cloud Chat

Quando usar - Você precisa disparar mensagens proativas para uma lista de contatos via WhatsApp ou e-mail - Você quer agendar uma campanha para horário específico - Você quer selecionar o público por tag, por filtro de atributos ou por upload de CSV - Você quer aplicar tag ou time específico aos tickets criados pela campanha Pré-requisitos - Ser administrador ou supervisor no Cloud Chat - Para supervisor: estar alocado na caixa de entrada vinculada ao número que será usado como origem - Ter um template aprovado pela Meta cadastrado — ver Como criar, editar e excluir templates de WhatsApp no Cloud Chat :::warning Se o supervisor não estiver alocado na caixa, ele não conseguirá visualizar o número nem criar campanhas com ele. ::: Canais compatíveis O canal usado na campanha depende da caixa de entrada selecionada. Hoje o disparo por campanha está disponível para: - WhatsApp (via Meta ou via Twilio) - E-mail :::info Para campanhas de e-mail, o fluxo tem passos próprios (domínio, remetente e endereço postal). Veja o guia dedicado: Como configurar e enviar campanhas de e-mail no Cloud Chat. ::: Comportamento de criação do ticket Se não existir ticket aberto para o contato - Um novo ticket é criado automaticamente - O ticket não entra em estado "aberto" imediatamente - Só é considerado aberto quando o cliente responde - Nesse momento é atribuído a um agente ou à ClaudIA Se já existir ticket aberto para o contato - A nova mensagem é enviada dentro da conversa existente - Aparece em verde (mensagem automática do sistema) Passo a passo Etapa 1 — Acessar a seção de campanhas 1. No menu, vá em Campanhas 2. Acesse Campanhas únicas 3. Clique em Criar uma campanha única Etapa 2 — Criar a campanha 1. Informe o Título da campanha :::info Dica: use um título que facilite auditoria e acompanhamento (ex: "Renovação Março/2026 — Clientes Ativos"). ::: Etapa 3 — Definir resolução automática por inatividade (opcional) No campo Duração para resolver automaticamente os tickets de campanha que não tiverem atividade: - Informe o número de dias - Se ficar vazio, o padrão é 1 dia Encerra automaticamente conversas criadas pela campanha caso não haja atividade. Etapa 4 — Selecionar canal e template Selecione a caixa de entrada (número/canal) de origem e o template que deseja usar. Ao escolher o template, o conteúdo dele é exibido para conferência. Variáveis no template - Para variável dinâmica (ex: nome do contato): digite {{ e selecione na lista. Garanta o fechamento }}. - Para valor fixo: digite o texto direto, sem {{ }}. :::error Para evitar banimento do número ao usar a API da Meta: - Evite mensagens que firam a política de conteúdo da Meta - Evite envios em massa fora do horário comercial - Ofereça uma opção de cancelamento nos templates - Monitore a qualidade do número via WhatsApp Manager Detalhes em: Como evitar bloqueios e banimentos no WhatsApp. ::: Etapa 5 — Definir o público (audiência) Na seção Audiência você tem três formas de escolher quem vai receber a campanha, organizadas em abas: Tag, Filtro e CSV. Use a que melhor representa o público desejado — escolha uma aba por campanha. À medida que você seleciona, o Cloud Chat mostra quantos contatos foram alcançados (ex.: ✓ 320 contatos selecionados). Se a base não tiver contatos que atendam ao critério, aparece "Nenhum contato corresponde a esses critérios". :::warning Templates de autenticação exigem o número de telefone do destinatário. Contatos sem telefone (alcançáveis apenas pelo nome de usuário do WhatsApp) não receberão a campanha. ::: Opção A — Tag Selecione um ou mais marcadores / tags dos clientes. A campanha alcança todos os contatos que possuem aquela(s) tag(s). É o caminho mais rápido quando seu público já está organizado por tags. Opção B — Filtro Monte o público por critérios de atributos do contato (ex.: nome, e-mail, cidade, país, identificador ou atributos como criado em / última atividade). Clique em Adicionar primeiro filtro e defina cada condição com campo + operador + valor. Você pode Adicionar filtro para combinar mais de uma condição. - Use ver contatos para conferir a lista que será atingida antes de disparar. - Se o resultado ultrapassar o limite da plataforma, aparece o aviso X contatos correspondem, mas o limite é Y. Reduza os critérios. — refine os filtros para caber no limite. Opção C — CSV Suba uma lista pronta arrastando um arquivo ou clicando em Arraste um arquivo CSV ou clique para selecionar. - Formato: .csv — tamanho máximo de 5 MB. - O arquivo precisa ter a coluna phone_number ou email (pelo menos uma é obrigatória). - Após o upload, o Cloud Chat mostra quantos contatos foram encontrados e quantos não encontrados. - Em Baixar CSV dos não encontrados você obtém as linhas que não casaram com nenhum contato — corrija os dados e suba o arquivo novamente. :::info Erros comuns no CSV: arquivo acima de 5 MB (Arquivo excede o limite de 5 MB) ou formato diferente de .csv (Formato não reconhecido. Envie um arquivo .csv). ::: Etapa 6 — Selecionar time responsável (opcional) No campo Time ao qual a conversa criada será atribuída: - Selecione o time que ficará responsável pelas conversas geradas - Se não selecionar, segue as regras padrão de atribuição do sistema Etapa 7 — Selecionar tag para a conversa criada (opcional) No campo Tag para conversa que será criada: - Se a campanha criar um novo ticket, a tag será aplicada - Se a campanha reutilizar uma conversa já aberta, a tag não será adicionada :::info Esse comportamento é intencional para evitar alterações indesejadas em conversas em andamento. ::: Etapa 8 — Definir o envio: agora ou agendado Em Horário agendado, escolha entre Enviar agora ou Agendar para depois: - Enviar agora → a campanha é disparada imediatamente (pode haver atraso operacional de alguns minutos). - Agendar para depois → informe data e hora para o disparo. :::info O horário usa, por padrão, o fuso horário do seu sistema. Para alterar o fuso da conta: Como configurar o fuso horário no Cloud Chat. ::: Etapa 9 — Criar Após revisar as configurações, clique em Criar para disparar (ou agendar) a campanha. Para abandonar, clique em Cancelar. Observações - Você pode escolher o público por Tag, Filtro (atributos do contato) ou CSV (lista pronta) — use a aba correspondente na seção Audiência. - Para campanhas de e-mail: Como configurar e enviar campanhas de e-mail no Cloud Chat. - Para impedir que a ClaudIA responda automaticamente às respostas da campanha: Campanhas e disparos proativos com a ClaudIA: comportamento, bloqueio e boas práticas - Para envios proativos unitários (1 contato por vez): Como fazer envio de mensagens proativas unitárias no Cloud Chat - Para envio via API direto: Como enviar mensagem proativa pelo WhatsApp via API - Para entender tiers e limites de envio: Tiers de envio do WhatsApp: o que são e como evoluir

Última atualização em Jun 08, 2026

Como enviar mensagens proativas unitárias no Cloud Chat

Quando usar - Você precisa disparar uma mensagem proativa para um único contato (não em massa) - Você quer abrir um chamado por iniciativa do agente, fora do canal usual - Você quer enviar template via WhatsApp ou e-mail proativo a partir do contato Pré-requisitos - Ser administrador (sem precisar estar alocado em caixa) ou supervisor / agente / assistente alocado na caixa correspondente - Para WhatsApp: ter um template aprovado pela Meta — ver Como criar, editar e excluir templates de WhatsApp no Cloud Chat - Para e-mail: ter uma caixa de e-mail configurada Canais compatíveis Permitem disparo unitário - E-mail - WhatsApp - SMS - Twilio - API :::info Sobre API: o comportamento depende da implementação do cliente. Tecnicamente o disparo unitário deveria funcionar, mas valide diretamente no produto. ::: Não permitem disparo unitário - Web Widget (website) - Messenger / Instagram - Telegram - LINE Permissão de envio - Administrador — disparo sem precisar estar alocado em caixa - Supervisor, Agente, Assistente — precisam estar alocados na caixa para que ela apareça como opção :::warning Se o usuário não estiver alocado, a caixa não aparece como opção e o disparo não pode ser feito. ::: Comportamento de criação do ticket - A mensagem já nasce assignada a um agente, e o ticket também já nasce assignado - Sempre gera um novo ticket com status em aberto :::warning Se o cliente tiver dois tickets em aberto, novas mensagens enviadas pelo cliente serão direcionadas ao ticket mais recente. ::: Disparo proativo unitário via WhatsApp :::error Sempre siga as diretrizes da Meta / WhatsApp para evitar sanções e banimentos. Detalhes em: Como evitar bloqueios e banimentos no WhatsApp. ::: Vídeo de instrução: https://youtu.be/FiIRQxUjxgA Etapa 1 — Iniciar pela conversa ou pelo contato Pela conversa Quando estiver em uma conversa qualquer, vá no painel direito e clique em Nova mensagem. :::info O ticket aberto não precisa estar na caixa de WhatsApp — basta que seja o contato pra quem você quer enviar. ::: Pelos Contatos Acesse Contatos, selecione o contato: E clique em Nova mensagem: Etapa 2 — Selecionar caixa e template Selecione a caixa de envio e o template desejado. Você pode buscar pelo título ou rolar a tela para selecionar: Etapa 3 — Anexos no header (se aplicável) Se o template tem anexos no cabeçalho, preencha-os. :::warning Os anexos devem obedecer os formatos e tamanhos suportados pela Meta. ::: Etapa 4 — Variáveis do template Variáveis dinâmicas Para variável dinâmica, escreva {{ e escolha a variável do sistema. Garanta o fechamento }}. Variáveis com valor fixo Para usar valor fixo (sem {{ }}), digite direto. No exemplo, o botão da template foi fixado em https://cloudchat.cloudhumans.com. :::warning Elementos estáticos da template (como botões de ação rápida pré-preenchidos) não podem ser editados. ::: Etapa 5 — Enviar Quando estiver pronto, clique em Enviar mensagens. :::info Em disparos proativos, só é possível enviar templates — não envie texto livre fora da janela de 24h. ::: Disparo proativo unitário via E-mail Útil para abrir um ticket interno por iniciativa do agente ou enviar uma comunicação proativa. Vídeo de instrução: https://youtu.be/HtTgEQe0g4c :::info Recomendamos que o e-mail seja enviado a partir de uma caixa separada das que você usa em outros canais — isso facilita o controle. ::: Etapa 1 — Selecionar o contato Acesse Contatos: Image Clique no contato e em Nova Mensagem: Image Image Etapa 2 — Configurar caixa, assunto e destinatários Escolha a caixa de e-mail e defina o assunto: Image Adicione pessoas em cópia ou cópia oculta se necessário: Image Etapa 3 — Escrever a mensagem Escreva a mensagem. Use atalhos digitando / se quiser. Pode anexar arquivos. Image Clique em Enviar Mensagem. Image Etapa 4 — Visualizar o ticket aberto Vá até Conversas e clique na caixa de entrada para ver os tickets criados: Image Image :::info Cada disparo proativo gera um novo ticket com novo número. Se quiser que o ticket não seja respondido automaticamente pela ClaudIA, acione o time de suporte. ::: Observações - Para envios em massa (lista de contatos): Como enviar mensagens via campanha no Cloud Chat - Para envio via API direto (sem UI): Como enviar mensagem proativa pelo WhatsApp via API - Para regras dos templates da Meta: Regras de templates do WhatsApp (Meta) - Para criar templates dentro do Cloud Chat: Como criar, editar e excluir templates de WhatsApp no Cloud Chat

Última atualização em May 21, 2026

Como configurar idioma da conta e resolução automática de tickets

Quando usar - Você precisa alterar o nome ou idioma do espaço da conta - Você quer configurar o fechamento automático de tickets sem atividade - Você está fazendo o setup inicial da conta Pré-requisitos - Estar logado como administrador no Cloud Chat Sobre este tutorial Neste artigo você aprende a ajustar configurações básicas de nome e idioma do espaço, além de configurar o tempo para o fechamento automático de tickets. Vídeo de instrução: https://youtu.be/zSuQE8rTvE0 Passo a passo Etapa 1 — Acessar Configurações da Conta 1. Acesse as Configurações do espaço 2. Clique em Configurações da conta Etapa 2 — Alterar nome e idioma Em Configurações da conta, é possível alterar: - Nome da conta - Idioma desejado para personalizar a experiência Etapa 3 — Configurar resolução automática de tickets Defina o tempo para a resolução automática de tickets: quanto tempo passará desde a última resposta do agente até que o ticket seja resolvido automaticamente, caso o cliente não responda. :::info Para entender em detalhe como funciona a resolução automática e em quais condições os tickets são resolvidos: Resolução automática de tickets. ::: Etapa 4 — Salvar Clique em Atualizar ao final para garantir que as alterações sejam salvas. Observações - Para entender o comportamento detalhado da resolução automática (condições, exceções, status): Resolução automática de tickets - Para configurar o fuso horário dos relatórios: Como configurar o fuso horário no Cloud Chat - Para definir limite de tickets por agente e atribuição via round robin: Como configurar limite de tickets por agente e atribuição via Round Robin

Última atualização em May 21, 2026

Como criar e gerenciar times no Cloud Chat

Quando usar - Você precisa agrupar agentes por departamento ou função (suporte, vendas, financeiro, etc.) - Você quer atribuir conversas a um time específico (não a um agente individual) - Você quer configurar horários de atendimento diferentes por equipe Pré-requisitos - Estar logado como administrador no Cloud Chat - Ter os agentes que farão parte do time já cadastrados — ver Como criar um novo usuário no Cloud Chat Sobre este tutorial Neste artigo você aprende a criar, editar e gerenciar times no Cloud Chat. Vídeo de instrução: https://youtu.be/4c3uRF5LecQ Criar um novo time Etapa 1 — Acessar Times 1. Acesse Configurações 2. Selecione Times 3. Clique em Criar nova equipe Etapa 2 — Configurar nome e atribuição 1. Insira o nome e a descrição da equipe 2. Em Permitir atribuição automática, decida: - Marcado → tickets transferidos para o time seguem regra de round robin entre membros online - Desmarcado → ticket fica sem dono designado 3. Clique em Criar novo departamento Etapa 3 — Adicionar agentes 1. Selecione os agentes que vão compor o time 2. Clique em Adicionar agentes 3. Clique em Finalizar Etapa 4 — Alocar agentes nas caixas de entrada :::warning Para o agente visualizar corretamente a caixa de entrada, ele também precisa estar alocado nela — não basta estar no time. ::: 1. Vá em Configurações → Caixa de entrada, selecione a caixa desejada (ex: Chat) e clique em Editar 2. Vá até Colaboradores → Agentes e digite o nome do agente. Clique sobre o nome correspondente 3. Clique em Atualizar para salvar Editar, configurar horário diferente e excluir times Editar nome, descrição ou membros 1. Clique em Editar no time desejado 2. Edite nome e descrição Configurar horário de atendimento diferente Para uma equipe com horário diferente do padrão (ex: financeiro só seg-sex): 1. Clique em Permitir configurações de disponibilidade da equipe 2. Defina os horários 3. Clique em Atualizar o horário comercial da equipe Adicionar ou remover membros Edite a lista e clique em Atualizar departamento ao final. Excluir uma equipe 1. Clique em Excluir 2. Digite o nome exato da equipe para confirmar 3. Clique em Excluir Observações - Para criar agentes antes de adicioná-los ao time: Como criar um novo usuário no Cloud Chat - Para entender perfis de permissão: Tipos de permissões / perfis de usuários no Cloud Chat - Para configurar limite de tickets por agente e round robin: Como configurar limite de tickets por agente e atribuição via Round Robin - Para configurar SLA por time via automação: SLA: Métricas de tempo de atendimento

Última atualização em May 21, 2026

Como configurar CSAT por canal e visualizar resultados

Quando usar - Você quer ativar a pesquisa de satisfação automática nos atendimentos do Cloud Chat - Você precisa entender quando e como o CSAT é registrado em relação ao agente - Você quer visualizar e filtrar os resultados de CSAT no painel Pré-requisitos - Estar logado como administrador no Cloud Chat - Ter pelo menos uma caixa de entrada configurada Sobre este tutorial Neste artigo você entende como funciona o CSAT (Customer Satisfaction Score) do Cloud Chat, como ativá-lo e onde visualizar os resultados. Vídeo de instrução: https://youtu.be/DVyBFMw9YG8 Como funciona o CSAT do Cloud Chat O CSAT funciona de duas formas: envia automaticamente para 100% dos tickets resolvidos daquele canal onde está ativo, ou não envia para ninguém — não há frequência intermediária. A pesquisa é um link que leva a uma página com pergunta de 1 a 5, com números E emojis, e oferece a possibilidade do cliente comentar com mais detalhes (não obrigatório). :::info Atualmente, não é possível personalizar o CSAT além disso — estamos sempre revisando. ::: Como o agente é registrado nos relatórios Sempre que um CSAT é registrado, ele é vinculado ao último agente atribuído à conversa no momento em que o cliente responde a pesquisa. - Atribuir um novo agente substitui o anterior para fins de registro do CSAT - Remover o agente ainda vincula o CSAT ao último agente atribuído - Alterar/remover agente após o registro não altera o registro - Se nenhum agente foi atribuído, o CSAT não é vinculado a nenhum agente Como ativar o CSAT O CSAT precisa ser ativado por caixa de entrada. Etapa 1 — Acessar configurações da caixa 1. Acesse Configurações 2. Vá em Caixa de entrada e selecione a caixa desejada Etapa 2 — Habilitar CSAT Role até o final das configurações e ative a opção Habilitar CSAT no canal. Customização do CSAT para WhatsApp Para quem usa a API nativa do WhatsApp (não vale para Twilio), customizamos uma opção de envio de CSAT direto no app. Assim que a conversa é encerrada, o cliente recebe a pesquisa nativamente no WhatsApp — sem link externo, sem redirecionamento. Pode responder ali mesmo de forma simples e integrada. :::warning A Meta atualmente não suporta todos os tipos de mensagem no WhatsApp Web — só nos dispositivos padrão (Android e iOS). ::: O idioma em que o CSAT é enviado é o mesmo configurado na conta do Cloud Chat. Como visualizar os resultados Etapa 1 — Acessar Relatórios 1. Vá em Relatórios 2. Clique em CSAT Etapa 2 — Filtrar resultados Você pode filtrar por: - Data - Agente - Equipe - Caixa de entrada ou Nota Para abrir um ticket específico, clique no número do ticket. :::info Importante: o CSAT é registrado com base na data em que o cliente responde, não na data de criação do ticket. O CSAT mede a experiência final do cliente — após a resolução. ::: Observações - Para configurar a resolução automática (que dispara o envio do CSAT): Resolução automática de tickets e Configurações da conta: idioma e resolução automática - Para configurar conversa única no WhatsApp (impacta o envio do CSAT): Como configurar o recurso de conversa única no WhatsApp - Para extrair dados de CSAT em relatórios via API: Como extrair dados em lote via API (Data Extract API)

Última atualização em May 21, 2026

Como integrar a ClaudIA ao Cloud Chat e adicionar canais

Quando usar - Você quer entender como a ClaudIA se integra ao Cloud Chat - Você quer adicionar a ClaudIA a um novo canal que ainda não está coberto - Você quer evitar conflitos de automações que afetem o funcionamento da ClaudIA Pré-requisitos - Estar logado como administrador ou CX Engineer no Cloud Chat - Ter o canal (caixa de entrada) que você quer cobrir já configurado Sobre este tutorial Neste artigo você entende como funciona a integração da ClaudIA com o Cloud Chat, a importância de manter as configurações intactas e como adicionar a ClaudIA a um novo canal para que ela comece a atendê-lo. Vídeo de instrução: https://youtu.be/O7u9rL149ao O que é a ClaudIA no Cloud Chat A ClaudIA atua como agente dentro do Cloud Chat. Literalmente um agente. Todos os tickets recebidos são automaticamente atribuídos a ela através das automações. Ao acessar a seção de Agentes, você encontra o usuário da ClaudIA: :::error Não delete nem altere o usuário da ClaudIA. Isso pode impactar negativamente o funcionamento dela. ::: Como a ClaudIA é ativada As automações são responsáveis por atribuir os tickets à ClaudIA. Existem duas automações principais: 1. Uma para chamar a ClaudIA 2. Outra para atribuir o contato a ela :::warning Evite criar automações que entrem em conflito com essas duas. Por exemplo, ao receber um ticket, é fundamental que ele seja sempre encaminhado pra ClaudIA. Caso contrário, ela deixará de responder ou poderá responder de forma conflitante e em paralelo a um agente humano. ::: :::info Em caso de dúvida ao criar uma automação nova, acione o suporte antes de ativar para evitar quebrar o funcionamento da ClaudIA. ::: Como adicionar a ClaudIA a outro canal Etapa 1 — Garantir que a ClaudIA está na caixa de entrada nova Antes de tudo, confirme que a ClaudIA está adicionada como agente na caixa de entrada do novo canal — caso contrário, ela não pode atendê-lo. Etapa 2 — Acessar Automações 1. Vá em Configurações → Automações Etapa 3 — Editar o primeiro gatilho 1. Clique em Editar no primeiro gatilho 2. No campo Caixa de entrada (Inbox), adicione o novo canal e clique em Atualizar Etapa 4 — Repetir para o segundo gatilho Aplique o mesmo procedimento no segundo gatilho. :::success Com isso, a ClaudIA passa a responder os tickets que entrarem pelo novo canal. ::: Observações - Para detalhes de como gerenciar automações: Como gerenciar automações no Cloud Chat - Para entender os eventos que disparam automações: Como funcionam os eventos que disparam automações no Cloud Chat - Para entender quando a ClaudIA transfere para um humano (N2): Transferência de chamados para Nível 2 (N2) - Para entender perfis (CX Engineer tem acesso à plataforma da ClaudIA): Tipos de permissões / perfis de usuários no Cloud Chat

Última atualização em May 21, 2026

Tipos de permissões e perfis de usuários no Cloud Chat

Quando usar - Você precisa decidir qual perfil dar ao criar um novo usuário - Você quer entender o que cada perfil pode ou não fazer - Você está auditando permissões da conta Sobre este artigo O Cloud Chat oferece cinco perfis de acesso para usuários, cada um com permissões específicas para diferentes papéis operacionais. Resumo rápido (matriz de permissões) | Permissão | Assistente | Agente | Supervisor | CX Engineer | Administrador | | --- | --- | --- | --- | --- | --- | | Ver e responder conversas atribuídas | ✅ | ✅ | ✅ | ✅ | ✅ | | Ver conversas não atribuídas (dentro das suas caixas) | ✅ | ✅ | ✅ | ✅ | ✅ | | Ver aba "Todos" (todas as conversas da conta) | ❌ | ✅ | ✅ | ✅ | ✅ | | Atribuir conversas para outros agentes | ❌ | ✅ | ✅ | ✅ | ✅ | | Criar e editar atalhos e macros próprios | ❌ | ✅ | ✅ | ✅ | ✅ | | Criar filtros personalizados | ❌ | ✅ | ✅ | ✅ | ✅ | | Editar filtros de outros usuários | ❌ | ❌ | ✅ | ✅ | ✅ | | Acessar e baixar relatórios | ❌ | ❌ | ✅ | ✅ | ✅ | | Gerenciar campanhas (criar, editar, excluir) | ❌ | ❌ | ✅ | ✅ | ✅ | | Importar contatos | ❌ | ❌ | ✅ | ✅ | ✅ | | Acessar dados CSAT | ❌ | ❌ | ✅ | ✅ | ✅ | | Acessar configurações de tenant | ❌ | ❌ | ❌ | ✅ | ✅ | | Acessar a ClaudIA (plataforma de IA) | ❌ | ❌ | ❌ | ✅ | ✅ | | Configurar agentes de IA, ferramentas e MCP | ❌ | ❌ | ❌ | ✅ | ✅ | | Gerenciar bases de conhecimento da IA | ❌ | ❌ | ❌ | ✅ | ✅ | | Exportar/excluir contatos em massa | ❌ | ❌ | ❌ | ❌ | ✅ | | Criar e editar usuários | ❌ | ❌ | ❌ | ❌ | ✅ | | Configurar caixas de entrada (inboxes) | ❌ | ❌ | ❌ | ❌ | ✅ | | Configurar webhooks e integrações | ❌ | ❌ | ❌ | ❌ | ✅ | | Gerenciar assinatura e faturamento | ❌ | ❌ | ❌ | ❌ | ✅ | Descrição detalhada dos perfis Assistente O perfil mais limitado do sistema, muito usado em times de outsourcing/BPO. - Visualiza e responde apenas conversas atribuídas diretamente a ele ou não atribuídas dentro das suas caixas - Não acessa a aba "Todos" - Pode visualizar atalhos existentes, mas não pode criar ou editar - Não acessa relatórios nem campanhas Agente Perfil padrão para atendentes que lidam diretamente com clientes. - Visualiza e responde conversas atribuídas a ele - Acessa conversas não atribuídas e pode pegá-las - Visualiza todas as conversas da conta pela aba "Todos" - Pode atribuir conversas para outros agentes - Cria e edita seus próprios atalhos, macros e filtros - Não acessa relatórios nem gerencia campanhas Supervisor Inclui todas as permissões de Agente, acrescidas de capacidades de gestão e análise operacional. - Acessa e baixa todos os relatórios da conta - Acessa pesquisas e métricas de CSAT - Gerencia campanhas (criação, edição e exclusão) - Importa contatos - Edita e exclui filtros personalizados de qualquer usuário :::info Supervisor não acessa a ClaudIA (plataforma de IA) nem configurações de tenant — exclusivo de CX Engineer e Administrador. ::: CX Engineer Perfil técnico voltado para times que configuram e operam a plataforma de IA (ClaudIA). Acumula todas as permissões de Supervisor com acesso exclusivo à camada de IA. Tudo que o Supervisor faz, mais: - Acesso completo à ClaudIA — a plataforma de IA do Cloud Chat: - Configurar e gerenciar agentes de IA - Configurar ferramentas (tools) e conectores MCP - Gerenciar bases de conhecimento usadas pela IA - Configurações de tenant — acessa e edita parâmetros de configuração da conta indisponíveis para Supervisor :::info Na prática: o Supervisor gerencia a operação de atendimento (relatórios, campanhas, contatos). O CX Engineer faz tudo isso e ainda configura "como a IA se comporta" — fluxos controlados, ferramentas, fontes de conhecimento. ::: Administrador Acesso total a todos os recursos do sistema. - Cria, edita e remove usuários - Configura e gerencia caixas de entrada (inboxes), incluindo modelos de WhatsApp e reconexões - Configura webhooks, integrações e bots - Acessa todos os relatórios e os baixa - Gerencia campanhas e importa/exporta contatos - Gerencia assinatura e faturamento - Configura etiquetas, equipes e todos os recursos globais - Acesso total à ClaudIA e às configurações de tenant Perguntas frequentes Posso ter mais de um Administrador? Sim. Não há limite de administradores por conta. Qual a diferença entre Assistente e Agente? O Assistente só vê conversas atribuídas a ele ou sem atribuição dentro das suas caixas. O Agente vê todas as conversas da conta pela aba "Todos" e pode atribuir conversas para outros. Qual a diferença entre Supervisor e CX Engineer? O CX Engineer tem todas as permissões do Supervisor — a diferença está no acesso à ClaudIA (plataforma de IA): só CX Engineer (e Administrador) configura agentes de IA, ferramentas, MCP e bases de conhecimento. O Supervisor pode acessar a ClaudIA? Não. Acesso à ClaudIA é exclusivo de CX Engineer e Administrador. O CX Engineer pode criar usuários ou configurar inboxes? Não. Essas ações são exclusivas de Administrador. O Supervisor pode criar campanhas? Sim. Tanto Supervisor quanto CX Engineer e Administrador têm acesso completo a gerenciar campanhas. Observações - Para criar um novo usuário e atribuir um perfil: Como criar um novo usuário no Cloud Chat - Para definir uma senha temporária a um agente: Como definir uma senha temporária para um agente no Cloud Chat - Para entender como a ClaudIA opera (acessível por CX Engineer/Admin): Como integrar a ClaudIA ao Cloud Chat e adicionar canais

Última atualização em May 21, 2026

Como habilitar continuidade de conversas por e-mail

Quando usar - O cliente está interagindo via chat widget no site e perdeu a sessão (aba anônima, troca de computador, fechou o navegador) - Você precisa que uma conversa de WhatsApp continue por e-mail (anexos longos, tratativas mais elaboradas) - Você quer manter o contexto da conversa quando ela transita entre canais Pré-requisitos - Estar logado como administrador - Ter uma caixa de entrada de e-mail configurada — ver Conectando caixa de e-mail ao Cloud Chat - O agente que vai operar precisa estar alocado na caixa de e-mail Sobre este artigo A continuidade por e-mail garante que a conversa não se perca quando o cliente sai do canal original. O comportamento varia conforme o canal de origem. Para conversas via Chat Widget (site) - A continuidade ocorre automaticamente quando o cliente perde a sessão e tem um e-mail cadastrado - O histórico completo da conversa é enviado por e-mail ao cliente - Quando o cliente responde ao e-mail, o agente vê a resposta direto na conversa, com identificação que veio do e-mail - O agente também pode forçar manualmente a continuidade na aba do ticket Para conversas via WhatsApp - A continuidade só pode ser iniciada pelo agente, não pelo cliente - Útil quando a conversa precisa prosseguir fora do WhatsApp (tratativas longas, anexos) - O histórico é incluído no e-mail, mantendo o contexto - As respostas do cliente por e-mail aparecem na conversa do agente Pré-requisitos da configuração :::warning Essa configuração só está disponível se existir uma caixa de entrada de e-mail associada e o agente estiver alocado nela. A continuidade por e-mail está disponível para os tipos de inbox: - Site (chat widget) - WhatsApp (com transferência manual pelo agente) ::: Passo a passo Etapa 1 — Criar (ou ter) a caixa de e-mail Tenha ou crie uma caixa de entrada do tipo e-mail em Configurações → Caixa de entrada. Etapa 2 — Habilitar continuidade na caixa do site Na caixa do tipo Site (com widget configurado), ative a opção Habilitar continuidade das conversas por e-mail. Etapa 3 — Selecionar a caixa de e-mail Na opção Selecione a caixa de e-mail para continuar a continuidade, escolha a caixa configurada na Etapa 1. :::success Com essas configurações feitas, a continuidade por e-mail já está funcionando. ::: Exemplo de conversa 1) Cliente entra em contato pelo widget do site 2) Agente responde 3) Cliente saiu do chat — Cloud Chat continua via e-mail A conversa segue por e-mail incluindo o histórico completo: 4) Cliente responde — agente vê com identificação de e-mail Observações - Para entender envios proativos por e-mail (caso oposto — você inicia o ticket): Como enviar mensagens proativas unitárias no Cloud Chat - Para enviar a transcrição completa de uma conversa por e-mail (uma única vez): Como enviar a transcrição de uma conversa por e-mail

Última atualização em May 21, 2026

Como configurar conversa única no WhatsApp

Quando usar - Você quer que cada nova mensagem do cliente após uma conversa resolvida abra um novo ticket - Sua operação trata cada interação como evento isolado (não-recorrente) - Você prefere ter mais granularidade nos relatórios (1 ticket = 1 atendimento) Pré-requisitos - Estar logado como administrador - Ter uma caixa de entrada de WhatsApp configurada Sobre este tutorial Neste artigo você entende como configurar o recurso de conversa única na caixa de WhatsApp para que, quando uma conversa for resolvida, ela resulte em um novo ticket (em vez de continuar uma conversa existente eternamente). Vídeo de instrução: https://youtu.be/sB6baeooG28 Passo a passo Etapa 1 — Acessar Configurações da caixa de WhatsApp 1. Acesse Configurações 2. Clique em Caixas de entrada 3. Selecione a caixa do WhatsApp Etapa 2 — Ativar Conversa Única Role até o final das configurações até encontrar Bloquear para conversa única. Comportamento: - Desativada (padrão) → cada vez que uma conversa é resolvida e o cliente envia nova mensagem, um novo ticket é aberto - Ativada → a conversa continua a mesma, com o mesmo dono e a mesma pessoa respondendo :::info Recomendamos manter a configuração desativada, exceto em casos muito específicos que exigem uma conversa única. ::: Lembre de Atualizar as configurações ao final. Limitação importante :::error Quando a conversa única está ativada, o CSAT NÃO é enviado ao cliente ao final da conversa, mesmo que a configuração de envio de CSAT esteja ativa na caixa de entrada. É uma limitação atual do sistema. Mantenha a funcionalidade desativada se a coleta de CSAT for importante na sua operação. ::: Observações - Para entender o CSAT e configurá-lo: Como configurar CSAT por canal e visualizar resultados - Para entender os status de tickets (Aberto, Resolvido, etc.): Status de tickets no Cloud Chat - Para configurar o tempo de fechamento automático: Resolução automática de tickets

Última atualização em May 21, 2026

Como configurar limite de tickets por agente e atribuição via Round Robin

Quando usar - Você quer limitar o número de tickets simultâneos que cada agente pode atender - Você quer distribuir tickets automaticamente entre o time (round robin) - Você quer ajustar o limite de forma diferente por agente ou por time Pré-requisitos - Estar logado como administrador no Cloud Chat Sobre este tutorial Neste artigo você aprende a configurar o limite de chats em paralelo por agente e a ativar a atribuição automática de tickets via round robin. Vídeo de instrução: https://youtu.be/JLUTcrNXAEU Passo a passo Etapa 1 — Definir limite geral pra conta Primeiro, defina o limite global (para toda a empresa) de tickets em aberto que os agentes podem ter. 1. Acesse Configurações → Configurações da Conta Image 2. Defina o limite na seção de assinatura automática por conta :::info Exemplo: definindo limite como 50, um agente pode receber automaticamente no máximo 50 tickets em status Aberto ao mesmo tempo. Manualmente, mais tickets podem ser atribuídos além deste limite. ::: Image Image :::warning Exceção ao limite: se um agente está com 50 tickets, coloca um como pendente, recebe um novo em aberto e depois o cliente responde o pendente (que volta para Aberto), o limite será excedido. ::: Etapa 2 — Definir limite diferente para agentes específicos (opcional) Após o limite geral, você pode estabelecer um limite individual por agente. 1. Vá em Configurações → Agentes 2. Selecione um usuário 3. Defina o Limite de atribuição automática Image Etapa 3 — Ativar Round Robin na caixa de entrada Edite a caixa de entrada desejada e clique em Habilitar atribuição automática. Image Image Image :::success Com a funcionalidade ativada, os tickets são distribuídos aleatoriamente entre os agentes. - Se um agente fica offline, os tickets vão para os demais até atingirem o limite - Quando um agente atinge o limite, não recebe mais tickets até que abra espaço - Se nenhum agente está online, os tickets são distribuídos quando ficarem online ::: Etapa 4 — Ativar Round Robin por time (opcional) A configuração também pode ser feita para equipes. 1. Edite a equipe 2. Ative Atribuição automática para o departamento Image Image Image 3. Siga o processo de configuração de times até Finalizar Image Observações - Para criar agentes e atribuir limites individuais: Como criar um novo usuário no Cloud Chat - Para criar e gerenciar times: Como criar e gerenciar times no Cloud Chat - Para configurar SLA por automação após distribuir os tickets: SLA: Métricas de tempo de atendimento - Para entender o status de agente (Disponível/Ocupado/Desconectado) que afeta o round robin: Status do agente no Cloud Chat

Última atualização em May 21, 2026

Como gerenciar automações no Cloud Chat

Quando usar - Você quer padronizar e automatizar ações que se repetem no atendimento (atribuir tag, transferir time, enviar mensagem) - Você quer reagir automaticamente a eventos da conversa (criada, atualizada, mensagem nova, reaberta) - Você quer preencher atributos customizados ou disparar webhooks via regras Pré-requisitos - Estar logado como administrador ou CX Engineer - Ter os campos customizados, tags e times já criados se quiser usá-los nas ações Sobre este artigo O Cloud Chat permite criar automações para padronizar e agilizar o atendimento — reduz trabalho manual e garante consistência. Com base em eventos e condições, você configura ações automáticas como preencher campos, atribuir conversas, enviar mensagens, etc. Como acessar e gerenciar automações 1. Acesse Configurações 2. Vá até Automações 3. Nesta tela você pode: - Criar novas automações - Editar regras existentes - Clonar automações - Excluir automações - Ativar / desativar (via botão de status) Como criar uma automação Clique em Adicionar Regra de Automação e preencha: - Título — nome identificador - Descrição (opcional) — resumo do que faz - Evento — gatilho da automação: - Conversation Created - Conversation Updated - Message Created - Conversation Opened - Condições — regras que precisam ser verdadeiras (ex: agente = X, time = Y) - Ações — o que acontece quando os critérios forem atendidos (ex: adicionar tags, enviar mensagem) Finalize clicando em Criar, e mantenha o status Ativo para que ela funcione. Eventos disponíveis 1. Conversation created — sempre que um atendimento começa 2. Conversation updated — quando há atualização relevante na conversa 3. Message created — quando uma nova mensagem é criada (pelo agente, usuário ou cliente) 4. Conversation opened — quando uma conversa que estava resolvida, pendente ou em espera é retomada :::info Para entender como cada evento funciona e suas boas práticas: Como funcionam os eventos que disparam automações no Cloud Chat. ::: Condições disponíveis por evento Ao configurar, defina condições que precisam ser verdadeiras para a regra rodar. As opções variam por evento. :::warning Algumas condições como Country não estão disponíveis para todos os contatos — dependem do browser/canal passar essa informação. Muitos canais não têm esses atributos disponíveis e/ou usuários optam por bloquear. ::: :::info Atributos customizados (de conversas ou contatos) podem ser usados como condição em qualquer um dos eventos. ::: Conversation Created Disparado assim que uma nova conversa começa. - Status, Browser Language, Email Subject, Country, Phone Number, Referrer Link, Email, Inbox, Conversation Language, Priority Conversation Updated Disparado sempre que uma conversa existente é modificada. - Conversation Tag, Status, Browser Language, Email Subject, Country, Referrer Link, Phone Number, Assignee, Team, Email, Inbox, Conversation Language, Priority Message Created Ativado quando uma nova mensagem entra na conversa. - Conversation Tag, Message Type (incoming/outgoing), Message Content, Email, Inbox, Conversation Language, Phone Number Conversation Opened Quando uma conversa resolvida/pendente/adiada é reaberta. - Browser Language, Email, Email Subject, Country, Referrer Link, Assignee, Phone Number, Team, Inbox, Conversation Language, Priority Ações disponíveis - Atribuir a um agente específico - Direcionar a uma equipe - Adicionar etiquetas (tags) - Preencher campos personalizados - Enviar mensagens automáticas ou anexos - Resolver, silenciar ou adiar a conversa - Enviar notificações por e-mail - Disparar webhooks - Cancelar a execução da automação - Alterar campos customizados de conversas - Alterar campos customizados de contatos Você pode combinar várias ações em uma única regra. Usando campos customizados em automações O Cloud Chat permite criar Campos Customizados (atributos customizados) que armazenam informações específicas de uma conversa ou contato. Configurados em Configurações → Atributos Customizados. Detalhes em: Como criar campos customizados de contatos e conversas. Em uma automação, você pode preencher ou alterar esses campos com valores fixos baseados nas condições. Exemplo: Quando a conversa for marcada como resolvida e o time for "Tech", preencher o campo Motivo do Contato com Pedido de Suporte. Usando atributos dinâmicos em automações Além de valores fixos, você pode preencher campos com valores dinâmicos usando chaves duplas. Esses valores são substituídos no momento da execução com base no contexto. Exemplos: - {{conversation.display_id}} — ID público da conversa - {{inbox.name}} — nome da inbox Detalhes: Como usar campos dinâmicos no Cloud Chat. Exemplo prático Configure uma automação para preencher um campo referência_interna com o ID da conversa: Ação: Preencher referência_interna com {{conversation.display_id}}. Dicas importantes ao configurar Cuidado com "igual a FALSO" :::warning Recomenda-se evitar o operador "igual a FALSO" — pode causar comportamentos inesperados. Prefira "diferente de VERDADEIRO". ::: Evite conflitos com a ClaudIA :::error Algumas automações podem interferir nas regras da ClaudIA. Antes de ativar, verifique se ela não altera status, campos ou fluxos usados pela ClaudIA — pode interromper ou comprometer suas respostas. Detalhes em: Como integrar a ClaudIA ao Cloud Chat e adicionar canais. ::: Diferença entre "E" e "OU" nas condições - E (AND) — todas precisam ser verdadeiras simultaneamente Ex: Status = Aberto E Prioridade = Alta → só dispara se ambos forem verdadeiros - OU (OR) — basta uma ser verdadeira Ex: Status = Aberto OU Prioridade = Alta → dispara em qualquer dos dois cenários Cuidado com muitas ações em uma única automação :::warning Muitas ações em uma só automação pode gerar: - Alterações em cadeia difíceis de controlar - Risco de loops automáticos - Dificuldade de identificar o que disparou a regra Boa prática: mantenha simples e direto. Se precisar de muitas ações, divida em mais de uma automação. ::: Atenção a lógica com mais de uma automação :::warning Concorrência de automações — quando duas automações modificam os mesmos campos com: - Mesmo evento - Mesma condição - Mesma ação Pode haver sobrescrita incorreta de dados. Sempre valide condições adicionais para que apenas uma regra seja aplicada. ::: Campos vazios A automação nunca deve deixar campos vazios. Antes de atualizar/excluir um atributo importante (agente, atributo personalizado): - Se o campo não puder receber valor → automação não deve ser executada - Se já houver valor → avalie se mantém ou complementa, mas nunca sobrescreva para vazio - Antes de excluir algo → verifique se não está sendo usado em outras automações Webhooks — como identificar o status? Em uma conversa você pode acompanhar o status do envio de webhooks como auditoria. - Sucesso de envio — ícone de antena na parte inferior da mensagem - Falha no envio — triângulo com exclamação no centro - Webhook não executado — sem nenhum ícone, indica que a automação não rodou (pode estar desativada ou mal configurada) Observações - Para entender em detalhe a ordem dos eventos: Como funcionam os eventos que disparam automações no Cloud Chat - Para criar campos customizados antes de usar em condições/ações: Como criar campos customizados de contatos e conversas - Para configurar SLA via automação: SLA: Métricas de tempo de atendimento - Para configurar a ClaudIA em canais novos sem quebrar: Como integrar a ClaudIA ao Cloud Chat e adicionar canais

Última atualização em May 21, 2026

Como funciona a resolução automática de tickets

Quando usar - Você quer fechar automaticamente tickets sem atividade depois de X horas - Você precisa entender em quais condições o ticket é fechado vs. mantido aberto - Você está investigando por que um ticket não foi fechado automaticamente Pré-requisitos - Estar logado como administrador Sobre este artigo A plataforma oferece a funcionalidade de resolução automática de tickets que permite o fechamento recorrente de conversas inativas, com base em condições e períodos configuráveis. Onde configurar Etapa 1 — Acessar Configurações da conta 1. Vá em Configurações → Configurações da conta 2. Localize o campo Depois de quantas horas um ticket deve resolver a si mesmo caso não haja nenhuma atividade 3. Defina o número de horas de inatividade após as quais os tickets devem ser resolvidos A configuração passa a valer para todos os tickets que se encaixam nas condições abaixo. Condições para resolução automática :::info Um ticket só será resolvido automaticamente se todas as seguintes condições forem atendidas: - Status do ticket é Aberto - A última mensagem da conversa é de um agente (mensagens de bots de automação, internas ou privadas não contam como última atividade válida) ::: Status que NÃO permitem resolução automática :::warning Tickets nos status Pendente ou Adiado não são resolvidos automaticamente. Se esses tickets forem reabertos, o tempo configurado para auto-resolução começa a contar a partir da data da reabertura. ::: Observações - Para configurar nome/idioma e o tempo de resolução automática: Como configurar idioma da conta e resolução automática de tickets - Para entender como o CSAT é disparado quando o ticket é resolvido: Como configurar CSAT por canal e visualizar resultados - Para entender o que cada status de ticket significa: Status de tickets no Cloud Chat

Última atualização em May 21, 2026

Como importar contatos em massa via CSV

Quando usar - Você precisa carregar uma base nova de contatos no Cloud Chat - Você quer atualizar atributos personalizados de muitos contatos de uma vez - Você precisa adicionar tags ou bloquear contatos em massa Pré-requisitos - Estar logado como administrador ou supervisor - Ter o arquivo CSV no encoding UTF-8 com pelo menos um identificador (email, telefone ou identifier) por contato :::info Também é possível fazer essa importação via API. Detalhes em: Como importar contatos em massa via API. ::: Acessar o template de import Etapa 1 — Baixar o template A importação de contatos é simples. Primeiro, baixe um template do CSV. 1. Acesse a seção Contatos no menu lateral 2. Clique em Importar 1. Baixe o template do CSV (já vem com exemplos) Exemplo do CSV: Detalhes importantes sobre o CSV São colunas padrões — você pode adicionar mais colunas (tags, campos personalizados). Para criar campos personalizados antes: Como criar campos customizados de contatos e conversas. :::warning Os campos que determinam um contato único são telefone, e-mail e identificador (identifier). Pelo menos um precisa estar sempre presente. ::: :::info As colunas que não devem ser alteradas devem ser deletadas, com exceção dos campos chave (email, telefone ou identifier). ::: Comportamento de campos em branco | Campo | Comportamento se em branco | | --- | --- | | Nome e campos padrão | O valor existente é apagado | | Campos personalizados | Campos em branco são ignorados — valor existente é preservado | | Tags | Não substituem — adicionam (ver abaixo) | | Email/telefone/identifier (quando não são chave) | Valor existente é preservado | Tags — 3 formatos - tags (recomendado) — lista separada por vírgulas. Adiciona ao conjunto existente (não remove tags presentes) - tags_add — equivalente a tags. Adiciona sem remover - tags_remove — lista separada por vírgulas. Remove tags específicas :::info Se o mesmo contato aparece em tags_add e tags_remove na mesma importação, a remoção ganha (ordem: primeiro adiciona, depois remove). Para remoção em massa por outro caminho, use a API de remoção de tags. ::: Telefones brasileiros :::warning Sempre inclua o código do país (+55) e o 9 no início do celular. - Sem +55 → duplicidade - Sem o 9 → duplicidade + impacto em campanhas WhatsApp Exemplo correto: +5511960832431 (+55 é o código de país; o 9 foi adicionado pela Anatel há alguns anos). ::: Normalização automática :::info Nota técnica: o sistema possui normalização automática — se você enviar +551160832431 (sem o 9), o sistema adiciona automaticamente. Mas recomendamos fortemente incluir o 9 no CSV para evitar ambiguidade. ::: Lookup de variantes (BR mobile-9) Ao identificar contatos existentes, o sistema busca variantes do telefone enviado. Se o CSV envia +5511933334444 e o contato existe como +551133334444 (sem o 9), o match acontece e o contato é atualizado em vez de duplicado. Caracteres não-imprimíveis Caracteres null-byte (\x00) em qualquer célula são silenciosamente removidos durante a importação. Bloqueando contatos via CSV A coluna blocked é aceita e bloqueia o contato no momento da importação. | Operação | Valores aceitos (case-insensitive) | | --- | --- | | Bloquear | true, 1, yes, t, on | | Desbloquear (se já estava bloqueado) | false, 0, no, f, off | | Vazio | Contatos novos: desbloqueado por padrão. Contatos existentes: estado atual preservado | :::warning Mudança a partir de 30/04/2026: contas que enviavam CSVs com blocked antes dessa data tinham essa coluna silenciosamente ignorada. Agora o valor é respeitado. Para aplicar valores históricos retroativamente, basta re-importar o CSV. ::: Apagando dados via CSV Para apagar um campo de um contato existente, use o valor especial __DELETE__ na célula: - Em phone_number, email, identifier, name → o campo é limpo (NULL) - Em colunas de atributos personalizados → a chave é removida do JSON do contato - Não funciona em blocked — para desbloquear, use false (ou 0/no/f/off) :::warning Se você usa literalmente a string "__DELETE__" como valor legítimo em algum campo, acione o suporte antes da importação para evitar perda de dados. ::: Atenção: dual-write em company, company_name e city :::warning Valores nas colunas company, company_name e city são gravados simultaneamente em additional_attributes e em custom_attributes do contato. Isso garante que dashboards, filtros e segmentações encontrem o valor. Mudança a partir de 30/04/2026: antes apenas additional_attributes era populado, o que causava inconsistência em filtros baseados em atributos personalizados. ::: O que acontece na prática Ao importar: 1. Sistema busca se o contato já existe — pelo email, identifier e telefone, nessa ordem de prioridade 2. Se não encontrar → cria um contato novo 3. Se encontrar → atualiza informações conforme as regras de campos em branco :::error Divergência de identificadores (AMBIGUOUS_MATCH) — se o CSV contiver um contato com dois ou mais campos chave (email, telefone, identifier) que apontem para contatos diferentes já existentes, a linha é rejeitada com erro AMBIGUOUS_MATCH. Exemplo: se o email [email protected] pertence ao contato A, mas o telefone +5511960832431 pertence ao contato B, o sistema não saberá qual atualizar e rejeita a linha. Mudança a partir de 30/04/2026: antes, o sistema usava o primeiro match encontrado e silenciosamente sobrescrevia dados. Agora a linha é rejeitada explicitamente. Corrija manualmente antes de reimportar. ::: Linhas duplicadas no CSV :::warning Se o CSV tiver duas ou mais linhas com o mesmo email, telefone ou identifier, apenas a primeira é processada — as demais são rejeitadas como duplicatas. Vale mesmo se as outras informações forem diferentes. Dica: revise o CSV antes de importar. ::: Adicionar mais informações (tags e campos customizados) Você pode editar qualquer informação adicionando a chave do campo como título de uma nova coluna. Adicionar tags Crie uma coluna tags e preencha cada célula com a tag desejada. :::warning A tag precisa já existir. Se não existir, sua importação falhará. ::: Crie tags em Configurações → Tags ou diretamente na aba de contatos: Adicionar atributos personalizados Pegue a chave do atributo customizado em Configurações → Atributos Personalizados e use como nome da coluna no CSV. Subir o import no Cloud Chat Salve a planilha como CSV (UTF-8), volte à seção de importação, escolha o arquivo e clique em Importar. :::success Quando o sistema concluir (pode levar até 30 minutos), você recebe um e-mail com o número de sucessos e falhas. ::: :::error IMPORTANTE: garanta que o CSV está no encoding UTF-8. Outros encodings podem gerar caracteres inválidos ou impedir o match de tags. ::: Observações - Para volumes via API: Como importar contatos em massa via API - Para importar via HubSpot: Como importar contatos via HubSpot - Para criar atributos personalizados antes de usar no CSV: Como criar campos customizados de contatos e conversas - Para remover tags em massa via API: Como remover tags de contatos em massa via API

Última atualização em May 21, 2026

Como funciona a transferência de chamados para Nível 2 (N2) com a ClaudIA

Quando usar - Você quer entender quando e por que a ClaudIA transfere uma conversa para humano (N2) - Você é admin e precisa configurar os gatilhos de handover - Você é agente N2 e quer um guia rápido de como receber e tratar um ticket transferido pela ClaudIA Pré-requisitos - Para administradores: ter acesso ao Hub da ClaudIA e ao Cloud Chat - Para configurar roteamento por tag: ter os grupos N2 já criados no helpdesk O que é a transferência N2 É o processo (handover) no qual a ClaudIA interrompe o atendimento automatizado e encaminha a conversa para um humano (time ou agente) no helpdesk. :::info Por que acontece — para garantir que casos complexos, sensíveis ou que geram frustração sejam tratados por pessoas, com contexto e ações que a IA não executa. ::: Em que situações a ClaudIA transfere para N2 A ClaudIA pode transferir automaticamente por vários gatilhos. a) Baixa confiança (Low Confidence) A ClaudIA mede o score de confiança das respostas encontradas na base de conhecimento. Se baixo repetidas vezes, a IA não tem resposta segura. Como funciona: 1. ClaudIA busca conteúdos relevantes 2. Calcula score de confiança para cada conteúdo 3. Se ficar abaixo do threshold configurado, incrementa o contador (count_limit) 4. Se o contador atinge o limite, aciona handover O que admin deve fazer: revisar Low Confidence Threshold e Count Limit, melhorar conteúdos N1 e testar em homologação. b) Pedido explícito do cliente O cliente solicita falar com humano (ex: "quero falar com um atendente"). Como funciona: 1. Detector de intenção reconhece a frase 2. ClaudIA faz handover imediato O que admin deve fazer: ajustar lista de frases/intenções que disparam o handover; testar variações ("atendente", "suporte humano", "alguém real"). c) Detecção de frustração A ClaudIA soma sinais de insatisfação (palavras, repetição, tom) e gera frustration score. Como funciona: quando o score ultrapassa o limite, a transferência é acionada para evitar piora na experiência. O que fazer: revisar threshold de frustração; treinar mensagens de contenção antes do handover; monitorar causas frequentes. d) Limite de mensagens (conversa muito longa) Quando a conversa ultrapassa um número configurado de mensagens (padrão 30), a transferência é acionada para evitar loops e perda de contexto. O que fazer: ajustar o Message Limit conforme seu fluxo, ou habilitar encaminhamentos parciais. e) Conteúdo marcado como N2 (escala direta) Alguns temas na base de conhecimento podem ser deliberadamente marcados como N2 — sempre encaminham para humano. O que fazer: revisar a lista e garantir que só sejam casos realmente complexos. f) Tomada manual (Forced handover / "Tomar") Um agente ou supervisor pode interromper a ClaudIA e assumir o ticket. O que fazer: treinar agentes para usar o botão Tomar corretamente e acompanhar se a ClaudIA realmente saiu do atendimento. O que acontece no momento da transferência 1. Gatilho detectado (um dos itens acima) 2. Mensagem ao cliente — a ClaudIA envia mensagem padrão (configurável) informando que vai transferir :::info Se habilitado, pode haver handover sem enviar mensagem ao cliente. ::: 3. Criação de nota interna com: motivo, scores aplicáveis, últimos trechos da conversa, conteúdos tentados 4. Aplicação de tag(s) que descrevem o assunto 5. Encaminhamento do ticket ao grupo N2 configurado (ou ao grupo definido pela tag) 6. Agente N2 assume: abre o ticket, lê nota/transcrição e continua o atendimento Tags e roteamento Etapa 1 — Verificar Tagger Confirme que o motor de tags está ativo e com as regras corretas. Etapa 2 — Mapear tags → grupos No painel de integração, defina que cobrança vá para Equipe Cobrança, técnico vá para Suporte Técnico, etc. Etapa 3 — Testar mapeamento Crie conversas de teste que acionem cada tag e confirme que o ticket chega ao grupo certo. Se aparecer NO_TAG - Verifique se há conteúdo acionado na conversa - Se não, revise o Tagger (regras/expressões) ou adicione fallback tags Configuração para administradores Etapa 1 — Criar conta/agente da ClaudIA no helpdesk Etapa 2 — Criar times e grupos N2 :::warning Atenção: a ClaudIA deve estar em um time separado dos agentes humanos. Se a ClaudIA estiver no mesmo time que os atendentes, a distribuição automática (round-robin) pode falhar ao escalar para o N2 — tickets chegam sem agente atribuído mesmo com agentes online. ::: Configure os times seguindo esta arquitetura: 1. Time exclusivo da ClaudIA — crie um time dedicado apenas para a ClaudIA (ex: ClaudIA). Nenhum agente humano deve fazer parte desse time. 2. Time intermediário de transbordo (ex: transbordo n2) — crie um time que receberá os tickets escalados pela ClaudIA. Configure esse time com a atribuição automática desabilitada. Não é necessário (nem recomendado) que agentes humanos fiquem nesse time. 3. Times de atendimento humano (ex: Atendimento ao Cliente, Atendimento ao Vendedor) — times onde os agentes humanos ficam e efetivamente atendem. 4. Automações de distribuição — crie automações no Cloud Chat que, quando um ticket chegar ao time intermediário, distribuam automaticamente para o time de atendimento correto com base na caixa de entrada. Exemplo: - Atribuição Time Atendimento Cliente → encaminha para o time Atendimento ao Cliente - Atribuição Time Atendimento Vendedor → encaminha para o time Atendimento ao Vendedor :::success Com essa arquitetura, quando a ClaudIA escala para N2, o ticket passa pelo time intermediário e é distribuído automaticamente para um agente disponível no time correto — sem ficar preso sem atribuição. ::: Etapa 3 — Configurar integração / webhook Entre Cloud Chat e seu helpdesk. Etapa 4 — Mapear tags → grupos No painel de integração. Etapa 5 — Ajustar gatilhos no Hub da ClaudIA - Low Confidence Threshold — ex: 0.5–0.6 como ponto de partida - Count Limit — ex: 3 tentativas - Message Limit — ex: 30 - Frustration Threshold — ex: 0.7 - Habilitar/desabilitar handover sem mensagem conforme política Etapa 6 — Personalizar mensagens padrão Mensagem ao usuário e template de nota interna. Etapa 7 — Testar em homologação Simule baixa confiança, pedido de humano, frustração e conversa longa. Etapa 8 — Publicar/monitorar Após deploy, acompanhe taxas de handover, NO_TAG e motivos mais frequentes. Guia rápido para agentes N2 Ao receber um ticket vindo da ClaudIA: 1. Abrir o ticket e ler a nota interna imediatamente 2. Ler as últimas mensagens (transcrição parcial deixada pela ClaudIA) 3. Conferir as tags aplicadas — ajuda a priorizar e direcionar 4. Assumir o atendimento (mudar owner/status conforme processo) 5. Mensagem inicial ao cliente (sugestão): Olá [Nome], aqui é [Seu nome] do time [Equipe]. Vou continuar o atendimento que começou com a ClaudIA sobre [assunto]. Você pode confirmar [dados/última ação]? 6. Registrar as ações internas e atualizar o ticket com resoluções, anexos ou observações 7. Fechar o ticket quando concluído Problemas comuns e soluções rápidas Transferência não chega ao time 1. Verifique se o webhook/integração está ativo 2. Confira se o grupo N2 existe e está ativo no helpdesk 3. Teste com handover de homologação e analise logs Ticket sem tag (NO_TAG) 1. Veja se a ClaudIA acionou algum conteúdo 2. Revise regras do Tagger e adicione fallback se necessário Muitos handovers por baixa confiança 1. Aumente o Count Limit ou ajuste o Low Confidence Threshold 2. Melhore/adicione conteúdos N1 mais completos ClaudIA continua respondendo após "Tomar" 1. Confirme se o Tomar foi registrado no helpdesk 2. Se necessário, reinicie o handover manual e acompanhe Ticket chegou ao N2 sem agente atribuído :::warning Esse comportamento ocorre quando a ClaudIA está no mesmo time que os agentes de atendimento humano. O round-robin não consegue selecionar um agente disponível e o ticket fica sem atribuição. ::: Como corrigir: 1. Mova a ClaudIA para um time exclusivo, separado dos times de atendimento humano 2. Crie um time intermediário (ex: transbordo n2) com a atribuição automática desabilitada 3. Crie automações que, a partir desse time intermediário, distribuam o ticket para o time de atendimento correto com base na caixa de entrada 4. Se a configuração da integração precisar ser atualizada para apontar para o novo time intermediário, entre em contato com o suporte Cloud Humans Exemplos práticos Cenário A — Baixa confiança - Cliente: "Por que fui cobrado duas vezes?" - ClaudIA: tenta respostas com scores 0.28, 0.31, 0.29 → Count Limit atingido - Ação: envia mensagem de handover, cria nota Low confidence, aplica tag cobrança e encaminha à Equipe Cobrança - Agente N2: abre ticket, confere nota, responde explicando próximos passos Cenário B — Pedido explícito - Cliente: "Quero falar com um atendente" - ClaudIA: reconhece intenção → handover imediato - Nota: Customer requested human - Agente: assume e responde com tom empático Cenário C — Frustração detectada - Cliente envia mensagens repetidas com tom agressivo - ClaudIA: detecta frustration score alto → handover - Nota: Frustration detected (score 0.82) - Agente: assume rapidamente, pede desculpas pela experiência e propõe próximos passos Observações - Para integrar a ClaudIA a outros canais sem quebrar o handover: Como integrar a ClaudIA ao Cloud Chat e adicionar canais - Para configurar automações sem interferir nas regras da ClaudIA: Como gerenciar automações no Cloud Chat - Para configurar SLA respeitando os tempos de pausa quando a IA está atuando: SLA: Métricas de tempo de atendimento

Última atualização em May 27, 2026

Como funcionam os eventos que disparam automações no Cloud Chat

Quando usar - Você está criando uma automação e quer saber qual evento usar - Suas automações estão se atrapalhando e você precisa entender a ordem de execução - Você quer evitar conflitos e loops em automações que modificam os mesmos campos Sobre este artigo As automações do Cloud Chat são disparadas com base em eventos. Para que as regras funcionem corretamente, é fundamental entender a ordem em que esses eventos acontecem no ciclo de vida de uma conversa. Para criar/editar automações: Como gerenciar automações no Cloud Chat. Responsabilidade de cada evento 1. Conversation Created - Sempre o primeiro evento - Disparado assim que a conversa (ticket) é criada :::info Boa prática: use este evento apenas para atribuir valores iniciais (ex: inbox, prioridade, agente, tags). ::: 2. Message Created - Acontece sempre que uma nova mensagem entra na conversa - Ocorre durante a criação da conversa (ex: quando o cliente abre o atendimento enviando mensagem) :::info Boa prática: use para ações reativas — aplicar tags pelo conteúdo da mensagem ou disparar webhooks. ::: 3. Conversation Updated - Disparado quando há mudanças em conversa existente: status, atribuição de agente, time, prioridade :::info Boa prática: use quando precisar acompanhar alterações de fluxo, e não apenas a criação. ::: 4. Conversation Opened - Ocorre quando uma conversa que estava resolvida, pendente ou adiada é reaberta pelo agente :::info Boa prática: use para retomar fluxos automáticos (ex: reatribuir para a mesma equipe que resolveu antes). ::: Fluxo típico de execução - Cliente abre atendimento enviando mensagem → Conversation Created e Message Created rodam em paralelo - Qualquer campo muda (status, agente, time, prioridade) → Conversation Updated - Agente resolve a conversa → Conversation Updated (status = resolvida) - Agente reabre o ticket manualmente → Conversation Opened e Conversation Updated rodam em paralelo Casos comuns de erro 1. Concorrência entre automações no mesmo evento :::warning Erro: duas automações alterando o mesmo campo (agente, prioridade) no mesmo evento. Solução: sempre validar condições adicionais para que apenas uma regra seja aplicada. ::: 2. Sobrescrever elementos referenciados por uma ação :::warning Erro: ações que substituem valores já preenchidos (campos customizados, agente). Solução: automação nunca deve deixar campos vazios ou apagar informações sem checar se são utilizadas em outras automações. ::: 3. Uso incorreto de "igual a FALSO" :::warning Pode causar disparos inesperados em massa. Solução: prefira "diferente de VERDADEIRO". ::: 4. Excesso de ações em uma única automação :::warning Pode causar loops ou alterações em cadeia difíceis de rastrear. Solução: divida automações grandes em regras menores e independentes. ::: 5. Webhook não disparando :::warning Se não aparece ícone de sucesso/falha → a automação não rodou. Causa comum: condições mal definidas ou conflito com outra automação que bloqueou a execução. ::: Boas práticas finais :::success Antes de publicar qualquer automação, revise sempre: - Condições - Ações - Possíveis interações entre eventos Isso evita comportamentos inesperados e mantém o fluxo da operação estável. ::: Se tiver dúvidas, acione o suporte Cloud Chat. Observações - Para criar e gerenciar automações: Como gerenciar automações no Cloud Chat - Para integrar a ClaudIA a um novo canal sem quebrar as automações dela: Como integrar a ClaudIA ao Cloud Chat e adicionar canais - Para configurar SLA via automação: SLA: Métricas de tempo de atendimento

Última atualização em May 21, 2026

Como criar atributos customizados condicionais de conversa

Quando usar - Você quer mostrar campos específicos na conversa apenas quando outros campos têm certos valores - Você quer um formulário adaptativo que guia o agente conforme as respostas - Você quer reduzir poluição visual no painel da conversa Pré-requisitos - Estar logado como administrador - Ter um atributo base já criado (será o gatilho para o condicional) — ver Como criar campos customizados de contatos e conversas :::warning Os atributos customizados condicionais se aplicam apenas a atributos de conversa — não a contatos. ::: Sobre este artigo Os atributos customizados condicionais permitem criar campos dinâmicos que aparecem na conversa apenas quando determinadas condições são atendidas. Oferece interface mais limpa e organizada, mostrando apenas campos relevantes para cada situação. Benefícios - Interface mais limpa — apenas campos relevantes são exibidos - Fluxo guiado — campos aparecem conforme o contexto - Melhor organização — reduz confusão no preenchimento - Flexibilidade — formulários adaptativos baseados em respostas anteriores Como configurar Etapa 1 — Acessar Atributos Customizados 1. Vá em Configurações 2. Acesse Atributos Customizados 3. Selecione a aba Conversas 4. Clique em Adicionar Atributo Customizado Etapa 2 — Criar um atributo base Primeiro, crie um atributo sem condição que servirá como gatilho. Exemplo - Nome de exibição: Tipo de Problema - Tipo: Lista - Valores: Técnico, Comercial, Suporte Etapa 3 — Criar um atributo condicional Agora crie um atributo que aparece apenas quando uma condição específica for atendida. Exemplo - Nome de exibição: Detalhes Técnicos - Tipo: Lista - Condicional: ✓ Habilitado - Atributo de Referência: Tipo de Problema - Valor Alvo: Técnico Como ativar 1. Na parte inferior, marque Torne este atributo condicional 2. Selecione o atributo alvo e o valor ao qual este atributo estará condicionado Exemplos práticos Exemplo 1: Onboarding de cliente 1. Tipo de Cliente → Novo, Existente 2. Plano Desejado (se Novo) → Básico, Premium, Enterprise 3. Recursos Premium (se Plano = Premium) → Lista de features 4. Migração Necessária (se Existente) → Sim, Não Casos de uso comuns E-commerce Tipo de Produto → Categoria → Subcategoria → Variações Suporte Técnico Tipo de Problema → Sistema Afetado → Severidade → Solução Vendas Lead Source → Interesse → Orçamento → Decisor Atendimento Tipo de Solicitação → Departamento → Prioridade → SLA Onde os atributos são exibidos Eles aparecem na seção Informações de Conversa dentro da conversa. Ordem dos atributos :::warning A ordem da listagem dos atributos customizados se reflete diretamente na ordem em que aparecem na conversa. ::: Como reordenar 1. Arraste e solte — use o ícone de "grip" (≡) à esquerda 2. Ordem lógica — atributos base primeiro, condicionais depois 3. Fluxo natural — organize conforme a sequência lógica de preenchimento Exemplo de boa ordem 1. Tipo de Problema (base) 2. Categoria Técnica (condicional: Tipo = Técnico) 3. Prioridade do Bug (condicional: Categoria = Bug) 4. Departamento Comercial (condicional: Tipo = Comercial) 5. Contato Preferencial (base) Fluxo de trabalho recomendado 1. Planejamento 1. Mapeie o fluxo — desenhe como os campos se relacionam 2. Defina hierarquia — base vs. condicionais 3. Liste valores — prepare todas as opções 2. Implementação 1. Crie atributos base primeiro (sem dependências) 2. Adicione condicionais gradualmente 3. Teste o fluxo com casos reais 4. Ajuste a ordem conforme necessário 3. Manutenção 1. Monitore alertas — atributos com problemas 2. Atualize valores — mantenha listas atualizadas 3. Revise o fluxo — ajuste conforme feedback dos agentes Solução de problemas "Atributo não aparece na conversa" - Verifique se a condição está correta - Confirme que o valor alvo existe no atributo de referência - Verifique se não há referências circulares "Erro de validação" - Clique no ícone de aviso para ver detalhes - Corrija referências quebradas - Atualize valores inválidos "Ordem incorreta" - Use drag & drop para reordenar - Coloque atributos base antes dos condicionais - Teste a sequência após reorganizar Observações - Para criar atributos customizados não condicionais (base): Como criar campos customizados de contatos e conversas - Para validar conteúdo do campo com REGEX: Como validar campos customizados com expressões regulares (REGEX) - Para preencher esses atributos automaticamente via macro: Como usar macros com atributos customizados no Cloud Chat - Para preencher esses atributos via automação: Como gerenciar automações no Cloud Chat - Para atualizar via API: Como atualizar atributos customizados em conversas via API

Última atualização em May 21, 2026

Como configurar SLA e métricas de tempo de atendimento

Quando usar - Você precisa definir prazos de primeira resposta, próxima resposta e resolução para tickets - Você quer acompanhar visualmente se um ticket está dentro ou fora do SLA - Você quer aplicar políticas de SLA automaticamente com base em tag, prioridade ou agente Pré-requisitos - Estar logado como administrador (apenas admin gerencia SLA) - Ter o evento desejado mapeado em uma automação — ver Como gerenciar automações no Cloud Chat Sobre este artigo O SLA (Service Level Agreement) permite definir e acompanhar métricas de tempo do atendimento. Controlado por políticas de SLA que determinam limites para respostas e resolução, aplicadas aos tickets via automações. O objetivo é garantir previsibilidade, controle e monitoramento do tempo de atendimento. Acesso e permissões A gestão de políticas de SLA está em Configurações. :::warning Apenas usuários com perfil de Administrador podem: - Criar políticas de SLA - Editar políticas - Excluir políticas - Criar automações com políticas de SLA Outros perfis não têm acesso a essas ações. ::: Políticas de SLA Métricas configuradas Os admins podem criar políticas com: - Tempo de Primeira Resposta (FRT) — first response time - Tempo de Próxima Resposta (NRT) — next response time - Tempo de Resolução (RT) — total resolution time Regras e validações :::error O tempo de resolução não pode ser menor que: - O tempo de primeira resposta - O tempo de próxima resposta Caso essa regra não seja respeitada, a política não será salva. ::: Edição :::warning Quando uma política já está em uso e é editada: - O único valor que pode ser alterado é o NRT — e não de forma imediata, na mensagem seguinte ::: Exclusão Ao excluir uma política: - Ela deixa de funcionar imediatamente - Tickets que usavam essa política deixam de ter o SLA associado :::info A exclusão é a única forma de remover uma política de um ticket após ela ser aplicada. ::: Como criar uma política Configurações → SLA → Criar uma nova Política de SLA → Preencher campos (Nome, descrição, FRT, NRT, RT) → Criar Após criar, o passo seguinte é adicionar a uma automação. Aplicação do SLA via automações :::warning Políticas de SLA não funcionam sozinhas — para aplicar a um ticket, é necessário configurar via Automações. ::: Configuração Em Automações, crie gatilhos para aplicar políticas com base em: - Tag - Prioridade - Agente - Outros Quando o gatilho é atendido, a política é aplicada automaticamente. Regras importantes :::warning - Uma política só pode ser adicionada via automação - Após adicionada a um ticket: - Não é possível removê-la via automação - Via automação, pode apenas ser substituída por outra - A remoção completa só acontece se a política for excluída do sistema ::: Como os tempos de SLA são calculados As métricas são calculadas dinamicamente considerando o estado do ticket, quem está interagindo e pausas automáticas. Tempo de Primeira Resposta (FRT) Definição: tempo entre a primeira mensagem do cliente e a primeira resposta de um agente humano. Regras de cálculo: - Inicia quando: cliente envia mensagem e ticket não está em status Pendente - Encerra quando: agente humano envia primeira resposta - Se a política for aplicada após a primeira resposta já ter ocorrido → FRT não é considerado - Se o ticket entra em pausa → tempo fica congelado Tempo de Próxima Resposta (NRT) Definição: tempo entre uma mensagem do cliente e a próxima resposta do agente humano, após a primeira resposta. Regras de cálculo: - Só passa a existir após o FRT ter sido concluído - Inicia quando o cliente envia nova mensagem - Encerra quando agente humano responde ou o ticket é resolvido - Sempre que o agente responde → NRT é zerado (volta a aparecer quando o cliente mandar nova mensagem) - Visualmente: - Em alguns momentos aparece FRT e RT - Em outros, NRT e RT - Em outros, só RT (quando última mensagem foi do agente) - É pausado em estados de pausa Tempo de Resolução (RT) Definição: tempo total para resolver o ticket, considerando apenas períodos ativos. Regras de cálculo: - Inicia com a criação do ticket - É acumulativo, com pausas - Encerra quando o ticket é marcado como resolvido - É fixo — sempre existe enquanto o ticket não for resolvido - Nunca pode ser menor que FRT ou NRT Estados que pausam o SLA :::info Os tempos são congelados quando o ticket está em: - Pendente (atribuído ou não) - Em atendimento pela IA (ClaudIA) - Adiado - Outros estados configurados como pausa Durante esses estados, nenhum tempo é incrementado — o SLA permanece associado, porém pausado. ::: Comportamento com a ClaudIA Quando a IA (ClaudIA) está atuando no ticket, o SLA tem comportamento específico. :::info Regras de pausa com IA: - Se a IA estiver respondendo como agente → todos os tempos do SLA ficam pausados - O tempo não é contado como primeira ou próxima resposta - A contagem é retomada quando: - Um agente humano assume - O ticket sai do estado de pausa Isso garante que o SLA não penalize o tempo em que a IA está atuando — apenas interações humanas são consideradas. ::: Visualização do SLA no ticket Regras gerais - SLA ativo → exibido normalmente no ticket - SLA pausado → não fica visível na interface, mesmo que a política continue associada Aplica-se especialmente quando o ticket está: - Pendente - Em atendimento pela ClaudIA - Adiado Lado esquerdo — Tempos dinâmicos O lado esquerdo exibe os tempos do SLA conforme o estado e estágio do atendimento. Exibição dos tempos - Sem agente atribuído → exibe FRT (esquerda) e RT (direita) - Após FRT existir → exibe NRT (esquerda) e RT (direita) Regras importantes - Se a política for adicionada após o FRT já ter ocorrido → FRT não é considerado nem exibido - O NRT é variável — zerado sempre que o agente responde - O único tempo fixo durante todo o ciclo é o RT Comportamento visual (cronômetros) - Dentro do prazo → tempo decresce, exibido em verde - Em atraso → tempo passa a contar de forma crescente, exibido em vermelho Hover Ao passar o mouse: - Dentro do prazo → mostra "quanto tempo falta para vencer" - Em atraso → mostra "há quanto tempo o prazo foi ultrapassado" - Se aparecer só uma barra (-) → "a próxima resposta é a do cliente" Área central — Histórico Exibe quando a política foi adicionada e que foi via automação. Lado direito — Detalhes textuais Exibe prazos e status de cada métrica de forma textual e objetiva. Métricas exibidas - Variam conforme estado da conversa: FRT, NRT, RT - O RT é o único fixo Formato Cada métrica apresenta: - Data e hora limite do SLA - Status textual abaixo: "Vence em X" ou "Em atraso há cerca de X" Cores - Dentro do prazo → verde - Em atraso → vermelho Regras de pausa Quando o SLA está pausado: - Não é exibido no lado direito - Mesmo que a política continue associada Resumo das regras importantes - Apenas administradores gerenciam políticas de SLA - Políticas excluídas → deixam de funcionar imediatamente - Edições só afetam novos tickets - SLA só é aplicado via automações - As informações visíveis a agentes são dinâmicas - Política aplicada: - Não pode ser removida via automação - Pode apenas ser substituída por outra - RT nunca pode ser menor que FRT ou NRT - SLA só é visível para agentes se não estiver em estado de pausa Observações - Para criar a automação que aplica o SLA: Como gerenciar automações no Cloud Chat - Para entender quando a ClaudIA está atuando (e o SLA fica pausado): Como funciona a transferência de chamados para Nível 2 (N2) com a ClaudIA - Para configurar limite de tickets por agente (impacta NRT): Como configurar limite de tickets por agente e atribuição via Round Robin - Para entender como o auto-fechamento de tickets funciona: Como funciona a resolução automática de tickets

Última atualização em May 21, 2026

Como definir uma senha temporária para um agente no Cloud Chat

Quando usar - Um agente esqueceu a senha e você quer redefinir manualmente - Você está fazendo o onboarding e quer entregar uma senha inicial controlada - Um agente foi bloqueado e precisa de uma senha temporária para retomar o acesso Pré-requisitos - Estar logado no Cloud Chat com um perfil de Administrador - Ter um canal seguro para entregar a senha temporária ao agente Sobre este tutorial Neste artigo você aprende como redefinir a senha de um agente pelo painel administrativo do Cloud Chat. Passo a passo Etapa 1 — Acessar Agentes 1. Acesse o Cloud Chat com um usuário Administrador 2. Vá em Configurações 3. Abra a seção Agentes Etapa 2 — Editar o agente 1. Encontre e selecione o agente que terá a senha redefinida 2. Clique em Alterar Etapa 3 — Definir a senha temporária 1. No campo Senha temporária, defina uma nova senha 2. Clique em Editar agente para salvar Etapa 4 — Compartilhar com o agente Compartilhe a senha temporária com o agente e oriente que, no primeiro acesso, ele deve alterar a senha em Perfil, definindo uma senha definitiva. Para o agente fazer essa troca: Como redefinir / alterar sua senha no Cloud Chat. Recomendações de segurança :::error Para manter a conta protegida: - Envie a senha temporária por canal seguro (mensagem privada corporativa ou cofre de senhas) - Evite enviar a senha em grupos ou canais públicos - Use uma senha temporária forte e única, sem reutilizar padrões ::: Observações - Para o agente trocar a senha temporária por uma definitiva: Como redefinir / alterar sua senha no Cloud Chat - Para criar um novo usuário (em vez de redefinir senha de um existente): Como criar um novo usuário no Cloud Chat - Para entender perfis de permissão antes de criar/editar agentes: Tipos de permissões / perfis de usuários no Cloud Chat

Última atualização em May 21, 2026

Como Criar Atributos Personalizados de Multi Seleção para Conversas

Atributos personalizados de multi seleção permitem classificar uma conversa com mais de um valor ao mesmo tempo, facilitando organização, filtros e análises. Também é possível criar atributos condicionais, que dependem da seleção de outro atributo. Veja como realizar a configuração de Atributos Personalizados assistindo à este vídeo ou lendo o conteúdo deste post. Quando usar multi seleção Use esse tipo de atributo quando uma conversa puder ter: - Mais de um motivo - Mais de um tema envolvido - Mais de uma classificação válida ao mesmo tempo Como criar um atributo de multi seleção 1. Acesse Configurações → Atributos personalizados → Conversas 2. Clique em Criar novo atributo 3. Preencha: - Nome do atributo - Tipo: Multi seleção - Opções (valores que poderão ser selecionados) 4. Salve o atributo Pronto. O atributo já estará disponível para uso nas conversas. Como criar um atributo condicional (dependente) Atributos condicionais são usados quando um campo só faz sentido após outro já ter sido definido. Exemplo: - Categoria → Subcategorias (multi seleção) Passo a passo: 1. Garanta que o atributo “pai” já exista 2. Crie o atributo “filho” (pode ser multi seleção) 3. Na configuração do atributo, defina: - De qual atributo ele depende - Quais valores do atributo pai ativam esse campo 4. Salve e valide o comportamento O atributo filho só será usado quando o contexto fizer sentido. Como usar o atributo na conversa 1. Abra uma conversa no Cloud Chat 2. Localize a seção de atributos personalizados 3. Selecione um ou mais valores no atributo multi seleção Boas práticas rápidas - Prefira nomes curtos e objetivos nas opções - Evite listas muito longas sem condicional - Use condicionais para manter a classificação clara e consistente

Última atualização em Apr 13, 2026

Como Montar Integrações entre Sistemas com Automações e Webhook

Resumo O Cloud Chat possui uma funcionalidade de "Enviar Evento Webhook". Através dela nós conseguimos construir integrações com qualquer sistema que consiga gerar um Webhook. Quando o sistema não tem uma estrutura para criação de Webhook, somente API, é possível utilizar um intermediador (exemplos: n8n, Zapier, Make, Plugga...) para criar um Webhook e construir um fluxo de integração com o sistema alvo como por exemplo Hubspot, Jira e outros. - obs: as vezes é necessário construir um fluxo de "enriquecimento" dos dados que vieram do webhook utilizando uma API (por exemplo - IMPORTANTE: Esse tipo de integração costuma ser criado para integrações "de via única", ou seja, sem atualização de um campo específico. A complexidade de uma integração "de duas vias" é maior e geralmente vai exigir uma necessidade alta de uso de Webhook + API Cloud Chat + API/integração nativa do sistema alvo Existem outras duas maneiras de construir essas integrações, porém possuem um nível de complexidade mais alto e tem objetivos diferentes: - Utilizar nossa API para puxar todos os dados de conversas, todos os dias e alimentar um datalake ou banco de dados: Objetivo costuma ser analítico ou de registro / consolidação de informações - Lado negativo: Dado não vai ser criado real-time. Portanto pode ser ruim para Operação utilizar (exemplo: triagem em N2 / tech) - Utilizar o Eddie ao invés do intermediador como n8n, zapier ou make: Vai funcionar de maneira muito semelhante - Lado negativo: Só vai funcionar para atendimentos que passarem pela ClaudIA Detalhamento Payload enviado pelo Webhook do Cloud Chat Quando uma automação dispara um webhook, ela faz um POST HTTP para a URL configurada, enviando um JSON com as seguintes informações principais: Estrutura do payload (JSON) - event - O tipo de evento que disparou o webhook (ex: message_created, conversation_created, etc.) - content - O conteúdo da mensagem - message_type - Tipo da mensagem (incoming, outgoing, etc.) - conversation - Objeto com dados da conversa, incluindo id, status, etc. - sender - Objeto com dados do remetente (contato), incluindo id, name, email, phone_number, etc. - account - Objeto com dados da conta, incluindo:  - idinbox - Objeto com dados da inbox/canal - contact - Dados do contato associado Exemplo prático (baseado no código) Como visto no exemplo de integração com Rasa: @app.route('/rasa', methods=['POST']) def rasa(): data = request.get_json() message_type = data['message_type'] message = data['content'] conversation = data['conversation']['id'] Resumo do JSON típico que chega no seu endpoint: { "event": "message_created", "message_type": "incoming", "content": "Olá, preciso de ajuda!", "id": 12345, "conversation": { "id": 678, "status": "open", "channel": "web_widget", "contact_inbox": { ... } }, "sender": { "id": 90, "name": "João Silva", "email": "[email protected]", "phone_number": "+5511999999999" }, "account": { "id": 1 }, "inbox": { "id": 10, "name": "Website Widget" } } O que fazer caso o Webhook não contenha o dado que você precisa Nessa situação você vai precisar utilizar os "id"s gerados (ex.: inbox.id, conversation.id, sender.id) para fazer uma chamada de API no Cloud Chat e coletar essa informação para poder enviar para o outro sistema. Em resumo: O webhook envia um POST com JSON contendo os dados do evento, da conversa, do contato/remetente, da conta e da inbox, junto com o conteúdo da mensagem e o tipo de mensagem. Isso permite que o sistema externo (que recebe o webhook) saiba exatamente o que aconteceu e tome a ação adequada.

Última atualização em Apr 13, 2026

Mensagem de Acompanhamento por Inatividade (Follow-up)

Neste artigo, você conhecerá a funcionalidade de follow-up por inatividade, que permite ao Cloud Chat enviar uma mensagem automática ao cliente quando a conversa fica sem resposta por um tempo configurado. Como funciona? A funcionalidade de Follow-up por Inatividade permite que o Cloud Chat envie automaticamente uma mensagem para o cliente quando uma conversa fica sem resposta por um determinado período. Essa mensagem funciona como um lembrete antes que o sistema encerre o ticket automaticamente por meio da Resolução Automática de Tickets (Auto-Resolve). Sem esse acompanhamento automático, alguns problemas podem ocorrer: - Conversas encerradas sem aviso, gerando sensação de abandono para o cliente - Clientes que se distraem e acabam não respondendo a tempo - Reabertura de tickets desnecessária - Aumento de volume e retrabalho para o time de suporte Com o follow-up, o sistema envia um lembrete antes do fechamento da conversa, oferecendo ao cliente uma última chance de continuar o atendimento. Exemplo prático Um agente responde ao cliente às 10h. O cliente não responde. Se o follow-up estiver configurado para 60 minutos, às 11h o sistema envia automaticamente uma mensagem como: "Olá! Você ainda precisa de ajuda? Caso não tenha mais dúvidas, este ticket será fechado automaticamente em breve." - Se o cliente responder, a conversa continua normalmente. - Se o cliente não responder, o auto-resolve encerra o ticket no tempo configurado. Regras de funcionamento Algumas regras definem quando o follow-up pode ou não ser enviado: - A funcionalidade é habilitada por caixa de entrada - O tempo de inatividade é configurado em minutos e o valor deve ser múltiplo de 5 (ex: 5, 10, 15, 30, 60, 120) - Para que o follow-up funcione, a conta precisa ter a **resolução automática de tickets **configurada. Se ela não estiver configurada, a seção de configuração da mensagem de follow-up não aparecerá na interface. - O tempo de envio da mensagem de follow-up precisa ser menor que o tempo da resolução automática de tickets. - O follow-up só é enviado se a última mensagem pública foi de um agente humano - Apenas um follow-up é enviado por ciclo de inatividade Importante sobre o tempo de envio O envio do follow-up pode sofrer um atraso de até 5 minutos em relação ao tempo configurado. Isso acontece porque a verificação de inatividade é realizada periodicamente, em intervalos de 5 minutos, por meio de um processo automático (cronjob). Ou seja, o sistema não monitora as conversas em tempo real, mas sim em ciclos de verificação. Por exemplo: se o follow-up estiver configurado para 60 minutos, a mensagem pode ser enviada entre 60 e 65 minutos após a última resposta do agente. Quando o follow-up não é enviado O sistema não enviará follow-up nos seguintes casos: - A conversa já foi resolvida - A conversa foi adiada/pendente - A última mensagem foi enviada por bot ou automação - O cliente respondeu antes de atingir o tempo configurado - Um follow-up já foi enviado naquele ciclo Se o cliente responder depois do follow-up e a conversa ficar inativa novamente, um novo follow-up pode ser enviado em um novo ciclo. Fluxo Como habilitar e configurar a mensagem Siga os passos abaixo para habilitar o follow-up em uma caixa de entrada. 1. Acesse as configurações No menu lateral do Cloud Chat: 1. Vá em Configurações 2. Clique em Caixas de Entrada 3. Selecione a caixa de entrada que deseja configurar 2. Localize a seção de follow-up Dentro das configurações da caixa de entrada, procure a seção: Mensagem de Acompanhamento por Inatividade Observação: Se essa seção não aparecer, verifique se a resolução automática de tickets está ativa. 3. Habilite a funcionalidade Habilite a opção Mensagem de Acompanhamento por Inatividade. Em seguida configure os campos: Período de inatividade (minutos) Defina o tempo em minutos que o sistema deve aguardar sem resposta do cliente antes de enviar o follow-up. Regras: - Mínimo de 5 minutos - Valor deve ser múltiplo de 5 - Deve ser menor que o tempo de auto-resolve Mensagem de acompanhamento Escreva o texto que será enviado automaticamente ao cliente. Exemplo de mensagem: "Olá! Você ainda precisa de ajuda? Caso não tenha mais dúvidas, este ticket será fechado automaticamente em breve." 4. Salve as configurações Após preencher os campos: Clique em Atualizar para aplicar as alterações. A partir desse momento, o follow-up já estará ativo para novas conversas daquela caixa de entrada. Dica para testar a funcionalidade Para validar se tudo está funcionando corretamente: 1. Configure um tempo curto (ex: 5 minutos) 2. Inicie uma conversa de teste 3. Aguarde o envio automático da mensagem Perguntas frequentes O follow-up aparece como mensagem do agente? Sim. A mensagem aparece como mensagem enviada pelo agente, mas com um tipo especial de mensagem que não reinicia o timer da resolução automática de tickets. Se eu desabilitar o follow-up, as mensagens já enviadas são removidas? Não. As mensagens que já foram enviadas permanecem na conversa. Apenas novos follow-ups deixam de ser enviados. O follow-up funciona em todos os canais? Sim. A funcionalidade funciona em qualquer canal, desde que esteja habilitada. Posso configurar tempos diferentes para cada inbox? Sim. Cada caixa de entrada possui configuração independente, permitindo definir tempos diferentes para cada operação.

Última atualização em Apr 13, 2026

Funcionalidades de Tags

As Tags agora fazem parte do CloudChat. São etiquetas que você cria para organizar e classificar conversas e contatos — toda a gestão (criar, editar, excluir, importar e exportar) acontece direto na plataforma, em Configurações > Tags. O que são tags? Tags são etiquetas que você cria para organizar e classificar conversas e contatos. Cada tag tem um nome, uma cor e uma descrição opcional. Exemplos de uso: marcar conversas por tema ("cobrança", "cancelamento"), por prioridade ("urgente"), por campanha ("black-friday-2026") ou por qualquer critério que faça sentido para a sua operação. Onde encontro as tags? As tags aparecem em três lugares: - Configurações > Tags — página de gerenciamento onde você cria, edita, exclui, importa e exporta tags - Barra lateral da conversa — para aplicar ou remover tags de uma conversa específica - Perfil do contato — para aplicar ou remover tags de um contato Quem pode gerenciar tags? Apenas Administradores podem criar, editar, excluir e importar tags na página de Configurações. Qualquer usuário autenticado (agentes, supervisores, etc.) pode aplicar e remover tags em conversas e contatos. A página de gerenciamento de Tags Acesse pelo menu lateral: Configurações > Tags. Nessa tela você vê todas as tags da conta, com nome, descrição e cor, e tem as ações de buscar, ordenar, adicionar, editar, excluir, importar e exportar. Como criar uma tag 1. Vá em Configurações > Tags 2. Clique em Adicionar tag 3. Preencha o nome (obrigatório), descrição, cor e se ela deve ser exibida no menu lateral 4. Clique em Criar Regras de nome: - Mínimo de 2 caracteres - Apenas letras, números, hifens (-) e underscores (_) - Sem espaços ou caracteres especiais - Convertido automaticamente para minúsculas - Deve ser único na conta Como aplicar tags a uma conversa 1. Abra a conversa 2. Na barra lateral direita, localize a seção de tags 3. Pesquise e selecione a tag desejada Você também pode aplicar tags em massa: selecione várias conversas na lista e use a ação de tags no menu de ações em lote. Para remover uma tag, clique no "x" ao lado dela na barra lateral da conversa. Como aplicar tags a um contato 1. Abra o perfil do contato 2. Localize a seção de tags 3. Pesquise e selecione a tag desejada Como filtrar conversas por tag Use os filtros de conversa para buscar por tag: 1. Na lista de conversas, abra os filtros 2. Selecione o atributo Tags 3. Escolha uma ou mais tags Você também pode salvar essa combinação como uma visualização personalizada para acesso rápido. Busca e ordenação de tags Na página Configurações > Tags, o campo de busca filtra tags por nome ou descrição conforme você digita. O dropdown de ordenação permite organizar a lista por ordem alfabética (A-Z ou Z-A) ou por data de criação (mais recentes ou mais antigas). Exportação CSV A opção Exportar CSV na página de tags gera um arquivo com todas as tags da conta, contendo nome, descrição e cor. O CSV pode ser usado como backup, para conferência ou como base para preparar um arquivo de importação. Importação CSV A opção Importar CSV permite criar tags em massa a partir de um arquivo CSV. Como importar: 1. Na tela de importação, baixe o template de exemplo clicando no link disponível — ele já vem com as colunas corretas (name, description, color) e linhas de exemplo para você preencher 2. Edite o arquivo com suas tags (apenas name é obrigatório) 3. Selecione o arquivo (limite de 1 MB) 4. Clique em Importar CSV O processamento acontece em segundo plano. Ao concluir, você recebe um e-mail com o resumo da importação: quantas tags foram criadas com sucesso, quantas já existiam (duplicadas) e quantas tiveram erro. Se houver erros, o e-mail inclui um arquivo CSV anexo com o detalhamento de cada linha que falhou e o motivo do erro. Regras da importação: | Situação | Comportamento | | --- | --- | | Tag com mesmo nome já existe | Ignorada (contada como duplicada) | | Nome em branco | Linha rejeitada | | Nome com caracteres inválidos (espaços, caracteres especiais) | Linha rejeitada | | Cor inválida ou em branco | Cor padrão aplicada (azul) | | Arquivo maior que 1 MB | Rejeitado antes do processamento | Tags em automações e macros Tags podem ser usadas em regras de automação e macros: - Como condição — dispare uma automação quando uma conversa tiver (ou não) determinada tag - Como ação — adicione ou remova tags automaticamente quando uma regra for acionada Exemplos: - Quando uma conversa for atribuída ao time de cobrança, adicionar a tag "cobranca" automaticamente - Quando uma conversa receber a tag "urgente", atribuir a um agente específico Macros também permitem adicionar ou remover tags como parte de uma sequência de ações que o agente executa manualmente. Perguntas frequentes Posso aplicar a mesma tag a conversas e contatos? Sim. As tags são compartilhadas — a mesma tag pode ser usada em conversas e contatos. O que acontece se eu excluir uma tag? A tag é removida de todas as conversas e contatos que a utilizavam. Posso renomear uma tag? Sim, editando a tag em Configurações > Tags. O novo nome é aplicado em todos os lugares onde a tag aparece. Posso usar ponto-e-vírgula como separador no CSV? Sim. O sistema detecta automaticamente se o separador é vírgula ou ponto-e-vírgula. Preciso preencher todas as colunas do CSV? Não. Apenas a coluna name é obrigatória. description e color são opcionais. O que acontece se eu importar tags que já existem? Elas são ignoradas sem erro. O resumo da importação mostra quantas foram puladas como duplicadas.

Última atualização em Jun 08, 2026

Liberação de acesso ao Hub via Cloud Chat

Visão geral Agora os administradores da conta podem liberar o acesso de um agente ao Hub diretamente pelo Cloud Chat, sem necessidade de abrir um ticket ou usar outra ferramenta. A liberação é feita na tela de edição do agente, em dois campos diferentes: um para escolher os Projetos de Claudia (podem ser selecionados quantos forem necessários) e outro para selecionar os Workspaces de Eddie. Como liberar o acesso ao Hub para um agente 1. Vá em Configurações → Agentes 2. Localize o agente na lista e clique em Editar 3. Na tela de edição, selecione os Projetos de Claudia aos quais ele deve ter acesso 4. Escolha os Workspaces de Eddie aos quais deve ter acesso 5. Clique em Salvar O acesso ao Hub é concedido na hora. O agente pode entrar no Hub usando as mesmas credenciais do Cloud Chat. Cenário comum: novo agente que precisa de acesso ao Hub A liberação é feita em dois passos: 1. Registre o agente normalmente em Configurações → Agentes → Adicionar agente 2. Após criar, clique em Editar no agente recém registrado e selecione os Projetos e Workspaces Sobre os campos | Campo | Função | | --- | --- | | Projetos de Claudia | Define a quais projetos de Claudia o agente terá acesso. Pode selecionar mais de um. | | Workspaces de Eddie | Define a quais workspaces de Eddie o agente terá acesso. Pode selecionar mais de um. | Ambos os campos são independentes — você pode liberar apenas Claudia, apenas Eddie ou ambos. Perguntas frequentes Quem pode liberar o acesso ao Hub? Somente usuários com perfil de Administrador veem esses campos na tela de edição. Como removo o acesso de um agente ao Hub? Abra o agente em Configurações → Agentes → Editar, desmarque os Projetos e Workspaces que deseja remover e salve. O agente recebe um e-mail avisando que obteve acesso? Não. A liberação é silenciosa. Coordene internamente com o agente que o acesso foi concedido. Posso editar os acessos de um agente quantas vezes quiser? Sim. As mudanças são aplicadas toda vez que você salvar. E se não vir esses campos na tela? Confirme que está conectado como Administrador. Se mesmo assim os campos não aparecerem, entre em contato com a equipe de Cloud Humans.

Última atualização em Apr 24, 2026

Bases de Conhecimento e Conteúdos

O que é A área de Conteúdos centraliza a base de conhecimento que a Claudia consulta para responder nos atendimentos. Em vez de espalhar instruções e respostas por planilhas ou docs soltos, o time monta tudo aqui: respostas personalizadas para perguntas frequentes, conteúdos importados de Help Center, documentos e conversas anteriores. A entrada principal é no Menu da Claudia, um resumo do que já existe e atalhos para cada origem de conteúdo (respostas customizadas e importações). Quem pode usar - Usuários com perfil admin - Usuários com perfil cx_engineer Outros perfis não têm acesso à tela de Conteúdos. Como acessar 1. Faça login no CloudChat. 2. Abra o menu da Claudia e clique em Conteúdos. A área de Conteúdos é dividida em fluxos principais hoje: - Visão geral no dashboard — Bases de Conhecimento - Criar Bases de Conhecimento (o lugar que reúne os conteúdos) - Criar Conteúdo Customizado (disponível quando a sua Base existir) - Criar Conteúdo Importado (disponível quando a sua Base existir) Dentro de uma Base você ainda pode: - Visualizar, editar ou esconder uma resposta existente - Agendar, publicar ou excluir conteúdos Visão geral no dashboard Ao entrar em Conteúdos, você vê: - Suas Bases de Conhecimento - Flags informativas sobre as bases - Botão "Nova Base" no canto superior direito — atalho rápido para criar uma nova Base de Conhecimento Criando uma Base de Conhecimento 1. Em Bases de Conhecimento, clique em Nova base 2. Dê um nome para a base (ex.: central-de-ajuda). 3. Clique em Salvar Criando um conteúdo customizado Para criar um conteúdo customizado, é necessário primeiro ter uma Base de Conhecimento criada. O fluxo correto é: 1. Acesse a área de Bases de Conhecimento no menu da ClaudIA.2. Crie sua Base (ou selecione uma já existente) clicando em Nova base no canto superior direito.3. Dentro da Base, clique em Conteúdos (criação manual). Clique em Criar conteúdo customizado e, no formulário, preencha: - Título - Conteúdo (resposta) - Tag - Tópico - Tipo(N1, N2 ou INTERACTIVE) Escolha uma das três ações na base do formulário: - Salvar rascunho - Agendar - Publicar Assim que você adicionar o conteúdo, será redirecionado para o dashboard de conteúdos customizados. No dashboard de conteúdos customizados é possível buscar conteúdos e filtrar por tipo, tag, tópico, fluxo e origem. As abas separam os conteúdos Publicados, Agendados, Rascunhos e Desabilitados. Ao selecionar um ou mais conteúdos, ficam disponíveis as ações: - Visualizar - Editar - Ver histórico - Desabilitar conteúdo - Excluir conteúdo Criando um conteúdo Importado - Adicionar origem Para importar conteúdos, também é necessário ter uma Base de Conhecimento criada. O fluxo correto é: 1. Acesse a área de Bases de Conhecimento no menu da ClaudIA. 2. Crie sua Base (ou selecione uma já existente) clicando em Nova base no canto superior direito. 3. Dentro da Base, entre em Conteúdos Importados. 4. Clique em Adicionar origem. 5. Preencha os campos: - Cadência - Hora - Dia da semana - Tipo de origem (CloudChat Help Center ou Fontes externas/web) - URL inicial - Filtro de caminho - Rotas para ignorar na sincronização - Cache (TTL) - Tag padrão - Tópico Padrão 6. Clique em Adicionar origem. Criando um conteúdo Importado - Importar CSV Para importar conteúdos, também é necessário ter uma Base de Conhecimento criada. O fluxo correto é: 1. Acesse a área de Bases de Conhecimento no menu da ClaudIA. 2. Crie sua Base (ou selecione uma já existente) clicando em Nova base no canto superior direito. 3. Dentro da Base, entre em Conteúdos Importados. 4. Clique em Importar CSV 5. Baixe o modelo do CSV 6. Preencha o CSV 7. Arraste o arquivo CSV para o modal 8. Clique em Importar Depois disso vai ser possível ver no dashboard as origens e status dos seus conteúdos importados, além de ver os conteúdos no dashboard de conteúdos. E depois disso? Seguindo os passos acima, ao final do processo você terá 1 Base de Conhecimento com conteúdo customizado e conteúdo importado, pronta para ser vinculada a uma ClaudIA e usada nos atendimentos.

Última atualização em Jun 08, 2026

Como configurar e enviar campanhas de email no Cloud Chat

Quando usar - Você quer disparar emails em massa para um segmento de contatos do Cloud Chat. - Você precisa que as respostas dos clientes voltem como conversas normais no Cloud Chat (não em um inbox externo). - O envio precisa cumprir CAN-SPAM / LGPD (endereço postal + link de unsubscribe automáticos). Pré-requisitos :::error Antes de criar a primeira campanha, conclua as etapas 1, 2 e 3 deste tutorial na ordem. Pular qualquer uma faz a campanha falhar silenciosamente ou ser rejeitada pelo Gmail/Yahoo. ::: - Perfil de administrador no Cloud Chat. - Acesso ao DNS do domínio que será usado pra enviar (Cloudflare, Route53, Registro.br, etc.). A verificação envolve adicionar 3-4 registros. - Uma caixa de entrada do tipo Email já configurada — ela vai receber as respostas dos contatos. Se ainda não tem, crie em Configurações → Caixas de entrada. - O endereço postal completo da empresa (rua, cidade, estado, CEP, país) — exigência da CAN-SPAM, vai no rodapé de todo email. Sobre este tutorial O fluxo completo tem 5 etapas: endereço postal → domínio → remetente → campanha → acompanhamento. Cada etapa fica em Configurações → Campanhas por email no menu lateral. Passo a passo Etapa 1 — Configurar o endereço postal O endereço postal aparece no rodapé de todos os emails de campanha, junto com o link de unsubscribe. É exigência legal (CAN-SPAM nos EUA, LGPD no Brasil) e Gmail/Yahoo rejeitam emails sem essa informação. 1. Vá em Configurações → Campanhas por email → Endereço postal. 2. Preencha rua, cidade, estado/UF, CEP e país. 3. Clique em Salvar. :::warning Sem endereço postal preenchido, qualquer tentativa de criar uma campanha de email retorna erro de validação. Configure antes de prosseguir. ::: Etapa 2 — Adicionar e verificar o domínio Você precisa provar que controla o domínio que vai usar como remetente (ex: mail.suaempresa.com). Sem isso, emails caem em spam ou são rejeitados na origem. 1. Vá em Configurações → Campanhas por email → Domínios. 2. Clique em Adicionar domínio. 3. Digite o domínio (recomendado: subdomínio dedicado, ex: mail.suaempresa.com em vez do domínio raiz). 4. O Cloud Chat mostra 3-4 registros DNS (MX, SPF/TXT, DKIM). Copie todos. 5. No seu provedor de DNS (Cloudflare, Route53, etc.), adicione cada registro exatamente como aparece — tipo, nome, valor. 6. Volte ao Cloud Chat e clique em Verificar agora no card do domínio. 7. Aguarde a verificação assíncrona (pode levar até 5 minutos após o DNS propagar). :::success Quando estiver tudo certo, o status do domínio muda para Verificado (verde). Só domínios verificados podem ser usados como remetente. ::: :::info O botão Verificar agora fica desabilitado por 30 segundos depois de cada clique pra dar tempo do provedor de envio processar. Se o status não mudar em 5 minutos, confirme se os registros DNS estão idênticos aos exibidos na tela e tente de novo. ::: Etapa 3 — Criar um remetente O remetente é o endereço visível que aparece no campo "De" dos emails (ex: [email protected]). Cada remetente está vinculado a um domínio verificado e a uma caixa de entrada que recebe as respostas. 1. Vá em Configurações → Campanhas por email → Remetentes. 2. Clique em Adicionar remetente. 3. Preencha: - Nome de exibição: nome que aparece no email do destinatário (ex: "Pepa - Suporte Suaempresa"). - Parte local: o que vem antes do @ (ex: pepa, contato, noreply). - Domínio: escolha um dos domínios verificados na etapa anterior. - Caixa de entrada de resposta: a caixa de entrada do tipo Email que vai receber respostas dos clientes. Quando o destinatário responder o email, vira uma conversa nessa inbox. 4. Clique em Salvar. :::warning A caixa de entrada de resposta precisa ser do tipo Email e estar no mesmo account. Se você não tem nenhuma, crie primeiro em Configurações → Caixas de entrada → Adicionar caixa de entrada → Email. ::: Etapa 4 — Criar a campanha 1. Vá em Campanhas → Únicas → Criar uma campanha única. 2. Escolha Tipo: Email. 3. Preencha: - Título: nome interno da campanha (não vai pro destinatário). - Assunto: vai no email. Suporta variáveis dinâmicas (ver abaixo). - Remetente: escolha um dos remetentes criados na Etapa 3. - Tipo de corpo: HTML (com formatação) ou Texto puro (line breaks preservados). - Corpo: o conteúdo do email. Suporta variáveis dinâmicas. 4. Defina a audiência — escolha uma das 3 formas: - Filtro: por atributo do contato (ex: custom_attribute_1 igual a cloud). - Etiquetas: contatos com tags específicas. - CSV: upload de planilha com email ou phone_number na coluna identificadora. 5. Clique em Salvar. A campanha entra em status Ativo e é disparada na próxima janela de envio (geralmente em 1-2 minutos). Variáveis dinâmicas disponíveis no assunto e corpo: - {{ contact.first_name }} — primeiro nome do contato. Se o contato tem nome de uma palavra só (ex: "Ana"), retorna o nome inteiro. - {{ contact.last_name }} — sobrenome. Vazio se o contato só tem 1 palavra no nome. - {{ contact.name }} — nome completo capitalizado. - {{ contact.email }} — email do contato. - {{ contact.phone_number }} — telefone do contato. - {{ contact.custom_attribute['chave'] }} — qualquer custom attribute do contato. :::info Contatos sem email válido (campo vazio ou formato inválido) são automaticamente excluídos da audiência. Mesma coisa pra contatos na lista de bloqueios — quem deu unsubscribe ou bounce permanente não recebe. ::: Etapa 5 — Acompanhar o envio Na lista de campanhas (Campanhas → Únicas), cada campanha mostra um status: - Ativo: aguardando a próxima janela de envio (≈1 min). - Em execução: emails sendo disparados no momento. - Concluído: envio finalizado com 99%+ de eventos terminais. - Parcialmente concluído: pelo menos 80% dos contatos receberam — usado quando alguns falharam mas a maioria foi entregue. - Falhou: erro de configuração (domínio não verificado, remetente deletado, kill switch acionado por bounce alto). Clique em Ver detalhes pra ver quantos contatos foram alvo da campanha e quantos receberam o email. :::info Quando o destinatário responde o email, a resposta vira automaticamente uma conversa proativa na caixa de entrada de resposta do remetente. Toda a thread (email original + resposta do cliente) fica vinculada via headers de email padrão. ::: Observações - Limite por campanha: 3.000 contatos por envio. Pra públicos maiores, divida em várias campanhas. - Kill switch automático: se a taxa de bounce/reclamação ultrapassar 10% em uma amostra de 200+ entregas, a campanha é pausada automaticamente e marcada como Falhou. Isso protege a reputação do domínio remetente. - Lista de bloqueios: contatos que deram unsubscribe, bounce permanente ou marcaram como spam ficam em Configurações → Campanhas por email → Lista de bloqueios. Eles são excluídos automaticamente de todas as campanhas futuras. - Cancelando unsubscribes manualmente: você pode remover um email da lista de bloqueios pela mesma tela. Use com cuidado — clientes podem reclamar.

Última atualização em May 26, 2026

Como assumir uma conversa atendida pela ClaudIA através do Cloud Chat

A partir de agora, enquanto uma conversa estiver sendo atendida pela ClaudIA, você pode assumir o atendimento de forma controlada: o Cloud Chat avisa a ClaudIA, ela para de responder, e o ticket fica disponível pra você continuar do ponto onde estava. Diretamente da interface do Cloud Chat. Este artigo cobre: - Como um agente assume uma conversa da ClaudIA - Como um administrador configura quem pode fazer isso na conta - O que acontece nos bastidores quando você confirma a transferência https://www.loom.com/share/65dd518fdacd4bea91cc34e176e33246 Para agentes: como assumir uma conversa Você pode disparar a transferência de duas formas, ambas com o mesmo resultado. 1. Pela aba lateral da conversa Com a conversa aberta, vá até a seção "Atribuído a" na barra lateral direita e escolha seu nome (ou outro agente humano) no dropdown. 2. Pela caixa de resposta Se você abrir uma conversa atribuída à ClaudIA, vai aparecer a opção "Atribuir a mim" antes de você poder responder. Clicar nela dispara o fluxo de transferência. O modal de confirmação Nos dois caminhos, antes de finalizar, aparece um modal: Esse modal é proposital. Assumir o atendimento é uma ação significativa — a ClaudIA para de responder na conversa —, então a gente exige confirmação explícita. Em conversas que não estão atribuídas à ClaudIA, a atribuição continua silenciosa, como antes. Enquanto o sistema processa, o botão muda para "Transferindo" e fica desabilitado até a transferência concluir. Mensagens de erro que você pode ver | Mensagem | O que aconteceu | O que fazer | | --- | --- | --- | | "Você não tem permissão para transferir esta conversa atribuída à IA." | Seu perfil não está habilitado pra fazer handoff de IA. | Fale com o administrador da conta pra revisar os perfis permitidos. | | "Sessão expirada. Faça login novamente para realizar a transferência." | Seu login expirou no meio do fluxo. | Faça login no CloudChat de novo e tente novamente. | | "Falha ao transferir o ticket. Serviço temporariamente indisponível. Tente novamente." | A ClaudIA está temporariamente fora do ar. | Tente novamente em alguns segundos. Se persistir, abra chamado com a Cloud Humans. | Em qualquer um desses erros, o responsável da conversa volta pro estado anterior automaticamente — a ClaudIA continua atribuída e você não fica com um ticket pela metade. Tente de novo quando o problema for resolvido. Para administradores: configurando quem pode assumir Por padrão, todos os perfis da sua conta podem assumir conversas da ClaudIA. Se você quiser restringir, vá em: Configurações da Conta → Geral → "Perfis permitidos para assumir conversas da IA" É um multi-select. Marque ou desmarque conforme a política do seu time. O que cada perfil significa A ordem abaixo vai do perfil com mais permissões pro com menos — cada um herda os níveis acima. | Perfil | Descrição | | --- | --- | | Administrador | Tem acesso total a todos os recursos. | | CX Engineer | Tem acesso às funções do supervisor, às configurações e ferramentas de IA, e pode criar e editar fluxos controlados. | | Supervisor | Pode visualizar e responder mensagens dos usuários, editar atalhos e gerenciar relatórios. | | Agente | Pode visualizar e responder mensagens dos usuários e editar atalhos. | | Assistente | Pode apenas visualizar e responder a conversas atribuídas a ele ou conversas não atribuídas; não vê outras mensagens. | Se um perfil não estiver marcado, qualquer pessoa nesse perfil que tentar assumir uma conversa da ClaudIA vai receber a mensagem de "permissão negada" e a transferência não acontece. :bulb: Recomendação: se você não tem uma política clara ainda, deixe o default (todos habilitados) e ajuste depois com base no uso real. Restringir demais cedo costuma criar atrito desnecessário. O que acontece do lado da ClaudIA quando você confirma Quando você confirma a transferência, o CloudChat não apenas troca o assignee — ele avisa a ClaudIA explicitamente. Do lado da ClaudIA: 1. Escolhe a tag de escalação mais relevante e gera um sumário do que aconteceu na conversa até aqui 2. Posta uma nota interna na conversa registrando o motivo da transferência 3. Marca o ticket como resolvido com o motivo "transferência forçada para humano" 4. Para de responder — daqui pra frente, a conversa é sua Isso traz três benefícios: - Sem competição: a ClaudIA não vai responder em paralelo enquanto você está atendendo - Histórico limpo: fica registrado por que a IA parou de responder, então auditorias e revisões ficam fáceis - Métricas corretas: essa conversa entra nos relatórios da ClaudIA como "transferida por agente", não como abandono ou erro Perguntas frequentes Posso devolver a conversa pra ClaudIA depois de assumir? Não. Uma vez transferida, a ClaudIA marca o ticket como resolvido do lado dela e não retoma o atendimento daquela conversa. Se você precisar de ajuda da IA novamente, o caminho é criar uma nova conversa. Por que o modal aparece toda vez que eu atribuo um humano numa conversa atualmente atribuída à ClaudIA? Porque assumir o atendimento desliga a ClaudIA daquela conversa — é uma ação que muda o comportamento do sistema. Em conversas que não estão atribuídas à IA, a atribuição continua silenciosa. A configuração de perfis permitidos vale pra todos os inboxes ou só pra alguns? Vale pra toda a conta — não é configurável por inbox.

Última atualização em May 28, 2026