> For the complete documentation index, see [llms.txt](https://docs.plumvoice.com/insight/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.plumvoice.com/insight/data-integration/automatic-web-services.md).

# Automatic Web Services

Automatic web services is a setting, that when configured, makes Plum Insight automatically send the results of a survey visit to a SOAP or REST endpoint. This setting has to be configured individually for each survey users want to use it for.

**Enabling Automatic Webservices**

To enable Automatic web services for a survey, navigate to that survey's settings page. That page contains an “Automatic Webservices” section, which looks like this:

![](/files/-M5YG3dajNSKykCjEDi8)

| **Field**           | **Description**                                                                                                                                                                                                                                                                                                                           |
| ------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Web Session Timeout | This field determines the timeout duration for web survey sessions. If a user is idle for this period of time, their session will expire. At that time the automatic webservice request will be made. **Note:** By default, the web session timeout is set at 60 minutes, regardless of whether or not automatic web services is enabled. |
| Web Service Type    | SOAP or REST, indicating which type of service will be called.                                                                                                                                                                                                                                                                            |
| Web Service URL     | The URL for the SOAP or REST service. If specifying SOAP, make sure this is the URL to the WSDL and not the service itself (i.e. make sure you append ?WSDL to the URL).                                                                                                                                                                  |

To enable automatic webservices for a survey, users must set a Web Service Type *and* a Web Service URL. Failure to set both of these fields makes it impossible for Insight to reasonably determine whether to interact with a REST or SOAP service and, as a result, Insight will abandon the attempt altogether.

### **Data Integration for Automatic Webservices**

The request data submitted by Plum Insight's automatic webservices feature will be identical to that of the SOAP and REST webservice question type. Users can build their services in the same manner as they would for a SOAP or REST webservice question type.

Automatic webservice requests will be made at the conclusion of a survey session or under the following circumstances:

* After all [transcriptions](https://docs.plumvoice.com/documentation/using-the-plum-voice-suite/how-to-guides/using-plums-transcription-api) have been returned for audio recordings for comment question types
* After a web session has exceeded the set web session timeout


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

```
GET https://docs.plumvoice.com/insight/data-integration/automatic-web-services.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.