The Unified Agent brings every step of building a Salesmsg texting agent into one connected experience. Instead of jumping between disconnected setup screens, you start with a single message describing what you want your agent to do, then chat, configure, test, and activate it all from one page.
How It Works
Building an agent with the Unified Agent follows a simple path:
Describe your agent in one message, or pick a starting point
Chat with the Creator Agent to fill in the details
Fine-tune everything in the Configure tab
Test your agent live before it reaches a real contact
Activate once your setup passes a quick check
Your existing agents keep working exactly as they do now. Nothing changes for them unless you choose to edit them.
Starting a New Agent
Go to AI & Automation in the left menu and click New AI Agent
In the Choose type window, select Texting (or Incoming calls for a Calling Agent)
Under What would you like to create?, type a message describing what you want your agent to do, or select a template chip such as Booking, AI Data Collection, Customer Support, or FAQ to prefill a starting point
Edit the prefilled text if you selected a template, then send it
You land in the unified setup view, with the Create tab open by default for new agents.
Setting Up Your Agent by Chatting
The Create tab guides you through setup without asking you to write a prompt from scratch.
Answer the Creator Agent's questions as they come up, covering things like booking settings, what data to collect, and follow up timing
Watch your prompt build in real time as you answer
Keep chatting anytime to adjust tone, add details, or change how your agent responds
Trigger
Every agent needs to know when to start a conversation and where to send it from.
How the agent gets triggered: Run manually is always available and can't be turned off. Add Run automatically to enroll contacts that match your criteria, or Run via webhook to enroll contacts through the agent's webhook URL.
Which inbox to use: In Start conversations from, select the inbox and number your agent should send messages from. You can only select one.
How contacts get enrolled: This step is optional, so you can skip it if you'd rather not set enrollment criteria yet. If you do set it up, you'll see your enrollment criteria summarized once you've made your selections.
Re-enrollment: Decide whether contacts can go through the agent again after they've already completed it. This is turned on by default.
If you're setting this up through the Create tab, the Creator Agent asks you these questions in order. Answering the inbox question is required, but you can skip the enrollment criteria step entirely if you're not ready to define it yet.
Managing Settings in the Configure Tab
The Configure tab holds every setting for your agent in one place: Trigger, Instructions, Contact opt-out detection, Crisis / self-harm language detection, Knowledge Base, Booking and Auto Follow-Up. Both merge fields and actions are optional, so you only add what your agent actually needs.
For more on enrollment, re-enrollment and Auto Follow-Up timing, see Salesmsg AI Agent.
Adding Actions and Merge Fields
To add actions (tags, SMS, notes, stop) and merge fields to your agent's instructions with the / shortcut, see Add Actions and Merge Fields to AI Agent Instructions.
Enhancing your agentâs instructions
Enhance helps you improve your agentâs instructions by telling it exactly what to focus on. You can choose from preset improvements, add your own note, and compare the new version with your original before you save it. Enhance is available for both Texting and Calling Agents.
How to enhance your instructions
Go to AI & Automation and select Agents.
Open the agent you want to update.
In the instructions section, click Enhance.
Under What to improve?, select any of the presets that apply:
Age restriction adds age verification rules, for example for adults only or 18+ offers.
Competitor mentions adds a rule for how your agent handles questions about other brands.
Clearer goal adds a clear goal for your agent to work toward.
Optionally, type a note in the text field to describe anything else you want improved.
Click Enhance.
Review your current instructions on the left and the enhanced version on the right. If there are suggestions, youâll see up to three short Recommendations below the enhanced text.
Choose how to continue:
Click I like it to accept the enhanced instructions.
Click Refine to keep adjusting the result.
Click Try again to generate a new version.
Presets and the note are both optional. You can click Enhance without selecting anything for a general improvement.
For tips on writing your agent's instructions, see How to Write Instructions for Salesmsg AI Agents.
Reviewing suggestions before activating your Calling Agent
When you activate a Calling Agent, Salesmsg checks your setup to help it perform well from the first call. The check looks at your instructions, Knowledge Base settings, actions, and selected template, and lets you know if anything could be improved.
What to expect when you activate
Go to AI & Automation and select Agents.
Open your Calling Agent and activate it.
If there are suggestions, a validation window appears listing them.
Choose how to continue:
Click Edit instructions to go back and make changes.
Click Skip for now to activate your agent as is.
If no suggestions are found, your agent activates right away with no extra step.
For Calling Agent setup, see AI Calling Agent.
Knowledge Base
Adding knowledge base files helps your agent give more accurate answers by referencing your own documentation.
Decide if your agent should use knowledge base files: Choose Yes or No. If you choose No, this step ends there and your agent won't reference any files.
Choose which files to use: If you choose Yes, select the files your agent should pull from. All available files are selected by default, but you can narrow it down to specific ones. You can also search by file name if you have a lot of files to look through.
At least one file needs to be selected to save this step. If your knowledge base is empty, you'll see a message letting you add files before continuing.
You can save your agent even if a file is still processing, so you don't have to wait for every file to finish before moving on.
To add and manage your knowledge base files, see Salesmsg AI Knowledge Base.
Booking
If your agent handles scheduling, the booking setup connects your agent to your calendar and defines how it books meetings.
Choose your scheduling app: Calendly is available now and is preselected by default. If you haven't connected Calendly yet, you'll see a Connect option that takes you through the connection flow. HubSpot is marked Coming soon.
Select the event to use: Pick which Calendly event your agent should offer. You can search through your connected events by name or link if you have several.
Choose how customers book: Decide whether your agent should Chat to book a time with the contact directly, or simply Share booking link and let the contact pick a time themselves. Chatting to book a time is the default.
Decide how reminders and changes are handled: Choose whether your agent should automatically handle reminders, cancellations, and reschedules on its own. This is turned on by default.
Once you've answered all four, your selections are saved to your agent's settings and reflected in your prompt.
For more on booking agents, see Booking AI Agent.
Testing Your Agent
Before your agent goes live, test it right from the setup page.
Click Start testing in the Test agent panel
Send a message in the live phone preview and watch your agent respond in real time, using your actual prompt, actions, and merge fields
Restart the test as many times as you need
Testing never uses credits and never reaches a real contact.
Booking in test mode
Booking steps are simulated with sample availability. In test mode:
No real appointment is created in your calendar
Booking links aren't connected to your real calendar, so they won't show the date or time agreed in the chat
This is expected. To check real booking behavior, test with a real contact (see the FAQ below).
Activating Your Agent
When you're ready to go live, click Activate. Salesmsg checks your setup first:
Required fields like your agent name, prompt, and inbox must be filled in
If you've enabled a knowledge base or booking integration, those are checked too
Your prompt is also reviewed for accuracy. If something needs attention, you'll see an alert before your agent can go live
If anything is missing, you're taken back to the Configure tab with the fields that need attention highlighted. Once everything checks out, your agent's status updates to Active.
Publishing Changes to an Active Agent
When you publish changes to an active AI Texting Agent, AI Calling Agent, Campaign, Workflow, or Survey, a "Publish changes?" confirmation appears. Changes apply only to contacts in new sessions. They do not apply to contacts already in an active session, which finish on the previous version.
Activating a disabled agent or workflow shows a confirmation that changes apply only to contacts in new sessions, not contacts already enrolled.
Activating a draft agent or workflow that has enrollment filters turned on shows a confirmation with the number of contacts that meet the enrollment criteria.
Editing an Existing Agent
Click Edit on any agent from your agents list to open its setup page.
Agents built in the Unified Agent open with the Configure tab active by default, with all your saved settings already filled in
You can switch to the Create tab anytime to continue setup by chatting instead
Agents built in the older setup flow continue to open in that same flow when you edit them
If you duplicate an agent built in the older flow, the duplicate is also created in the older flow
If you duplicate a Unified Agent, the duplicate opens in the new setup, with the Configure tab active
Reviewing Agent Details and Performance
To see your agent's details in a read-only view and track its statistics (Total, In Progress, Skipped, Completed, Stopped by User, Booked and more), see Manage and Monitor Active AI Agents.
Frequently Asked Questions
Will my existing agents change?
No. Existing agents keep working as configured. They open in the same setup flow you're used to unless you build a new agent with the Unified Agent.
Does testing my agent use up credits?
No. You can test as many times as you need without using any credits.
What happens if I try to activate an agent that's missing something?
You'll see what's missing, and you're taken back to the Configure tab with those fields highlighted so you can fix them before activating.
How can I test booking (or the full flow) with a real contact?
Test mode simulates booking, so to see real booking links and calendar events, run your agent with one test contact:
Create a contact with your own phone number, or use a teammate's
In Trigger, keep only Run manually enabled for now, so no other contacts are enrolled automatically
Activate the agent and manually enroll only your test contact
Reply from your phone and go through the booking flow. Check that the link or booked time matches what you agreed on
Cancel the test meeting in your calendar, then check Run automatically and add your enrollment criteria when you're ready to go live
Note: unlike test mode, conversations with real contacts use credits and create real calendar events.
Related Articles
Need Help? âđ»
Contact us on live chat or send an email to us at [email protected].









