**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 de um 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:** Dentro das opções de configuração do assistente, encontre a área dedicada às "Ferramentas" (Tools).
3.  **Adicione uma Nova Ferramenta:** Escolha entre adicionar uma ferramenta "Nativa" ou "Customizada (HTTP)".
4.  **Para Ferramentas Nativas:** Selecione o serviço desejado (como o Google Agenda) na lista de integrações disponíveis. Siga as instruções na tela para conectar e autorizar sua conta.
5.  **Para Ferramentas Customizadas:**
    *   **Dê um Nome e Descrição:** Crie um nome claro (ex: "Consultar Status do Pedido") e uma descrição detalhada para a IA. A descrição é crucial, pois ensina o Capitão quando e como usar a ferramenta (ex: "Use esta ferramenta para verificar o status de um pedido de um cliente quando ele fornecer o número do pedido").
    *   **Configure a Requisição HTTP:** Preencha os campos de URL do endpoint, método HTTP, cabeçalhos (para autenticação) e o corpo da requisição, se necessário.
6.  **Ative e Teste:** Após a configuração, ative a ferramenta para que o Capitão possa começar a usá-la. Realize testes enviando mensagens que deveriam acionar a nova ferramenta para garantir que tudo está funcionando como esperado.

## Perguntas Frequentes (FAQ)

### Qual a diferença entre Ferramentas (Tools) e Cenários?
As Ferramentas (Tools) são projetadas para executar ações em sistemas **externos** ou outras partes da API da Papo, como consultar um banco de dados ou agendar um evento. Já os Cenários são instruções para o Capitão executar uma ação **interna** na plataforma, como transferir a conversa para um atendente humano (transbordo) em situações específicas.

### Preciso saber programar para usar as Ferramentas?
Para as **Ferramentas Nativas**, como a integração com o Google Agenda, não é necessário conhecimento de programação. A configuração é feita por meio de uma interface simples. Para as **Ferramentas Customizadas (HTTP)**, é necessário ter conhecimento técnico sobre como funcionam as APIs, incluindo métodos HTTP, autenticação e formato JSON.

### Como a IA sabe qual Ferramenta usar?
A IA decide qual ferramenta usar com base na **descrição** que você fornece ao configurá-la. Uma descrição clara e detalhada, que explica o propósito da ferramenta e quais informações ela precisa, é fundamental. O Capitão analisa a intenção do cliente e a compara com as descrições de todas as ferramentas disponíveis para escolher a mais adequada.

### Posso usar as Ferramentas para interagir com a própria API da Papo?
Sim. Você pode configurar uma Ferramenta Customizada (HTTP) para fazer chamadas à API da Papo. Isso permite criar automações avançadas, como usar a IA para criar um novo contato no CRM, enviar uma mensagem por outro canal ou atualizar um atributo de um cliente, tudo a partir de uma instrução na conversa.

### É seguro usar Ferramentas Customizadas com minhas chaves de API?
Sim. As informações de autenticação, como chaves de API (tokens), são armazenadas de forma segura na plataforma Papo e utilizadas em comunicações de servidor para servidor, que são mais seguras. É uma boa prática de segurança criar chaves de API com permissões limitadas especificamente para essa integração, em vez de usar chaves com acesso total.

## Leia também
- [O que são Cenários e como usá-los para treinar a IA do Capitão](/hc/papo/articles/o-que-sao-cenarios-e-como-usa-los-para-treinar-ia-capitao)
- [Como gerar e usar chaves de API para integrar com outros sistemas](/hc/papo/articles/como-gerar-usar-chaves-api-integrar-sistemas)

---

**[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-pt&utm_content=pt_BR)**

O primeiro usuário é grátis e você já pode começar a configurar sua IA para executar ações reais.