CRM - Interações com Clientes

O que é

A página Interações é a linha do tempo de contatos do CRM. Ela lista, em ordem decrescente pela data da interação, todos os registros de Ligação, Email, WhatsApp, Reunião, Visita e Nota lançados pela equipe contra um cliente do CRM. Cada item mostra o tipo, o cliente, a oportunidade vinculada (quando existir), quem registrou e um trecho da descrição.

A tela costuma ser usada pelo vendedor para auditar o que já foi falado com o lead antes de um follow-up, e pelo gerente do CRM para acompanhar a cadência de contato da equipe. Para empresas que customizaram o vocabulário do módulo, o título e o rótulo do botão respeitam o termo configurado em CRM > Configurações (por padrão "Interação" / "Interações").

Como usar

1. Acesse Módulos > CRM > Interações no menu lateral.
2. Use a barra de filtros abaixo do cabeçalho para refinar a lista:
   • Buscar por título ou descrição... - pesquisa no título e no texto livre (case-insensitive, via ILIKE).
   • Tipo - restringe a um dos seis canais: Ligação, Email, WhatsApp, Reunião, Visita ou Nota.
3. Para criar um novo registro, clique em Nova Interação (FAB no canto superior direito). Você será levado ao formulário de cadastro.
4. No formulário de cadastro, preencha:
   • Cliente - obrigatório, escolha um cliente já existente no CRM.
   • Tipo - obrigatório, define o ícone e a cor do badge na timeline.
   • Oportunidade - opcional; só lista oportunidades abertas ao criar, mas o vínculo é mantido depois mesmo que ela seja fechada.
   • Direção - opcional, "Entrada" (recebida) ou "Saída" (enviada).
   • Título - texto curto que vira o destaque do item na lista; se ficar em branco, a lista mostra o tipo capitalizado.
   • Descrição - texto longo livre; é o que aparece resumido (200 caracteres) na lista.
   • Duração (minutos) - quando preenchida, vira um badge cinza ao lado do badge de tipo.
   • Resultado - texto curto (até 100 caracteres) que aparece em destaque azul abaixo da descrição.
   • Data da Interação - se ficar vazia, o sistema usa o instante atual. Se você escolher apenas a data de hoje (sem hora), o sistema substitui pelo horário atual para preservar a ordenação da timeline.
5. Dentro de cada item da lista, use a barra de ações para:
   • Editar - abre o formulário de edição da interação.
   • Ver Cliente - vai para a ficha do cliente vinculado.
   • Ver Oportunidade - vai para a oportunidade vinculada (só aparece se houver vínculo).
   • Excluir - pede confirmação e remove o registro.

Casos especiais

Registro rápido via modal/API

A rota POST /admin/crm/interacoes/rapido (registroRapido) aceita um payload mínimo (cliente_id, tipo, descricao, resultado e oportunidade_id opcional) e responde JSON. Ela é usada por modais embutidos em outras telas do CRM (por exemplo, ao registrar uma ligação rápida na ficha do cliente) e sempre grava data_interacao = now().

Criação a partir de uma oportunidade

Se você chegar em Nova Interação com ?cliente_id= ou ?oportunidade_id= na URL, o formulário pré-preenche esses campos. Ao salvar, se a interação tiver oportunidade_id, o redirecionamento volta para a tela da oportunidade em vez da listagem, mantendo o fluxo de trabalho dentro do funil.

Botões "Salvar e continuar" / "Salvar e criar nova"

O formulário aceita duas variantes de submit (campo oculto _action):

• save_and_continue - após salvar, volta para a edição da mesma interação (útil para acrescentar anexos ou ajustes).
• save_and_create_new - após salvar, abre um novo formulário em branco para registrar outro contato em sequência.

Termo customizado do módulo

Os títulos da página ("Interações", "Nova Interação", mensagens do estado vazio) usam CrmConfiguracao::atual()->termo('interacao'). Se você tiver renomeado o termo (em CRM > Configurações > Termos), todos os rótulos visíveis são atualizados automaticamente.

Erros comuns e como resolver

• Botão "Nova Interação" não aparece / acesso negado - Causa: o módulo CRM não está ativo no plano ou o usuário não tem a permissão crm.interacoes. Solução: ative o módulo em Configurações > Plano e Cobrança e conceda a permissão ao papel do usuário.
• "The selected cliente id is invalid" - Causa: o cliente_id enviado não existe (ou foi excluído). Solução: refaça a seleção do cliente no autocomplete do formulário.
• "The selected oportunidade id is invalid" - Causa: a oportunidade foi excluída entre a abertura do formulário e o envio. Solução: deixe o campo de oportunidade em branco ou selecione outra ainda existente.
• "The selected tipo is invalid" - Causa: o valor de Tipo está fora da lista aceita (ligacao, email, whatsapp, reuniao, visita, nota). Solução: escolha pelo select; não envie valores manuais.
• A interação não aparece na ordem esperada da timeline - Causa: foi salva com data sem hora num dia que não é hoje. Solução: edite o registro e ajuste a Data da Interação com hora.
• Excluir mostra "Excluir esta interação?" mas não remove - Causa: o usuário não tem a permissão de excluir o CRM (a rota DELETE exige essa permissão específica, distinta de crm.interacoes). Solução: conceda excluir o CRM ao papel ou peça a um Gerente que exclua.

Onde encontrar

• URL: /admin/crm/interacoes
• Caminho no menu: Módulos > CRM > Interações
• Permissão necessária: ver o CRM + crm.interacoes (para excluir: excluir o CRM)
• Módulo necessário: CRM - Gestão de Relacionamento

Veja também

• Gerenciar Leads
• Oportunidades de Venda
• Tarefas e Follow-ups