Tipos de agente
O ConectAI suporta agentes com diferentes propósitos e engines. Esta página resume as escolhas.
Por canal de atendimento
Agente de WhatsApp
Atende mensagens de texto, áudio, imagem vindas do WhatsApp Cloud API.
- Pode receber áudio (Whisper transcreve)
- Pode mandar áudio gerado (TTS)
- Pode mandar imagem, documento (segunda via)
- Suporta variáveis de template HSM
Agente de telefone
Atende chamadas de voz.
- Streaming bidirecional de áudio
- Latência fim-a-fim de ~800ms-1.5s
- Pode transferir para humano (com contexto)
- Pode gravar (se feature ativada)
Agente híbrido
Mesmo agente atende WhatsApp e telefone. Conhecimento e prompt compartilhados, comportamento adaptado por canal.
Vantagem: consistência — cliente que ligou e depois mandou WhatsApp tem a mesma experiência
Manutenção única: muda em um lugar, vale para os dois
Recomendação: começa híbrido a menos que tenha um motivo forte pra separar.
Agente especialista
1 agente por finalidade. Útil quando você tem fluxos muito diferentes.
Exemplos comuns:
- Agente de Atendimento — dúvidas, 2ª via, status
- Agente Técnico — chamados, agendamento de visita
- Agente de Cobrança — outbound de pagamento
- Agente Comercial — interesse em planos novos
A rota DID → agente em /config/telefonia decide qual atende cada DID.
Por engine de voz
Apenas para agentes de telefone, você escolhe a engine:
ConectaAI (LiveKit)
Pipeline próprio com:
- STT: Whisper / Deepgram
- LLM: Claude (Anthropic)
- TTS: vozes em pt-BR
- Trunk: Athostec, Twilio, custom
Configurações avançadas liberadas — todos os parâmetros do agente podem ser tunados (latency budget, interim transcripts, voice activity detection, etc.)
Mais controle — útil se você tem necessidade específica
Latência um pouco maior que Retell em alguns casos
Retell
Parceiro especializado em voz IA.
Latência otimizada — ~700ms vs ~1s do ConectaAI
Voz natural — qualidade de áudio premium
Configs avançadas bloqueadas — você usa o que o Retell oferece, sem fine-tuning
Custo um pouco maior (incluído no plano Pro/Enterprise)
Quando o agente está em Retell, todas as configs avançadas no editor ficam visualmente desativadas (cinza). Isso é proposital — Retell não expõe esses parâmetros.
Por finalidade (use cases)
Combinações típicas que vemos em produção:
Provedor pequeno (1-3 mil assinantes)
- 1 agente híbrido genérico
- WhatsApp + 1 número de telefone
- Base de conhecimento de ~50 entries
- Engine ConectaAI
Provedor médio (3-15 mil)
- 1 agente principal (atendimento + técnico)
- 1 agente de cobrança outbound
- WhatsApp + 2-3 números (atendimento + cobrança + emergência)
- KB de ~200 entries
Provedor grande (15 mil+)
- Agentes especializados (mínimo 4)
- Vários números segmentados por região / tipo de serviço
- Engine Retell para latência crítica
- KB ramificada (com flows)
Tipos no Flow Builder
Dentro do Flow Builder, há 21 kinds de node organizados em 8 categorias:
| Categoria | Exemplos |
|---|---|
| Fluxo | Start, End, Branch, Switch, Subflow |
| Conversa | Pergunta, Resposta, Confirmação |
| Voz | Discar, Transferir, DTMF |
| Inteligência | LLM, Classify, Extract |
| Cliente | Buscar assinante, Atualizar dado |
| Ações | Webhook, HTTP Tool, MCP |
| Dados | Set variable, Calc |
| Outros | Wait, Log, Notify |
Cada kind tem flags isAdvanced e isVoiceOnly que controlam onde aparece. Veja Flow Builder para detalhes.