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

# Creating a Use Case (Step 1)

> This guide will walk you through the first step to setting up your SMS campaigns in Avoca. Your CSM will walk you through this initially

<Warning>
  **IMPORTANT DISCLAIMER**

  * Every use case requires a prompt in order for the AI to converse (text with your customers).
  * To ensure that the quality of the texting AI, currently ONLY Avoca can add/edit the prompt.
  * Without a prompt, you are still able to use our text messaging, but you will be responsible to responding to customer messages manually.

  **Please** reach out to your Avoca CSM once you finish configuring everything you see on this Help Guide so they can assist you in setting up the prompt.
</Warning>

### Prerequisites

Before getting started, ensure your Dashboard has the following pages enabled:

* **Texts**
* **Workflows**

If you don't see the Workflows page, please contact your Avoca representative to have it enabled.

## Step 1: Creating a Use Case

A use case defines the purpose of your text messages and how the AI will interact with your customers.

### Create Your Use Case

<Steps>
  <Step>
    Navigate to **Settings** > **+ Add**

    <Frame>
      <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-33.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=18a512ca6fb0209d4f55de58ba3d35cf" width="1520" height="800" data-path="images/outbound/image-33.png" />
    </Frame>
  </Step>

  <Step>
    Next, select from one of our default use cases, or create a custom use case and click “Get Started” once you have selected one

    <Columns cols={2}>
      <Frame>
        <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-34.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=1ba85a74dcd9a631690c124b945a0fa7" width="542" height="484" data-path="images/outbound/image-34.png" />
      </Frame>

      <Frame>
        <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-35.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=0f65d4e2f6a26c29729e6b63784e41eb" width="543" height="484" data-path="images/outbound/image-35.png" />
      </Frame>
    </Columns>
  </Step>

  <Step>
    Select the phone number you'll be using for this Use Case.

    * Use the SCALED number that was provisioned for your account.
    * **DO NOT** use LIMITED numbers, those are for testing purposes only.

    <Frame>
      <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-36.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=7dc166b21434a2e59c6a4311dfc7c1de" width="555" height="673" data-path="images/outbound/image-36.png" />
    </Frame>
  </Step>
</Steps>

### Configure Text Settings

**Basic Settings: Run through the configuration in the image above**

* **Enabled:** Toggle whether messages will be sent when a campaign goes live
* **Two-Way Texting:** Enable this if you want the ability to respond to customer messages or take over conversations manually
* **Write notes to ServiceTitan Customer Profile:** Enable to sync conversation history to customer profiles
* **Write text messages to ServiceTitan Job Notes:** Enable to write each text message as a note on the related job
* **First Message Template:**

Your first message should be clear and personalized. You can use dynamic fields (called Liquid Tags) to customize each message:

**Available dynamic fields:**

* customer\_name
* customer\_phone
* customer\_email
* customer\_address
* appointment\_option\_1, appointment\_option\_2, appointment\_option\_3
* appointment\_date\_option\_1, appointment\_date\_option\_2, appointment\_date\_option\_3
* lead\_source
* lead\_notes

<Note>
  *Note: Customers will see the personalized values, not the field names.*
</Note>

<Frame>
  <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-37.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=3f3bf0321cc333cc80db034e64c7d37a" width="531" height="853" data-path="images/outbound/image-37.png" />
</Frame>

**Opt-Out Message:**

We recommend including an opt-out message in your initial message. Here are some examples:

* "Reply STOP to unsubscribe."
* "To opt out of future messages, reply STOP."
* "You can stop receiving texts at any time by replying STOP."

<Tip>
  **Tip:**

  Include the opt-out message only in your first message, not in follow-up messages.
</Tip>

<Frame>
  <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-38.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=0a130141f6e3678a84ac101fc62dda91" width="531" height="853" data-path="images/outbound/image-38.png" />
</Frame>

### Configure Escalations

**Escalation Reasons**

Select when you want conversations to be flagged for human review.

You can choose from common reasons or create custom ones.

<Frame>
  <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-39.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=e646c4e54e07db8cf966bd9706234acc" width="449" height="663" data-path="images/outbound/image-39.png" />
</Frame>

**How Escalations Work:**

<Frame>
  <img src="https://mintcdn.com/avoca-hc/FRiTG1nGLWAIjyGQ/images/outbound/image-40.png?fit=max&auto=format&n=FRiTG1nGLWAIjyGQ&q=85&s=ee1df6ee9a9d03101b6539c909874227" width="1909" height="954" data-path="images/outbound/image-40.png" />
</Frame>

When a conversation is escalated, it will appear in the **Escalated** folder in your Conversations dashboard.

## Next Steps

[Setting up a Workflow (Step 2)](/Setting-up-a-Workflow-Step-2-2f1f2b56d4d580939c46d3e6e5f31994)

## Need Help?

If you have questions or need assistance setting up your SMS campaigns, please reach out to your Avoca Customer Success Manager or reach out to our support team at [support@avoca.ai](mailto:support@avoca.ai)
