Skip to main content

Add Actions and Merge Fields to AI Agent Instructions

Use the / shortcut to add merge fields and actions like tags, SMS, notes and stop to your AI Agent's instructions.

A
Written by Aaron Sundukovskiy

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

  1. Open your Texting AI Agent and go to the Instructions field

  2. Type / to open the shortcut menu

  3. Select the Actions tab

  4. Choose an action type:

    • Add tag

    • Remove tag

    • Send SMS

    • Add contact note

    • Stop conversation

  5. Configure the action based on the type (see below)

  6. 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:

  1. Select Merge Fields from the dropdown

  2. Choose a source: Salesmsg (always available), Calendly, or HubSpot. If Calendly or HubSpot isn't connected, you'll see a Reconnect option

  3. Pick one or more fields from the list for your selected source

  4. Your selected fields appear as highlighted chips right in your prompt text, and your final prompt updates immediately to reflect them

Actions:

  1. Select Actions from the dropdown

  2. Choose an action type from the modal (see the full list below)

  3. Configure the action's details

  4. 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].

Did this answer your question?