Tema
Assistentes de I.A.
Os assistentes de I.A. (Prompts) são o núcleo da automação de atendimento. Cada assistente define como a inteligência artificial se comporta, responde e interage com os clientes via WhatsApp.
Criando um assistente
Acesse Assistentes no menu lateral e clique em Novo Assistente. O editor abre em tela ampla com uma navegação lateral de seções: Identidade, Instruções, Conhecimento, Ferramentas, Automações, Follow-up e Modelo e comportamento.
- Campos obrigatórios não preenchidos são destacados ao salvar, e a seção com pendência recebe um indicador na navegação.
- Se você fechar o editor com alterações não salvas, a plataforma pede confirmação antes de descartar.
- O botão Testar (disponível após salvar) abre o sandbox de conversa lado a lado com o editor: você ajusta instruções e configurações de um lado e testa do outro, sem sair da tela. As mensagens de teste usam a configuração atual do formulário, mesmo antes de salvar. No celular, o sandbox abre como painel sobreposto.
Duplicar assistente
Na lista de assistentes, use o botão de duplicar para criar uma cópia de um assistente existente. A cópia inclui todas as configurações, instruções e treinamento do assistente original. Útil para criar variações de um assistente sem começar do zero.
Identidade
Define quem é o assistente.
| Campo | Descrição |
|---|---|
| Nome | Nome de identificação do assistente |
| Tipo | Define o comportamento especializado (ver tabela abaixo) |
| Fila de destino | Fila padrão para onde as conversas vão |
| Disponível internamente | Permite que a equipe use o assistente no chat interno |
Tipos de assistente
| Tipo | Uso |
|---|---|
| Conversacional | Atendimento geral e suporte |
| Chat Interno | Exclusivo para uso da equipe |
| Produto | Catálogo de produtos com busca |
| Vitrine | Portfólio ou showcase |
| Agendamento | Marcação de horários genérica |
| Agendamento Médico | Consultas médicas |
| Agendamento de Exames | Exames médicos |
| Agendamento de Reunião | Reuniões |
| Agendamento de Aula | Aulas |
| Agendamento de Visita | Visitas |
Tipos de agendamento habilitam ferramentas específicas de calendário na I.A.
Instruções
Define a personalidade e o comportamento do assistente.
Campo de instruções
Texto livre onde você escreve as regras de comportamento do assistente. Exemplos:
- Tom de voz e estilo de comunicação
- Informações sobre a empresa
- Regras de atendimento
- O que fazer e o que não fazer
- Formato das respostas
Estilos de personalidade
Clique em um card para inserir o texto correspondente no fim das instruções (você pode editar o resultado livremente):
- Profissional — comunicação formal e direta
- Amigável — tom acolhedor e caloroso
- Vendas — foco em conversão
- Técnico — suporte especializado
- Empático — alta sensibilidade emocional
- Conciso — respostas diretas e curtas
Conhecimento
Alimenta o assistente com conhecimento. Possui quatro sub-abas, cada uma com um contador dos itens cadastrados.
Conteúdo web
Adicione endereços de sites. O conteúdo é extraído automaticamente ao salvar, e cada URL exibe o resultado da última extração:
- Conteúdo extraído — a página foi lida com sucesso e incorporada ao contexto do assistente.
- Falha na extração — não foi possível ler a página (passe o mouse sobre o indicador para ver o motivo). Verifique a URL e salve novamente para tentar de novo.
Arquivos
Arraste arquivos para a área de upload (ou clique para selecionar — vários de uma vez) para alimentar a base de conhecimento.
Formatos suportados:
- Documentos: PDF, TXT, HTML, MD, PPTX, DOC, DOCX, JSON, CSV
- Imagens: PNG, JPG, JPEG, GIF, WEBP
- Mídia: MP4, MP3, WAV, OGG
Cada arquivo aceita:
- Descrição — obrigatória para imagens, áudio e vídeo
- Permitir envio como anexo — deixa a I.A. enviar o arquivo na conversa
Os arquivos são indexados em um vector store para busca semântica.
Perguntas e Respostas
Pares de pergunta-resposta (FAQ). O assistente consulta essas respostas quando o cliente faz perguntas semelhantes. Também serve para blocos de informação que não estão em documentos (use o campo de pergunta como tópico). Limite: 100 entradas no total.
Exemplos de Conversa
Conversas reais para treinar o estilo do assistente. Cada exemplo contém:
- Título — nome descritivo
- Categoria — vendas, suporte, agendamento, informações, negociação, reclamação ou outro
- Conversa — sequência de mensagens (usuário e assistente)
Há dois caminhos para criar exemplos a partir de tickets reais (limite de 20 exemplos por assistente):
- Direto no editor: na aba Exemplos de Conversa, clique em Adicionar do ticket, busque um ticket fechado e selecione as mensagens que representam um bom atendimento.
- A partir do ticket: abra um ticket fechado e clique em Treinar agente IA.
Ferramentas
Reúne tudo o que o assistente pode fazer durante a conversa: ferramentas nativas da plataforma, ferramentas HTTP personalizadas e servidores MCP.
Ferramentas nativas
Cada ferramenta pode ser habilitada ou desabilitada individualmente, ou por categoria.
Gerenciamento de Ticket:
| Ferramenta | O que faz |
|---|---|
| Transferir Fila | Move a conversa para outra fila |
| Trocar Assistente | Transfere para outro assistente de I.A. |
| Adicionar Tag | Categoriza o ticket |
| Remover Tag | Remove categorização |
| Finalizar Ticket | Encerra a conversa |
| Mover Etapa Kanban | Avança no fluxo de trabalho |
Dados do Contato:
| Ferramenta | O que faz |
|---|---|
| Salvar Dados | Armazena nome, email e outros dados do contato |
| Extração Automática | Captura informações automaticamente da conversa |
Detecção:
| Ferramenta | O que faz |
|---|---|
| Detectar Sentimento | Identifica a emoção do cliente |
| Detectar Tópico | Reconhece assuntos mencionados |
| Detectar Pergunta | Identifica perguntas específicas |
Conhecimento:
| Ferramenta | O que faz |
|---|---|
| Buscar Arquivos | Consulta a base de conhecimento (vector search) |
Ferramentas HTTP
As ferramentas HTTP dão autonomia ao assistente: você registra endpoints que a própria I.A. decide chamar durante a conversa e cujo resultado ela lê e interpreta sozinha para continuar o atendimento. É a diferença entre montar um fluxo fixo e deixar o assistente agir de forma autônoma (prompt-driven).
As ferramentas HTTP só ficam disponíveis depois de salvar o assistente.
Como funciona:
- Você cadastra uma ferramenta com uma descrição clara do que ela faz.
- Durante a conversa, a I.A. decide se e quando chamá-la, preenchendo os parâmetros definidos.
- A plataforma faz a requisição HTTP e devolve a resposta crua para a I.A.
- A I.A. interpreta o resultado e segue o atendimento (pode encadear chamadas).
Campos:
| Campo | Descrição |
|---|---|
| Nome | Identificador curto |
| Descrição | Explica para a I.A. o que faz e quando usar |
| Método | GET, POST, PUT, PATCH ou DELETE |
| URL | Endpoint a chamar. Deve usar HTTPS e aceita |
| Cabeçalhos | Headers personalizados |
| Corpo da requisição | Para POST/PUT/PATCH; aceita |
| Parâmetros de entrada | Campos que a I.A. preenche ao chamar |
| Autenticação | Nenhuma, Basic ou Bearer token |
| Timeout | Tempo máximo de espera (1 a 30 segundos) |
| Ativada | Liga/desliga sem excluir |
As variáveis podem vir dos dados do ticket/contato (ex.: ) ou dos parâmetros que a I.A. preenche (ex.: ).
Testar ferramenta: ao editar uma ferramenta já salva, a área Testar ferramenta permite preencher os parâmetros de entrada manualmente e executar a requisição real, exibindo o status HTTP, a duração e o corpo da resposta. Use para validar a configuração antes de liberar para a I.A.
Segurança:
- Apenas endpoints HTTPS.
- Endereços internos (IPs privados,
localhost, metadados de nuvem) são bloqueados automaticamente, mesmo que o domínio resolva para um IP interno. - A lista de ferramentas por empresa funciona como lista de permissões: a I.A. nunca chama uma URL não registrada.
- As respostas têm tamanho limitado.
- Campos de segredo (senhas, tokens, valores de cabeçalho) nunca voltam para o navegador; ao editar, deixe em branco para manter o valor salvo.
Servidores MCP
Além das ferramentas HTTP, o assistente pode se conectar a servidores MCP (Model Context Protocol) via HTTP. Um servidor MCP é um catálogo de ferramentas prontas que a I.A. pode chamar durante a conversa — em vez de cadastrar cada endpoint manualmente, você aponta para o servidor e ele informa quais ferramentas oferece.
Os servidores MCP só ficam disponíveis depois de salvar o assistente.
Como cadastrar:
- Informe a URL do servidor MCP (deve ser HTTPS pública).
- Configure a autenticação, se necessário: Nenhuma, Basic, Bearer token ou OAuth 2.0, além de cabeçalhos personalizados.
- Clique em Conectar e listar ferramentas. A plataforma se conecta ao servidor e descobre as ferramentas disponíveis.
- Marque quais ferramentas a I.A. pode usar (lista de permissões). Se nenhuma estiver marcada, nenhuma ferramenta do servidor é exposta.
- Salve.
Você também pode importar um servidor MCP já configurado em outro assistente da empresa (servidores OAuth importados precisam ser reautorizados).
A partir daí, a I.A. decide se e quando usar cada ferramenta liberada durante o atendimento, interpretando o resultado para continuar a conversa.
Segurança:
- Apenas servidores em URLs HTTPS públicas são aceitos. Endereços internos e privados são bloqueados automaticamente.
- A I.A. só acessa as ferramentas que você marcar explicitamente — nenhuma ferramenta não selecionada é usada.
Automações
Crie regras automáticas baseadas em gatilhos. Cada automação tem um gatilho (quando) e uma ação (o quê).
Tipos de gatilho
| Gatilho | Quando dispara |
|---|---|
| Conversa iniciada | Primeiro contato do cliente |
| Mensagem contém | Texto específico na mensagem |
| Sentimento do usuário | Emoção detectada (raiva, frustração, etc.) |
| Data específica | Em uma data determinada |
| Usuário falando sobre | Tópico detectado na conversa |
| Usuário perguntou sobre | Pergunta específica identificada |
| Usuário informou | Dado fornecido pelo cliente |
| Contexto personalizado | Condição customizada |
Tipos de ação
| Ação | O que faz |
|---|---|
| Enviar mensagem | Envia texto ao cliente |
| Transferir fila | Move para outra fila |
| Adicionar tag | Categoriza o ticket |
| Remover tag | Remove categorização |
| Finalizar ticket | Encerra a conversa |
| Criar tarefa | Cria tarefa interna |
| Mover Kanban | Avança etapa do fluxo |
| Agendar mensagem | Envia mensagem com atraso |
| Agendar fluxo | Inicia um fluxo com atraso |
| Alterar status | Muda status do ticket |
| Atribuir atendente | Designa um responsável |
| Webhook | Chama API externa |
| Enviar email | Dispara email |
| Trocar assistente | Transfere para outro assistente |
Cada automação aceita:
- Prioridade — ordem de execução (menor = primeiro)
- Parar execução — impede que automações seguintes disparem
- Atraso — tempo de espera antes da ação (segundos, minutos ou horas)
As automações (criações, edições e exclusões) são efetivadas quando você salva o assistente.
Webhooks
A ação de webhook permite integrar com sistemas externos:
- URL, método HTTP (GET/POST/PUT/DELETE/PATCH)
- Autenticação (nenhuma, basic ou bearer token)
- Headers personalizados
- Corpo da requisição em JSON
- Timeout configurável
- Botão de teste com visualização da resposta
A ação de webhook nas automações é disparada de forma assíncrona e não devolve a resposta para a I.A. Quando você quer que a própria I.A. faça a requisição e interprete o resultado durante a conversa, use as Ferramentas HTTP (na seção Ferramentas).
Follow-up
Envia mensagens automáticas quando o cliente não responde, com intervalos simples ou progressivos, condições por tags e controle de volume de envio. Consulte a documentação de follow-up para detalhes completos.
Modelo e comportamento
Ajustes técnicos do modelo de I.A.
Modelo de I.A.
| Campo | Descrição |
|---|---|
| Provedor | OpenAI, OpenRouter, Anthropic, Grok, Google, Meta, Zhipu, Qwen, Mistral, DeepSeek ou Outros |
| Modelo | Varia por provedor (ex: GPT-5.5, Claude Opus 4.7, Gemini 3.5) |
| Chave da API | Sua chave de acesso ao provedor |
Comportamento
| Campo | Descrição |
|---|---|
| Criatividade | Slider de 0 (preciso) a 1 (criativo). Padrão: 0.2. Disponível na maioria dos modelos |
| Esforço de Raciocínio | Quanto o modelo deve raciocinar antes de responder: Baixo, Médio ou Alto. Disponível em modelos com suporte a raciocínio (GPT-5, Claude, Grok 4.2+, Gemini 3, Qwen 3, Kimi K2.5+, DeepSeek V4+, ByteDance Seed) |
| Verbosidade | Nível de detalhe das respostas: Conciso, Moderado ou Detalhado. Disponível em modelos compatíveis (GPT-5, Claude) |
| Atraso máximo | Segundos de espera antes de responder (simula digitação). Padrão: 0 |
Os campos de Esforço de Raciocínio e Verbosidade aparecem automaticamente quando o modelo selecionado oferece suporte a esses recursos.
Modo de resposta
| Modo | Comportamento |
|---|---|
| Texto | Responde apenas com texto (padrão) |
| Áudio | Responde apenas com áudio |
| Equivalente | Envia texto e áudio juntos |
| Aleatório | Escolhe aleatoriamente entre texto e áudio |
Modos com áudio exigem uma voz configurada (integração ElevenLabs). A voz possui ajustes de estabilidade, velocidade, similaridade, exagero de estilo, boost de speaker e remoção de ruído de fundo.
Capacidades especiais
Transcrição de áudio
Mensagens de voz enviadas pelo cliente são automaticamente transcritas para texto via OpenAI Whisper. O assistente responde com base no conteúdo transcrito.
Análise de imagens
Imagens enviadas pelo cliente são processadas pela I.A. como entrada visual. O assistente interpreta e responde sobre o conteúdo da imagem.
Busca semântica (RAG)
Arquivos enviados na seção de conhecimento são indexados em um vector store. Quando o cliente faz uma pergunta, a ferramenta Buscar Arquivos consulta os documentos e retorna trechos relevantes para compor a resposta.
Troca de assistente
A I.A. pode transferir a conversa para outro assistente durante o atendimento. Útil para escalar para assistentes especializados (ex: do assistente geral para o de agendamento). A troca inclui:
- Mensagem de transição para o cliente
- Resumo da conversa para o novo assistente
Contexto resumido
O campo Contexto Resumido (no modelo) injeta informações pré-computadas em toda resposta. Use para dados que o assistente precisa ter sempre disponíveis, sem depender de busca.
Integração com filas
Cada fila pode ter um assistente vinculado. Quando um ticket entra na fila sem atendente, o assistente assume a conversa automaticamente.
- Uma fila → um assistente
- Um assistente → várias filas
- Se a fila e o assistente têm follow-up configurado, o do assistente tem prioridade
Provedores suportados
| Provedor | Modelos populares |
|---|---|
| OpenAI | GPT-5.5 Pro, GPT-5.5, GPT-5.4 Pro, GPT-5.4, GPT-4.1 |
| Anthropic | Claude Opus 4.7, Claude Opus 4.7 Fast, Claude Sonnet 4.6, Claude Haiku 4.5 |
| Grok | Grok 4.3, Grok 4.2, Grok 4.2 Multi-Agent |
| Gemini 3.5 Flash, Gemini 3.1 Flash Lite, Gemini 2.5 Pro, Gemini 2.5 Flash | |
| Meta | LLaMA 4 Maverick, LLaMA 4 Scout |
| Zhipu | GLM 5.1, GLM 5 Turbo, GLM 5v Turbo |
| Qwen | Qwen 3.6 Max, Qwen 3.6 Plus, Qwen 3.6 Flash, Qwen 3.5 |
| Mistral | Mistral Medium 3.5, Mistral Small |
| DeepSeek | DeepSeek V4 Pro, DeepSeek V4 Flash |
| Outros | Kimi K2.6, ByteDance Seed 2.0 |