# SMS
## Function
This module enables you to send outbound SMS messages.
{% hint style="info" %}
**This module requires a Plum DEV account with SMS-enabled, non-PCI phone numbers.**
Don't have Plum DEV yet? [**Contact us**](https://www.plumvoice.com/contact-us/) to get set up!
{% endhint %}
## Input Fields
As shown in the following image, this module first displays fields for Plum DEV account authentication:
1. **Username**
2. **Password**
### Username & Password
Enter your Plum DEV account credentials in these fields, then select **Authenticate**. If authentication is successful, the module will display your username with a checkmark. As shown in the following image, additional fields will also be displayed:
1. **SMS Phone Number**: Select one of your SMS-enabled phone numbers.
2. **Recipient Phone Number**: Strings and/or variables are accepted.
3. **SMS Message**: Strings and/or variables are accepted.
### SMS Phone Number
Select the SMS-enabled number you will use to send your message(s). Phone numbers linked to your Plum DEV account will be listed for use.
{% hint style="warning" %}
**IMPORTANT!** **Your SMS-enabled number must be non-PCI.** SMS is unencrypted, which makes SMS messaging incompatible with PCI numbers and infrastructure.
{% endhint %}
### Recipient Phone Number
**Accepted values:** Strings, variables.
Enter one phone number that will receive your message.
**Format.** The phone number may be entered with or without formatting. See the following list for some examples:
* Formatted: `(222) 345-9789`
* Unformatted: `2223456789`
**Adding variables.** Any declared variables can be added to this field by selecting the plus sign (), selecting a variable from the **Variable Name** dropdown box, and selecting **Add**. Note that this field will only accept one value for the recipient's phone number.
### SMS Message
**Accepted values:** Strings, variables.
Enter the message to be sent. You can enter one or multiple values.
**Adding variables.** Any declared variables can be added to this field by selecting the plus sign (), selecting a variable from the **Variable Name** dropdown box, and selecting **Add**.
## 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
Note: For the SMS module, this setting's effects will likely be noticeable only when servers are busy.
|
| -------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### [Timeout Length](/fuse/module-settings.md#timeout-length)
|  | Allows users to set the maximum time, in seconds, that elapse before returning a timeout error. This applies to modules that fetch outside scripts, like the SOAP, REST, or Subdialog modules.
Default value is 30 seconds. Minimum is 1 second. Maximum is 120 seconds.
|
| -------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### [Private](/fuse/module-settings.md#private)
|  | Controls the logging function of a module.
Enabling this setting instructs the module to not record, report, or retain 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. A critical setting for businesses that need to maintain PCI-DSS or HIPAA compliance.
The module icon becomes grayed-out when this setting is enabled. More details here.
|
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### [Show Custom Errors (SMS)](/fuse/module-settings.md#show-custom-errors)
|  | When enabled, this setting adds an Error transmitter to the module. As shown in the following image, this can be used to set an alternate call flow if an error is returned.
- Note: For sample errors returned on failure, see the SMS API page for DEV.
|
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
---
# 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/sms.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.