Visão geral dos produtos
O módulo Produtos permite cadastrar o catálogo de itens vendidos pela sua operação e disponibilizá-lo aos agentes de IA e ao pipeline de vendas. Cada produto pode ter variantes (tamanho, cor, plano, etc.) e pode ser vinculado a itens de pipeline para rastrear oportunidades de vendas contínuas.
Disponível a partir de 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 essas informações dispersas (planilhas, integrações externas, prompts colados manualmente), você mantém uma única fonte dentro do CRM. Quando o agente de IA precisa falar sobre uma oferta, ele consulta este catálogo. Quando uma conversa se torna uma oportunidade, você vincula o produto ao item de pipeline correspondente.Como funcionam os produtos
Cada produto possui:- Informações básicas: nome, descrição, preço, status (ativo/inativo).
- Variantes: versões diferentes do mesmo produto (por exemplo, “Plano Básico”, “Plano Pro”, “Plano Empresarial”), cada uma com seu próprio preço e SKU.
- Vinculação de agente: 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 de pipeline: dentro de um item de pipeline (uma oportunidade), você registra qual produto está sendo negociado. Útil para relatórios de vendas por pipeline.
Casos de uso comuns
- Vendas via WhatsApp: o agente conhece o catálogo e responde preços/variantes sem que os operadores tenham que colar tabelas no prompt.
- Acompanhamento de funil: cada conversa do pipeline registra o produto em negociação, permitindo a medição da conversão por produto.
- Portfólio de produtos por agente: diferentes equipes (vendas, suporte, retenção) podem ter agentes com catálogos distintos.
Acessando o Módulo Produtos
O acesso é feito pelo menu principal da plataforma, em Produtos.
A visibilidade do menu depende da permissão products.read em sua função. Se a entrada não aparecer, peça ao administrador para concedê-la (consulte 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 — breve explicação utilizada pelo agente para contextualizar a oferta.
- Status —
active(disponível para venda) ouinactive(não aparece nos seletores).
- Preço base — referência utilizada quando não há variante.
- SKU — código de inventário, se aplicável.
Trabalhando com variantes
As variantes representam versões do mesmo produto com atributos distintos (preço, características, SKU). Exemplos:- Plano de software: “Basic”, “Pro”, “Enterprise” — preços diferentes, mesmo produto raiz.
- Vestuário: “S”, “M”, “L” — SKU e estoque diferentes.
- Curso: “Mensal”, “Anual” — periodicidade e preço diferenciados.
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. Somente produtos com statusactive estão disponíveis para vinculação.
Ao vincular, o catálogo é injetado no contexto do agente em tempo de execução. Isso significa que as alterações no catálogo (preço, descrição, nova variante) serão refletidas na próxima conversa do agente, sem reconfigurar o prompt.
Consulte detalhes em Configuração do Agente.
Vinculando produtos a itens de pipeline
Dentro do detalhe do item do pipeline, há um painel Venda onde você registra: *Qual produto está sendo negociado. *Qual variante (se houver). *Valor de negociação (pode diferir do preço de catálogo em caso de desconto). O agente AI também pode fazer essa ligação automaticamente durante uma conversa, usando a ferramenta nativalink_product_to_pipeline_item. Quando o cliente confirma o interesse em um item específico, o agente registra o link sem intervenção manual.
Permissões
O acesso ao módulo é controlado por três permissões no recursoproducts:
Por padrão,
account_owner obtém manage e agent obtém read. As funções personalizadas podem ter qualquer combinação. Consulte Funções personalizadas.
Considerações Finais
O catálogo de produtos:- Centraliza as informações da oferta em um único lugar.
- Conecta agentes de IA ao que sua empresa realmente vende.
- Acopla o pipeline de vendas ao catálogo, possibilitando relatórios de conversão.