Assistente de IA (FlakeDesk IA)

O FlakeDesk tem uma IA própria — a FlakeDesk IA — incluída nos planos, sem precisar de chave de API. Ela conhece a plataforma e acessa (com as suas permissões) os dados do seu CRM.

Onde usar

  • Página Assistente IA (menu lateral): chat completo, com histórico e memória nos planos que incluem esse recurso.
  • Botão ✨ "Perguntar ao FlakeDesk" (topo de qualquer tela, sempre visível): abre o assistente em um painel lateral, com sugestões de perguntas de acordo com a tela em que você está. A conversa continua enquanto você navega. O assistente sabe em qual tela você está: pergunte "o que é esta tela?", "como uso isso aqui?" ou, no detalhe de um contato/empresa, "resuma este contato" — ele entende o contexto.
  • Botões de IA por tela: "Resumir com IA" e "Sugerir follow-up" nos detalhes de contato e empresa; "Resumir conversa" e "Sugerir resposta" nas conversas de WhatsApp do Atendimento.

O que o assistente consegue fazer

  • Responder dúvidas sobre como usar o FlakeDesk (ele consulta a documentação da plataforma e cita a fonte).
  • Buscar nos seus dados: contatos, empresas, interações — ex.: "Quem devo contatar esta semana?", "Resuma o estado do funil". Buscas por vários cargos de uma vez funcionam ("Gerente, Diretor, Head").
  • Indicar os melhores leads: perguntas como "quem são os 5 melhores leads?" usam o Score: as suas estrelas, que valem em todos os planos, e a nota de 0 a 100 calculada pela IA, que existe nos planos Premium e Platinum. Para isso os contatos precisam ter sido avaliados no menu Score — se ainda não foram, o assistente orienta a rodar a avaliação primeiro.
  • Registrar interações por você: ao pedir "registre uma nota na Maria", ele prepara a ação e mostra um cartão de confirmação — nada é gravado sem o seu OK. O cartão mostra tudo o que será gravado: se o registro é de um contato ou de uma empresa, o nome, o tipo da interação, o texto e, quando houver, a data do próximo contato (que vira um follow-up). Confira esses dados antes de confirmar (no aplicativo do celular, a data e o tipo do registro aparecem a partir da versão mais recente): o assistente lê mensagens de clientes, e um texto escrito por alguém de fora pode tentar mudar o que ele propõe. Na versão mais recente do aplicativo, o nome do contato ou da empresa é conferido no FlakeDesk antes de o botão Confirmar aparecer; se aparecer "Não foi possível conferir o registro desta ação", descarte e peça de novo.
  • Consultar a base de conhecimento da organização (documentos internos cadastrados pelo admin) citando as fontes.

As consultas acima (central de ajuda, base de conhecimento, buscas no CRM, Score e registro de interações) funcionam com a FlakeDesk IA e com o ChatGPT. Com Claude pela chave própria o assistente não usa essas consultas: veja a seção "IA Pro", abaixo.

Transparência e limites

  • Cada resposta mostra a origem: FlakeDesk AI Basic (IA própria) ou IA premium (Claude/ChatGPT com a chave da sua organização).
  • A FlakeDesk IA tem limite diário e limite mensal de interações por usuário conforme o plano (os contadores aparecem na página do assistente). Conta como interação cada pergunta ao assistente e cada uso dos botões Resumir com IA e Sugerir follow-up (contatos e empresas) e do resumo e da sugestão de resposta das conversas do Atendimento. Uma pergunta conta uma vez só, mesmo quando o assistente consulta o CRM em várias etapas para responder. O cálculo do Score IA não consome esses limites. O limite diário renova automaticamente no dia seguinte; o mensal, na virada do mês. Há também um limite de rajada: mais de 30 solicitações em 5 minutos (perguntas, resumos, sugestões e cálculos de Score somados) pedem alguns minutos de espera (o aviso é "Muitas solicitações de IA em sequência").
  • Limites por plano: Free 10/dia e 50/mês · Starter 25/dia e 200/mês · Premium 100/dia e 1.000/mês · Platinum sem limites.
  • O assistente só vê o que você pode ver: os dados respeitam organização, permissões e política de visibilidade.
  • As respostas da IA podem conter erros: confira antes de usar uma resposta numa decisão. O assistente só grava algo no CRM depois que você confirma no cartão de ação. As regras de uso dos recursos de IA (por exemplo, a proibição de uso em canal voltado a menores de 18 anos e de orientação de saúde) estão na seção 5.1 dos Termos de Uso.
  • A memória do assistente (no plano Platinum) guarda o que ajuda nas próximas conversas, como suas preferências e o foco do seu trabalho. Ela não guarda números da base: quantos contatos existem, as interações, as avaliações do Score e os follow-ups são lidos do CRM na hora de cada pergunta. Se a memória disser algo diferente do que está no CRM, vale o que está no CRM. Para consultar o que ele guardou, abra a página Assistente IA e a aba Memória.

IA Pro: Claude ou ChatGPT com a chave da sua empresa (BYOK)

Nos planos Premium e Platinum (e no teste grátis), um administrador pode trocar o motor do assistente por Claude (Anthropic), ChatGPT (OpenAI) ou um endpoint compatível, usando a chave de API da própria empresa (BYOK, do inglês "traga a sua chave"). As chamadas passam a ser cobradas na conta da sua empresa nesse provedor e não consomem os limites diário e mensal da FlakeDesk IA. O limite de rajada (30 solicitações em 5 minutos) continua valendo.

Antes de começar: crie uma chave de API na conta da sua empresa no provedor escolhido (no painel de desenvolvedor da Anthropic ou da OpenAI). A chave é um texto longo que o próprio provedor mostra ao criar; copie-a.

Passo a passo

  1. No menu lateral, abra Administração → Configurações e clique no cartão Assistentes de IA (endereço /admin/settings/ai). Só administradores da organização veem essa tela.
  2. Fique na aba Provedor.
  3. Em Provedor, escolha Anthropic / Claude, OpenAI / ChatGPT ou Endpoint compatível. A opção FlakeDesk IA (incluída) é o padrão e não precisa de chave.
  4. Em Modelo, escolha o modelo da lista.
  5. Em API key, cole a chave do provedor. Para Endpoint compatível, preencha também Endpoint customizado com o endereço público (https) do serviço, compatível com a API de chat completions.
  6. Clique em Salvar IA. Aparece "Configurações de IA salvas!".

A chave fica guardada no servidor e não é mostrada de volta: o campo mostra só o começo e o fim dela ("Chave atual: ..."). Para trocar, cole a nova chave; para manter a atual, deixe o campo em branco ao salvar. Para voltar à IA incluída, escolha FlakeDesk IA (incluída) e salve. Administradores também podem trocar o provedor pelo seletor no topo da página Assistente IA (em telas de computador).

Atenção com Claude (Anthropic): com Claude pela chave própria, o assistente funciona sem as ferramentas de consulta. Ele não consulta a central de ajuda do FlakeDesk nem a base de conhecimento da organização, não faz buscas no CRM (contatos por cargo, melhores leads do Score) e não prepara registros de interação. Ele responde só com o que vem na conversa e com um resumo do CRM enviado a cada pergunta (totais, contatos adicionados há pouco, últimas interações e contatos ligados à pergunta). Se a sua equipe usa o assistente para tirar dúvidas de uso ou consultar documentos internos, prefira a FlakeDesk IA ou o ChatGPT. Os botões Resumir com IA, Sugerir follow-up, Resumir conversa e Sugerir resposta funcionam normalmente com Claude, porque recebem os dados do registro direto.

Base de conhecimento da organização

Administradores cadastram documentos internos (políticas, playbooks, perguntas frequentes) em Administração → Configurações → Assistentes de IA, aba Base de conhecimento:

  1. Clique em Adicionar documento.
  2. Preencha Título e Conteúdo.
  3. Em Quem pode receber este documento, escolha a audiência: Só a equipe (assistente interno), o padrão, para playbooks, políticas internas e margens; Só clientes (chatbot de atendimento), para produtos, preços públicos e horários; ou Equipe e clientes. Documento novo nasce como "Só a equipe": nada vai para o cliente final sem você escolher.
  4. Clique em Salvar e indexar. O conteúdo é indexado e o assistente passa a usá-lo nas respostas, citando o documento. Sem evidência suficiente, o assistente diz claramente que não encontrou informação confiável.

Se aparecer "Documento salvo, mas a indexação falhou", salve de novo em alguns minutos; se continuar, fale com o suporte.

Desligar a IA para a organização

O interruptor Assistente de IA ativo nesta organização fica em Administração → Configurações → Assistentes de IA, aba Provedor. Desligado, nenhum dado do CRM é enviado ao provedor de IA: o assistente, os resumos, as sugestões, o cálculo do Score IA e a transcrição das mensagens de voz do WhatsApp param para toda a organização. O chatbot de atendimento tem o próprio interruptor, na tela do chatbot (com a IA desligada, ele passa para a equipe as conversas com áudio, porque o áudio não é transcrito). Para desligar:

  1. Abra Administração → Configurações → Assistentes de IA, aba Provedor.
  2. Desligue Assistente de IA ativo nesta organização.
  3. Clique em Salvar IA.

Erros comuns

As mensagens aparecem num aviso no canto da tela, em geral depois de "Erro ao comunicar com o assistente:".

  • "Você atingiu o limite diário da FlakeDesk AI Basic.": o limite diário do seu usuário acabou. Ele renova no dia seguinte. Para um limite maior, um administrador pode alterar o plano em Administração → Plano e cobrança.
  • "Você atingiu o limite mensal da FlakeDesk AI Basic.": o limite do mês acabou e renova na virada do mês. Para continuar agora, um administrador pode alterar o plano ou, nos planos Premium e Platinum, configurar a chave própria (seção IA Pro, acima), que não consome esses limites.
  • "Muitas solicitações de IA em sequência.": mais de 30 solicitações em 5 minutos. Aguarde alguns minutos e tente de novo.
  • "O uso de IA da organização atingiu o teto deste mês.": a organização chegou ao teto mensal de uso da IA. A IA volta no mês seguinte; se precisar antes, fale com o suporte.
  • "IA indisponível neste plano" ou "Este recurso não faz parte do plano atual da organização.": o plano atual da organização não inclui o recurso (por exemplo, o Score por IA, que é dos planos Premium e Platinum). Um administrador pode alterar o plano em Administração → Plano e cobrança.
  • "O assistente de IA foi desativado pelo administrador da sua organização.": um administrador desligou a IA na aba Provedor (veja "Desligar a IA para a organização"). Peça a ele para religar.
  • "A IA está indisponível no momento. Tente novamente em instantes.": o provedor de IA não respondeu. Tente de novo em alguns minutos. Se a organização usa chave própria, confira também se a chave ainda é válida e se a conta no provedor tem saldo.
  • "Esta chave é reservada pela plataforma." (ao salvar a chave): cole a chave da conta do seu próprio provedor de IA, não uma chave da plataforma.
  • "O endereço do provedor de IA não é permitido." (ao salvar um endpoint compatível): use o endereço público (https) informado pelo provedor.
  • Os campos de provedor externo aparecem bloqueados com "Provedores externos (BYOK) bloqueados pelo plano": a chave própria é dos planos Premium e Platinum. A FlakeDesk IA continua disponível.

Veja também