Skip to main content
O módulo Produtos permite cadastrar o catálogo de itens vendidos pela sua operação e disponibilizá-lo para agentes de IA e para o pipeline de vendas. Cada produto pode ter variantes (tamanho, cor, plano, etc.), e pode ser vinculado a itens de pipeline para acompanhar oportunidades de venda em curso.
Disponível a partir do v1.0.0-rc3.

​
O que é o Catálogo de Produtos?

O catálogo é uma lista central de produtos da sua operação. Em vez de manter essa informação espalhada (planilhas, integrações externas, prompt de agente colado manualmente), você mantém uma fonte única dentro do CRM. Quando o agente de IA precisa falar de oferta, ele consulta esse catálogo. Quando um atendimento vira oportunidade, você liga o produto ao item de pipeline correspondente.

​
Como Funcionam os Produtos?

Cada produto tem:
  • Informações básicas: nome, descrição, preço, status (ativo/inativo).
  • Variantes: versões diferentes do mesmo produto (ex.: “Plano Básico”, “Plano Pro”, “Plano Enterprise”), cada uma com seu próprio preço e SKU.
  • Vinculação a agentes: você escolhe quais agentes têm acesso a quais produtos. Os produtos vinculados são injetados no contexto do agente no momento da conversa.
  • Vinculação a pipeline: dentro de um item de pipeline (uma oportunidade), você registra qual produto está sendo negociado. Útil para reports de venda por pipeline.

​
Casos de Uso Comuns

  • Atendimento comercial via WhatsApp: o agente conhece o catálogo e responde sobre preços/variantes sem que o operador precise colar tabela no prompt.
  • Acompanhamento de funil: cada conversa no pipeline registra o produto sob negociação, permitindo medir conversão por produto.
  • Carteira de produtos por agente: times diferentes (vendas, suporte, retenção) podem ter agentes com catálogos distintos.

​
Acessando o Módulo de Produtos

O acesso é feito pelo menu principal da plataforma, na seção Produtos.
A visibilidade do menu depende das permissões products.read no seu papel. Se o item não aparece, peça ao administrador para conceder a permissão (ver Funções Personalizadas).

​
Criando um Produto

Na tela do catálogo, clique em Novo Produto para abrir o formulário. Campos obrigatórios:
  • Nome — como aparece para o agente e para o operador.
  • Descrição — explicação curta usada pelo agente para contextualizar a oferta.
  • Status — ativo (disponível para venda) ou inativo (não aparece nas seleções).
Campos opcionais:
  • Preço base — referência usada quando não há variante.
  • SKU — código de inventário, se aplicável.

​
Trabalhando com Variantes

Variantes representam versões do mesmo produto com atributos distintos (preço, características, SKU). Exemplos:
  • Plano de software: “Básico”, “Pro”, “Enterprise” — preços diferentes, mesmo produto raiz.
  • Roupa: “P”, “M”, “G” — SKU e estoque diferentes.
  • Curso: “Mensal”, “Anual” — periodicidade e preço diferentes.
Cada variante tem nome, preço próprio e pode ter SKU. Quando um agente fala de um produto que tem variantes, ele apresenta as opções e ajuda o cliente a escolher.

​
Vinculando Produtos a Agentes

Na tela de configuração do agente, há uma aba Produtos. Lá você escolhe quais itens do catálogo o agente conhece. Apenas produtos com status ativo ficam disponíveis para vinculação. Ao vincular, o catálogo é injetado no contexto do agente em runtime. Isso significa que mudanças no catálogo (preço, descrição, nova variante) refletem na próxima conversa do agente, sem reconfigurar o prompt. Ver detalhes em Configuração de Agentes.

​
Vinculando Produtos a Itens de Pipeline

Dentro do detalhe de um item de pipeline, há um painel Venda onde você registra:
  • Qual produto está sendo negociado.
  • Qual variante (se houver).
  • Valor da negociação (pode diferir do preço de catálogo, em caso de desconto).
O agente de IA também pode fazer esse vínculo automaticamente durante uma conversa, usando a tool nativa link_product_to_pipeline_item. Quando o cliente confirma interesse em um item específico, o agente registra a vinculação sem intervenção manual.

​
Permissões

O acesso ao módulo é controlado por três permissões no recurso products: Por padrão, account_owner recebe manage e agent recebe read. Papéis customizados podem ter qualquer combinação. Ver Funções Personalizadas.

​
Considerações Finais

O catálogo de produtos:
  • Centraliza informação de oferta em um único lugar.
  • Conecta agentes de IA ao que sua empresa de fato vende.
  • Acopla pipeline de vendas ao catálogo, permitindo reports de conversão.
Para o passo a passo de vincular o catálogo ao agente, ver Configuração de Agentes. Para registrar vendas no pipeline, ver Gerenciando Pipelines.