***

title: Send SMS
subtitle: Enable your agent to send text messages during calls
slug: how-to-create-a-send-sms-action
description: Learn how to configure SMS actions that allow your AI agent to send text messages to customers during or after phone calls using Twilio integration.
---------------------

For clean Markdown of any page, append .md to the page URL. For a complete documentation index, see https://docs.synthflow.ai/llms.txt. For full documentation content, see https://docs.synthflow.ai/llms-full.txt.

Send SMS actions enable your AI agent to automatically send text messages to customers after phone conversations. This is useful for sending confirmation codes, appointment details, links, or follow-up information.

<Note>
  **Twilio Required:** SMS actions are only available when using Synthflow's Twilio integration or your own Twilio account. Other telephony providers do not support SMS functionality.
</Note>

## Overview

SMS actions are reusable components that you create once and can attach to multiple agents. Each SMS action defines the message content and the conditions under which it should be sent during a call.

Common use cases include:

* Sending appointment confirmations with date and time
* Sharing links to resources or booking pages
* Providing verification codes or reference numbers
* Sending follow-up information after a call
* Delivering promotional offers or discounts

## Create an SMS Action

<Steps>
  <Step>
    Navigate to **Actions** in the left-hand sidebar.
  </Step>

  <Step>
    Select **Send SMS** from the action types.
  </Step>

  <Step>
    Click **Create** to begin configuring your new SMS action.
  </Step>

  <Step>
    Enter the SMS message content you want to send.
  </Step>

  <Step>
    Describe the trigger condition that determines when the SMS should be sent. Be specific about the circumstances that should activate this action.

    **Example conditions:**

    * "When the customer confirms they're interested in the offer"
    * "After scheduling an appointment"
    * "When the customer requests more information"
    * "If the customer agrees to receive promotional messages"
  </Step>

  <Step>
    Click **Save** to create the SMS action.
  </Step>
</Steps>

## Attach to an Agent

Once created, attach the SMS action to your agent so it can send messages during calls.

<Steps>
  <Step>
    Navigate to **Agents** in the left-hand sidebar.
  </Step>

  <Step>
    Open the agent you want to configure by clicking on it.
  </Step>

  <Step>
    Go to the **Actions** tab within your agent.
  </Step>

  <Step>
    Under **Send SMS**, click **Add** and select your SMS action from the dropdown.
  </Step>
</Steps>

Your agent will now send the configured SMS message when the specified conditions are met during a call.

## Best Practices

* **Keep messages concise**: SMS has a 128-character limit per message; longer messages may be split
* **Be clear about sender**: Include your business name so recipients know who sent the message
* **Test thoroughly**: Make test calls to verify messages are sent correctly and at the right time
* **Check timing**: Ensure messages are sent at appropriate times during the conversation

## FAQ

<AccordionGroup>
  <Accordion title="What happens if the SMS fails to send?">
    Failed SMS attempts are logged in your call details. You can review these in your call logs to identify and troubleshoot any delivery issues.
  </Accordion>

  <Accordion title="Are there character limits for SMS messages?">
    Yes, standard SMS messages are limited to 128 characters. Messages longer than this will be split into multiple SMS segments, which may incur additional charges from Twilio.
  </Accordion>

  <Accordion title="How do I track SMS delivery?">
    SMS delivery status is included in your call logs and can also be tracked through your Twilio dashboard. You can view delivery status, timing, and any errors that occurred.
  </Accordion>
</AccordionGroup>