> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/requisicao-soap.md).

# 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 um serviço REST tradicional.

{% hint style="info" %}
Para chamar um serviço REST tradicional, use o módulo **Requisição HTTP**. Para um serviço GraphQL, use o módulo **Requisição GraphQL**.
{% endhint %}

{% hint style="warning" %}
Na tela do Hyperflow Integrações, 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.
{% endhint %}

**📷 Inserir print:** visão geral do módulo Requisição SOAP na área de trabalho do fluxo

***

### 🧭 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.

**📷 Inserir print:** painel de módulos com a categoria Integração expandida e o módulo Request SOAP visível

***

### 🔍 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.

**📷 Inserir print:** painel de configuração do módulo Requisição SOAP aberto

***

#### 🔗 WSDL e Método

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

**📷 Inserir print:** campos WSDL e Método preenchidos

***

#### 🔐 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**.
* **Autenticação básica** — login simples com usuário e senha, com os campos **Usuário** e **Senha**.

{% hint style="warning" %}
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.
{% endhint %}

**📷 Inserir print:** seção de autenticação com WS Security ativado e campos preenchidos

***

#### 📋 Opções do WSDL e Cabeçalhos

* **Opções do WSDL** — configurações avançadas (formato JSON) usadas ao carregar o WSDL.
* **Cabeçalhos** — informações adicionais enviadas junto da chamada SOAP, em formato JSON.

**📷 Inserir print:** campos Opções do WSDL e Cabeçalhos preenchidos

***

#### 📝 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.

**📷 Inserir print:** campo Body preenchido, com a opção "Enviar XML sem converter" visível

***

#### 🔀 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).

**📷 Inserir print:** módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro

***

### 💡 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 **Método**, 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**, **Método**, **Cabeçalhos** e **Body**.
* Suporta autenticação via **WS Security** ou **Autenticação básica**.
* 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.