SMS Agents

SMS Agents handle text message conversations with your contacts. They use AI to respond to inbound messages and can also support outbound messaging workflows.

Key Concepts

• SMS Agent — The AI configuration for text message conversations
• Text Number — The phone number used for sending/receiving SMS
• Conversation — A thread of messages with a specific contact

Getting Started

1. Ensure you have a phone number provisioned for SMS (see Phone Numbers)
2. Navigate to Agents > SMS Agents
3. Click + Create SMS Agent
4. Configure the agent name, number, and instructions
5. Save

Creating an SMS Agent

Configure your SMS agent with:

• Name — Descriptive identifier
• Text Number — Select a provisioned phone number
• Instructions — System prompt guiding the AI's text responses
• Tools — Functions available during SMS conversations

Viewing Conversations

Open an SMS agent to review its conversations. Each conversation shows:

• Contact name and phone number
• Message history
• Last message date
• Message count

How Inbound SMS Works

When someone sends a text message to your agent number:

1. The message is received by KarmaFlow
2. The SMS agent processes the message using its instructions
3. The AI generates and sends a response
4. The conversation continues as long as the contact keeps texting

Outbound SMS

Send outbound text messages through orchestrations or API calls. The SMS agent's configured persona and instructions continue to shape how the conversation is handled.