> ## Documentation Index
> Fetch the complete documentation index at: https://docs.voxworks.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Send to Contact

> Send an SMS message to the contact during the conversation.

## Description

Sends an SMS message to the contact's phone number. The SMS is scheduled for delivery and returns `true` if successfully queued.

***

## Manual Inputs

| Name                | Data Type | Required | Description                         |
| ------------------- | --------- | -------- | ----------------------------------- |
| SMS message to send | string    | Yes      | The text content of the SMS message |

***

## Global Inputs

This tool automatically uses:

| Variable           | Description                              |
| ------------------ | ---------------------------------------- |
| \[Contact - Phone] | The contact's phone number (destination) |

***

## Manual Outputs

| Name   | Data Type | Description                           |
| ------ | --------- | ------------------------------------- |
| result | bool      | `true` if SMS was queued successfully |

***

## Global Outputs

| Variable                     | Data Type | Description                                              |
| ---------------------------- | --------- | -------------------------------------------------------- |
| \[SMS - Send Error - Spoken] | string    | Error message if sending failed (for assistant to speak) |

***

## Conditions

### Success (true)

The tool returns `true` when:

* The SMS is successfully queued for delivery

### Failure (false)

The tool returns `false` when:

* The contact's phone number is missing or invalid
* The assistant's phone number is not configured
* The message content is empty
* Another error occurs when scheduling the SMS

***

## Example Usage

```text theme={null}
Tool Step: Send booking confirmation
   Input: "Your appointment is confirmed for [Calendar - Booking Time - Written]. See you then!"

   Condition: true (success)
   -> Next: confirmation_step
   -> Script: "I've sent you a text with the details."

   Condition: Otherwise (failure)
   -> Next: fallback_step
   -> Script: "I wasn't able to send the text."
```

***

## Best Practices

1. **Include key details** — Confirmation numbers, times, links
2. **Handle failures gracefully** — Always have a verbal fallback
3. **Use variables** — Personalise with \[Contact - First Name] and booking details
4. **Validate phone first** — Use a [Code Step](/tools/code-step/overview) to check the number can receive SMS before sending

***

## Next Steps

* [SMS - Read and Extract Email](/tools/integrations/sms/sms-read-email) — Receive SMS and extract email
* [Tool Steps](/flows/steps-tool) — Learn how to configure tool steps
* [Variables](/flows/variables) — See all available variables