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.