Zynzap · AjudaAssistente IA
Conecte o seu próprio provedor de IA para refinar textos, sugerir respostas, resumir conversas e classificar leads — com custo revisado antes de cada chamada.
Para que serve
O Assistente IA usa um provedor de inteligência artificial configurado pela sua empresa (OpenAI, Anthropic, Google Gemini ou GLM / Zhipu) para:
- Refinar mensagem — corrigir ortografia, gramática e clareza de um texto sem mudar o sentido (página Assistente IA e botão Corrigir com IA em Modelos);
- Sugerir resposta no Atendimento — com uma orientação opcional (ex.: "oferecer horário amanhã"); a sugestão vai para o campo de mensagem para você revisar antes de enviar;
- Resumir conversa no Atendimento — útil ao assumir uma conversa longa;
- Classificação sugerida pela IA — propõe temperatura e qualificação do lead no painel do contato; você clica em Aplicar se concordar.
Antes de começar
- Tenha uma credencial (chave de API) do provedor escolhido e o identificador exato de um modelo disponível na sua conta do provedor.
- Só administradores cadastram ou trocam a credencial. Gestores usam a página; atendentes usam a IA dentro do Atendimento.
- Se a sua conta tem autenticação em duas etapas, salvar a configuração pede o Código do autenticador (quando a última confirmação tiver mais de dez minutos).
Passo a passo
Configure o provedor
Em Assistente IA, no cartão Provedor da sua conta:
- Provedor — OpenAI, Anthropic, Google Gemini ou GLM / Zhipu.
- Modelo — o identificador exato do modelo na sua conta do provedor.
- Endpoint aprovado — somente leitura: o endereço oficial do provedor para onde o texto é enviado.
- Credencial do provedor — cole a chave. Ela fica cifrada; depois de salva, aparece "Credencial já cadastrada" e o campo vira Substituir credencial (deixe vazio para manter a credencial cifrada existente). Para remover, marque Remover a credencial armazenada e desativar o serviço.
- Temperatura — entre 0 e 2; valores menores reduzem variações na escrita. Para correção de texto, use algo baixo, como 0,2.
- Ativar refinamento com IA — liga o serviço para a empresa.
Clique em Salvar configuração. O badge muda de Indisponível para Configurado.
Refine uma mensagem
No cartão Refinar mensagem, cole o texto em Sua mensagem (até 16.384 bytes) e clique em Refinar conteúdo. Revise o custo na janela que abre, confirme, e copie o Resultado.
Use no Atendimento
Numa conversa, use Sugerir resposta (opcionalmente com uma Orientação para a IA) ou Resumir conversa (Gerar resumo). A sugestão é inserida no campo — "Revise antes de enviar." Use Gerar de novo para outra versão.
Acompanhe a atividade
O cartão Atividade da sua conta mostra Chamadas de IA, Tokens recebidos e Tokens gerados, por modelo. O valor em reais aparece no histórico de Plano e consumo.
Dicas
- A IA nunca envia nada sozinha: sugestões e correções sempre passam por você.
- Guie a sugestão com uma orientação curta e concreta ("confirmar entrega para sexta, tom cordial").
- IA automática em campanhas e aquecimento permanece bloqueada.
Erros comuns e como resolver
| Sintoma | Causa | Como resolver |
|---|---|---|
| Badge Indisponível | Sem credencial ou serviço desativado | Cadastre a credencial e marque Ativar refinamento com IA |
| "Não foi possível salvar. Confira provedor, modelo e credencial." | Modelo inexistente na conta do provedor ou chave inválida | Copie o identificador exato do modelo no painel do provedor |
| "Tarifa de IA indisponível no momento." | Catálogo de preços temporariamente indisponível | Tente de novo em instantes |
| "Saldo insuficiente. Adicione créditos ou ajuste o plano." | Sem créditos para o custo da chamada | Adicione créditos em Plano e consumo |
| A IA não sugeriu uma resposta. | Conversa sem conteúdo suficiente ou resposta vazia do provedor | Escreva uma orientação ou tente Gerar de novo |
Perguntas frequentes
Permissões
| Papel | O que pode fazer |
|---|---|
| Administrador | Configura o provedor e usa todos os recursos |
| Gestor | Usa Refinar mensagem e a IA no Atendimento; não altera o provedor |
| Atendente | Usa Sugerir resposta, Resumir e classificação no Atendimento |
| Leitor | Sem acesso |
Cobrança
Cada chamada de IA é uma operação paga: antes de executar aparece Revise o custo antes de continuar, com o custo máximo (uma chamada, até 16.384 bytes de entrada e até 500 tokens de saída). Só o consumo confirmado é cobrado. Veja Cobrança.