# Agilize Docs para IA - Página atual

Este arquivo contém uma versão focada e legível por IA da página aberta na documentação pública da Agilize.
Use esta versão quando a pergunta do usuário estiver restrita ao documento atual.

Última geração: 2026-05-28T23:42:17.794Z

## Página

- Título: Chamada em API Externa
- URL humana: https://agilize.app/docs/configuracao/referencias/nodes-fluxos-do-bot/chamada-em-api-externa
- Leitura completa para IA: https://agilize.app/docs/llms.txt
- Descrição: Executa um método de integração e segue pela rota de sucesso, falha ou limite.

## Seções

- Quando usar
- Campos de configuração
- Entradas e saídas
- Exemplo prático
- Boas práticas e riscos comuns
- Como testar
- Guias relacionados

## Conteúdo da página

# Chamada em API Externa

Executa um método de integração e segue pela rota de sucesso, falha ou limite. Este node deve ser usado dentro de fluxos do bot, sempre conectado a uma jornada com objetivo claro, rota esperada e tratamento para exceções.

## Quando usar

- Use quando o fluxo precisa chamar uma integração cadastrada e decidir o caminho pelo retorno.
- Aplique para consultar dados, validar informações ou executar operações externas.

## Campos de configuração

- **Plataforma e Método**: selecione a integração e a operação a executar.
- **Máx. Tentativas**: repete enquanto não atender à regra configurada.
- **Variável Saída**: armazena o retorno.
- **Dados de Entrada (DE/PARA)**: mapeamento de campos do método.
- **Avaliação do Resultado**: tipo de avaliação (padrão, existência, lista com itens, valor igual), campo avaliado e valor alvo.

## Entradas e saídas

- Entradas: recebe 1 entrada.
- Saídas: possui 3 saídas.
- Máximo de tentativas: usada quando a integração não atinge a condição de sucesso dentro do limite configurado.
- Nenhum retorno ou falha: usada quando a chamada retorna algo fora da regra esperada.
- Retorno com sucesso: usada quando a avaliação configurada é atendida.

## Exemplo prático

Consulte uma integração para validar CPF, buscar pedidos ou recuperar dados antes de decidir o próximo passo.

## Boas práticas e riscos comuns

- Teste com dados controlados antes de usar em produção.
- Defina o que acontece quando uma integração falha ou retorna vazio.
- Evite sobrescrever dados importantes sem uma regra clara de negócio.
- Utilize a variável de saída para tomadas de decisão subsequentes.
- Para notificações assíncronas, use Requisição HTTP (Webhook).

## Como testar

- Use dados de teste para simular sucesso, falha e retorno vazio.
- Confira se variáveis, tags, registros ou integrações foram alterados corretamente.
- Valide o caminho seguido depois da execução.

## Guias relacionados

- [Nodes de fluxos do bot](/docs/configuracao/referencias/nodes-fluxos-do-bot)
- [Guia geral de fluxos do bot](/docs/configuracao/fluxos-automacoes/guia-geral-de-fluxos-do-bot)
- [Fluxos do bot](/docs/configuracao/fluxos-automacoes/fluxos-do-bot)