Ferramentas (Tools) são ações que o agente de IA pode executar durante uma conversa — como consultar pedidos, criar tarefas, agendar eventos no calendário e muito mais. Cada ferramenta requer permissão explícita para ser usada.
Ferramentas disponíveis
O CloudWhats pode expor ao agente um conjunto amplo de ferramentas, organizado por categorias funcionais. A disponibilidade real depende das permissões habilitadas para cada agente:
📦 Pedidos
- Consultar pedidos — buscar pedidos do contato
- Atualizar status — alterar o status de um pedido
✅ Tarefas
- Consultar tarefas — listar tarefas do contato
- Criar tarefa — criar nova tarefa
- Atualizar tarefa — editar tarefa existente
- Excluir tarefa — remover tarefa
💼 CRM (Negócios)
- Consultar deals — listar negócios do contato
- Criar deal — abrir novo negócio
- Atualizar deal — mover etapa ou editar dados
- Excluir deal — remover negócio
🔔 Lembretes
- Consultar lembretes — ver lembretes da conversa
- Criar lembrete — agendar um lembrete
- Excluir lembrete — cancelar lembrete
⏰ Mensagens agendadas
- Consultar agendamentos — ver mensagens programadas
- Agendar mensagem — programar envio futuro
- Cancelar agendamento — remover mensagem agendada
📅 Google Calendar
- Listar eventos — consultar agenda do calendário
- Criar evento — agendar reunião ou compromisso
🖼️ Galeria
- Buscar na galeria — pesquisar mídias por tags
- Enviar item — enviar imagem/documento da galeria
👤 Handoff
- Transferir para usuário — encaminhar para atendente específico
- Transferir para time — encaminhar para um time
Sistema de permissões
Cada ferramenta precisa ser explicitamente habilitada na configuração do agente. As permissões são granulares:
- Leitura — consultar dados (ex: ver pedidos, listar tarefas)
- Criação — criar novos registros (ex: criar tarefa, criar deal)
- Atualização — editar registros existentes (ex: alterar status de pedido)
- Exclusão — remover registros (ex: excluir tarefa)
Contexto de dados
Além das ferramentas de ação, você pode incluir dados como contexto para o agente entender melhor o contato:
| Contexto | Limite padrão | Descrição |
|---|---|---|
| Histórico de pedidos | 5 pedidos | Últimos pedidos do contato |
| Tarefas | 10 tarefas | Tarefas associadas ao contato |
| Deals do CRM | 5 deals | Negócios em andamento |
| Lembretes | 5 lembretes | Lembretes pendentes da conversa |
| Mensagens agendadas | 5 mensagens | Mensagens programadas |
| Itens da galeria | 20 itens | Mídias disponíveis para envio |
| Campos customizados | Todos | Campos personalizados do contato |
Como funciona a execução
Quando o agente decide usar uma ferramenta:
- O modelo de IA identifica que uma ferramenta é necessária
- O CloudWhats valida as permissões do agente
- O ID do contato é inferido automaticamente do contexto da conversa
- A ferramenta é executada e o resultado retorna ao modelo
- O agente formula a resposta final usando os dados obtidos
- Toda execução é registrada no log de auditoria
Auditoria de acessos
Todas as ações executadas pelo agente são registradas em um log de auditoria que inclui: qual agente, qual conversa, qual contato, tipo de dado acessado (ORDERS, TASKS, CRM, etc.), tipo de ação (READ, CREATE, UPDATE, DELETE), IDs dos recursos afetados e timestamp. Esses logs são acessíveis pelo painel administrativo.
Privacidade operacional
Se você permitir acesso a calendário, CRM, tarefas, lembretes, galeria ou mensagens agendadas, o agente poderá usar esses dados para responder ou executar ações dentro do escopo autorizado.