O nó SOAP compartilha a infraestrutura de credenciais e execução com o nó API — se você já conhece esse nó, essa configuração vai parecer familiar.
Configuração básica
- URL — o endereço do serviço SOAP.
- Operation Name — o nome da operação SOAP que você quer invocar (texto livre; não é validado contra um WSDL).
Namespaces
Defina os namespaces do envelope SOAP em uma tabela reordenável (arraste para mudar a ordem):
Você pode usar variáveis do workflow ao definir a URI.
Headers
Adicione headers personalizados como pares chave-valor.O header
Content-Type é gerenciado automaticamente de acordo com a versão de SOAP escolhida em Settings, e não pode ser editado manualmente.Body
O corpo da requisição é editado em um editor de código livre (JSON ou XML). O nó não constrói visualmente o envelope SOAP — a montagem final do envelope é resolvida pelo motor de execução.Autenticação
Três opções disponíveis:Settings
- Versão do SOAP —
1.1ou1.2. Alterá-la reescreve automaticamente o headerContent-Type. - Timeout — em milissegundos, padrão de
30000(30s). - Transformação de resposta — extraia apenas a parte da resposta que você precisa definindo um
extractPath(por exemplo,GetUserResponse.Data).
Avançado
Reter a conversa enquanto aguarda
Por padrão, enquanto o nó aguarda a resposta do serviço, o usuário fica livre: se ele escrever, a mensagem é atendida pelo roteador do projeto e pode iniciar outro fluxo na mesma conversa. Para evitar isso, abra a aba Avançado e habilite Reter a conversa enquanto aguarda: o usuário permanece neste workflow até a requisição terminar.Quanto tempo dura
A conversa é liberada assim que a requisição termina, tanto pela saída de sucesso quanto pela de erro, e o fluxo continua. Como garantia, a retenção dura no máximo o timeout configurado em Settings; se você não configurou um, dura 60 segundos. Nunca ultrapassa 1 hora.Quando não se aplica
- Nós dentro de uma Tool: só o workflow que conversa com o usuário pode retê-lo, então a opção é ignorada em um nó SOAP executado dentro de uma Tool. Nesse caso, habilite-a no nó Tool do workflow; consulte Sua primeira Ferramenta.
- Conversas com um operador: se um agente humano assumir a conversa, as mensagens dele não passam pela retenção.
- Usuário já retido: se outro nó —por exemplo, uma Pausa ou uma Tool com a mesma opção— já estiver retendo o usuário, essa retenção é mantida e este nó não a substitui.
Salvar a resposta
Ative “Salvar resposta” e defina um nome de variável para armazenar a resposta do serviço SOAP.Acessar a resposta a partir de um nó Código
$context.getSoapRequest('minhaVariavel'). Ambos os acessores suportam .headers() e .json(); getSoapResponse também inclui .status().