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:
- O cliente pergunta sobre o pedido: Envia algo como “Cadê meu pedido 12345?”.
- 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.
- A Ferramenta é acionada: O assistente envia o número “12345” para o endpoint do seu sistema externo.
- O sistema retorna o status: A API devolve um resultado, como “Pedido em transporte” ou “Pedido entregue”.
- 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:
- 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.
- Crie uma Ferramenta do tipo customizada HTTP: Escolha a opção que permite conectar a um sistema externo via API.
- 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. - 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.
- 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”.
- 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
- Como testar a conexão de um webhook da Papo antes de ativar a automação
Comece grátis e configure a consulta de pedidos com o Capitão →
Centralize WhatsApp, Instagram, e-mail e SMS em uma só caixa com a IA da Papo respondendo em 2 segundos.