Principal Clicksmart

Clicksmart

Thiago Brito
Por Luana Premoli and 2 outros
14 artigos

Otimizando artigos para assistentes de IA

Manter uma Base de Conhecimento organizada, clara e eficiente é essencial para garantir que clientes e Inteligências Artificiais como o Clicksmart possam encontrar as respostas de que precisam. Este guia apresenta práticas e orientações para criar artigos que nossa IA possa interpretar, e assim responder de forma precisa às perguntas dos clientes com base nos artigos da sua Base de Conhecimento. 1. Plataformas para Base de Conhecimento Embora seja possível documentar em arquivos Word em um drive compartilhado (como OneDrive ou GDrive), há inúmeras limitações nesse tipo de abordagem. Por exemplo, imagens nos documentos Word não possuem URLs que as identifiquem e que possam ser compartilhadas. Por esse motivo e outros, recomendamos plataformas de autoria colaborativa como: - Confluence - Freshdesk* - Zendesk* - Movidesk* - Bookstack - WordPress - Clickdesk* NOTE: as plataformas marcadas com * possuem widget HTML de atendimento, o que permite que você disponibilize no seu site uma UI de atendimento aos seus clientes. Esse widget pode ter como back-office a IA da Openclick: o Clicksmart. 2. Produza Artigos com Texto e Capturas de Tela A combinação de texto e imagens permite que a IA extraia informações tanto da descrição textual quanto dos elementos visuais. - Formato das imagens Evite utilizar imagens no formato GIF, especialmente em contextos onde a compatibilidade é essencial. Dê preferência ao formato PNG, que oferece melhor compressão sem perda de qualidade e é amplamente suportado por navegadores modernos e assistentes baseados em IA. Vale destacar que plataformas como o WhatsApp não renderizam corretamente imagens GIF animadas, comprometendo a experiência do usuário. Essa recomendação está alinhada às boas práticas de acessibilidade e interoperabilidade sugeridas pelo W3C. - Atributo ALT (texto alternativo) Todas as imagens devem conter o atributo alt devidamente preenchido. Esse texto alternativo é fundamental para garantir a acessibilidade do conteúdo, permitindo que leitores de tela descrevam as imagens para pessoas com deficiência visual. Além disso, o atributo alt é utilizado por mecanismos de IA para interpretar o contexto da imagem. Essa prática está em conformidade com as Diretrizes de Acessibilidade para Conteúdo Web (WCAG) estabelecidas pelo W3C. - Nome do arquivo de captura de tela Os nomes dos arquivos de imagem devem ser coerentes com o conteúdo representado, evitando descrições genéricas como captura1.png, imagem02.png ou similares. Sempre que possível, utilize nomes que facilitem a identificação do contexto, da funcionalidade ou da tela apresentada. 3. Utilize um Glossário de Termos Inclua uma página dedicada para termos técnicos ou jargões utilizados nos seus artigos. Por exemplo: - “O que são Leads?” - “Como o termo ‘churn rate’ se aplica aqui?” 4. Evite Anexos, Use Conteúdo Inline Insira todo o conteúdo diretamente na página do artigo com imagens embutidas, evitando anexos como PDFs. 5. Títulos, Subtítulos e Formatação do Texto Utilize os recursos de formatação para destacar informações importantes, assim como é feito em um livro técnico. - Capítulos (H1): título principal. - Seções (H2): divisões do tema. - Subseções (H3, H4): detalhes específicos. - Bullets: Marcadores para itens não sequenciais. - Listas numeradas: para passos e ramificações. - Negrito dar ênfase e destacar pontos críticos. - Itálico para exemplos ou detalhes complementares. Essa abordagem evita ambiguidades e ajuda a IA (e as pessoas) a entenderem em qual contexto cada informação está. 6. Reduza a Ambiguidade Antes de publicar, peça que alguém sem domínio do tema revise o conteúdo. Ferramentas automáticas de clareza também ajudam a identificar trechos confusos. 7. Utilize Acrônimos (SIGLAS) Corretamente - EBITDA (correto) em vez de Ebda (incorreto). 8. Defina Sinônimos e Alias Mantenha uma página dedicada a sinônimos, gírias e variações de termos: - CV: Forma como os usuários chamam Curriculum Vitae. - Definição: Documento que resume qualificações e experiências. - IBGE: Instituto Brasileiro de Geografia e Estatística. 9. Inclua Subtítulos em Vídeos Use arquivos .srt ou .vtt para fornecer legendas que possam ser interpretadas pela IA. 10. Organize os Artigos em Categorias - Busca por filtros: Restringe a pesquisa. - Treinamento modular da IA: Permite incluir/excluir tópicos por categoria. 11. Planeje Antes de Escrever - Defina o objetivo: Qual problema o artigo resolve? - Conheça o público: Adapte vocabulário e complexidade. 12. Crie Conteúdo Acessível e Inclusivo - Use linguagem simples. - Destaque o que é mais importante. 13. Garanta Consistência e Evite Redundância - Use as mesmas SIGLAS e termos em todos os artigos. - Escolha um tempo verbal e mantenha. - Centralize informações críticas em um único local (ex.: horário de atendimento). - Adote o princípio DRY (Don't Repeat Yourself), ou seja, evite contradições e não repita a mesma informação em lugares diferentes. - Não insira informações como “Entre em contato com o suporte”, “Envie um e-mail” ou “Fale no WhatsApp” dentro do conteúdo dos artigos. O texto da Base de Conhecimento é utilizado diretamente pela IA. Caso essas instruções estejam presentes, a IA poderá sugerir ao cliente que entre em contato com o suporte, mesmo quando a própria IA já tem a função de oferecer suporte. 14. Atualize e Revise Regularmente - Revisão programada: Mantenha as informações atualizadas. - Feedback do usuário: Use perguntas frequentes para identificar lacunas. 15. Utilize uma IA como "Professora de Redação" Digite o seu texto e peça para uma IA (ChatGPT ou similar) assumir o papel de "professora de redação" e criticar seu texto sobre clareza, ambiguidades e didática. 16. Priorize Melhorias Baseado em Insights Utilizando alguma ferramenta de Insights como a da Openclick, avalie quais respostas não são bem atendidas pela IA e foque seus esforços melhorando e/ou criando artigos para essas lacunas. Isso vai permitir com que você priorize seus investimentos de documentação onde realmente é necessário, conforme as "dores do cliente". Seguindo essas diretrizes, você não apenas melhora a compreensão dos seus clientes, mas também otimiza a capacidade da IA de fornecer respostas precisas e úteis. Se tiver dúvidas, entre em contato com nosso suporte! 📧 Falar por E-mail 💬 Falar no WhatsApp

Última atualização em Nov 07, 2025

Como interagir com a IA

A inteligência artificial (IA) do Clicksmart pode ser uma poderosa aliada na otimização do seu dia a dia, seja para automatizar processos, esclarecer dúvidas técnicas ou gerar ideias. No entanto, a qualidade das respostas depende diretamente da forma como você interage com ela. Neste guia, você aprenderá as melhores práticas para obter respostas claras, úteis e eficazes ao conversar com a IA. 1. Dê Contexto às Perguntas Para obter respostas mais precisas, forneça informações relevantes ao fazer uma pergunta. Em vez de: "Qual é a melhor estratégia?" Prefira: "Qual é a melhor estratégia para reduzir o tempo de deslocamento de técnicos em uma empresa de manutenção residencial?" 2. Evite Ambiguidades Formule perguntas claras e objetivas. Se a pergunta for muito genérica ou ambígua, a IA pode interpretar de maneiras diferentes, comprometendo a precisão da resposta. Ambíguo: "Como funciona isso?" Claro: "Como funciona o processo de agendamento automático no Clicksmart?" 3. Seja Específico Quanto mais detalhes você fornecer, melhor será a resposta. Se precisar de um código, especifique a linguagem de programação. Se for um relatório, informe o período e os dados necessários. Exemplo: "Preciso de um modelo de relatório de visitas técnicas para enviar ao cliente, incluindo hora de chegada, execução e assinatura." 4. Interaja como se Fosse um Humano Faça perguntas de forma natural, como se estivesse conversando com uma pessoa. Explique o problema e forneça exemplos, se necessário. Dica: Use frases completas, explique o cenário e mencione restrições ou necessidades específicas. 5. Refine as Respostas Se a resposta não atender completamente à sua necessidade, refine a pergunta. Você pode pedir mais detalhes, exemplos ou ajustes na resposta. Exemplos: - “Você pode dar mais exemplos?” - “Pode reescrever de forma mais técnica?” - “Adapte essa resposta para um cliente iniciante.” 6. Use Exemplos Concretos Quando possível, inclua dados reais, trechos de texto, prints ou cenários que representem o que você quer resolver. Isso ajuda a IA a entender melhor e responder com precisão. 7. Mantenha a Conversa Organizada Evite pular de assunto. Se quiser tratar de um novo tema, indique claramente que está mudando. Assim, a IA consegue manter a linha de raciocínio correta. 8. Salve Prompts Eficientes Ao encontrar uma forma de pergunta que gera bons resultados, salve-a para usar novamente no futuro. Isso cria um banco de comandos úteis para sua rotina. Conclusão A IA do Clicksmart foi desenvolvida para ajudar você a ser mais produtivo, criativo e assertivo. Quanto melhor for sua comunicação com ela, melhores serão os resultados. Use este guia como referência, experimente diferentes abordagens e adapte o uso da IA ao seu estilo e objetivos. Se tiver dúvidas ou quiser aprender mais, nossa equipe de suporte está sempre à disposição. 📧 Falar por E-mail 💬 Falar no WhatsApp

Última atualização em Sep 04, 2025

Painel dashboard administrativo

1. Dashboard O painel principal do Clicksmart, onde você pode selecionar o assistente e o intervalo de datas para visualização dos dados. Serve como ponto de partida para o acompanhamento das interações da IA. Estatísticas Mostra os principais indicadores de performance. - Retenção: porcentagem de conversas resolvidas pela IA sem necessidade de intervenção humana. - Total de Interações: quantidade total de trocas (mensagens) entre usuários e assistente. - Total de Usuários: número de usuários únicos atendidos. - Chats únicos: quantidade de sessões de conversa únicas. - Total de perguntas: quantidade de perguntas feitas à IA. - TMR: tempo médio que a IA leva para responder às mensagens. - TMA: tempo médio total que a IA leva para concluir todo o atendimento, desde a primeira interação até o encerramento da conversa. Índice de Solução Exibe a taxa de resoluções classificadas pelo cliente, ou seja, a porcentagem de conversas em que o usuário classificou como satisfatório. *Indicador válido somente ao utilizar o Widget OpenClick. Cérebro Gráfico circular que mostra o percentual de respostas da IA onde ela usou conhecimento do treinamento ou conhecimento nativo. *Em respostas sem referências, também são contabilizadas mensagens de cumprimento: Bom dia, Boa tarde e mensagens pré definidas em prompt. Avaliação Gráfico circular que representa a distribuição das qualificações dos usuários em relação as respostas da IA. Ele é uma ferramenta visual que permite entender rapidamente o nível de satisfação dos respondentes. Categorias de avaliação: - 🟦 Neutro: Representa os usuários que não expressaram uma opinião, seja positiva ou negativa. Isso indica uma experiência satisfatória, mas sem destaques. - 🟧 Gostaram: Representa os usuários que tiveram uma experiência positiva e demonstraram satisfação. - ⚫ Não gostaram: Representa os usuários que relataram insatisfação com a experiência. *Indicador válido somente ao utilizar o Widget OpenClick. Usuário mais ativo na IA Lista os usuários (por e-mail ou IP) que mais interagiram com a IA no período selecionado. Mostra também o número de perguntas realizadas por cada um. Usuários que mais solicitaram atendimento humano Lista os usuários que mais pediram transferência para atendimento humano, permitindo identificar padrões de insatisfação ou limitações da IA. Quando não há dados, aparece a mensagem de “Nenhuma informação encontrada para data selecionada”. Isso quer dizer que a plataforma não foi configurada para fazer transbordo inteligente para humano. Desempenho do assistente Mostra os dados individuais de cada assistente cadastrado, como: - Interações: número total de mensagens trocadas. - Chats únicos: número de sessões iniciadas. - Usuários: total de usuários atendidos. - Perguntas: número de perguntas feitas. - Retenção: taxa de retenção daquele assistente específico. O botão "Ver Interações" permite visualizar os detalhes de cada sessão. 2. Assistentes Permite gerenciar e acessar rapidamente cada agente IA contratado. É o hub para monitorar os agentes. Interação com Assistente Lista todas as sessões de conversa do usuário com esse agente IA específico. Perfeito para revisar histórico e entender padrões de uso. É através dessa opção que você pode "Revisar Resposta", caso uma resposta da IA precise ser modificada ou melhorada. Veja mais sobre como Revisar Resposta: Abertura de revisão de resposta no Clicksmart Editar Assistente Personalização do Assistente Permite personalizar o layout ao utilizar o nosso Widget, ou seja, tocar Logo, cores e mensagens de saudação, texto do botão e texto de classificação. Configurações de IA Adicionar instruções para decisões complexas (ex: quando a IA tem múltiplos caminhos para responder Horário de Funcionamento Defina os horários em que o agente de IA opera com a possibilidade de fazer o transbordo para atendimento humano ou não. 3. Interações Mostra todas as conversas realizadas pelo assistente IA no período selecionado. Nesta ela, é possível fazer download de todas as interações dos últimos 30 dias nos formatos XLSX, CSV Excel ou CSV. Essa funcionalidade é ideal para análises detalhadas ou relatórios gerenciais. 4. Revisões da IA Aqui é possível acompanhar todas as solicitações de revisão de resposta do agente de IA. Existem 5 status possíveis, sendo eles: Status das revisões Cada solicitação de revisão possui um status, que indica o andamento da análise ou da implementação do ajuste. Pendente Indica que a solicitação de revisão foi recebida e está aguardando análise da equipe. Em revisão Significa que a solicitação já foi analisada e está aguardando revisão ou retorno do cliente para continuidade do processo. Aceito Indica que o ajuste sugerido foi incorporado automaticamente ao sistema, sem necessidade de intervenção manual. Rejeitado Utilizado quando não há documentação disponível que permita treinar a IA para realizar o ajuste solicitado. Revisado Indica que o ajuste solicitado foi implementado manualmente pela equipe. Também é possível fazer download de todas as revisões enviadas nos últimos 30 dias nos formatos XLSX, CSV Excel ou CSV. 📧 Falar por E-mail 💬 Falar no WhatsApp

Última atualização em Mar 20, 2026

Parâmetros do Agente de RCA para Zendesk

Visão Geral O agente de RCA (Root Cause Analysis) do Clicksmart é uma inteligência artificial conectada ao Zendesk que automatiza respostas a tickets com base em parâmetros configuráveis. Para utilizá-lo, o cliente deve criar um Webhook no painel administrativo do Zendesk e configurar os parâmetros corretos para que a IA atue de forma precisa. Parâmetros Disponíveis A seguir, os três parâmetros principais que controlam o comportamento do agente RCA: Parâmetro 1: Qual comentário ler - last: Lê o último comentário do ticket - all: Lê todos os comentários do ticket - first: Lê o primeiro comentário do ticket Parâmetro 2: Tipos de comentários - public: Considera apenas os comentários públicos - private: Considera apenas notas internas (comentários privados) - all: Considera todos os comentários (públicos e privados) Parâmetro 3: Tipo de resposta - true: Responde ao ticket de forma visível ao cliente - false: Responde com uma nota interna (apenas equipe vê) Combinações Possíveis e Significados Existem 18 variações possíveis a partir da combinação dos 3 parâmetros: Exemplo de Configuração no Webhook Para configurar corretamente o agente de RCA via Webhook no Zendesk, insira os parâmetros desejados no campo URL do ponto de extremidade em Aplicativos e integrações -> Webhooks -> Webhooks no painel administrativo do ZenDesk. Sintaxe da URL: https://{empresa}.clicksmart.openclick.ai/api/v1/asyncwebhook/zendesk/{assistant_id}/{api_key}/{public|private|all} Onde: - {assistant_id} → ID do seu assistente na Clicksmart - {api_key} → API Key gerada na Clicksmart para este assistente - {public|private|all} → Combinação conforme as 18 variações possíveis. Se tiver dúvidas, entre em contato com nosso suporte! 📧 Falar por E-mail 💬 Falar no WhatsApp

Última atualização em Sep 04, 2025

Configuração do Transbordo Inteligente para Freshchat

Informações obrigatórias que você deve fornecer URL do seu chat Freshchat (API Endpoint) Informe a URL do seu chat Freshchat, disponível em Configurações de API. Exemplo: seuempresa-1234567890.freshchat.com API Key do Freshchat Informe a chave de API gerada no seu painel do Freshchat. Caminho para geração: Configurações > Configurações Pessoais > API Settings Exemplo: eyJrewrtgrsgjdXN0b223rasdasfdL.... ID do Agente Clicksmart no Freshchat Crie um agente específico no seu Freshchat para que nossa IA envie o resumo da conversa no momento do transbordo. Para obter o ID do agente, execute: curl --location 'https://{seu_domínio}.freshchat.com/v2/agents' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {API_KEY}' ID do Tópico no Freshchat Informe o ID do tópico que será utilizado para entrada dos chats no momento do transbordo. Para obter o ID do tópico, execute: curl --location 'https://{seu_domínio}.freshchat.com/v2/channels' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {API_KEY}' Configuração do Webhook no Freshchat Você precisará configurar um webhook no Freshchat apontando para nossa API. Formato do webhook: https://smartbase.openclick.com.br/api/v1/asyncwebhook/freshchat/{collection_id}/{api_key}/user/p1/p2 Onde: - {collection_id} → ID do seu assistente na Clicksmart - {api_key} → API Key gerada na Clicksmart para este assistente ⚠️ Atenção: O Freshchat permite apenas um webhook ativo por ambiente. Formulário para Transferência (Grupos) Se desejar que, antes do transbordo, o usuário selecione uma categoria ou motivo, envie a estrutura do formulário no formato JSON. Exemplo: [ { "title": "Sobre qual assunto vamos conversar?", "name": "group_id", "type": "radio", "required": true, "options": [ { "label": "Compras", "value": "7281e873-051e-4651-9f51-14da2882210a" }, { "label": "Outros", "value": "99999990-051e-4651-9f51-14da2882210a" } ] } ] Onde: - title → O nome da categoria que será mostrado ao usuário - value → ID da fila (grupo) dentro do Freshchat Para obter o ID dos grupos, execute: curl --location 'https://{seu_domínio}.freshchat.com/v2/groups' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {API_KEY}' Textos Personalizados (Opcional) Você pode enviar textos personalizados para os seguintes momentos: - Mensagem exibida ao usuário quando ocorre a transferência: Exemplo padrão: “Transferência concluída. Um agente estará com você em breve.” - Mensagem quando o atendimento retorna do humano para a IA: Exemplo: “Retornando o atendimento para o assistente virtual.” - Mensagem de retorno por inatividade: Exemplo: “Devido à inatividade, retornamos para o assistente virtual.” Tempo de Inatividade (Opcional) Defina após quanto tempo (em segundos) de inatividade o chat será devolvido para a IA. Padrão sugerido: 600 segundos (10 minutos). Resumo das Informações que você precisa enviar

Última atualização em Oct 17, 2025

Como organizar e nomear seus arquivos para que a IA identifique corretamente os conteúdos no SharePoint e OneDrive

Descrição A forma como os documentos são nomeados e estruturados impacta diretamente na capacidade da Inteligência Artificial (IA) de localizar e interpretar os conteúdos. Este artigo apresenta boas práticas de nomenclatura e estrutura de pastas para garantir que a IA da OpenClick identifique corretamente os arquivos armazenados em ambientes como Microsoft SharePoint e OneDrive. 1. Por que isso é importante A IA depende de três fatores para localizar informações: - Nome do arquivo: usado como referência direta para o tema. - Estrutura de pastas: indica contexto (por exemplo, “Infra > Dúvidas > Senha”). - Conteúdo interno: analisado em conjunto com o nome e o caminho do arquivo. Uma má organização ou nomes genéricos podem fazer a IA confundir documentos, omitir respostas ou priorizar materiais desatualizados. 2. Boas práticas de nomenclatura Use nomes claros e padronizados, evitando espaços e caracteres especiais. Exemplos corretos: - Infra_Suporte_Senha.docx - Política_Teletrabalho_2025.pdf - FAQ_Instalação_VPN_Windows.docx Evite: - documento_final(1).docx - Captura.PNG - arquivo_teste_novo_versao3.docx Dica: mantenha a estrutura Tema_Subtema_Detalhe_Ano sempre que possível. 3. Estrutura ideal de pastas A estrutura hierárquica facilita que a IA entenda o contexto de cada documento. Exemplo de estrutura recomendada: BaseConhecimento ┣━━ Infra ┃    ┣━━ Dúvidas ┃    ┣━━ Senha ┃    ┗━━ VPN ┣━━ Marketing ┃    ┣━━ Campanhas ┃    ┗━━ Manuais ┣━━ RH ┃    ┣━━ Políticas ┃    ┗━━ Benefícios Boas práticas: - Evite misturar documentos de áreas diferentes em uma mesma pasta. - Crie subpastas para separar conteúdos operacionais de políticas e instruções. - Nomeie as pastas de forma descritiva e curta. 4. Cuidados com formatação e compatibilidade A IA e a API da Microsoft possuem limitações técnicas: - Evite nomes com mais de 150 caracteres. - Não use acentos ou caracteres especiais (ç, ã, @, %, &). - Mantenha o formato de arquivo legível (DOCX, PDF de texto, XLSX). - Evite pseudo-PDFs: arquivos que são imagens (screenshots) não são interpretáveis pela IA. 5. Testando a leitura da IA Após organizar os arquivos: 1. Solicite à IA que busque um documento específico pelo nome. 2. Verifique se ela consegue identificar o conteúdo correto. 3. Caso o resultado esteja incorreto, revise: - Nome do arquivo - Localização na estrutura - Tipo de arquivo (texto legível vs. imagem) 6. Dicas complementares - Mantenha nomes consistentes entre diferentes versões. Exemplo: Manual_Instalação_v1.docx, Manual_Instalação_v2.docx. - Atualize sempre o nome quando o conteúdo for revisado. - Centralize documentos de referência em uma única base para evitar duplicações. Glossário Pseudo-PDF: Arquivo em formato PDF que contém apenas imagens (sem texto legível). API: Interface de Programação de Aplicações, usada para conectar sistemas como o SharePoint à IA. Indexação: Processo no qual a IA analisa e armazena informações de arquivos para consultas futuras. Hierarquia de pastas: Organização em níveis, usada para agrupar conteúdos relacionados. Categoria 📂 Integrações e IA com SharePoint/OneDrive 📂 Boas Práticas de Documentação Revisão e atualização - Autor: Thiago Brito - Revisão: Equipe OpenClick / IA Clicksmart - Última atualização: 04/11/2025

Última atualização em Feb 10, 2026

Metodologia OpenClick em 5 Fases para Implementação de IA

Introdução A implantação de uma solução de Inteligência Artificial em atendimento exige organização, clareza de etapas e alinhamento entre todas as áreas envolvidas. Para garantir previsibilidade, qualidade e eficiência em cada fase do processo, a OpenClick utiliza uma metodologia própria estruturada em cinco fases sequenciais. Essa metodologia foi desenvolvida a partir de experiências práticas em múltiplos projetos de implantação de IA e representa um modelo consolidado que equilibra velocidade, segurança e qualidade técnica. Ela permite acompanhar a evolução da IA desde os primeiros acessos e integrações até o uso em larga escala pelos clientes finais, garantindo que cada etapa seja validada antes de avançar para a seguinte. A adoção desse método traz benefícios diretos, como maior controle durante o projeto, visibilidade clara de marcos e entregas, redução de riscos operacionais, acurácia na construção da base de conhecimento e uma transição suave do ambiente de testes para o ambiente produtivo. Além disso, a divisão em fases facilita o trabalho colaborativo entre cliente e equipe de implementação, garantindo que decisões sejam tomadas com base em dados e testes reais. Este artigo apresenta, de forma estruturada, cada uma das cinco fases que compõem a metodologia OpenClick e como elas contribuem para uma implantação de IA bem-sucedida. Fase 1: Onboard Abertura do projeto, alinhamento de escopo e definição de participantes. Atividades - Realização da reunião de kickoff. A reunião de kickoff marca o início oficial do projeto. Nela, as equipes se apresentam, revisam o escopo, confirmam os objetivos e esclarecem dúvidas iniciais. Esse encontro garante que todas as partes iniciem o trabalho com entendimento alinhado sobre responsabilidades, prazos e próxima etapa. - Definição de objetivos de negócio e indicadores. Nesta etapa, são estabelecidos os resultados que o projeto deve alcançar, como redução de tempo de resposta, aumento da automação ou melhora na experiência do cliente. Também são definidos indicadores que permitirão acompanhar o desempenho da IA, garantindo que o projeto evolua com base em métricas claras. - Identificação dos canais que serão atendidos pela IA. A equipe identifica quais canais farão parte da implantação inicial, por exemplo, chat, WhatsApp, e-mail ou ticket. Isso organiza as prioridades do projeto e permite preparar a estrutura técnica e operacional necessária para cada canal. - Criação de acessos e canais internos de comunicação do projeto. São configurados os acessos técnicos (usuários, permissões, integrações) e criados os canais de comunicação entre as equipes (como grupos de mensagem ou espaços compartilhados). Essa preparação evita bloqueios durante o projeto e facilita a colaboração entre cliente e OpenClick. Fase 2: Integração e aprendizado Conexão da IA às fontes de conteúdo e inicialização do modelo. Atividades - Integração com repositórios de conteúdo (bases de conhecimento, documentos, etc.). Nesta etapa, a IA é conectada às fontes oficiais de informação do cliente, como bases de conhecimento, manuais, documentos e repositórios internos. Essa integração garante que a IA tenha acesso aos conteúdos que servirão de base para suas respostas, permitindo que o modelo aprenda a partir das diretrizes e processos reais da empresa. - Estruturação inicial da base de conhecimento utilizada pela IA. Após a integração, os conteúdos são organizados em um formato adequado para que a IA consiga interpretar e responder com clareza. Isso inclui revisar textos, padronizar seções, ajustar títulos e garantir que os artigos essenciais estejam disponíveis. Essa estruturação inicial é fundamental para que o modelo comece a aprender corretamente. - Geração da primeira versão da IA em ambiente de testes (playground). Com os conteúdos preparados e integrados, é criada a primeira versão funcional da IA em um ambiente de testes. O playground permite que as equipes interajam com a IA, façam perguntas reais e avaliem o comportamento inicial do modelo. Essa etapa possibilita identificar pontos de melhoria antes de seguir para fases mais avançadas. Fase 3: Customização e testes Uso de perguntas reais para calibrar o comportamento da IA. Objetivo Alcançar um nível de assertividade mínimo de referência, geralmente entre 65% e 70%, antes da exposição mais ampla aos clientes finais. Atividades - Coleta de perguntas reais de clientes. Nesta etapa, são reunidas perguntas reais enviadas pelos clientes no atendimento. Essas perguntas representam situações práticas e ajudam a IA a aprender como os usuários se comunicam no dia a dia. Utilizar exemplos reais é essencial para tornar o modelo mais assertivo e alinhado ao comportamento dos clientes. - Classificação de respostas como adequadas ou não adequadas. A equipe avalia as respostas que a IA fornece durante os testes, classificando cada uma como correta, incompleta ou inadequada. Essa análise indica como o modelo está interpretando as perguntas e identifica oportunidades de melhoria. Essa classificação também é usada para medir a taxa de assertividade da IA. - Ajustes na base de conhecimento e nas configurações da IA. Com base nas análises dos testes, são realizados ajustes nos conteúdos e nas configurações do modelo. Isso pode incluir revisões de artigos, adição de novas informações, melhorias no fluxo de respostas ou refinamentos técnicos. Esses ajustes garantem que a IA evolua e se torne mais precisa antes de avançar para as fases seguintes. Fase 4: Adoção inicial Liberação controlada da IA para um grupo restrito de clientes ou canais. Características - Ativação em um ou poucos canais prioritários. Nesta etapa, a IA é ativada de forma controlada em canais específicos, como chat ou WhatsApp, escolhidos com base no volume e na prioridade da operação. A ativação limitada permite observar o desempenho da IA em um ambiente real, mas em escala reduzida, garantindo segurança e controle sobre o impacto inicial. - Janelas de uso planejadas (por período do dia ou dias específicos). A implantação é realizada em horários ou dias definidos previamente, permitindo avaliar o comportamento da IA em momentos específicos do atendimento. Essas janelas controladas facilitam ajustes rápidos, diminuem riscos operacionais e permitem que a equipe acompanhe o desempenho mais de perto. - Monitoramento intenso das interações e feedbacks. Durante essa fase, todas as interações da IA são acompanhadas de forma detalhada para identificar comportamentos inesperados, dúvidas comuns e oportunidades de melhoria. O feedback contínuo tanto do time interno quanto dos clientes é essencial para ajustar a IA antes da expansão para outros canais ou para uso em larga escala. Fase 5: Adoção em escala Expansão da IA para os canais definidos após a validação de qualidade. Atividades - Ativação em todos os canais escolhidos (por exemplo: WhatsApp, chat, e-mail, ticket). Nesta etapa, a IA é disponibilizada em todos os canais previstos no projeto, passando a operar de forma ampla em ambientes de atendimento reais. Essa expansão permite que a automação alcance todo o fluxo de suporte, garantindo maior cobertura e impacto operacional. - Ajustes finos baseados nos indicadores da fase anterior. Com base nos resultados da fase de adoção inicial como assertividade, motivos de transferência e temas mais acionados são realizados ajustes para aprimorar a performance da IA. Esses refinamentos aumentam a precisão das respostas e garantem uma transição segura para o uso em grande escala. - Estabelecimento de rotina de melhoria contínua. Após a expansão total, é definida uma rotina permanente de monitoramento e evolução da IA. Essa rotina envolve acompanhar métricas, revisar conteúdos, identificar novos temas e executar atualizações periódicas. A melhoria contínua garante que a IA permaneça atualizada, relevante e alinhada às mudanças nos produtos, processos e necessidades dos clientes. Seguindo estas cinco fases a OpenClick demonstrará organização, previsibilidade e qualidade em todas as etapas da implementação das suas soluções em IA. Categorias Metodologia • Implementação

Última atualização em Feb 10, 2026

Abertura de revisão de resposta no Clicksmart

Abertura de revisão de resposta no Clicksmart A validação das interações da IA é uma parte essencial do processo de melhoria contínua. Sempre que uma resposta não corresponde ao comportamento esperado, o usuário pode solicitar que o time OpenClick analise a interação. Este manual ensina, passo a passo, como abrir uma solicitação utilizando a função de revisão de resposta diretamente pelo Clicksmart. Acessando as interações da IA Encontrando a interação que precisa de revisão Com a conversa aberta, percorra as mensagens até localizar a resposta da IA que você deseja enviar ao time OpenClick. É importante observar atentamente o contexto para confirmar que a mensagem selecionada realmente representa o comportamento incorreto, incompleto ou inesperado. Quando encontrar a resposta em questão, o botão Revisar resposta estará disponível logo abaixo da mensagem. Abrindo a janela de revisão Ao clicar em Revisar resposta, será exibida a janela onde você poderá explicar o que aconteceu. Nesse espaço, descreva com clareza: - O que a IA fez no trecho analisado - Por que você considera que houve um erro ou dúvida - Como a IA deveria ter se comportado É importante fornecer o máximo de contexto possível, mas sempre de forma objetiva, para facilitar a análise técnica. Após escrever a sua explicação no campo Resposta esperada, finalize clicando em Salvar Alterações. O que acontece após enviar a revisão Assim que a alteração é salva, a solicitação é criada. A plataforma envia a solicitação para uma fila de análise ao time OpenClick contendo: - Session ID - ID da mensagem revisada - Texto da revisão inserida - Dados do assistente - Dados do revisor Essas informações permitem que o time localize exatamente a interação correspondente e inicie a análise técnica.Esse processo melhora a qualidade da IA, ajusta comportamentos incorretos, corrige pontos de lógica e fortalece o modelo, garantindo uma experiência de uso cada vez mais consistente. Notas importantes • Use sempre linguagem clara e objetiva ao descrever a resposta esperada. • Revise o trecho completo da interação antes de enviar a revisão. • Certifique-se de que a mensagem selecionada representa exatamente o ponto que deseja reportar. Glossário Interação — Mensagem trocada entre usuário e IA dentro da Clicksmart. Revisar resposta — Função usada para enviar ao time OpenClick uma revisão sobre determinada mensagem da IA. Session ID — Identificador único da sessão que permite localizar toda a conversa. ID da interação — Código que identifica a mensagem específica revisada. Resposta esperada — Campo onde o usuário descreve como a IA deveria ter respondido. Categorias Clicksmart Interações da IA Processos de Revisão OpenClick

Última atualização em Dec 02, 2025

O que Você Deve Saber e Quais Dores Você Quer Solucionar ao Contratar um Agente de IA para Atendimento ao Cliente

O que é um Agente de IA para Atendimento? Um agente de IA para atendimento ao cliente é uma solução tecnológica baseada em inteligência artificial capaz de interagir com clientes de forma autônoma, oferecendo respostas rápidas, precisas e personalizadas. Ele pode ser utilizado em diversos canais, como WhatsApp, e-mail, chat no site, redes sociais e até telefone. Principais Dores Que um Agente de IA Resolve Antes de contratar, é importante entender quais problemas você quer resolver. Veja algumas das principais dores que levam empresas a adotarem agentes de IA: - Demora no atendimento: Clientes esperam respostas rápidas. A IA responde em segundos, 24h por dia. - Baixa escalabilidade: Crescer sem precisar aumentar proporcionalmente a equipe de atendimento. - Erros humanos: Padronização nas respostas, eliminando falhas comuns no atendimento manual. - Falta de rastreabilidade: Registro automático de interações e geração de dados para análise. - Atendentes sobrecarregados: A IA cuida das perguntas repetitivas, liberando o time humano para situações mais complexas. O que Você Deve Saber Antes de Contratar Contratar um agente de IA é uma decisão estratégica. Antes de implementar, considere os seguintes pontos: - Definição dos objetivos: A IA vai atender, qualificar, vender, gerar suporte ou tudo isso? - Limitações da IA: Ela não substitui 100% o humano, especialmente em situações complexas ou emocionais. - Treinamento contínuo: O agente de IA precisa ser alimentado com informações, ajustes e atualizações constantes. - Integrações necessárias: Verifique se a IA pode se integrar aos seus sistemas atuais (CRM, ERP, ticket, etc.). - LGPD e segurança: Garanta que o fornecedor siga as normas de proteção de dados. Benefícios de um Agente de IA Ao contratar um agente de IA, sua empresa pode conquistar: - Atendimento 24/7: Sem pausas, feriados ou fins de semana. - Redução de custos: Menor necessidade de expansão do time humano. - Melhora na experiência do cliente: Respostas ágeis e precisas aumentam a satisfação. - Padronização do atendimento: Comunicação alinhada com os padrões da marca. - Dados e relatórios: Análises que ajudam a tomar decisões estratégicas. Conclusão Contratar um agente de IA para atendimento não é apenas uma questão de modernização, mas uma estratégia para escalar seu atendimento, reduzir custos e oferecer uma experiência mais consistente e eficiente ao seu cliente. Avalie bem suas dores, alinhe os objetivos e escolha um parceiro que ofereça não só a tecnologia, mas também acompanhamento consultivo e suporte para garantir o sucesso da implementação.

Última atualização em Feb 20, 2026

Como fornecer acesso ao SharePoint

Passo 1 – Entender o que vamos fazer O que é SharePoint/OneDrive corporativo? Imagine o SharePoint como um armário gigante e organizado na nuvem da Microsoft, onde sua empresa guarda todos os documentos importantes: contratos, relatórios, apresentações, etc. Cada equipe ou projeto tem seu próprio "gaveta" (chamado site), e dentro dessas gavetas há pastas (bibliotecas de documentos) com os arquivos organizados.​ O que é um "Agente de IA" e por que ele precisa acessar esses arquivos? O Agente de IA é como um assistente inteligente que vai responder dúvidas dos clientes ou colegas lendo os documentos do SharePoint. Para isso, ele precisa de uma "chave de acesso" para "enxergar" e entender o conteúdo desses arquivos durante seu treinamento e operação. Como funciona o acesso? 1. Criamos um "crachá digital" (um aplicativo cadastrado no Azure) que diz à Microsoft: "esta integração tem permissão para ler arquivos específicos". 2. Esse crachá gera uma "senha temporária" (token de acesso) a cada uso. 3. Com essa senha, o Agente acessa os arquivos via endereços web especiais (APIs da Microsoft Graph), como se fosse abrindo uma URL no navegador.​ Os 4 IDs que precisaremos para fazer essa integração funcionar: Para tudo dar certo, precisamos que vocês forneçam exatamente estes 4 identificadores únicos (são como "números de série" de cada parte do sistema). Eles são gerados pela própria Microsoft e são seguros para compartilhar com nossa equipe técnica: Importante: Sem esses 4 IDs, não conseguimos conectar. Eles são como as coordenadas exatas para abrir o armário na gaveta certa! Passo 2 – Criar o aplicativo no portal Microsoft Quem faz: Alguém com acesso de administrador ou desenvolvedor no Azure da empresa. 1. Acesse o Portal EntraID (https://entra.microsoft.com ) com sua conta corporativa. 2. No menu lateral esquerdo, vá em Entra ID → Registros de aplicativos (App registrations) → Novo registro (New registration). 3. Nome: Dê um nome claro, por exemplo: Agente-IA-OpenClick. 4. Tipos de conta suportados: mantenha a opção padrão “Contas neste diretório organizacional apenas (padrão).” 5. Clique em Registrar (Register). Ao final, Copie imediatamente estes 3 IDs da tela "Visão geral": - ID do aplicativo (Client ID) ← Anote! - ID do diretório (Tenant ID) ← Anote! Crie o Client Secret: 1. No menu do app, clique Certificados e segredos (Certificates & secrets). 2. Novo segredo do cliente (Client secret) → Descrição: Agente-IA-OpenClick → Expiração: Coloque o máximo possível → Adicionar 3. Copie o Valor (não a Secret ID!) ← Anote imediatamente, pois some depois! Esses três dados serão usados mais tarde para gerar o token de acesso. Passo 3 – Dar permissão de leitura ao SharePoint Agora é preciso dizer quais dados o aplicativo pode ler. 1. No mesmo cadastro do aplicativo, vá em Permissões de API (API permissions). 2. Clique em Adicionar permissão (Add a permission) → escolha Microsoft Graph.​ 3. Escolha o tipo de permissão ( Application permissions). 4. Adicione as permissões: Sites.Read.All (ler sites e estruturas do SharePoint). Files.Read.All (ler conteúdo dos arquivos armazenados).​ 5. Clique em Adicionar permissões (Add permissions). 6. Peça para um administrador global clicar em Conceder consentimento de administrador (Grant admin consent) para a organização, aprovando essas permissões.​ Sem esse “consentimento do administrador”, a integração não consegue acessar os arquivos. Depois que o acesso for concedido pelo administrador global, veja que a coluna status ficará com o ícone verde e o status deve ficar "Concedido para [nome da Empresa]" em todas as permissões. Passo 4 – Localizar a biblioteca de documentos Quem faz: Time de TI. Para que o sistema saiba de onde puxar os arquivos, precisamos localizar: - O site do SharePoint (por exemplo, “Comercial”, “Projetos”, “Financeiro”).​ - A biblioteca de documentos dentro desse site (por exemplo, “Documentos”, “Contratos”, “Relatórios”).​ 1. Abra o site do SharePoint no navegador onde estão os arquivos (ex: https://suaempresa.sharepoint.com/sites/teste ). 2. Anote: nome do site e a biblioteca de documentos (ex: "teste"). Passo 5 – Localizar o Drive ID da biblioteca de documentos Quem faz: Time OpenClick Passo 7 – Enviar os 3 IDs e qual a biblioteca de documentos para nossa equipe Nos envie por e-mail: - Os 3 Ids obtidos - A URL de acesso do site do SharePoint no navegador onde estão os arquivos (ex: https://suaempresa.sharepoint.com/sites/teste ). Pronto! Com isso, testamos a conexão e treinamos o Agente de IA para ler seus documentos.

Última atualização em Jan 09, 2026

Relatório de Insights

O que são Insights? Insights são interpretações qualitativas obtidas a partir das interações dos usuários com a inteligência artificial. O objetivo é identificar padrões, comportamentos, intenções e sentimentos dos usuários, com foco em análise de conteúdo e contexto — e não em números. Ou seja, enquanto relatórios tradicionais trazem "o quê" aconteceu, os Insights ajudam a entender o "porquê". Diferença entre Insights e BI Muitos usuários confundem Insights com Business Intelligence (BI). Abaixo está uma tabela comparativa para esclarecer: Como funciona o assistente de Insights? O assistente de Insights funciona de forma assíncrona. Isso significa que o usuário não envia perguntas e obtém respostas em tempo real. Em vez disso, ele ajusta o prompt com o tipo de informação que deseja explorar, e o assistente processa os dados disponíveis ao longo do dia. Após a análise, o relatório com os Insights será gerado automaticamente dentro do período acordado (Diário, Semanal ou Mensal). A entrega do relatório ocorrerá no início do dia útil seguinte ao agendamento. Quando e onde o relatório ficará disponível? Você poderá acessar os Insights gerados na plataforma Clicksmart em: https://app.clicksmart.openclick.ai/ → Assistentes → Interação com o Assistente → Filtre pela data. Além disso, é possível agendar envios periódicos de relatórios conforme sua necessidade, como diário , semanal ou mensal. Exemplos do que pode ser configurado no assistente - "Quais temas mais preocupam os clientes hoje?" - "A IA está conseguindo responder bem sobre o tema X?" - "Os clientes demonstraram frustração ou confusão?" - "Que padrões de comportamento foram percebidos nas interações recentes?" - "Existe alguma mudança de sentimento nas últimas interações com a IA?" Esses tipos de perguntas permitem que o assistente analise intenções, sentimentos e padrões de conversa com profundidade. O que NÃO pedir ao assistente O assistente de Insights não deve ser utilizado para análises quantitativas. Evite perguntas como: - "Quantos tickets foram abertos ontem?" - "Qual foi o volume de interações em abril?" - "Quais os assuntos com maior número de menções?" Essas perguntas devem ser direcionadas a sistemas de BI ou relatórios operacionais. O assistente de Insights é voltado à análise qualitativa e interpretativa. Boas práticas de uso do assistente de IA - Formule perguntas abertas e investigativas, como: “O que está mudando no comportamento dos usuários?” - Evite usar termos como "traga a quantidade de..." ou "liste os mais citados...". - Use a ferramenta para orientar decisões estratégicas com base em sentimentos, temas recorrentes e dificuldades percebidas. - Combine, sempre que possível, os Insights com dados de BI para criar uma visão mais completa. Por que usar Insights no seu dia a dia? Os Insights são extremamente valiosos para equipes que buscam uma compreensão mais profunda do comportamento e das necessidades dos usuários. Eles ajudam a: - Descobrir dores ocultas dos clientes: Entender problemas que não são facilmente identificados em métricas quantitativas. - Identificar oportunidades de melhoria no atendimento: Detectar padrões de insatisfação ou confusão que podem ser corrigidos. - Ajustar conteúdos e treinamentos da IA: Com base em como os usuários realmente interagem com a IA. - Apoiar decisões estratégicas: Focando no comportamento real dos usuários, em vez de depender apenas de métricas. Como escrever boa regras Para que o assistente de Insights forneça resultados precisos, é essencial escrever regras bem estruturadas. Siga estas dicas: 1. Seja claro sobre o objetivo: Exemplo: "Quero entender se os clientes estão insatisfeitos com o novo processo." 2. Defina o contexto, se necessário: Exemplo: "Houve aumento na insatisfação dos usuários?" 3. Foques em aspectos qualitativos: Perguntas sobre sentimentos, percepções, padrões de comportamento ou feedbacks. Modelo de prompt: "Gostaria de entender [comportamento, sentimento ou padrão] relacionado a [tema específico] nas interações da última semana." FAQ (Perguntas Frequentes) Posso pedir mais de um tema no mesmo assistente? Sim, mas é ideal que o pedido esteja bem estruturado para que o assistente consiga interpretar corretamente e gerar resultados relevantes. O assistente lê interações antigas? Sim, desde que estejam dentro do período de análise definido.

Última atualização em Feb 20, 2026

Como configurar corretamente o Modelo de Prompt

Este manual explica como escrever instruções claras, previsíveis e seguras no campo editar o modelo de prompt do Clicksmart. O foco deste material não é ensinar IA, e sim ensinar como orientar o comportamento do assistente para que ele: - Não adivinhe intenções - Não misture assuntos - Não responda caminhos errados - Não gere respostas fora do esperado - Siga exatamente as regras do seu negócio Se o Modelo de Prompt estiver bem escrito, a IA responde bem. Se estiver ambíguo, a IA vai escolher um caminho por conta própria. Qual é a função do Modelo de Prompt no Clicksmart O modelo de prompt é o local onde você define as regras de decisão da IA. Ele não serve apenas para “dizer o que responder”, mas principalmente para definir: - Quando responder - O que perguntar antes de responder - Em quais situações NÃO responder direto - Como separar cenários parecidos - Como lidar com dúvidas incompletas do Humano Tudo o que a IA pode ou não pode fazer precisa estar explícito aqui. ⚠️ A IA não interpreta contexto implícito do seu negócio. Se algo não estiver escrito, ela não vai “deduzir corretamente”. Onde editar o Modelo de Prompt Para acessar o campo correto: 1. No menu lateral esquerdo, clique em Assistentes (Item 1) 2. Caso exista mais de um assistente configurado, utilize o campo Assistentes (Item 2) para selecionar o assistente desejado. 3. Após selecionar o assistente, clique nos 3 pontos, Editar Assistente, e clique na aba Configurações (Item 3) 4. Dentro da aba Configurações, localize o campo Editar modelo de prompt (Item 4). É neste campo que devem ser inseridas as instruções. Regra principal de escrita# Toda instrução deve seguir este formato lógico: Se o humano perguntar X, responda Y. Evite qualquer instrução que não deixe claro: - o gatilho (o que o Humano disse) - a ação esperada (o que a IA deve fazer) Sempre trate o usuário final como Humano No Modelo de Prompt, utilize exclusivamente o termo: ✔ Humano Não use: - Cliente - Usuário - Pessoa O Clicksmart trabalha com o conceito de Humano, e a padronização evita conflitos de interpretação. Nunca escreva instruções negativas Evite frases como: Nunca faça isso. Não responda aquilo. Evite falar sobre X. A IA não lida bem com negações abstratas. Sempre escreva dizendo o que deve ser feito, por exemplo: Se o Humano perguntar sobre X, responda com: Se algo não deve ser respondido, explique qual é a resposta correta naquele cenário, e não o que deve ser evitado. Organização por Tópicos (Estrutura Modular) Nunca escreva um Modelo de Prompt como texto corrido. Use Markdown para separar claramente os temas. Exemplo de estrutura correta: ## ACESSOS ### ACESSO AO WORDPRESS Se o Humano informar que está com dificuldade de acesso ao WordPress, responda: Regras de hierarquia - Nunca use # - Sempre comece em ## - Subtópicos usam ### - Títulos sempre em CAIXA ALTA Essa hierarquia ajuda a IA a decidir em qual bloco procurar a resposta. Por que usar Markdown no Modelo de Prompt A IA interpreta melhor quando o conteúdo está organizado por hierarquia. Benefícios: - Reduz ambiguidade - Organiza contexto - Melhora precisão de resposta - Evita misturar assuntos O Markdown atua como estrutura lógica para a IA. Boas Práticas de Markdown Títulos Correto: ## ACESSOS Errado: ##ACESSOS Sempre use espaço após ## ou ###. Parágrafos - Não usar recuo - Não usar tabulação - Sempre separar blocos com linha em branco Negrito e itálico - Negrito: **texto** - Itálico: *texto* Use com moderação. Excesso atrapalha mais do que ajuda. Linhas Horizontais --- Se o Humano... Evite usar --- se não houver espaçamento correto. Pode gerar conflito com títulos. Uso Correto de Aspas Quando usar aspas simples ' Use aspas simples quando quiser que a IA responda exatamente o texto informado. Exemplo: Se o Humano perguntar sobre seu nome, responda: 'Olá, meu nome é Assistente da Empresa.' A resposta será idêntica, sem variações. Quando NÃO usar aspas Sem aspas, a IA pode formular a resposta com base na instrução. Exemplo: Se o humano perguntar sobre horário de atendimento, informe o horário comercial da empresa. Como evitar respostas inventadas Nunca escreva instruções como: Consulte o artigo Busque no site Verifique no Google A IA não executa ações externas. Se uma informação for necessária: - Copie o conteúdo essencial para o Modelo de Prompt - Ou informe diretamente o Humano Exemplo: Se o Humano perguntar sobre X, responda 'A informação X pode ser obtida através do link www.linkfornecido.com.br' Como Reduzir Linhas Desnecessárias Evite criar várias regras para o mesmo problema. Em vez de: Se o Humano informar erro. Se o Humano informar que não funciona. Se o Humano informar que não acessa. Use: Se o Humano informar dificuldade, erro ou falha de acesso ao WordPress, responda: Isso reduz conflito entre instruções. Separe corretamente os grandes temas Organize o Modelo de Prompt por blocos claros: ## ACESSOS ## PLANOS ## FINANCEIRO ## CANCELAMENTO ## DOMÍNIOS Dentro de cada bloco, detalhe os cenários: ### CENÁRIO ESPECÍFICO Nunca misture assuntos diferentes no mesmo bloco. Modelo recomendado de escrita ## ACESSOS ### ACESSO AO WORDPRESS Se o Humano informar dificuldade de acesso ao WordPress, responda: 'Você já verificou se o domínio está apontado corretamente para sua hospedagem?' Dica prática: escreva prompts em ferramentas de validação de makrdown Recomendamos usar o editor: 👉 https://stackedit.io/app# Ele facilita a escrita em Markdown porque permite visualizar em tempo real como o conteúdo será estruturado e interpretado, reduzindo erros de formatação que podem passar despercebidos ao escrever diretamente no campo do Clicksmart. Como o Prompt depende de organização clara, hierarquia correta de títulos e espaçamentos adequados, o StackEdit ajuda a validar esses elementos antes da publicação, garantindo que o texto esteja bem estruturado, mais legível e preparado para que a IA interprete as instruções com maior precisão e menor risco de ambiguidades. Como utilizar o StackEdit 1. Acesse https://stackedit.io/app# 2. Escreva seu conteúdo no painel esquerdo (Item 1) 3. Visualize a estrutura no painel direito 4. Ajuste títulos (##, ###) 5. Revise espaçamentos (Item 2) 6. Copie o conteúdo validado 7. Cole no campo Editar modelo de prompt no Clicksmart Erros mais comuns Evite: - Texto corrido sem tópicos - Títulos fora de hierarquia - Instruções vagas - Frases negativas - Repetição de regras - Linguagem ambígua - Orientar ações que a IA não pode executar Checklist final antes de publicar - ( ) Cada regra começa com “Se o Humano…” - ( ) Os assuntos estão bem separados - ( ) Não existem instruções contraditórias - ( ) O termo Humano foi usado corretamente - ( ) Não há dependência de contexto externo - ( ) As respostas são objetivas e previsíveis Glossário Modelo de Prompt Conjunto de regras que define como a IA deve decidir, perguntar e responder. Markdown Estrutura de organização textual usada para separar regras e contextos. Resposta inventada (alucinação) Quando a IA tenta responder sem ter uma regra clara definida. Categorias - Clicksmart - Configuração de Assistente - Modelo de Prompt - Boas Práticas - Markdown - Inteligência Artificial A#

Última atualização em Mar 06, 2026

Como integrar um agente de IA no Microsoft Teams

Este artigo descreve, passo a passo, como integrar um Agente de IA para operar dentro do Microsoft Teams, utilizando o Azure Active Directory, o Azure Bot Service e um backend próprio para processamento de mensagens. Pré-requisitos Antes de iniciar, é necessário: - Conta corporativa Microsoft (Microsoft 365) - Permissão para criar recursos no Azure - Acesso ao Microsoft Teams - Permissão para upload de aplicativos customizados no Teams (ou acesso ao Admin Center) - Um Agente de IA ja contratado Visão geral do funcionamento A integração do agente de IA com o Microsoft Teams funciona por meio do Azure Bot Service, que atua como intermediário entre o Teams e o backend do agente. Fluxo de comunicação: Usuário no Microsoft Teams → Microsoft Teams → Azure Bot Service → Backend do agente de IA O Azure Bot é responsável apenas pelo transporte das mensagens. Toda a lógica de IA, regras de negócio e integrações externas devem ser executadas no backend. Criar a Application no Azure Active Directory A Application representa a identidade do agente de IA dentro do ambiente Microsoft. Acesso https://portal.azure.com Procedimento 1. Acesse o Azure Portal 2. Entre em Azure Active Directory 3. Selecione App registrations 4. Clique em New registration Configuração - Name: nome identificador do agente (exemplo: IA-Teams) - Supported account types: Accounts in this organizational directory only - Redirect URI: não configurar Após a criação, anote as seguintes informações: - Application (client) ID - Directory (tenant) ID Esses dados serão utilizados nas etapas seguintes. Criar o Client Secret da Application O Client Secret será utilizado para autenticar o Azure Bot como essa Application. Caminho Azure Active Directory → App registrations → [Application criada] → Certificates & secrets Procedimento 1. Clique em New client secret 2. Defina uma descrição 3. Escolha o prazo de validade 4. Clique em Add Anote o valor do secret em local seguro. Esse valor não poderá ser recuperado posteriormente. Criar o Azure Bot O Azure Bot é o recurso responsável por conectar o Microsoft Teams ao backend do agente de IA. Acesso https://portal.azure.com/#create/Microsoft.AzureBot Procedimento 1. No Azure Portal, clique em Create a resource 2. Pesquise por Azure Bot 3. Clique em Create Configuração - Bot handle: nome interno do bot - Subscription: assinatura Azure - Resource Group: grupo de recursos desejado - Pricing tier: - Type of App: Existing Microsoft App - Microsoft App ID: Application (client) ID - Microsoft App Password: Client Secret Finalize a criação do recurso. Habilitar o canal Microsoft Teams Após a criação do Azure Bot, é necessário habilitar o canal do Microsoft Teams. Caminho Azure Bot → Channels Procedimento 1. Acesse o recurso do Azure Bot 2. Clique em Channels 3. Selecione Microsoft Teams 4. Salve a configuração A partir desse momento, o bot passa a aceitar mensagens originadas do Teams. Configurar o endpoint do agente de IA O Azure Bot apenas encaminha mensagens para um endpoint configurado. - Solicite o endpoint para nosso time! Configuração no Azure Bot Caminho: Azure Bot → Settings Procedimento: 1. Informar o endereço no campo Messaging endpoint 2. Salvar as alterações Criar o aplicativo do Microsoft Teams (manifest) Para que o agente apareça no Microsoft Teams, é necessário criar um aplicativo do Teams. Documentação oficial https://learn.microsoft.com/microsoftteams/platform/concepts/build-and-test/apps-package Estrutura mínima do pacote teams-app/ ├─ manifest.json ├─ color.png (192x192) └─ outline.png (32x32) O arquivo manifest.json define: - Identidade do aplicativo - Bot associado - Escopos de uso (chat privado, grupo e canal) - Permissões necessárias Publicar o aplicativo no Microsoft Teams Publicação em produção - Via Teams Admin Center https://dev.teams.microsoft.com/apps - Ou submissão para a Microsoft Teams Store - Disponibilidade do endpoint HTTPS Considerações finais Seguindo este procedimento, o agente de IA passa a operar integrado ao Microsoft Teams, utilizando identidade corporativa, canal oficial de comunicação e backend próprio para processamento inteligente das mensagens.

Última atualização em Feb 20, 2026

Criando a chave de acesso ao Google Drive

Para a IA poder ser treinada com o conteúdo disponível no Google Drive, é necessário gerar a chave de acesso e para isso basta seguir os passos abaixo. 1. Criar uma Conta no Google Cloud 1. Acesse: Google Cloud 2. Clique em Começar gratuitamente e siga as instruções para criar sua conta. 3. Adicione um método de pagamento (o Google oferece créditos gratuitos para novos usuários). 4. Acesse o Google Cloud Console. 2. Criar um Projeto no Google Cloud 1. No topo da página, clique My First Project. 2. Clique em Novo projeto. 3. Escolha um nome para o projeto. 4. Mude o ID do projeto (Se desejável)  5. Escolha uma Organização (Se necessário) e clique em Criar. 6. Aguarde alguns segundos até que o projeto seja criado. Mais informações: Criar e gerenciar projetos 3. Ativar a API do Google Drive 1. No menu lateral esquerdo, clique em APIs e Serviços. 2. Clique em ATIVAR APIS E SERVIÇOS. 3. Pesquise por Google Drive API e clique nela. 4. Clique no botão Ativar. Acesse a Biblioteca de APIs do Google Drive. 4. Criar Credenciais e Conta de Serviço Após ativar a API, clique no botão Criar credenciais que aparece no canto superior direito. 1. Clique em Dados do Aplicativo e clique em Próxima. 2. Preencha o Nome da conta de serviço e uma Descrição da conta de serviço (opcional). 3. Clique em Criar e continuar. 4. Em Conceda a essa conta de serviço acesso ao projeto, clique em Selecionar papel. 5. Em Acesso Rápido, escolha Básico e depois escolha o papel Editor para permitir que a conta gerencie arquivos no Google Drive. 6. Clique em Continuar e depois em Concluir. Mais informações: Contas de serviço Mais informações: Papéis e permissões do IAM 5. Criar e Baixar a Chave JSON Vá até a aba "Credenciais" no menu esquerdo do Google Cloud Console. Em seguida: 1. Em Contas de serviço, clique no e-mail da conta de serviço que você criou. 2. Acesse a aba "Chaves". 3. Clique em "Adicionar chave" > "Criar nova chave". 4. Selecione o formato JSON e clique em "Criar". 5. Escolha a pasta onde deseja salvar o arquivo e clique em Salvar 6. O download do arquivo .json será iniciado automaticamente. Mais informações: Criar e excluir chaves Nota! Pode usar o Bloco de Notas para verificar a chave recém criada, clicando com o botão direito do mouse sobre o arquivo > Abrir com > Bloco de Notas. 6. Conceder Acesso à Pasta do Google Drive 1. Na tela CHAVES no Goolgle Cloud, clique em DETALHES e copie o  e-mail da conta de serviço 2. Acesse o Google Drive. 3. Encontre a pasta que deseja compartilhar e clique com o botão direito nela. 4. Selecione Compartilhar > Compartilhar. 5. No campo "Adicionar participantes, grupos e eventos da agenda", cole o e-mail da conta de serviço que foi criada. 6. Altere a permissão para Editor. 7. Clique em "Enviar". Conclusão Seguindo esses passos, você terá configurado sua conta de serviço no Google Cloud e gerado uma chave JSON para acessar uma pasta no Google Drive via API. Se precisar de ajuda adicional, consulte a Central de Ajuda do Google Cloud.

Última atualização em Mar 20, 2026