Actions and merge fields let your Texting AI Agent personalize messages and act on how a conversation goes. Add them to your agent's instructions with the / shortcut.
Adding actions to your agent's prompt
Actions let your Texting AI Agent do more than send messages. You can set up your agent to tag contacts, remove tags, send follow-up texts, add notes, or end a conversation, all triggered automatically based on how the conversation goes.
Adding an action
Open your Texting AI Agent and go to the Instructions field
Type / to open the shortcut menu
Select the Actions tab
Choose an action type:
Add tag
Remove tag
Send SMS
Add contact note
Stop conversation
Configure the action based on the type (see below)
Save your changes
Once added, each action appears as a chip inside your prompt. You can also tell the agent when the action should happen by describing the condition in your instructions, for example, after the contact confirms an appointment or if they ask to stop receiving messages.
Configuring each action type
Add tag
Search your organization's tags and select one or more to apply. If the tag you need doesn't exist yet, you can create it directly from the search field.
Remove tag
Search your organization's tags and select one or more to remove from the contact.
Send SMS
Write the message you want your agent to send. You can also turn on Let AI write this message, so the agent generates the text dynamically based on the conversation instead of sending a fixed message.
Add contact note
Write the note you want added to the contact's profile. Turn on Let AI write this note to have the agent generate the note based on the conversation instead of using fixed text.
Stop conversation
Adds a chip that ends the AI conversation with the contact. This action doesn't need any setup. Once it's triggered, the agent won't send any more messages, though other actions can still run.
Editing or removing actions
Click any action chip in your prompt to reopen its settings and make changes. To remove an action, delete its chip from the prompt text.
Adding merge fields or actions with a slash
Type / anywhere in your prompt to open a dropdown with two options: Merge Fields and Actions.
Merge fields:
Select Merge Fields from the dropdown
Choose a source: Salesmsg (always available), Calendly, or HubSpot. If Calendly or HubSpot isn't connected, you'll see a Reconnect option
Pick one or more fields from the list for your selected source
Your selected fields appear as highlighted chips right in your prompt text, and your final prompt updates immediately to reflect them
Actions:
Select Actions from the dropdown
Choose an action type from the modal (see the full list below)
Configure the action's details
The action appears as a highlighted chip in your prompt
You can click any existing merge field or action chip to edit it, or remove it from your prompt entirely.
Pasting from another agent: If you paste text into the Instructions field that contains action or merge field tokens (copied from another agent's instructions, or from any source using the same format), the editor recognizes them and rebuilds each one as its chip, assigning it a new ID so it doesn't conflict with chips already in the prompt. Plain text in the pasted content is inserted as-is, and any token with an unrecognized structure is inserted as plain text instead of a chip. This works in both the Unified Agent and the Calling Agent, though pasted Calling Agent actions carry an empty body that needs to be filled in again.
Available actions
Action | How it works |
Add tag | Select one or more tags from your organization's tag list, or search for one by name. If the tag you want doesn't exist, you can create it right from the search. A selection is required to add the action. |
Remove tag | Same tag-selection experience as Add tag, but removes the selected tags instead. If no matching tag is found, you'll see a no results message. |
Send SMS | Type the message your agent should send in the text box, with formatting and attachment options available below it. You can also turn on AI-generated messaging so the SMS is written dynamically based on the conversation instead of using fixed text. A message is required to save the action. |
Add contact note | Type the note your agent should add to the contact, plus an option to add emoji. Like Send SMS, you can turn on AI-generated notes so the note reflects the actual conversation instead of static text. A note is required to save the action. |
Stop conversation | Ends your agent's conversation with the contact. After this point in your prompt, no further AI conversation happens, only actions can run. This action isn't editable after it's added. |
If you close any action's setup modal without finishing it, the action isn't added to your prompt.
Setting conditions on actions
Actions are conditional. Alongside each action, you can add the condition that should trigger it, so your agent only performs the action when the situation actually calls for it, rather than every time.
Frequently Asked Questions
What's the difference between a static and AI-generated SMS or note action?
A static message sends the exact text you typed every time. An AI-generated one is written dynamically by your agent based on the conversation, so the wording can change depending on context.
Can I copy actions from one agent's instructions to another?
Yes. Paste the text into the Instructions field and the editor rebuilds each action and merge field as a chip. Pasted Calling Agent actions carry an empty body that needs to be filled in again.
How do I remove an action from my prompt?
Delete its chip from the prompt text.
Related Articles
Need Help? âđ»
Contact us on live chat or send an email to us at [email protected].
