Requisição SOAP

O módulo Requisição SOAP permite chamar um serviço web que usa o padrão SOAP, um formato de integração comum em sistemas corporativos e legados. É útil para integrar com sistemas externos que expõem esse tipo de serviço, em vez de uma API REST tradicional.

Para chamar uma API REST tradicional, use o módulo Requisição HTTP. Para uma API GraphQL, use o módulo Requisição GraphQL.

Na tela do Builder, este módulo pode aparecer com o nome em inglês, "Request SOAP", em vez de traduzido — isso é o mesmo módulo descrito nesta página.

🧭 Como acessar

1

No menu lateral, clique em Gerenciamento de aplicativos.

2

Em seguida, clique em Fluxos.

3

Abra ou crie um fluxo e acesse a área de trabalho do fluxo.

4

No painel de módulos, localize a categoria Integração (identificada pela cor azul).

5

Arraste o módulo Request SOAP para a área de trabalho do fluxo.

🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

🔗 WSDL e Method

Campo	O que preencher
WSDL	Endereço do arquivo WSDL do serviço SOAP (aceita variáveis do fluxo)
Method	Nome do método/operação a ser chamado, conforme definido no WSDL

🔐 Autenticação

Se o serviço exigir autenticação, ative uma das opções (elas são mutuamente exclusivas):

• WS Security — autenticação no padrão WS-Security, com Usuário e Senha.

• Basic Security — autenticação básica (usuário e senha), com Usuário e Senha.

Sempre preencha o Usuário e a Senha de verdade ao ativar uma dessas opções. Deixar os campos com o valor padrão da tela faz o módulo tentar se autenticar com credenciais inválidas, sem nenhum aviso no momento de salvar.

📋 WSDL Options e Headers

• WSDL Options — configurações avançadas (formato JSON) usadas ao carregar o WSDL.

• Headers — cabeçalhos SOAP adicionais, em formato JSON.

📝 Body

Escreva, em formato JSON, os dados a serem enviados ao método SOAP — o módulo converte automaticamente para o formato XML esperado.

Se preferir montar o XML manualmente, ative Enviar XML sem converter e escreva o XML completo diretamente.

🔀 Saídas do módulo

O módulo tem duas saídas:

• Sucesso — a chamada foi concluída, com o resultado disponível na variável response para os próximos módulos do fluxo.

• Erro — não foi possível concluir a chamada (por exemplo, WSDL inválido, método não encontrado, falha de conexão, ou um erro retornado pelo próprio serviço SOAP).

💡 Caso de uso

Cenário: uma empresa precisa consultar dados de um sistema legado que expõe um serviço SOAP para verificar o status de um contrato.

Configuração:

1

Adicione o módulo Requisição SOAP ao fluxo.

2

No campo WSDL, informe o endereço do serviço.

3

No campo Method, informe o nome da operação de consulta.

4

No campo Body, monte o JSON com os dados exigidos pela operação, usando variáveis do fluxo.

5

Conecte a saída Sucesso a um módulo que use o resultado (response) na conversa.

Resultado: o fluxo consulta automaticamente o sistema legado e usa a resposta na conversa com o cliente.

📌 Dicas úteis

• Consulte a documentação do WSDL do serviço para saber o nome exato do método e os dados exigidos por ele.

• Sempre conecte a saída Erro a algum tratamento, já que chamadas a serviços SOAP podem falhar por diversos motivos.

• Ao ativar autenticação, sempre confira se o usuário e a senha foram realmente preenchidos com valores válidos.

• Use Enviar XML sem converter apenas se precisar de um controle total sobre o formato exato do envelope XML enviado.

📝 Resumo

• O módulo Requisição SOAP chama um serviço web no padrão SOAP, enviando e recebendo dados no fluxo.

• Os campos principais são WSDL, Method, Headers e Body.

• Suporta autenticação via WS Security ou Basic Security.

• A saída Sucesso disponibiliza o resultado na variável response; a saída Erro cobre falhas de conexão, WSDL, método ou erros retornados pelo próprio serviço.