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
- 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. - Fique na aba Provedor.
- 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.
- Em Modelo, escolha o modelo da lista.
- 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.
- 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:
- Clique em Adicionar documento.
- Preencha Título e Conteúdo.
- 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.
- 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:
- Abra Administração → Configurações → Assistentes de IA, aba Provedor.
- Desligue Assistente de IA ativo nesta organização.
- 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
- Chatbot de atendimento: Atendente virtual com IA no WhatsApp e no site.
- Relatórios e Score: Indicadores da base e do atendimento, e o Score.
- Contatos: Cadastro, histórico de interações e responsável.
- Configurações da organização e planos: Configurações da organização, planos e cobrança.