Recursos de IA — v2.0
O LeadHub v2.0 introduz três recursos de IA principais que transformam seu CRM de um repositório passivo de leads em um motor ativo de leads:
| Recurso | O Que Faz |
|---|---|
| LeadBot | Chatbot de IA incorporável no seu site — qualifica visitantes, captura leads e agenda reuniões 24/7 |
| AI SDR | Agente de acompanhamento autônomo que trabalha leads por e-mail, SMS e WhatsApp em uma cadência inteligente |
| Construtor de Fluxo Visual | Canvas de arrastar e soltar para criar automações visualmente — o mesmo motor, interface bonita |
Todos os três recursos funcionam em hospedagem compartilhada (sem Redis, sem Supervisor, sem etapa de build). Eles degradam graciosamente quando nenhuma chave OpenAI está configurada.
Configurando a IA
Adicionando sua Chave de API OpenAI
- Vá para Configurações → IA & Integrações.
- Insira sua Chave de API OpenAI (começa com
sk-). - Clique em Salvar e Verificar — o sistema envia uma requisição de teste para confirmar que a chave é válida.
Cada inquilino gerencia sua própria chave. A chave do super admin nunca é compartilhada com os inquilinos.
Se nenhuma chave estiver configurada, o LeadBot exibe uma mensagem amigável de "indisponível" para os visitantes, e o AI SDR volta para uma sequência de modelos simples. Nenhum recurso quebra — eles simplesmente funcionam sem IA.
Limites de Gastos com IA
Para evitar custos de API fora de controle, você pode definir limites de gastos por inquilino:
- Vá para Configurações → IA & Integrações → Limites de Gastos.
- Defina um Limite Diário e/ou Limite Mensal (em USD).
- Quando um limite é atingido, os recursos de IA ficam pausados pelo restante desse período e são retomados automaticamente quando o contador é reiniciado.
Registro de Uso
Configurações → IA & Integrações → Uso exibe um log completo de cada requisição de IA:
| Coluna | Descrição |
|---|---|
| Data | Quando a requisição foi feita |
| Recurso | LeadBot, AI SDR, ou outro |
| Modelo | Modelo OpenAI utilizado |
| Tokens Entrada/Saída | Contagens de tokens de prompt e conclusão |
| Custo (USD) | Custo calculado para essa requisição |
| Total Acumulado | Gasto acumulado neste mês |
Isso lhe dá visibilidade completa dos custos de IA antes de sua fatura OpenAI chegar.
Requisitos
- Chave de API OpenAI (necessária para respostas de IA; fallback gracioso sem ela)
- PHP 8.4+ (já exigido pelo LeadHub)
- Cron job — o cron de 15 minutos usado para filas também aciona os ticks do AI SDR
- Sem Redis, sem Supervisor, sem npm/Node.js necessários
Super Admin: Controles de IA por Inquilino
Super admins podem visualizar e substituir configurações de IA para qualquer inquilino:
- Super Admin → Inquilinos → [inquilino] → Editar.
- A aba Configurações de IA mostra o gasto atual do inquilino, limites e status da chave.
- Você pode definir um limite mensal fixo no nível do inquilino a partir daqui — útil para limitar o uso de recursos em planos de nível inferior.