**Para configurar o Capitão da Papo (https://papo.global/) para consultar status de pedido em tempo real, use uma Ferramenta (Tool) customizada via HTTP. Ela conecta o assistente ao endpoint do seu ERP, e-commerce ou CRM e permite que a IA interprete a mensagem do cliente, envie o número do pedido ao sistema externo e devolva o status durante a conversa no WhatsApp.**

Com essa configuração, o Capitão deixa de ser apenas um assistente que responde perguntas e passa a executar ações práticas. O cliente pode enviar “onde está meu pedido 12345?” e receber uma resposta automática, como “Pedido em transporte”, sem intervenção humana. Isso reduz fila, acelera o atendimento e libera a equipe para casos complexos.

## 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 ERP, e-commerce ou CRM. | Exemplo: `https://api.meusistema.com/v1/pedidos`. |
| **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 número do pedido** | Permitir que o Capitão use a informação fornecida pelo cliente na conversa. | A ação se torna dinâmica conforme o pedido 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 status com o Capitão

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

1. **O cliente pergunta sobre o pedido:** Envia algo como “Cadê meu pedido 12345?”.
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 status.
3. **A Ferramenta é acionada:** O assistente envia o número “12345” para o endpoint do seu sistema externo.
4. **O sistema retorna o status:** A API devolve um resultado, como “Pedido em transporte” ou “Pedido entregue”.
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 copiar o número do pedido e abrir outro sistema.

## 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, CRM ou plataforma de e-commerce.
- **A URL do endpoint** que será chamada para consultar o pedido.
- **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 dados 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 pedidos

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 status de um pedido no e-commerce da empresa. | Avançado, requer APIs e requisições HTTP. |

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

## Configurando a Ferramenta customizada para status de pedido

O processo conceitual para habilitar a consulta de pedidos segue uma lógica clara:

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 número do pedido será enviado:** A Ferramenta pode usar dados da conversa para tornar a ação dinâmica. Assim, quando o cliente informa o pedido 12345, o Capitão envia esse valor na chamada.
5. **Descreva claramente quando a Ferramenta deve ser usada:** O Capitão seleciona a ferramenta adequada com base nas instruções e descrições que você configurou. Inclua exemplos de mensagens, como “consultar status”, “onde está meu pedido” ou “rastrear pedido”.
6. **Vincule o assistente a uma caixa de entrada:** Ative o Capitão na caixa de entrada do WhatsApp ou de outro canal conectado à Papo. A partir daí, ele passará a responder as solicitações de status dentro da conversa.

Os nomes exatos de telas e botões podem variar dentro da plataforma. Se houver dúvida sobre a localização de um campo, consulte a Central de Ajuda ou o suporte da Papo.

## Quando essa automação faz sentido

Configurar a consulta de status de pedido em tempo real é útil para operações que:

- Recebem muitas perguntas repetidas sobre pedidos no WhatsApp.
- Vendem por e-commerce ou trabalham com prazos de entrega.
- Querem diminuir o tempo de primeira resposta em conversas de pós-venda.
- Precisam liberar a equipe para casos que exigem análise humana, como trocas, reembolsos ou reclamações.
- Já possuem um sistema externo com API de consulta de pedidos.

Se a sua operação ainda não tem uma API de pedidos, a personalização completa pode não ser possível imediatamente. Nesse caso, vale avaliar se uma Ferramenta nativa da Papo atende a outra etapa do atendimento, como agendamento de demonstração no Google Agenda.

## Perguntas frequentes

### Preciso saber programar para configurar a consulta de status?

Sim, para Ferramentas customizadas HTTP é necessário conhecimento avançado de APIs e requisições HTTP. Ferramentas nativas têm configuração mais simples, mas não cobrem automaticamente todos os sistemas externos.

### O Capitão consegue consultar mais de um sistema?

Sim. Você pode configurar múltiplas Ferramentas customizadas para que o Capitão se comunique com diferentes APIs, como ERP, CRM ou plataforma de e-commerce.

### Como garantir a segurança da consulta?

Use headers de autenticação, como um token de acesso, para que a requisição seja segura e autorizada. Por exemplo, `Authorization: Bearer sua_chave_secreta`. Não compartilhe chaves publicamente e valide o acesso apenas ao endpoint necessário.

### Posso testar antes de ativar no WhatsApp?

Sim. O ideal é validar a chamada da API com uma ferramenta externa de testes antes de ativar o assistente na caixa de entrada, evitando respostas incorretas para o cliente.

### O que acontece se o sistema externo retornar um erro?

O Capitão só consegue responder com base no retorno da API. Se o endpoint estiver fora do ar ou retornar um erro, a resposta pode não conter o status. Por isso é importante monitorar a disponibilidade do sistema integrado.

Leia também:
- [Como treinar o Capitão para identificar intenção de compra e transferir para um vendedor](/hc/papo/articles/treinar-capitao-identificar-intencao-compra-transferir-vendedor)
- [Como testar a conexão de um webhook da Papo antes de ativar a automação](/hc/papo/articles/testar-conexao-webhook-papo-antes-ativar-automacao)

---

**[Comece grátis e configure a consulta de pedidos com o Capitão →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=configurar-capitao-consultar-status-pedido-tempo-real&utm_content=pt_BR)**

Centralize WhatsApp, Instagram, e-mail e SMS em uma só caixa com a IA da Papo respondendo em 2 segundos.