IAra — Agente de IA

O que é o Agente de IA da IAra

Use este guia quando você precisar configurar, entender ou validar O que é o Agente de IA da IAra na IAra. Antes de começar na IAra Na tela: Use o Playground para testar o comportamento antes de liberar o assistente no atendimento real. Playground. - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Na tela: A área de FAQs concentra perguntas e respostas que ajudam a IA a responder com mais precisão. FAQs. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como criar um assistente

Use este guia quando você precisar configurar, entender ou validar Como criar um assistente na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado O Assistant in IAra foi criado para ajudar a responder perguntas dos clientes, fornecer soluções e auxiliar em problemas relacionados ao produto. Ele aprende com os artigos da sua central de ajuda e conversas anteriores para fornecer respostas precisas. Quando vinculado a uma caixa de entrada, ele pode lidar com conversas diretamente com seus clientes. Como criar um assistente na IAra? Na tela: Comece criando a base do assistente e conferindo as FAQs que ele poderá consultar. assistente. Se estiver usando um plano pago na IAra Cloud, você encontrará o menu IAra na barra lateral esquerda. Neste menu, você verá opções para assistentes, documentos e perguntas frequentes. Clique em Assistentes. Você verá uma página como a abaixo. Clique no botão Criar um novo assistente. Aqui estão os campos atualmente disponíveis no formulário para criar um assistente: | Nome do campo | Descrição | Padrão | Obrigatório | | -- | -- | -- | --| | Nome do assistente | Este é o nome interno do assistente | -- | Sim | | Descrição | Forneça uma descrição do assistente sobre o que ele faz. Nota: Esta não é uma instrução para o assistente | -- | Sim | | Nome do produto | Isto é importante. O assistente é construído em torno do produto, ter o nome do produto o ajudaria a identificar as lacunas de conteúdo e as dúvidas do usuário | -- | Sim | | Recursos: Habilite perguntas frequentes de conversas resolvidas | Se você ativar esta opção, a IAra Assistant tentará identificar as lacunas no artigo da sua central de ajuda e sugerirá novas FAQs, consulte o documento FAQ para obter mais informações | falso | Não | | Recursos: Capture detalhes importantes como memórias de interações com a pessoa atendida | Se habilitado, isso tentaria identificar os principais detalhes das conversas e os salvaria nas notas | falso | Não | Depois de inserir os detalhes, clique em Criar e seu assistente será adicionado à sua conta! Você pode criar vários assistentes para lidar com diferentes casos de uso, se necessário. Como você conecta um assistente às caixas de entrada? Adicionar um assistente à sua conta não o conecta automaticamente a todas as caixas de entrada. Você precisará vincular manualmente cada assistente às caixas de entrada relevantes onde for necessário. Isso lhe dá flexibilidade para atribuir assistentes com base em produtos ou segmentos de clientes específicos. Para conectar um assistente, clique no menu de três pontos próximo aos detalhes do assistente. No menu suspenso, selecione Exibir caixas de entrada conectadas. Isso o levará a uma página que exibe todas as caixas de entrada vinculadas ao assistente. A partir daí, você pode gerenciar as conexões. Observação: cada caixa de entrada só pode ser conectada a um assistente por vez. Clique em Conectar uma nova caixa de entrada para ver uma lista de caixas de entrada disponíveis. Selecione uma caixa de entrada da lista e conecte-a. É isso! O assistente agora está ativo na caixa de entrada. Experimente: envie uma mensagem no seu chat e veja se ela responde com a saudação inicial. Você pode implantar o assistente em qualquer caixa de entrada disponível, seja chat ao vivo, WhatsApp, Instagram, e-mail ou mais. Ótimo! O assistente foi configurado com sucesso. Porém, nesta fase, ele não tem nenhum conhecimento sobre o seu negócio e o produto. Após a saudação inicial, o assistente tentará transferir a conversa para um agente. Para fornecer contexto ao assistente sobre o seu produto, você pode adicionar documentos. Saiba mais sobre documentos em [este artigo]. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como escrever instruções para o assistente

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Como escrever instruções para o assistente na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como adicionar documentos

Use este guia quando você precisar configurar, entender ou validar Como adicionar documentos na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Um documento na IAra atua como um recurso de conhecimento para o assistente. Ao vincular sua central de ajuda ou guias, a IAra pode analisar o conteúdo e ajudar de forma eficaz nas dúvidas dos clientes. Atualmente, oferecemos suporte a URLs de sites e arquivos PDF como fontes, mas planejamos expandir isso para incluir documentos do Notion no futuro. Como criar um documento? No menu da barra lateral, clique na opção Documentos em IAra. Você verá uma página como a abaixo. Na tela: Abra Documentos para adicionar URLs públicas ou arquivos que a IA deve consultar. documentos. Como posso verificar se o conteúdo foi analisado corretamente? Para garantir que o conteúdo seja analisado corretamente, a IAra analisa os documentos fornecidos para identificar possíveis dúvidas. Em seguida, gera uma lista de perguntas frequentes relacionadas ao documento. Ao revisar essas perguntas frequentes, você pode verificar se o conteúdo foi processado com precisão e interpretado corretamente. Você pode visualizar as FAQs geradas para cada documento. Basta clicar no menu de três pontos no documento e escolher Visualizar Respostas relacionadas para acessá-las. Na tela: Depois de criar o documento, acompanhe se ele aparece na lista e se foi processado corretamente. documento processado. Isso exibirá as perguntas frequentes relacionadas, conforme mostrado abaixo. Limite de uso Se você não assinou um complemento pago da IAra, o número de documentos que você pode adicionar será limitado. Com o plano Startups você pode adicionar até 100 documentos gratuitamente. Para planos superiores, o limite aumenta para 200 documentos gratuitos no plano Business e 300 documentos gratuitos no plano Enterprise. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como criar FAQs

Use este guia quando você precisar configurar, entender ou validar Como criar FAQs na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado FAQs (Perguntas Frequentes) são uma coleção de perguntas comuns e suas respostas, projetadas para fornecer assistência rápida e fácil aos clientes. A IAra usa essas perguntas frequentes para responder às dúvidas dos clientes com eficiência, garantindo o fornecimento de informações precisas e consistentes. Na tela: Clique em Criar nova FAQ para adicionar uma pergunta e resposta à base da IA. criar FAQ. Como as FAQs são geradas? As perguntas frequentes são geradas de duas maneiras: Automaticamente: a IAra analisa os artigos da sua central de ajuda e resolve conversas com clientes para identificar lacunas de conteúdo ou tópicos frequentes. Com base nesta análise, sugere perguntas frequentes. Manualmente: você pode criar perguntas frequentes diretamente navegando até a seção Perguntas frequentes, clicando em “Adicionar novo”, inserindo a pergunta e a resposta e atribuindo-as ao assistente. Como você pode adicionar um FAQ manualmente? Vá para a seção de perguntas frequentes na barra lateral em IAra. Se as perguntas frequentes já tiverem sido geradas a partir dos seus documentos, você as verá listadas aqui. Caso contrário, a página aparecerá conforme mostrado abaixo. Clique em “Criar Novo FAQ” para adicionar uma pergunta e sua resposta correspondente, conforme mostrado abaixo. Selecione o assistente e clique em “Criar”. O FAQ agora estará pronto para uso em conversas. Como você verifica as perguntas frequentes geradas nas conversas? Ao final de cada conversa, a IAra analisa as interações para identificar possíveis lacunas ou dúvidas recorrentes que ainda não foram abordadas em sua base de conhecimento. Com base nesta análise, sugere novos tópicos como FAQs para ajudar a melhorar a cobertura do seu conteúdo. Essas perguntas frequentes sugeridas são adicionadas à lista “Pendentes” na seção Perguntas frequentes, onde você pode revisá-las. Para revisar as perguntas frequentes sugeridas, acesse as páginas de perguntas frequentes e aplique o filtro "Pendente". Revise as perguntas sugeridas com atenção. Se uma pergunta for relevante e útil, clique no menu de três pontos e selecione a opção para marcá-la como aprovada. Você também pode editar a resposta sugerida para garantir que ela seja precisa e adequada à sua base de conhecimento antes de aprovar o FAQ. Você também pode visualizar a conversa a partir da qual a pergunta foi gerada. Se você não tiver certeza sobre a relevância de uma pergunta sugerida, basta clicar no ID da conversa para revisar a interação antes de decidir se deseja aprovar o FAQ. A revisão regular dessas sugestões ajuda a manter sua base de conhecimento precisa, atualizada e alinhada com a evolução das necessidades de seus clientes. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como testar a IA antes de ativar

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Como testar a IA antes de ativar na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. Na tela: No Playground, simule perguntas reais antes de ativar a IA para a equipe. teste no Playground. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como revisar respostas da IA

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Como revisar respostas da IA na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como configurar transferência para humano

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Como configurar transferência para humano na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como funcionam créditos de IA

Use este guia quando você precisar configurar, entender ou validar Como funcionam créditos de IA na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado Este guia explica como os créditos de IA são consumidos, como seus créditos são atualizados quando você recarrega, quando ocorre sua renovação mensal, o que acontece quando você muda de plano e como funcionam as notificações se seus créditos acabarem. Como os créditos de IA são consumidos? Os créditos de IA são deduzidos sempre que uma ação de IA é executada. Os exemplos incluem: - Respostas do assistente de IA assistente - Pesquisas de copiloto - Ações do editor (reformular, resumir, sugerir uma resposta) - Sugestões de etiquetas - Qualquer fluxo de trabalho ou automação que acione uma chamada de modelo - Transcrição de áudio Diferentes modelos consomem créditos a taxas diferentes. No momento, todas as ações consomem 1 crédito por mensagem, já que apenas uma configuração de modelo fixo é compatível. Isto mudará no futuro à medida que mais opções de modelos forem suportadas, altura em que diferentes modelos poderão consumir diferentes montantes de crédito por ação. Se uma ação não puder ser concluída devido a créditos insuficientes, ocorre uma falha de crédito (explicada mais adiante). Quando o uso é reiniciado? O uso é redefinido para 0 somente durante a renovação mensal. O uso NÃO é redefinido quando: - Recarregando créditos *Mudando seu plano - Alteração da contagem de assentos Isso significa que você pode recarregar créditos a qualquer momento sem perder o controle do seu ciclo de uso atual. Como os créditos de IA são atualizados? 1. Recarregando Créditos Quando você compra créditos adicionais, eles são simplesmente adicionados ao seu saldo existente. Exemplo *Créditos anteriores: 1500 - Recarga: 1000 - Novos créditos totais: 2.500 Nenhum outro valor muda. 2. Renovação Mensal Cada plano inclui uma concessão de crédito mensal gratuita. Na renovação, ajustamos o uso e os créditos com base em quanto você consumiu no mês anterior. Caso A: Sem uso Uso: 0 → Seu total de créditos não muda. Caso B: o uso é menor que seus créditos gratuitos mensais *Créditos anteriores: 1500 - Uso: 200 - Créditos mensais gratuitos: 300 → Nenhuma dedução é aplicada. → O total de créditos fica em 1.500. → O uso é redefinido para 0. Caso C: o uso excede seus créditos mensais gratuitos *Créditos anteriores: 1500 - Uso: 600 - Créditos mensais gratuitos: 500 Excedente = 600 − 500 = 100 → Deduzir o excedente do total de créditos. → Novos créditos totais: 1400 → O uso é redefinido para 0. 3. Alterando seu plano Quando você muda de plano, seus créditos mensais gratuitos podem aumentar ou diminuir. Exemplo - Plano inicial: 300 créditos grátis - Plano de negócios: 500 créditos grátis - Plano empresarial: 800 créditos grátis Se você mudar de Startups para Business, seu total de créditos aumentará em 200. Da mesma forma, se você mudar de Business para Startups, seu total de créditos diminuirá em 200. Seu uso permanece inalterado. Falha de crédito (manuseio de crédito insuficiente) Uma falha de crédito ocorre quando uma ação de IA é acionada, mas não há créditos suficientes para executá-la. O que acontece durante a falha de crédito - A ação não foi executada. Quaisquer fallbacks disponíveis são executados — por exemplo, se o assistente não puder responder, a conversa é transferida diretamente para um agente. - Registramos a ação com falha internamente para auditoria Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como usar o Copilot da IAra

Use este guia quando você precisar configurar, entender ou validar Como usar o Copilot da IAra na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado A IAra Copilot foi projetado para ajudar os agentes de suporte a trabalhar de maneira mais inteligente, fornecendo sugestões e insights úteis diretamente do seu painel. Aqui está um guia para ajudá-lo a aproveitar ao máximo a IAra Copilot. Onde encontrar o copiloto? Para começar, certifique-se de que a IAra Copilot esteja ativado em sua caixa de entrada. Abra seu painel e vá para a tela de conversa. No lado direito, você verá a guia Copilot ao lado das opções de contato. Clique na aba Copilot para acessar e começar a usar seus recursos. Como funciona o Copilot? Copilot é uma ferramenta que pode melhorar a comunicação de várias maneiras. Ele pode analisar a conversa atual e redigir uma resposta apropriada ou até mesmo traduzir uma mensagem para outro idioma, garantindo que o tom e o contexto permaneçam intactos. Além disso, o Copilot pode revisar o tom de uma conversa, identificar áreas de melhoria e sugerir ajustes para se alinhar melhor à voz e aos valores da sua marca. Para melhorar ainda mais a experiência, o Copilot também pode encontrar artigos ou recursos relevantes relacionados à conversa atual, oferecendo acesso rápido a informações que apoiam suas respostas. Com sua capacidade de preencher lacunas de comunicação, refinar o tom e fornecer insights acionáveis. Como usar o copiloto? Basta digitar sua solicitação em linguagem natural e a IAra irá analisá-la para fornecer a melhor resposta. Você pode usá-lo para redigir respostas, traduzir mensagens ou melhorar o tom. Para melhores resultados, deixe suas solicitações claras e específicas. Por exemplo, em vez de dizer “Ajude com esta resposta”, tente “Escreva uma resposta educada explicando o atraso e oferecendo um novo cronograma.” A IAra usa o conhecimento de seus documentos para elaborar respostas precisas e relevantes. Aqui está um exemplo rápido que mostra como redigir a resposta. Quando a IAra sugerir uma resposta, clique em “Usar isto” para adicioná-la diretamente à sua janela de mensagem. Dicas adicionais para uso eficaz - Sempre revise as sugestões do Copilot antes de enviá-las para garantir que estejam alinhadas com o tom e as diretrizes da sua equipe. - Utilize as recomendações do Copilot para preencher eventuais lacunas na comunicação com a pessoa atendida, como adicionar instruções mais detalhadas ou esclarecer pontos ambíguos. - Incentive sua equipe a explorar e utilizar o Copilot regularmente para uma colaboração mais tranquila e melhores interações com os clientes. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como usar memórias da IAra

Use este guia quando você precisar configurar, entender ou validar Como usar memórias da IAra na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado IAra Memories são informações salvas de conversas com clientes para fornecer contexto para interações futuras. Essas memórias permitem respostas personalizadas, eficientes e conscientes do contexto. Por exemplo, se um cliente mencionar que tem uma equipe de 18 pessoas ou compartilhar preferências específicas, a IAra armazenará essas informações. Isso permite que sua equipe use esses insights durante conversas futuras para aprimorar a experiência do cliente. Que tipo de informação o assistente de IA salva? A IAra foi projetado para salvar detalhes compartilhados pelos clientes que sejam relevantes para fornecer suporte personalizado. Isso pode incluir: • Preferências do cliente (por exemplo, estilo de comunicação preferido ou preferências de produto). • Dúvidas e problemas recorrentes (por exemplo, “Como faço para gerenciar usuários no painel?”). • Requisitos exclusivos (por exemplo, “Nossa equipe usa o Plano Enterprise e precisa de uma API para integrações.”). • Contexto operacional (por exemplo, “Nossa equipe é composta por 18 membros”). Esses detalhes são salvos automaticamente como notas no perfil do cliente, tornando-os facilmente acessíveis para referência futura. Onde posso ver uma memória gerada pelo assistente de IA? As memórias geradas pelo assistente de IA são armazenadas na seção Notas do painel do cliente, vinculadas diretamente ao cliente relevante. Isso garante que sua equipe possa acessá-los a qualquer momento durante as conversas. Como visualizar memórias: 1. Abra o perfil do cliente no painel. 2. Vá para a seção Notas, onde todas as memórias salvas são organizadas com carimbos de data e hora e contexto para fácil referência. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como atualizar robots.txt para permitir leitura do site pela IAra

Use este guia quando você precisar configurar, entender ou validar Como atualizar robots.txt para permitir leitura do site pela IAra na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado IAra usa o Firecrawl internamente para buscar e indexar o conteúdo do seu site. Isso permite que a IAra Assistant responda perguntas usando as informações do seu site. No entanto, se o robots.txt do seu site tiver regras Disallow, o Firecrawl irá respeitá-las e pular o rastreamento dessas páginas. Na tela: Depois de liberar a leitura do site, confira em Documentos se a fonte foi adicionada corretamente. documentos. Quando isso acontecer: - Nenhum documento do seu site será adicionado a IAra - O Assistente não receberá nenhum contexto adicional - As respostas podem ficar incompletas ou genéricas Para garantir que o Assistente funcione corretamente, você precisa permitir que o Firecrawl rastreie seu site. Etapa 1: verifique seu robots.txt Visite: https://seudominio.com/robots.txt Procure por entradas Disallow: que possam bloquear agentes de usuário. Etapa 2: adicionar uma regra de permissão para Firecrawl Peça ao administrador ou desenvolvedor do seu site para adicionar as seguintes linhas ao arquivo robots.txt: Agente do usuário: FirecrawlAgent Permitir: / Isso informa ao Firecrawl que é permitido rastrear todo o seu site, mesmo que outros bots sejam restritos. Etapa 3: salvar e publicar Depois de atualizar o robots.txt, certifique-se de que o arquivo esteja implantado e acessível publicamente. Você pode verificar visitando: https://seudominio.com/robots.txt e verificando se as novas regras aparecem. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como configurar ferramentas personalizadas da IAra

Use este guia quando você precisar configurar, entender ou validar Como configurar ferramentas personalizadas da IAra na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado As ferramentas personalizadas permitem que a IAra chame suas APIs externas durante as conversas — para que ele possa verificar o status da garantia, verificar a cobertura do serviço ou buscar dados de seus próprios serviços sem entregá-los a um agente humano. Quando um cliente faz uma pergunta, a IAra extrai os valores relevantes da conversa, insere-os na sua solicitação de API e usa a resposta para formar sua resposta. As ferramentas personalizadas estão disponíveis no plano Business e superiores. Criando uma ferramenta Navegue até IAra -> Ferramentas e clique em Criar uma nova ferramenta.\ Na tela: As ferramentas do assistente ficam na área de Ferramentas do Capitão. ferramentas. Nome da ferramenta — Um nome curto como "Pesquisa de garantia" ou "Verificação da área de serviço" (máximo de 55 caracteres). Descrição — Diga a IAra quando usar esta ferramenta. Este é o campo mais importante. Escreva como se estivesse informando um agente de suporte: “Verifica o status da garantia de um produto pelo número de série”. Descrições vagas como "API de garantia" farão com que a IAra perca oportunidades de usar a ferramenta. Método — Escolha GET (para buscar dados) ou POST (para enviar dados). URL do terminal — o URL da sua API. Use {{ nome_do_parâmetro }} para inserir valores extraídos da conversa: https://api.suaempresa.com/v1/warranty/{{ serial_number }} A URL deve usar HTTPS, deve ser um nome de host (não um endereço IP) e não pode apontar para localhost ou redes privadas. Autenticação — Escolha como sua API autentica solicitações: - Nenhum — Sem autenticação - Bearer Token — Envia seu token no cabeçalho Authorization - Autenticação Básica — Envia um nome de usuário e senha - API Key — Envia um nome e valor de cabeçalho personalizado (por exemplo, X-API-Key) As credenciais de autenticação só são visíveis para administradores de conta. Parâmetros — Defina o que a IAra deve extrair da mensagem do cliente. Cada parâmetro precisa de um nome, tipo e descrição. Por exemplo: serial_number (String) — "O número de série do produto, encontrado na parte traseira do dispositivo." Modelo de solicitação (somente POST) — Um modelo de corpo JSON usando sintaxe Liquid. Modelo de resposta — Controla o que a IAra vê na resposta da sua API. Se deixado em branco, a IAra recebe o JSON bruto. Use Liquid para extrair campos relevantes, por exemplo: Serial {{response.serial_number }}: {{response.warranty_status }}. Expira em: {{response.expiry_date}}. Use response para acessar o corpo JSON analisado. Os modelos de resposta ajudam a IAra a se concentrar nos dados relevantes e a evitar campos internos, como IDs de banco de dados ou informações de depuração. Testando sua ferramenta Clique em Testar conexão antes de salvar para verificar se seu endpoint está acessível. O teste relata o código de status HTTP.\ Se o teste falhar, verifique o seguinte: - 401 Unauthorized — Suas credenciais de autenticação estão incorretas. Verifique novamente seu token de portador, chave de API ou nome de usuário/senha. - 403 Proibido — Sua API está rejeitando a solicitação. Se você precisar de verificação de identidade, observe que as solicitações de teste não incluem cabeçalhos de contato. - 404 Not Found — O URL do endpoint está errado. Verifique o caminho e certifique-se de que sua API esteja em execução. - Tempo limite — Sua API demorou muito para responder. As ferramentas personalizadas têm um tempo limite de 30 segundos; certifique-se de que seu endpoint responda nessa janela Contexto enviado com cada chamada de ferramenta Quando a IAra chama sua API, ele inclui cabeçalhos de metadados para que seu backend conheça o contexto: - X-IAra-Account-Id — ID da sua conta - X-IAra-Conversa-Id — O ID da conversa - X-IAra-Contact-Email — O e-mail do cliente (se disponível) - X-IAra-Contact-Caixa de entrada-Verified — Se a identidade do cliente foi verificada pelo HMAC - X-IAra-Assistant-Id — O assistente do assistente de IA fazendo a ligação - X-IAra-Tool-Slug — O identificador interno da ferramenta - X-IAra-Contact-Id — O ID de contato do cliente - X-IAra-Contact-Phone — O número de telefone do cliente (se disponível) - X-IAra-Conversa-Display-Id — O número de exibição da conversa Você pode usar esses cabeçalhos para procurar a pessoa atendida em seu próprio sistema, registrar quais conversas acionaram chamadas de API e verificar a autenticidade da solicitação. Segurança Proteções integradas: *Todos os endpoints devem usar HTTPS - Solicitações para intervalos de IP privados, localhost e domínios .local são bloqueadas - Redirecionamentos HTTP não são seguidos - As respostas são limitadas a 1 MB - As credenciais de autenticação são visíveis apenas para administradores Verificação de identidade: se sua ferramenta retornar dados específicos do cliente (pedidos, faturamento, detalhes da conta), sua API deverá verificar o cabeçalho X-IAra-Contact-Caixa de entrada-Verified. Sem a verificação HMAC habilitada em sua caixa de entrada, um visitante pode definir qualquer endereço de e-mail no widget de chat. Retorne dados confidenciais apenas quando este cabeçalho for true. Para ferramentas que retornam dados públicos esta verificação não é necessária. Injeção de prompt: se sua API retornar conteúdo gerado pelo usuário (avaliações, postagens em fóruns), textos maliciosos poderão influenciar o comportamento da IAra. Use modelos de resposta para extrair apenas campos estruturados e limpar o conteúdo da sua API. Limites - Máximo de ferramentas por conta — 15 - Recomendado — 10 ou menos. Um aviso aparece acima de 10; mais ferramentas tornam mais difícil para a IAra escolher a ferramenta certa. - Comprimento do nome da ferramenta — 55 caracteres - Tamanho da resposta — 1 MB no máximo - Tempo limite da solicitação — 30 segundos Quando usar ferramentas personalizadas As ferramentas personalizadas são mais adequadas para pesquisas estruturadas com entradas previsíveis – verificando o status do sistema, buscando programações ou procurando registros por ID. Se você já tem uma integraçãa IAra dedicada para seu caso de uso (por exemplo, Shopify para comércio eletrônico), use-a - integrações dedicadas lidam com pesquisa, correspondência difusa e sincronização de dados de forma mais confiável do que uma única chamada de API. Exemplos Pesquisa de garantia Quando um cliente pergunta se seu produto ainda está na garantia, a IAra pode verificar usando o número de série. - Nome da ferramenta: Pesquisa de garantia - Descrição: Verifica o status da garantia de um produto pelo seu número de série. Use quando um cliente perguntar se seu produto está coberto, quando a garantia expira ou que tipo de cobertura ele possui. Verificação da área de serviço Para empresas que operam em regiões específicas – os clientes perguntam se o serviço está disponível em sua localidade. - Nome da ferramenta: Verificação da área de serviço - Descrição: Verifica se o serviço ou entrega está disponível em uma área específica através do CEP ou nome da cidade do cliente. As ferramentas personalizadas funcionam melhor quando as entradas são diretas e a resposta da API é previsível – verificações de status, pesquisas e outras consultas estruturadas são uma ótima opção. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como solicitar habilitação do Capitão na sua conta

Use este guia quando o Capitão não aparece na sua conta ou quando você precisa pedir a ativação do agente de IA para a equipe Digi2B. O que este artigo resolve A ativação do Capitão é feita pela equipe Digi2B conforme o plano, a implantação e a configuração da conta. A pessoa atendida não precisa acessar áreas técnicas internas para habilitar esse recurso. Antes de solicitar - Confirme qual conta da IAra deve usar o Capitão. - Defina em quais caixas de entrada o agente de IA será usado. - Separe o objetivo do assistente: suporte, qualificação, triagem, FAQ ou agendamento. - Tenha documentos, FAQs ou instruções iniciais para alimentar a base de conhecimento. - Defina quando a IA deve transferir para um atendente humano. Como solicitar a habilitação 1. Abra um chamado com o suporte Digi2B. 2. Informe o nome da conta e o canal onde o Capitão deve atuar. 3. Explique o objetivo do uso da IA. 4. Envie documentos, FAQs ou links que devem ser usados como base. 5. Informe quem será responsável por validar os testes antes da ativação para clientes. O que a Digi2B configura - Disponibilidade do recurso na conta. - Assistente inicial, quando aplicável. - Fontes de conhecimento, documentos e FAQs. - Regras de transferência para humano. - Limites de segurança e comportamento esperado. - Testes iniciais no Playground. Como validar depois da ativação 1. Acesse o menu Capitão no painel. 2. Revise FAQs, documentos e instruções configuradas. 3. Use o Playground para testar perguntas reais. 4. Teste perguntas fora do escopo para confirmar a transferência para humano. 5. Ative em uma caixa de entrada controlada antes de liberar para todos os canais. Problemas comuns - O menu Capitão não aparece: verifique com a Digi2B se o recurso está habilitado para a conta. - A IA responde sem contexto: revise documentos, FAQs e instruções. - A IA não transfere para humano: confira as regras de transferência. - A IA responde algo sensível: ajuste limites e remova fontes inadequadas. Checklist final - [ ] Conta e canal definidos. - [ ] Objetivo do assistente documentado. - [ ] Base de conhecimento enviada ou cadastrada. - [ ] Regras de transferência revisadas. - [ ] Testes feitos no Playground. - [ ] Ativação aprovada por um responsável da operação.

Como usar ações de IA no atendimento

Use este guia quando você precisar configurar, entender ou validar Como usar ações de IA no atendimento na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado O envolvimento com os clientes exige profissionalismo incansável. A qualidade da sua comunicação com seus clientes geralmente é um grande fator que contribui para as vendas e também para a retenção de clientes. Sem mencionar os efeitos na identidade da marca. Mas, para soar sempre perfeito –– você tem que ser um robô. Por isso, trouxemos a IA para o seu painel. Com nossa integração OpenAI, você pode melhorar as conversas com os clientes à medida que elas acontecem. Ao integrar IA ao painel da IAra, você pode melhorar as conversas com os clientes em tempo real, sem sacrificar sua voz exclusiva ou identidade de marca. Você receberá sugestões baseadas em IA que o ajudarão a refinar suas mensagens e a se comunicar de maneira mais eficaz com seus clientes. A configuração da integração leva menos de um minuto e os benefícios são imediatos. Para começar, siga as etapas abaixo. Como integrar OpenAI com IAra? Etapa 1. Vá para Configurações → Aplicativos → OpenAI. Clique no botão “Configurar” correspondente. Etapa 2. Clique no botão "Conectar". Um modal aparecerá solicitando sua chave de API OpenAI. Para obter sua chave de API OpenAI, faça login em sua conta OpenAI e visite este link. Depois de inserir sua chave secreta de API, você verá uma mensagem de sucesso na tela. Como usar os recursos de IA da IAra? Existem três recursos alimentados por IA na IAra. As seções abaixo explicam como usá-los. Sugestão de resposta com IA O recurso “Sugestão de resposta com IA” sugere uma possível resposta a uma mensagem de um cliente, auxiliando nas respostas rápidas. Siga as etapas abaixo para usar este recurso. Etapa 1. Vá para a guia Conversas na barra lateral e abra uma conversa que precisa de resposta. Você deverá ver uma nova opção chamada “Sugestão de resposta com IA”. Aqui está um exemplo: Etapa 2. Clique no botão para ver a sugestão. A caixa de resposta será preenchida com a resposta sugerida. Etapa 3. Edite sua mensagem como desejar e clique no botão Enviar! Melhore com IA O recurso “Melhorar com IA” sugere melhorias em seus rascunhos de mensagens à medida que você os redige. Siga as etapas abaixo para usar este recurso. Etapa 1. Vá para a guia Conversas na barra lateral e abra uma conversa. Comece a digitar uma mensagem na caixa de texto. Ao escrevê-lo, você verá uma nova opção chamada “Melhorar com IA”. Aqui está um exemplo: Etapa 2. Clique no botão "Melhorar com IA" para ver suas opções. Selecione um tom para sua mensagem – profissional ou amigável. Clique no botão "Gerar". Com base na sua seleção de tom, a IA reescreverá sua mensagem e preencherá instantaneamente a caixa de texto com a nova mensagem. Continuando o exemplo, ficaria assim: Etapa 3. Edite sua mensagem como desejar e clique no botão Enviar! Resumo com IA O recurso “Resumo com IA” resume as conversas em Notas Privadas em segundos. Siga as etapas abaixo para usar este recurso. Etapa 1. Vá para a guia Conversas na barra lateral e abra uma conversa. Mude para a guia “Nota privada”. Você deverá ver uma nova opção chamada “Resumo com IA”. Aqui está um exemplo: Etapa 2. Clique no botão. O editor de texto será preenchido com um resumo da conversa. Etapa 3. Edite sua nota como desejar e clique no botão ‘Adicionar nota’! Como usar o AI Assist? Você pode alternar o AI Assist selecionando-o na barra de comando ou clicando no botão AI Assist dentro do editor. Para selecionar um recurso desejado, basta clicar nele. Depois de clicar em uma opção, o modal Sugestão de resposta com IA será aberto, exibindo conteúdo gerado por IA. Para inserir o conteúdo no editor, clique no botão Usar esta sugestão . Perguntas frequentes Os resultados do AI Assist são sempre precisos?**** Os resultados nem sempre podem ser precisos. Embora o AI Assist seja projetado para fornecer sugestões precisas, é importante que os agentes revisem e verifiquem as sugestões antes de enviá-las aos clientes. Além disso, estamos trabalhando continuamente para melhorar nosso AI Assist. Você oferece suporte a algum provedor de IA que não seja OpenAI**** No momento, oferecemos suporte apenas para OpenAI. Mas estamos planejando adicionar mais fornecedores em breve. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.

Como melhorar respostas com base em documentos

Use este guia quando você precisar configurar e usar este recurso com clareza operacional. Quando usar este guia Use este guia para resolver ou revisar Como melhorar respostas com base em documentos na IAra com mais segurança, sem depender de tentativa e erro. Na tela: Use a tela de documentos para revisar quais fontes estão alimentando as respostas da IA. base de documentos. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como definir limites de segurança para a IA

Use este guia quando você precisar operar a IAra protegendo dados, acessos e informações sensíveis. Quando usar este guia Use este guia para resolver ou revisar Como definir limites de segurança para a IA na IAra com mais segurança, sem depender de tentativa e erro. Antes de começar - Defina qual conta, canal, time, agente, conversa ou assistente será usado no teste. - Separe prints, horários, links de conversa ou exemplos reais quando houver investigação. - Evite alterar produção sem validar antes em um cenário controlado. - Se o fluxo envolver IA, confirme se há base de conhecimento, instruções, limites e transferência para humano. Como se preparar 1. Defina qual conta, canal, time, conversa ou assistente será usado no teste. 2. Faça primeiro uma validação controlada antes de alterar um fluxo em uso. 3. Separe prints, horários, links de conversa e mensagens de erro, se houver. 4. Combine quem fará o ajuste e quem validará o resultado. 5. Registre o que foi testado para facilitar a continuidade se precisar pedir ajuda. Passo a passo operacional 1. Acesse a área correspondente no painel da IAra. 2. Revise se você está na conta, caixa de entrada, time ou assistente correto. 3. Faça a configuração ou ação descrita pelo artigo. 4. Teste usando um cenário realista, mas controlado. 5. Confirme se o resultado aparece para quem precisa operar: agente, gestor, cliente ou suporte. 6. Documente qualquer diferença de tela para ajustar o artigo antes da publicação. Problemas comuns - Tentar resolver direto em produção sem teste controlado. - Usar nomes genéricos que confundem agentes, gestores e relatórios. - Não registrar evidência quando algo falha. - Configurar recurso sem definir quem será responsável por operar depois. - Criar automação ou IA sem regra de transferência para humano. Checklist final - [ ] Objetivo do fluxo entendido. - [ ] Pré-requisitos conferidos. - [ ] Teste controlado realizado. - [ ] Evidências salvas quando necessário. - [ ] Responsável pela manutenção definido.

Como usar bots de agente

Use este guia quando você precisar configurar, entender ou validar Como usar bots de agente na IAra. Antes de começar na IAra - Confirme que seu usuário tem permissão para acessar a área citada no artigo. - Faça a configuração primeiro em um cenário de teste, sempre que o recurso afetar atendimentos reais. - Se o fluxo envolver WhatsApp, Meta, Twilio, e-mail, domínio, SAML, API ou outro provedor externo, confirme as credenciais e permissões antes de iniciar. Guia detalhado AgentBot permite conectar agentes externos de IA e lógica de bot personalizada diretamente à sua caixa de entrada da IAra. Ele permite que seu bot ouça as conversas dos clientes, processe as consultas recebidas e responda através da IAra em tempo real. Depois que um AgentBot é conectado a uma caixa de entrada, novas conversas recebem automaticamente um status pendente. A IAra então envia eventos de conversa para o URL do bot configurado como eventos de webhook. Seu AgentBot pode processar esses eventos, gerar a resposta correta usando sua própria lógica ou sistemas de IA e enviar mensagens de volta para a conversa usando APIs IAra. Isso torna mais fácil trazer seu próprio agente de IA, fluxo de trabalho de automação ou bot externo de suporte ao cliente para a IAra, ao mesmo tempo que mantém a transferência humana disponível quando necessário. Como funciona o AgentBot? Explicado abaixo em um fluxo de trabalho típico de um AgentBot. 1. O AgentBot recebe eventos como widget_triggered, message_created e message_updated com base nas interações do cliente. 2. O AgentBot processa as informações recebidas para gerar uma resposta apropriada. 3. O AgentBot também pode utilizar APIs de sistema externo para coletar informações adicionais do cliente, como status do pedido ou gatilhos de reserva. 4. O AgentBot pode integrar modelos de IA como OpenAI, Claude, Gemini ou ferramentas como Amazon Lex para entender o que a pessoa atendida deseja. 5. O AgentBot pode postar a resposta gerada de volta no widget utilizando APIs da IAra, como Criar nova mensagem. 6. O AgentBot pode alternar o status de uma conversa para aberto para transferir a conversa para um agente humano. 7. Continua monitorando conversas abertas para fornecer informações contextuais ao agente de suporte. Como funciona a transferência Homem-Agente? Quando um agente bot está conectado a uma caixa de entrada, as conversas são criadas com status “pendente”, permitindo que ele faça a triagem da conversa antes de passá-la para um agente humano. Se o bot determinar que a assistência de um agente humano é necessária ou se a pessoa atendida solicitou explicitamente ajuda humana, ele poderá usar a API de atualização de conversa para alterar o status para "aberto", o que tornaria a conversa disponível para um ser humano. Às vezes, os agentes queriam adiar uma conversa que foi transferida de volta para a fila do bot. Os agentes podem retornar uma conversa transferida para a fila do bot alterando o status de volta para “pendente”. Como posso usar o AgentBot? Listados abaixo estão alguns exemplos. 1. Empresas com alto volume de consultas de suporte ao cliente podem utilizar um AgentBot para autenticar e filtrar consultas, reduzindo a carga de trabalho dos agentes humanos e melhorando a eficiência do suporte ao cliente. 2. Os sites de comércio eletrônico podem integrar o AgentBot com seus bancos de dados existentes, fornecendo aos clientes atualizações em tempo real sobre o status do pedido e da remessa, bem como respondendo a outras dúvidas relacionadas. 3. Sites de notícias e conteúdo podem usar o AgentBot para enviar recomendações aos usuários por meio de mensagens de cartão. 4. Os sites de reservas de hotéis e filmes podem usar o AgentBot para lidar com reservas, reservas e responder a dúvidas relacionadas, proporcionando aos clientes uma experiência de reserva perfeita e conveniente. Exemplos - Para Dialogflow, veja Como integrar chatbot Dialogflow. - Para bots próprios, use webhooks e API conforme a configuração da sua integração. Na tela: A tela de robôs de agente mostra onde conectar bots externos à operação. robôs de agente. Além disso, procure maneiras interessantes de aproveitar os tipos de mensagens de bot na IAra. Criando bots de agente Como criar bots agentes em sua conta da IAra? Você pode criar bots de agente nas configurações da conta. Vá para Configurações -> Bots. Você verá uma opção como a abaixo. Clique em "Adicionar Bot" para criar um novo bot. Você verá uma opção para fornecer um nome, avatar e URL do webhook. Como conectar uma caixa de entrada a um bot? Abra a caixa de entrada onde deseja vincular o bot. Em Configuração do bot, escolha o bot que deve gerenciar as conversas. Depois de clicar em Salvar, você começará a receber eventos de webhook sempre que uma nova conversa ou mensagem for criada. Para obter mais detalhes sobre os eventos suportados nos webhooks, visite a documentação do Webhook [aqui]. Verificação de webhook Depois de criar um bot de agente, geramos automaticamente um segredo que você pode usar para verificar a carga que seu aplicativo recebe. Você pode ler mais sobre a verificação de webhook [aqui]. Como validar na IAra 1. Execute o fluxo em uma conta ou conversa de teste. 2. Confirme se o resultado aparece para o agente, gestor ou cliente exatamente como esperado. 3. Revise se o nome da caixa, time, etiqueta, assistente ou integração está claro para o restante da equipe. Problemas comuns - Usuário sem permissão para acessar a configuração. - Nome de tela diferente entre versões ou contas. - Recurso dependente de plano, provedor externo ou habilitação pela Digi2B. - Falta de teste em conversa realista antes de liberar para a equipe. Checklist final - [ ] Configuração revisada por um administrador. - [ ] Teste realizado com dado ou conversa controlada. - [ ] Impacto para agentes e gestores entendido. - [ ] Artigos relacionados revisados para evitar links quebrados.