**Para configurar o Capitão da Papo (https://papo.global/) para consultar estoque de produtos em tempo real, crie uma Ferramenta (Tool) customizada via HTTP. Ela conecta o assistente ao endpoint do seu sistema de gestão de estoque (ERP, WMS ou e-commerce) e permite que a IA interprete a pergunta do cliente, envie o código do produto à API e devolva a disponibilidade durante a conversa no WhatsApp.**

Com essa configuração, o Capitão deixa de ser apenas um assistente que responde dúvidas e passa a executar ações práticas de consulta. O cliente pode perguntar “Tem o tênis X no tamanho 42?” e receber uma resposta automática como “Sim, temos 3 unidades em estoque”, sem intervenção humana. Isso reduz o tempo de espera, evita frustrações e libera a equipe para negociações mais complexas.

## Resumo da configuração

| Etapa | O que fazer | Observação |
| :--- | :--- | :--- |
| **1. Acessar o Capitão** | Abrir as configurações do assistente na plataforma Papo. | Os nomes exatos dos menus podem variar. |
| **2. Criar Ferramenta customizada** | Usar o tipo HTTP para conectar o Capitão a um sistema externo com API. | Requer conhecimento técnico de APIs e requisições HTTP. |
| **3. Definir endpoint** | Informar a URL da API do seu sistema de estoque. | Exemplo: `https://api.meusistema.com/v1/estoque`. |
| **4. Configurar método e autenticação** | Usar GET para buscar dados e incluir headers de segurança, como token de autenticação. | Exemplo: `Authorization: Bearer sua_chave_secreta`. |
| **5. Enviar o código do produto** | Permitir que o Capitão use a informação fornecida pelo cliente na conversa. | A ação se torna dinâmica conforme o produto informado. |
| **6. Vincular ao WhatsApp** | Ativar o assistente na caixa de entrada do WhatsApp. | A consulta passa a funcionar durante o atendimento. |

## Como funciona a consulta de estoque com o Capitão

O fluxo é um ciclo que liga a pergunta do cliente a uma ação concreta:

1. **O cliente pergunta sobre disponibilidade:** Envia algo como “Tem o modelo X na cor azul?”.
2. **O Capitão entende a intenção:** Com base nas instruções e descrições das ferramentas configuradas, ele identifica que deve consultar o estoque.
3. **A Ferramenta é acionada:** O assistente envia o código do produto (extraído da conversa) para o endpoint do seu sistema externo.
4. **O sistema retorna a quantidade:** A API devolve um resultado, como `{ "disponivel": true, "quantidade": 5 }`.
5. **O Capitão responde ao cliente:** A IA usa esse retorno para formular uma resposta natural e completa no WhatsApp.

Todo esse processo acontece em tempo real, sem que um agente humano precise abrir outro sistema para verificar manualmente.

## Pré-requisitos para usar uma Ferramenta customizada HTTP

Antes de configurar, é importante ter:

- **Um assistente Capitão criado** na plataforma Papo, com nome e descrição definidos.
- **Um sistema externo com API disponível**, como ERP, WMS ou plataforma de e-commerce que exponha a consulta de estoque.
- **A URL do endpoint** que será chamada para obter a disponibilidade do produto.
- **Credenciais de autenticação**, como chave de API ou token de acesso, para manter a requisição segura.
- **Conhecimento de APIs e requisições HTTP**, já que a configuração de Ferramentas customizadas é avançada.

Se você não possui uma API no seu sistema ou não sabe quais parâmetros ela aceita, os detalhes técnicos devem ser validados com a equipe de desenvolvimento ou com a documentação do fornecedor.

## Ferramentas nativas vs. customizadas para estoque

A Papo oferece dois tipos de Ferramentas para o Capitão:

| Tipo | Descrição | Exemplo de uso | Conhecimento técnico |
| :--- | :--- | :--- | :--- |
| **Nativa** | Integrações pré-configuradas e prontas para usar na plataforma. | Agendar uma demonstração no Google Agenda. | Baixo, apenas ativar e conectar a conta. |
| **Customizada (HTTP)** | Ações personalizadas que se conectam a sistemas externos ou à API da Papo. | Consultar o estoque de um produto no ERP da empresa. | Avançado, requer APIs e requisições HTTP. |

Para consultar estoque em tempo real, o caminho mais comum é a Ferramenta customizada HTTP, pois os dados geralmente estão em um sistema próprio da empresa. Não há uma integração nativa automática para qualquer ERP ou WMS; cada sistema precisa ser conectado por meio do endpoint correspondente.

## Configurando a Ferramenta customizada para consulta de estoque

O processo conceitual para habilitar essa automação segue uma lógica clara, sem a necessidade de decorar nomes de telas ou botões:

1. **Acesse as configurações do assistente:** No painel da Papo, abra a área de configuração do Capitão onde as Ferramentas são gerenciadas.
2. **Crie uma Ferramenta do tipo customizada HTTP:** Escolha a opção que permite conectar a um sistema externo via API.
3. **Preencha os dados da requisição:** Informe a URL do endpoint, o método HTTP (GET para buscar dados) e os headers de autenticação, como `Authorization: Bearer sua_chave_secreta`.
4. **Defina como o código do produto será enviado:** A Ferramenta pode usar dados da conversa para tornar a ação dinâmica. Assim, quando o cliente informa o produto, o Capitão envia esse valor na chave esperada pela API (por exemplo, `?sku=XYZ`).
5. **Vincule o assistente à caixa de entrada do WhatsApp:** Ative o Capitão na caixa desejada para que a consulta funcione durante o atendimento.

Lembre-se de que o uso de Ferramentas customizadas pode consumir créditos de IA da sua conta, conforme a frequência de acionamento.

## Para quem essa configuração é indicada?

- **E-commerces e lojas virtuais** que precisam responder rapidamente sobre disponibilidade de produtos.
- **Varejistas com estoque físico** que atendem via WhatsApp e desejam automatizar a consulta.
- **Distribuidores e atacadistas** que gerenciam grandes catálogos e querem agilizar o atendimento ao cliente.
- **Empresas que já possuem uma API de estoque** e buscam integrar o atendimento sem desenvolver um chatbot do zero.

## Perguntas frequentes

### Preciso ter uma API de estoque para usar essa funcionalidade?
Sim. A Ferramenta customizada HTTP se conecta a um endpoint externo. Se o seu sistema de estoque não oferece uma API, será necessário desenvolver uma camada intermediária ou utilizar uma solução que já exponha esses dados.

### Posso consultar o estoque de vários produtos em uma única pergunta?
Depende da capacidade da sua API. Se o endpoint aceitar múltiplos códigos de uma vez, o Capitão pode enviar a lista e interpretar o retorno. Caso contrário, ele fará consultas individuais para cada produto mencionado.

### O Capitão consegue reservar ou dar baixa no estoque automaticamente?
Não. A Ferramenta customizada descrita aqui é apenas para consulta. Para ações como reserva ou baixa, seria necessário configurar endpoints que aceitem métodos POST/PUT e programar a lógica adequada, o que exige um desenvolvimento mais avançado.

### A consulta de estoque é segura?
Sim, desde que você utilize autenticação via token ou chave de API nos headers da requisição. O tráfego entre o Capitão e seu sistema é feito por HTTPS, mantendo os dados protegidos.

### Essa configuração tem custo adicional?
A criação de Ferramentas customizadas está disponível na plataforma Papo, mas o uso dessas ferramentas pode consumir créditos de IA. Os detalhes sobre consumo de créditos estão disponíveis no painel da sua conta.

## Leia também

- [Como otimizar a Base de Conhecimento para melhorar a busca RAG do Capitão](/hc/papo/articles/otimizar-base-conhecimento-busca-rag-capitao)
- [Como treinar o Prompt e IA com exemplos de conversas reais](/hc/papo/articles/treinar-prompt-ia-exemplos-conversas-reais)

---

**[Comece grátis e configure o Capitão para consultar estoque →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=configurar-capitao-consultar-estoque-produtos-tempo-real&utm_content=pt_BR)**

Com a Papo, você automatiza o atendimento no WhatsApp, reduz o tempo de resposta e libera sua equipe para o que realmente importa.