Como criar uma Ferramenta (Tool) do Capitão para buscar cotação de frete

Abrir em

Ver como Markdown

Abrir no ChatGPT Abrir no Claude

Vitor

Última atualização em Oct 15, 2026

Para criar uma Ferramenta (Tool) do Capitão que busca cotação de frete, utilize uma Tool customizada HTTP na plataforma Papo (https://papo.global/). Ela conecta o assistente à API da sua transportadora ou plataforma logística e permite que a IA interprete dados como CEP de destino, peso e dimensões enviados pelo cliente, consulte o sistema externo e devolva automaticamente o valor do frete durante a conversa no WhatsApp.

Com essa configuração, o Capitão deixa de ser apenas um assistente que tira dúvidas e passa a executar ações práticas de logística. O cliente pode perguntar “Quanto custa o frete para o CEP 02030‑040?” e receber na hora uma resposta como “O frete para esse CEP fica em R$ 18,90 com prazo de 3 dias úteis”, sem intervenção humana. Isso reduz o atrito na compra, acelera o atendimento e libera a equipe para negociações mais complexas.

Resumo da configuração

Etapa	O que fazer	Observação
1. Acessar as configurações do Capitão	Abrir as definições do assistente na Papo.	Os nomes exatos dos menus podem variar.
2. Criar Ferramenta customizada	Usar o tipo HTTP para conectar o Capitão a uma API de transportadora.	Requer conhecimento técnico de requisições HTTP.
3. Definir o endpoint	Informar a URL da API que calcula o frete (ex.: Correios, Braspress, Intelipost).	Exemplo: `https://api.transportadora.com/v1/cotacao`.
4. Configurar método e autenticação	Usar POST ou GET com headers de segurança, como token de acesso.	Exemplo: `Authorization: Bearer sua_chave_api`.
5. Enviar os dados da cotação	Permitir que o Capitão extraia da conversa o CEP, peso, formato ou outros parâmetros exigidos pela API.	A ação se torna dinâmica conforme o que o cliente informa.
6. Vincular ao WhatsApp	Ativar o assistente na caixa de entrada do WhatsApp.	A consulta passa a funcionar em tempo real no atendimento.

Como funciona a consulta de frete com o Capitão

O fluxo conecta uma pergunta comum do cliente a um cálculo em tempo real:

O cliente pede uma cotação: Envia uma mensagem como “Qual o frete para o CEP 04123‑000?”.
O Capitão interpreta a intenção: Com base nas instruções e descrições das ferramentas, ele reconhece que deve usar a Tool de cotação.
A Ferramenta é acionada: O assistente envia os valores extraídos da conversa (CEP, peso do produto, etc.) para o endpoint da transportadora.
A API devolve o valor e o prazo: O sistema externo retorna um JSON com as opções de frete disponíveis.
O Capitão responde ao cliente: A IA traduz esses dados em uma resposta natural, como “Temos PAC por R$ 22,90 (7 dias) e Sedex por R$ 39,50 (2 dias)”.

Todo o processo ocorre sem que um agente humano precise copiar CEP e abrir outro sistema.

Pré‑requisitos para configurar a Tool de cotação

Antes de criar a ferramenta, é necessário ter:

Um assistente Capitão já criado na plataforma Papo, com nome e descrição definidos.
Uma API de transportadora disponível, seja dos Correios, de uma plataforma logística (Intelipost, Frenet, SuperFrete) ou de um sistema próprio de gestão de entregas.
A URL do endpoint que será chamada para calcular o frete.
Credenciais de autenticação (chave de API, token ou header específico) para que a requisição seja segura.
Conhecimento de APIs e requisições HTTP, pois a configuração de Ferramentas customizadas é avançada.

Caso sua transportadora não ofereça uma API pública, será necessário desenvolver um intermediário ou utilizar uma solução de cotação que já exponha um endpoint. As especificações técnicas devem ser validadas com a equipe de desenvolvimento ou com a documentação do fornecedor.

Ferramentas nativas vs. customizadas para logística

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 via API.	Consultar cotação de frete em tempo real no WhatsApp.	Avançado, requer APIs e requisições HTTP.

Para buscar cotações de frete, o caminho indicado é a Ferramenta customizada HTTP, pois o cálculo depende de cada transportadora ou operador logístico. Não há uma integração nativa genérica para qualquer transportadora; você precisará do endpoint específico do serviço de cotação que utiliza.

Configurando a Tool customizada para cotação de frete

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

Acesse as configurações do assistente: No painel da Papo, vá até 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.
Informe os dados da requisição: Preencha a URL do endpoint da transportadora, o método HTTP (geralmente POST, pois você envia CEP e recebe o cálculo) e os headers de autenticação, como Authorization: Bearer sua_chave.
Defina os parâmetros dinâmicos: A grande vantagem é que o Capitão pode usar informações que o próprio cliente fornece na conversa. Você pode configurar a ferramenta para enviar o CEP que apareceu na mensagem, o peso padrão do produto ou o formato da encomenda. A ferramenta interpretará esses valores automaticamente.
Instrua o Capitão sobre como responder: Na descrição da ferramenta ou nas diretrizes do assistente, você pode orientar a IA a apresentar o valor e o prazo de forma amigável, como “Seu frete para o CEP … sai por R$ … e chega em …”.
Vincule o assistente à caixa de entrada: Certifique-se de que o Capitão está ativado para o WhatsApp (ou outro canal) onde os clientes farão a pergunta.

Após a configuração, qualquer mensagem que mencione “frete”, “cotação” ou “envio” acionará o fluxo — desde que o Capitão reconheça a intenção. A resposta final vem dos dados reais da transportadora, sem que um colaborador precise intervir.

Perguntas frequentes

Preciso ter uma API da minha transportadora para usar essa Tool?

Sim. A Ferramenta customizada HTTP funciona chamando um endpoint que retorna o valor do frete. Se sua transportadora não oferece API, você pode usar um serviço de cotação (como Intelipost, Frenet ou SuperFrete) que consolida várias transportadoras e fornece um único endpoint.

Como o Capitão sabe qual CEP ou peso usar?

Durante a configuração, você pode indicar que o valor de CEP deve ser extraído diretamente da mensagem do cliente. A ferramenta usa variáveis dinâmicas para capturar esses dados. O assistente também pode confirmar com o cliente se a informação estiver incompleta, dependendo das instruções que você der.

É necessário um desenvolvedor para configurar?

Sim. A criação de uma ferramenta customizada HTTP exige conhecimento de APIs, métodos HTTP e autenticação. Normalmente, um desenvolvedor ou alguém com experiência em integrações realiza essa etapa. A Papo não fornece o endpoint da transportadora, apenas a infraestrutura para conectá-lo.

A cotação de frete fica registrada no CRM da Papo?

O histórico da conversa e a resposta gerada ficam salvos na caixa de entrada. A Papo não cria automaticamente um registro de cotação em um módulo específico (como um negócio no Kanban), mas você pode complementar o fluxo usando outras automações, como webhooks, para criar um lead ou tarefa a partir dessa interação.

Posso usar essa mesma Tool para consultar prazos de entrega?

Sim. Geralmente o retorno da API de frete já inclui o prazo estimado. A Tool pode ser configurada para exibir tanto o valor quanto o prazo na resposta do Capitão.

Existe custo adicional para usar Ferramentas customizadas?

As Ferramentas customizadas fazem parte das funcionalidades do Capitão para contas que têm acesso a esse recurso. Para detalhes sobre disponibilidade conforme o plano, consulte o site da Papo.