# SOAP
{% hint style="danger" %}
**This is an advanced module**
{% endhint %}
## **Function**
This module allows users to integrate with a SOAP webservice integration from within the application.
Its functionality is similar to the [REST](/fuse/data/rest.md) (
) module, but using the SOAP specification. Unlike REST, SOAP is fully discoverable. With REST, users must know precisely what information the the webservice should return. Conversely, with SOAP, users can essentially send a list of required information and the webservice will be able to return that information.
## **Inputs**
The SOAP module has four different input sections.
### **WSDL URL**
Enter the WSDL for the desired SOAP webservice. Click the refresh icon to load the WSDL methods for the webservice in the module.
### **SOAP Version**
This indicates the SOAP version for the selected webservice. Options include SOAP 1.1 or SOAP 1.2.
### **Method**
Drop-down menu that selects the method of the desired SOAP webservice.
### **Parameters**
Set parameters for the desired SOAP webservice based on the method selected from the WSDL.
* **Parameter**: The parameter name. The module automatically populates this field when selecting a method for the desired SOAP webservice.
* **Value**: The value to be submitted for the parameter. This field accepts dynamic variables from within an application.
## **Module Settings**
### [**Hold Music**](/fuse/module-settings.md#hold-music)
| | |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 
| Enable this setting to play audio while an end-user is on hold.
To upload a file for hold music, go to Application Settings > Connection Settings > Webservices > Webservice fetch audio.
|
### [**Timeout Length**](/fuse/module-settings.md#timeout-length)
| | |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| This allows users to set the maximum time, in seconds, that elapse before returning a timeout error. This applies modules that fetch outside scripts, like the SOAP, REST, or subdialog modules.
The default value for Timeout Length is 30 seconds.
Acceptable number values range from 1 to 120.
|
### [Private](/fuse/module-settings.md#private)
| | |
| ------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| 
| This setting controls the logging function of a module.
Enabling the 'Private' setting instructs the module to not record, report, or retain the information input to that module for reporting or any other purposes. When enabled any information entered into a module during a call will be lost immediately when the call terminates.
The 'Private' setting is critical for businesses that need to maintain PCI-DSS or HIPAA compliance.
The module icon, in the upper left-hand corner, becomes grayed-out when this setting is enabled. See more details here.
|
### [**Show Custom Errors (SOAP)**](/fuse/module-settings.md#show-custom-errors-soap)
| | |
| ------------------------------------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 
| This setting can be used to catch any error that occur during the SOAP call.
The two common errors associated with a SOAP webservice are timeouts and faults. The latter are custom SOAP errors.
|
{% hint style="info" %}
The two common errors associated with a SOAP webservice are timeouts and faults. The latter are custom SOAP errors.
{% endhint %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://docs.plumvoice.com/fuse/data/soap.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.