**As Ferramentas (Tools) do Capitão são ações que o assistente de inteligência artificial da Papo (https://papo.global/) pode executar para automatizar tarefas e interagir com outros sistemas. Elas permitem que a IA vá além de apenas responder perguntas, podendo realizar ações práticas como agendar reuniões, consultar o status de um pedido em um sistema externo ou criar um novo negócio no seu CRM, tudo diretamente da conversa com o cliente.**

Com as Ferramentas, você transforma seu assistente Capitão de um informante passivo em um agente proativo. Ele pode entender a intenção do cliente e usar uma ferramenta específica para resolver a solicitação na hora, sem a necessidade de intervenção humana. Isso abre um leque de possibilidades para automações complexas e eficientes.

| Tipo de Ferramenta | Descrição | Exemplo de Uso | Conhecimento Técnico |
| :--- | :--- | :--- | :--- |
| **Nativa** | Integrações pré-configuradas e prontas para usar, disponíveis na plataforma Papo. | Agendar uma demonstração no Google Agenda do vendedor. | Baixo (apenas ativar e conectar a conta). |
| **Customizada (HTTP)** | Ações personalizadas que se conectam a sistemas externos (ERPs, CRMs) ou à própria API da Papo. | Consultar o status de um pedido no sistema de e-commerce da empresa. | Avançado (requer conhecimento de APIs e requisições HTTP). |

## Como as Ferramentas do Capitão Funcionam?

O processo de funcionamento de uma Ferramenta (Tool) é um ciclo inteligente que conecta a conversa do cliente a uma ação concreta:

1.  **Interpretação da Intenção:** O cliente envia uma mensagem como "Gostaria de saber onde está meu pedido 12345" ou "Quero marcar uma reunião com um consultor".
2.  **Seleção da Ferramenta:** O Capitão analisa a mensagem e, com base nas instruções e descrições das ferramentas que você configurou, identifica qual delas é a mais adequada para resolver a solicitação.
3.  **Execução da Ação:** A IA aciona a ferramenta selecionada. Se for uma ferramenta para consultar um pedido, ela enviará o número "12345" para o seu sistema externo. Se for para agendar, ela consultará os horários livres na agenda.
4.  **Retorno da Resposta:** O sistema externo ou a ferramenta nativa devolve um resultado (ex: "Pedido em transporte" ou "Horários disponíveis: 14h e 15h").
5.  **Comunicação ao Cliente:** O Capitão usa essa informação para formular uma resposta natural e completa para o cliente, finalizando a solicitação de forma autônoma.

Esse fluxo transforma o atendimento, permitindo que a IA resolva problemas de ponta a ponta, e não apenas forneça informações básicas.

## Tipos de Ferramentas: Nativas vs. Customizadas

Você pode equipar seu assistente Capitão com dois tipos de ferramentas, cada uma com um propósito diferente.

### Ferramentas Nativas
São integrações prontas para uso, desenvolvidas e mantidas pela Papo. O objetivo é simplificar a conexão com serviços populares sem que você precise se preocupar com detalhes técnicos.

O principal exemplo é a **integração com o Google Agenda**. Ao ativá-la, você permite que o Capitão:
*   Verifique a disponibilidade em tempo real na agenda de um ou mais membros da equipe.
*   Ofereça os horários livres ao cliente durante a conversa.
*   Crie o evento automaticamente na agenda assim que o cliente confirma o horário desejado.

A configuração geralmente envolve apenas autorizar a Papo a acessar sua conta no serviço externo e ativar a ferramenta para o seu assistente.

### Ferramentas Customizadas (HTTP)
As ferramentas customizadas oferecem flexibilidade total, permitindo que o Capitão se comunique com praticamente qualquer sistema que possua uma API (Application Programming Interface). Isso inclui seu ERP, CRM, plataforma de e-commerce ou até mesmo outros módulos da própria Papo.

Para configurar uma ferramenta customizada, você precisa fornecer os detalhes da requisição HTTP que a IA deve fazer:
*   **URL do Endpoint:** O endereço da API que será chamada (ex: `https://api.meusistema.com/v1/pedidos`).
*   **Método HTTP:** A ação a ser realizada (GET para buscar dados, POST para criar, PUT para atualizar, etc.).
*   **Headers (Cabeçalhos):** Informações adicionais, como chaves de autenticação (`Authorization: Bearer sk_sua_chave_secreta`) para garantir que a requisição seja segura e autorizada.
*   **Body (Corpo da Requisição):** Os dados a serem enviados, geralmente em formato JSON. Você pode usar variáveis da conversa para tornar a ação dinâmica (ex: `{"id_pedido": "{variavel_numero_pedido}"}`).

Com isso, você pode criar automações como "consultar saldo de pontos de fidelidade", "criar um lead no CRM da Papo" ou "abrir um ticket de suporte no seu sistema interno".

## Passo a Passo: Como Configurar uma Ferramenta no Capitão

Embora os nomes exatos dos menus possam variar, o processo conceitual para habilitar uma ferramenta para seu assistente segue uma lógica clara.

1.  **Acesse as Configurações do Assistente:** No painel da Papo, navegue até a área de configuração do Capitão que você deseja aprimorar.
2.  **Localize a Seção de Ferramentas (Tools):** Dentro das configurações do assistente, procure pela opção de gerenciar ou adicionar novas ferramentas.
3.  **Adicione uma Nova Ferramenta:** Escolha entre usar uma "Ferramenta Nativa" da lista ou criar uma "Ferramenta Customizada".
4.  **Para Ferramentas Nativas:**
    *   Selecione a integração desejada (ex: Google Agenda).
    *   Siga as instruções na tela para conectar sua conta e conceder as permissões necessárias.
    *   Ative a ferramenta para que o Capitão possa começar a usá-la.
5.  **Para Ferramentas Customizadas (HTTP):**
    *   **Dê um Nome e uma Descrição:** Esta é uma etapa crucial. O nome deve ser claro (ex: "VerificarStatusPedido") e a descrição precisa explicar em linguagem natural o que a ferramenta faz e quando deve ser usada (ex: "Use esta ferramenta para obter o status de um pedido quando o cliente fornecer o número"). A IA usará essa descrição para decidir quando acionar a ação.
    *   **Configure a Requisição:** Preencha os campos técnicos: URL do endpoint, método HTTP, cabeçalhos de autenticação e o corpo da requisição, usando variáveis quando necessário.
    *   **Salve e Ative:** Após preencher todos os dados, salve a configuração.
6.  **Teste a Ferramenta:** Envie uma mensagem para o assistente em um canal de teste, simulando o pedido de um cliente, para garantir que a ferramenta está sendo acionada corretamente e que a resposta é a esperada.

## Perguntas Frequentes (FAQ)

### ### O que é uma API e por que preciso dela para ferramentas customizadas?
Uma API (Interface de Programação de Aplicações) é um conjunto de regras e definições que permite que diferentes sistemas de software se comuniquem. Para ferramentas customizadas, a API do seu sistema (ERP, CRM, etc.) é a "ponte" que permite ao Capitão enviar e receber informações, como consultar um pedido ou criar um cliente.

### ### Preciso saber programar para usar as Ferramentas do Capitão?
Para **ferramentas nativas**, não. A configuração é simples e guiada, envolvendo cliques e autorizações de conta. Para **ferramentas customizadas (HTTP)**, sim, é necessário ter um conhecimento básico sobre como APIs e requisições HTTP funcionam. Este é um recurso mais avançado, voltado para desenvolvedores ou equipes com suporte técnico.

### ### O Capitão pode usar ferramentas para executar ações dentro da própria Papo?
Sim. Você pode usar as ferramentas customizadas para interagir com a API da própria Papo. Por exemplo, é possível criar uma ferramenta que, ao identificar um novo lead na conversa, faz uma chamada para a API da Papo e cria um novo contato no CRM ou adiciona uma etiqueta específica a ele.

### ### Como a IA sabe qual ferramenta usar em cada situação?
A IA decide com base em dois fatores principais: a intenção detectada na mensagem do usuário e a **descrição** que você fornece ao configurar a ferramenta. Uma descrição clara e precisa, como "Use esta ferramenta para agendar uma visita técnica", é fundamental para que o Capitão entenda o contexto e escolha a ação correta.

### ### As ferramentas customizadas são seguras?
A segurança das conexões via ferramentas customizadas depende da implementação correta. A Papo armazena suas chaves de API de forma segura, mas é sua responsabilidade garantir que você está se conectando a endpoints seguros (HTTPS) e usando chaves de API que tenham apenas as permissões necessárias para executar a ação, minimizando riscos.

## Leia Também
*   [Conheça o Capitão: Como configurar seu assistente de IA personalizado](/hc/papo/articles/conheca-o-capitao-como-configurar-assistente-ia-personalizado)
*   [O que é a API da Papo e para que serve?](/hc/papo/articles/o-que-e-api-papo-para-que-serve)

---

**[Comece grátis e automatize suas tarefas →](https://papo.global/?utm_source=helpcenter&utm_medium=article&utm_campaign=o-que-sao-ferramentas-tools-capitao-como-usar&utm_content=pt_BR)**

Centralize seu atendimento e comece a usar a IA para responder clientes em segundos.