Integração com ferramentas (API / HTTP Request)

Ferramentas permitem que o agente consulte sistemas externos — como seu ERP, site ou banco de dados — durante uma conversa.

O que o agente pode fazer

• Consultar estoque ou status de pedido
• Buscar dados de um cliente em outro sistema
• Enviar informações para uma planilha ou CRM externo
• Validar cupons ou códigos promocionais
• Transferir a conversa para atendimento humano

Como adicionar uma ferramenta

1. Acesse Agentes e abra o agente desejado
2. Na seção Ferramentas, clique em Adicionar ferramenta
3. Escolha o tipo HTTP Request
4. Preencha:
   • Nome — o que a ferramenta faz (ex.: "Consultar pedido")
   • URL — endereço da API
   • Método — GET ou POST
   • Descrição — quando o agente deve usar esta ferramenta
5. Salve e teste

Figura 1: Seção de ferramentas HTTP na página do agente

Testar a ferramenta

1. Após salvar, clique em Testar
2. Informe os parâmetros de exemplo
3. Verifique se a resposta veio correta
4. Ajuste a descrição se o agente não souber quando usar

Templates WhatsWave

Além de ferramentas HTTP personalizadas, você pode usar templates prontos da WhatsWave para ações comuns.

Templates disponíveis incluem:

• Transferir Atendimento — aciona a transferência para humano usando POST /chats/transfer

Veja o passo a passo em Como configurar transferência para humano e a visão completa em Transferência de IA para humano.

Dicas

• Escreva descrições claras: "Use quando o cliente perguntar status do pedido"
• Comece com ferramentas de consulta (GET) antes de criar ou alterar dados
• Proteja URLs sensíveis — use autenticação quando disponível