All SMS conversations take place between an Airkit application and the Actor who is accessing it. This document provides an overview of how to conceptualize and manage these conversations.

The Application

Under the hood, Airkit uses Twilio to manage SMS conversations. In order to send or receive SMS messages, an application must be associated with a Twilio number, which must be bought from Twilio, configured at the Org level, and then selected within the Settings of the relevant application. For more on associating Twilio numbers with Airkit applications, see Connecting Twilio Numbers.

The Actor

Every Journey has an Actor, which represents an individual person going through an application flow. In order to exchange SMS messages with the Actor, the application needs to know the Actor's phone number. This means that the Actor must be correctly initialized in order to establish a proper communication channel between the application and the Actor; see Conversations with Actors for more information.

Defining SMS Conversations

Automatic SMS Conversations can be defined in two separate ways.

• SMS Notifications define one-off, outgoing messages.
• Chat Bots define two-way conversations.

Of the two, only Chat Bots are capable of parsing incoming messages. Chat Bots must be used whenever you want to receive reply through SMS. However, that is not to say SMS Notifications cannot contain calls to action. An SMS Notification might, for example, contain a web link and invite the Actor to navigate to it.

For more on SMS Notifications, see SMS Notification Basics. For more on Chat Bots, see Chat Bot Basics.

TCPA Compliance

TCPA (Telephone Consumer Protection Act) is a series of US legislation that dictates how automated systems can reach out to customers via SMS channels. Airkit's out-of-the-box tools streamline TCPA enforcement, but because TCPA compliance is state- and timezone-dependent, this information must be properly configured in order to automate SMS conversations that abide by TCPA regulations. For more information, see TCPA.

Tracking Outgoing SMS Messages

The status of outgoing texts sent from all Apps within an Organization can be found in the Console, under App Health. To see the status of text messages associated with a particular application, select the relevant application in the Stage, and select the SMS tab in the Inspector that appears.

In addition to seeing the total number of texts sent from the application, you can also check on the status of each text. The status categories are, broadly:

• Pending - The text is in the process of being dispatched.
• Delivered - The text was successfully delivered to the recipients device.
• Sent - The text was successfully sent to the nearest upstream carrier, but no confirmation was (yet) received that it was delivered to the recipient's device.
• Failed - The text failed to be delivered.

Examining an individual text can provide more detail on its status. Under the hood, Twilio handles SMS messages in Airkit; see Twilio's documentation on possible status values for more details.