> ## Documentation Index > Fetch the complete documentation index at: https://docs.chatnorris.ai/llms.txt > Use this file to discover all available pages before exploring further. # Laudus > Como conectar seu ERP Laudus a um agente do ChatNorris para responder preço e estoque ao vivo, atender seus clientes com os documentos deles (saldo, pagamentos, despachos e detalhes), reenviar faturas e boletas, importar o catálogo para a base de conhecimento e criar clientes a partir dos seus leads. # Laudus Com a integração do Laudus, seu agente do ChatNorris atende com os dados reais do seu ERP. Conforme o que você ativar, o agente: * busca produtos por nome ou SKU e responde o preço de venda e o estoque dos seus depósitos naquele momento; * atende seus clientes sobre os documentos deles: saldo pendente, se uma fatura está paga, o despacho e o detalhe do que compraram, sempre depois de verificar que é o cliente; * reenvia uma fatura ou boleta para o email de documentos cadastrado no Laudus; * usa seu catálogo de produtos como fonte de conhecimento; * cria no Laudus os clientes que chegam como leads pelo chat. Funciona no widget web, WhatsApp, Instagram, Messenger, Telegram, Email e na API. ## Requisitos * Uma conta do ChatNorris com plano **Premium**. O Laudus, assim como os outros ERPs (Odoo e Bsale), é exclusivo do Premium. Você pode ver os planos em [chatnorris.ai/pricing](https://chatnorris.ai/pricing). * Pelo menos um agente criado no ChatNorris. Se você ainda não tem um, siga [Criar um agente](https://docs.chatnorris.ai/pt/guias/crear-agente-wizard.md). * Uma empresa no Laudus ERP (Chile) e um **usuário de API** do Laudus. * Função **Owner** ou **Admin** na sua organização do ChatNorris. > [!NOTE] > > O Laudus aparece no hub com a etiqueta **Beta**. Se o cartão mostrar **Solicitar acesso**, peça por ali e avisaremos quando ele for habilitado para a sua organização (veja [Integrações em beta](https://docs.chatnorris.ai/pt/guias/integraciones.md#integrações-em-beta)). ## Conectar o Laudus Cada agente se conecta a uma empresa do Laudus. **1. Crie um usuário de API no Laudus** Recomendamos um usuário dedicado (por exemplo, «ChatNorris») com as permissões estritamente necessárias: leitura de produtos, estoque, preços, clientes e documentos de venda. Adicione o envio de documentos por email e a criação de clientes somente se você for ativar essas capacidades. **2. Abra o hub de Integrações do agente** No ChatNorris, acesse `Agentes → [seu agente] → Integrações` e escolha **Laudus**. **3. Informe os dados e conecte** Digite o **RUT da empresa** (com hífen e dígito verificador), o **usuário** e a **senha** do usuário de API e clique em **Conectar**. O ChatNorris testa os dados com o Laudus antes de salvá-los: se não funcionarem, ele avisa e não salva nada. A senha é salva criptografada e nunca aparece no dashboard. Com **Testar conexão**, você a verifica de novo quando quiser. Se você alterar a senha do usuário no Laudus, digite a nova e salve. ## Configurar a Ação Conectar o Laudus ainda não ativa nada. Para escolher o que o agente faz: **1. Crie a Ação Laudus** Acesse `Agentes → [seu agente] → Ações`, clique em **Nova ação** e escolha **Laudus**. **2. Escolha as capacidades** Ative as que quiser (veja a tabela abaixo). **3. Ative a Ação e salve** A partir desse momento, o agente usa o Laudus em todas as conversas. | Capacidade | O que faz | | - | - | | **Estoque e preço ao vivo** | Busca produtos por nome ou SKU e responde o preço de venda calculado pelo Laudus (da lista de preços que você escolher, ou o preço base do produto) e o estoque dos depósitos que você escolher. | | **Dívida pendente** | Responde quanto o cliente deve conforme os documentos pendentes dele: vencido, a vencer e total. | | **Status de pagamento** | Responde se um documento está pago, com os recebimentos registrados e o saldo. | | **Status de despacho** | Responde os dados de despacho de um documento: data, transportadora, comuna e guias de despacho. | | **Detalhe do documento** | Mostra os produtos e as quantidades de um documento, com o total. | | **Reenviar documento** | O Laudus reenvia a fatura ou boleta para o email de documentos do cliente, depois de um «sim» explícito. | | **Criar clientes a partir de leads** | Quando um lead confirma o email no chat, ele é vinculado ao cliente do Laudus que tiver esse email, ou é criado. Nunca modifica um cliente existente. | ### Estoque e preço Escolha a **lista de preços** que o agente usa (se você não escolher nenhuma, ele responde o preço base do produto no Laudus) e os **depósitos** cujo estoque ele soma (se você não escolher nenhum, ele informa o estoque total). O preço e o estoque são consultados no Laudus a cada pergunta: nunca é respondido um dado antigo. Os impostos e descontos são calculados pelo Laudus. > [!NOTE] > > Um agente responde preços e estoque a partir de uma única integração. Se outra já faz isso (WooCommerce, Shopify, Jumpseller, Odoo ou Bsale), desative-a antes de ativar esta. A consulta de pedidos do WooCommerce pode continuar ativa: os preços e o estoque vêm do Laudus e os pedidos, do WooCommerce. ### Consultas de clientes Antes de compartilhar qualquer dado de um cliente, o agente o verifica uma vez com o **RUT** e um **segundo dado** que você escolhe em **Verificação**: * o número (folio) e o valor total de um documento dele (padrão); * um email cadastrado no Laudus (o de contato ou o de documentos); * qualquer um dos dois. Depois de verificado, durante 30 minutos o cliente pode fazer todas as consultas ativadas sem informar os dados de novo. Para proteger seus clientes: * se algo não bater, o agente sempre responde a mesma coisa, sem dizer qual dado falhou, para que ninguém consiga adivinhar RUTs nem números de folio; * após 5 tentativas malsucedidas na mesma conversa, as consultas são bloqueadas; * só são consultados documentos vigentes (nunca anulados) dos tipos que você escolher em **Documentos que podem ser consultados** (faturas, boletas, notas de crédito e notas de débito) e dentro da **antiguidade máxima** que você configurar. > [!WARNING] > > Para essas capacidades, recomendamos **Claude Sonnet ou superior** como modelo do agente (`Configurações → IA`): elas revelam dados dos seus clientes e reenviam documentos reais depois de uma confirmação. ### Reenviar documentos Quando o cliente verificado pede uma fatura ou boleta, o agente mostra o email de documentos cadastrado no Laudus, mascarado (por exemplo, `f***@empresa.cl`), e pergunta se deve reenviá-la para lá. Só com um «sim» explícito o Laudus envia o documento com o PDF. * O documento vai sempre para o email cadastrado no Laudus, nunca para outro. Se o cliente precisar alterá-lo, o agente oferece falar com uma pessoa da equipe. * Em **Limites de reenvio**, você escolhe quantos reenvios são permitidos por conversa e por dia em todo o agente. * No Playground, o reenvio é simulado: nenhum email é enviado. ### Criar clientes a partir de leads Com essa capacidade, cada lead que confirma o email no chat (por exemplo, no Lead Form) fica cadastrado como cliente no Laudus: se já existir um com esse email, ele é vinculado; se não, é criado com nome, email e telefone. O ChatNorris nunca modifica um cliente que já existe. ## Importar o catálogo para a base de conhecimento Com o Laudus conectado, você pode adicionar seu catálogo como fonte de conhecimento para que o agente encontre o produto certo quando o visitante o descreve com as próprias palavras. **1. Adicione a fonte** Acesse `Agentes → [seu agente] → Base de conhecimento → Adicionar fonte` e escolha **Laudus**. **2. Importe o catálogo** Clique em **Importar catálogo**. São importados os produtos vigentes e vendáveis da sua empresa. * Cada produto vira um documento com nome, SKU, categoria e unidade de venda. * **Preços, estoque e custos não são salvos**: o agente os consulta ao vivo com a Ação Laudus. * A fonte é sincronizada de novo automaticamente todos os dias (sincronização automática do Premium). Com **Importar novamente**, você a atualiza quando quiser. Com a Ação ativa, a lista de fontes também mostra a linha **Catálogo do Laudus ao vivo**. Não é uma fonte: indica que o agente consulta preço e estoque diretamente no Laudus. ## Créditos Conectar o Laudus não consome créditos. Cada resposta do agente que consulta preço e estoque ao vivo soma **0,5 crédito de IA** ao custo normal da resposta. O catálogo importado ocupa caracteres da sua base de conhecimento como qualquer outra fonte. ## Desconectar Em `Agentes → [seu agente] → Integrações → Laudus`, clique em **Desconectar**. A Ação Laudus é desativada e mantém a configuração. Se você não for mais usar o usuário de API, desative-o no Laudus. ## Perguntas frequentes > [accordion] O agente não encontra um produto que existe > > O agente só vê os produtos **vigentes e vendáveis** do Laudus. Verifique se o produto não está descontinuado nem marcado como não vendável. Se você busca por SKU, verifique se ele está cadastrado no produto. > [accordion] O agente não consegue verificar um cliente > > Verifique se o RUT do cliente está cadastrado no Laudus e se o segundo dado confere: o número (folio) e o valor total de um documento vigente de um tipo habilitado, ou um email cadastrado na ficha dele. Se a conversa acumulou 5 tentativas malsucedidas, ela fica bloqueada: o cliente pode escrever de novo em outra conversa. > [accordion] O cliente não recebeu o documento reenviado > > O Laudus o envia para o email de documentos cadastrado na ficha do cliente. Peça que ele verifique a pasta de spam e confirme no Laudus se esse email está atualizado. > [accordion] A integração aparece como vencida > > O Laudus recusou os dados salvos, por exemplo porque a senha do usuário de API foi alterada. Digite a nova senha na integração e salve. > [accordion] Posso usar o Laudus e o WooCommerce no mesmo agente? > > Sim, com uma condição: preços e estoque vêm de apenas um dos dois. O mais comum é deixar no Laudus o estoque e o preço, e no WooCommerce a consulta de pedidos. Se você importar os dois catálogos para a base de conhecimento, o agente vê os produtos duas vezes: deixe só um ativo. This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.