Principal Central de Ajuda
📚

Central de Ajuda

Ian Kraskoff Fabrício Rissetto Paulo Gosik
Por Ian Kraskoff and 6 outros
• 11 artigos

Com criar um novo Help Center/Central de Ajuda e lançar sua primeira FAQ/Artigo

Este tutorial vai te guiar na criação de um novo portal de FAQ para seus clientes usando o Cloud Chat. Step 1: Acesse o Cloud Chat e navegue até a barra lateral e clique em Central de Ajuda Step 2: Clique em novo portal. Step 3: Aqui, escolha seu logo. Faça o upload do seu logo. Para este exemplo, estamos usando o nosso. Step 4: Nomeie seu portal. Neste caso, vamos chamá-lo de Cloud Chat. Step 5: Seu portal será criado automaticamente, mas você pode alterar o "slug". Um "slug" é uma parte do endereço de um site, normalmente simples, sem espaços, que identifica uma página específica. Neste caso, o endereço do site vai ser https://cloudchat.cloudhumans.com/hc/cloud-chat/pt. Se o nome fosse "XPTO", o endereço padrão ficaria https://cloudchat.cloudhumans.com/hc/xpto. Lembrando que esse slug é editável e pode ser diferente do Nome que você escolheu pro seu FAQ. Step 6: Aperte em Criar configurações básicas do portal que o FAQ será criado automaticamente. Step 7: Para editar, escolha a cor que você quer para o seu portal. Pode escolhar uma das opções de cor via paleta de cores. Ou escolha a cor diretamente pelo HEX dela. Step 8: Digite o título da página. Esta alteração é mais para controle interno. Step 9: Digite o texto do cabeçalho. Esse é o texto que fica no topo do seu FAQ. Step 10: O link da página é o link para o qual seus clientes retornarão quando clicarem no seu site (ícone que aparece no topo direito do portal). No nosso caso, insirimos o link do nosso site. Step 11: Depois de inserir o link, atualize as configurações. Step 12: Seu portal está agora criado. Step 13: Acesse suas configurações. Step 14: clique em localidades Step 16: Clique em Adicionar localidade e crie a localidade para a língua de sua preferência. O padrão é Inglês. Step 17: Troque a língua padrão para a nova que você criou Step 18: Exclua a língua padrão (ou qualquer outra) que estava lá. Pronto. Sua Central de Ajuda está criada! 🚀 Para publicar Artigos (FAQs) dentro dessa central, siga o passo a passo descrito aqui.

Última atualização em Aug 09, 2025

Como ativar o Web Widget dentro do meu Portal de Ajuda

Esta funcionalidade permite que você habilite um widget de atendimento diretamente dentro do seu Portal de Ajuda. Com isso, os usuários podem conversar com a sua ClaudIA ou com o time humano sem sair da central de ajuda. O que é o Web Widget no Portal? O Web Widget é um pequeno módulo de chat que aparece no canto inferior direito do Portal de Ajuda. Ele permite que visitantes façam perguntas e iniciem conversas diretamente com seus agentes conectados ao CloudChat — sem necessidade de abrir outra página ou canal. O que é necessário antes de ativar? Antes de configurar o widget no Portal, verifique: - Você já possui um web widget configurado no CloudChat - O Portal já está criado no módulo de Central de Ajuda - Você tem permissão para acessar e editar Configurações do Portal Referência: Como instalar o Widget do Cloud Chat no seu site e passar dados do contato automaticamente Como ativar o Web Widget no seu Portal de Ajuda 1. Acesse a área de Portais No menu lateral da Central de Ajuda, abra a aba de portais: Central de Ajuda → Portais → Configurações do Portal 2. Selecione o Portal onde deseja ativar o widget Escolha o portal desejado e abra as configurações do portal. No canto superior direito da tela, clique no ícone de engrenagem para editar. Isso abrirá a página de configurações completas do portal. 3. Escolha o Widget Web que deseja exibir Na aba "Informação Básica", role até o final da página e escolha o Web Widget que deseja exibir. Clique em Atualizar configurações básicas. Nesse momento o widget aparecerá automaticamente para os visitantes quando acessarem o portal selecionado. Perguntas Frequentes Posso ativar widgets diferentes para portais diferentes? Sim, o widget é configurável por portal. Preciso alterar algum código no portal? Não. A ativação é 100% feita pela interface do CloudChat. É possível desativar o widget depois? Sim. Basta voltar ao campo “Widget Web” e remover a seleção ou escolher outro widget. A ClaudIA responderá automaticamente dentro do widget do portal? Não necessariamente. O comportamento é igual ao dos outros canais do Cloud Chat. Se a ClaudIA já estiver configurada e vinculada a esse widget, ela vai responder normalmente, assim como acontece quando você coloca o widget no seu site. Se ainda não houver uma ClaudIA configurada para esse widget, é só pedir para o seu gerente de conta fazer essa configuração.

Última atualização em Dec 05, 2025

Filtros de Conversas e Contatos Compartilhados

Esta FAQ explica como funcionam os filtros personalizados compartilhados, incluindo níveis de visibilidade, como são atualizados em tempo real e permissões envolvidas. Conceitos - Filtro personalizado (Custom View): combinação de condições salvas para contatos ou conversas, exibidas na barra lateral. - Tipos de filtro: conversation e contact (as telas utilizam o tipo ativo para listar os filtros). - Visibilidade: - Privado: visível apenas para o proprietário (quem criou). - Público: visível para todos os usuários logados na conta. Criação e Edição - Onde criar: no Dashboard, via modal de filtros avançados (botão “Adicionar Filtro”). - Fluxo: - A tela detecta o contexto (Contatos ou Conversas) e define o tipo automaticamente. - A visibilidade padrão é privada; é possível alterar para pública ao salvar. - API: - GET/POST/PATCH/DELETE em /api/v1/accounts/:account_id/custom_filters Onde os filtros aparecem - Barra lateral: ao selecionar "Conversas" ou "Contatos", a lista de filtros do respectivo tipo é carregada e atualizada em tempo real. Boas práticas - Nomeação clara: escolha nomes que indiquem propósito (ex.: “Conversas abertas e snoozed”). - Evite duplicados: ao editar um filtro público, prefira atualizar o existente ao invés de criar um novo com nome similar. - Visibilidade consciente: use público quando o filtro for útil para a equipe; mantenha privado para casos pessoais/experimentais.

Última atualização em Jan 14, 2026

Funcionalidades do Editor da Central de Ajuda

O editor de artigos permite criar conteúdos ricos e bem formatados para a Central de Ajuda. Este guia abrange todos os recursos disponíveis na barra de ferramentas. Formatação de Texto Negrito Selecione o texto e clique no ícone B ou pressione o atalho Ctrl+B (Cmd+B no Mac). Ideal para destacar termos importantes. Itálico Selecione o texto e clique no ícone I ou pressione o atalho Ctrl+I (Cmd+I no Mac). Útil para nomes de campos, menus ou termos técnicos. Sublinhado Selecione o texto e clique no ícone ++U++ ou pressione o atalho Ctrl+U (Cmd+U no Mac). Use com moderação para não poluir visualmente o artigo. Tachado Selecione o texto e clique no ícone ~~S~~ na barra de ferramentas. Útil para indicar informações desatualizadas ou substituídas. Código inline Selecione o texto e clique no ícone de código (<>). O texto aparecerá com fundo destacado, ideal para nomes de variáveis, campos de API ou valores exatos como contact_id que o usuário precisa digitar. Títulos e Estrutura Use títulos para organizar o artigo em seções. Estão disponíveis 3 níveis: - H1 — Título principal (use apenas uma vez por artigo, se necessário) - H2 — Seções principais do artigo - H3 — Subseções dentro de uma seção :::info Dica: Uma boa estrutura de títulos ajuda o leitor a encontrar rapidamente o que procura, especialmente em artigos longos. ::: Listas Lista com marcadores Clique no ícone de lista na barra de ferramentas para criar itens com bullet points: - Primeiro item - Segundo item - Terceiro item Lista numerada Use a lista ordenada quando a sequência dos passos importa: 1. Acesse o menu de configurações 2. Clique em "Central de Ajuda" 3. Selecione o portal desejado Links Selecione o texto que será o link e clique no ícone de corrente na barra de ferramentas. Cole a URL de destino no campo que aparece. O link ficará clicável na FAQ publicada. O link fica assim (esse específico te leva pro site da Cloud Humans). Imagens Clique no ícone de imagem na barra de ferramentas para fazer upload de uma imagem do seu computador. As imagens são úteis para ilustrar passo a passo, prints de tela e diagramas. :::warning Atenção: Evite imagens muito pesadas. Prefira prints recortados e otimizados para que o artigo carregue rapidamente. ::: Citação (Blockquote) Clique no ícone de aspas para transformar um parágrafo em citação. Citações aparecem com uma barra lateral e um fundo diferenciado. Clique novamente no ícone para remover a citação. Exemplo de uso: destacar uma frase importante de um documento oficial ou de uma política interna. Esse é um exemplo Bloco de código Clique no ícone de código com barra (</>) para inserir um bloco de código. Diferentemente do código inline, o bloco de código ocupa um espaço próprio e preserva a formatação original. Ideal para: - Trechos de código de integração - Exemplos de chamadas de API - Configurações em formato JSON ou YAML O resultado fica assim Linha Horizontal Clique no ícone de linha (—) para inserir um separador visual entre seções. Útil para dividir temas distintos em um mesmo artigo ou para criar pausas visuais em conteúdos longos. Blocos de Destaque (Callouts) Os callouts são caixas coloridas que chamam a atenção para informações especiais. Clique no ícone de callout e escolha um dos 4 tipos: :::info Informação: Para dicas, contexto adicional ou referências úteis. Exemplo: "Essa configuração também pode ser feita via API." ::: :::warning Aviso: Para cuidados importantes antes de uma ação. Exemplo: "Essa alteração afeta todos os agentes da conta." ::: :::success Sucesso: Para confirmar resultados esperados ou boas práticas. Exemplo: "Pronto! A integração foi ativada com sucesso." ::: :::error Erro: Para alertar sobre erros comuns ou ações irreversíveis. Exemplo: "Não delete este campo, pois ele é utilizado pelas automações." ::: Para remover um callout, posicione o cursor dentro dele e clique novamente no ícone de callout. :::info Regra importante: Não é possível colocar um callout dentro de outro callout, nem dentro de uma citação (e vice-versa). Cada bloco funciona de forma independente. ::: Tabelas Clique no ícone de tabela para inserir uma tabela com 3 colunas e 3 linhas (incluindo o cabeçalho). Editando a tabela Após inserir, clique em qualquer célula para editar o conteúdo. Use a tecla Tab para avançar para a próxima célula e a tecla Shift+Tab para voltar. Gerenciando linhas e colunas Clique no botão EDITAR que aparece acima da tabela para acessar as opções: | Ação | O que faz | | --- | --- | | Adicionar linha acima | Insere uma nova linha acima da atual | | Adicionar linha abaixo | Insere uma nova linha abaixo da atual | | Adicionar coluna à esquerda | Insere uma nova coluna à esquerda | | Adicionar coluna à direita | Insere uma nova coluna à direita | | Remover linha | Remove a linha onde o cursor está | | Remover coluna | Remove a coluna onde o cursor está | | Excluir tabela | Remove a tabela inteira | Redimensionando colunas Passe o mouse sobre a borda entre duas colunas no cabeçalho. O cursor mudará para uma seta dupla. Clique e arraste para ajustar a largura. :::warning Tabelas largas: Se a tabela tiver muitas colunas, ela exibirá scroll horizontal na FAQ publicada para manter a legibilidade em telas menores. ::: Copiar e colar de outros editores O editor reconhece automaticamente conteúdo colado de outras fontes: | Fonte | O que acontece | | --- | --- | | Google Docs | Formatação é preservada (negrito, itálico, links, listas) | | Notion | Estrutura de blocos é convertida automaticamente | | GitHub / README | Markdown é interpretado e formatado | | Páginas web | HTML é convertido em formatação do editor | Você não precisa reformatar manualmente — basta copiar e colar. Atalhos de Teclado | Atalho | Ação | | --- | --- | | Ctrl+B / Cmd+B | Negrito | | Ctrl+I / Cmd+I | Itálico | | Ctrl+U / Cmd+U | Sublinhado | | Ctrl+Z / Cmd+Z | Desfazer | | Ctrl+Shift+Z / Cmd+Shift+Z | Refazer | | Tab (dentro de tabela) | Próxima célula | | Shift+Tab (dentro de tabela) | Célula anterior | Publicando o artigo Quando o artigo estiver pronto: 1. Revise o conteúdo usando o botão Pré-visualizar 2. Na barra lateral, selecione a Categoria correta 3. Preencha o Meta título e a Meta descrição para melhorar o SEO 4. Clique em Publicar :::success Pronto! Após a publicação, o artigo ficará disponível imediatamente na Central de Ajuda pública. Você pode editar a qualquer momento sem precisar despublicar. :::

Última atualização em Apr 06, 2026