What's my plan?
Add-on AI agents - Advanced
This article applies only to advanced AI agents connected to a messaging channel.

You can create rich messaging templates and insert them in conversation flows for advanced AI agents. Rich messaging templates can be used to create:

  • Forms that collect a predefined set of information from a customer.
  • Webviews that present an external website to the customer within the Web Widget.
  • Custom templates that are designed to meet your business needs.

This article contains the following topics:

  • Creating a rich messaging template
  • Adding a rich messaging template in a dialogue
  • Viewing all rich messaging templates
  • Editing a rich messaging template
  • Deleting a rich messaging template

Related article:

  • Using templates to create conversation flows for advanced AI agents

Creating a rich messaging template

You can create a rich messaging template in your CRM integration settings.

To create a messaging template

  1. In AI agents - Advanced, select the advanced AI agent you want to work with.
  2. Click Settings in the sidebar, then select CRM integration.
  3. Select the Templates tab.
  4. Click Create your first template.

    Or, if you’ve created a template before, click Create template.

    The Create template window appears.

  5. Select one of the following options, based on the type of messaging template you want to create:
    • Forms
    • Webview
    • Custom (JSON)
  6. Click Create template.
  7. See the following sections for instructions on creating the specific type of template you selected:
    • Creating a form template
    • Creating a webview template
    • Creating a custom (JSON) template

Creating a form template

Form templates are useful for presenting a customer with a set of predefined fields that you want them to fill out, such as their contact information.

To create a form template

  1. If you haven’t already, create a rich messaging template and select Forms.

    The form template configuration page appears.

  2. In Template name, enter a name for the template.

    The name cannot have spaces or any special characters other than hyphens (-) and underscores (_). This name appears in the list of messaging templates and is the shorthand you’ll use to add the template in a dialogue.

  3. (Optional) In Description, enter a brief description of the template, such as its intended purpose.
  4. Select Block messaging input if you want to prevent the customer from continuing the conversation until they’ve filled out the form.
  5. In the Input Field section, in Message type, select the type of information you want to collect from the user.

    The options are Email, Text, and Select (which allows customers to select from options you define).

    All fields in this section are limited to 130 characters.

  6. In Name, enter the name of the variable that will be created based on this input field.
  7. In Label, enter the name of the field that will be shown to the customer in the widget.
  8. If you selected a message type of Select, click Add option and fill out the following fields:
    • Option name: Enter the name of the variable that will be created based on this option selection.
    • Option label: Enter the name of the option that will be shown to the customer in the form. Repeat this step for any additional options you want to present to the customer.
  9. (Optional) Click Add field to add additional fields to the form.

    For the best user experience, keep the number of fields to five or fewer. Technically it’s possible to create up to 100 fields.

  10. Click Create.

Creating a webview template

Webview templates are useful for presenting an external website to the customer within the Web Widget so that they don’t have to leave the conversation.
Note: Webview templates can be used to direct customers to a single website, with one fallback website available. To create a dynamic webview where the website the customer is directed to is based on collected parameters, use the Add a webview CRM action instead.

To create a webview template

  1. If you haven’t already, create a rich messaging template and select Webview.

    The webview template configuration page appears.

  2. In Template name, enter a name for the template.

    The name cannot have spaces or any special characters other than hyphens (-) and underscores (_). This name appears in the list of messaging templates and is the shorthand you’ll use to add the template in a dialogue.

  3. (Optional) In Description, enter a brief description of the template, such as its intended purpose.
  4. In Message text, enter the message your advanced AI agent will show above the button.
  5. In Button text, enter the text that appears as the label on the button.
  6. In URL, enter the URL that opens when the customer clicks the button.

    This URL must allow loading in an iframe.

  7. In Fallback URL, enter a backup URL.

    Channels that don’t support webviews open the fallback URL instead.

  8. (Optional) Click Optional fields to show the following additional configuration options:
    • Size: Select the size of the displayed webpage within the Web Widget. Available options are Compact, Tall, or Full.
    • Default: Select this toggle to make this the default action.
    • Automatically open webview: Select this toggle to automatically open the webview when this template is triggered.
    • Add field: Click to add field to capture metadata based on this template. Fill out the Metadata and Value fields. Repeat as needed to add additional fields.
  9. Click Create.

Creating a custom (JSON) template

Custom templates are useful for presenting carousels, lists of content, NPS ratings, or location-based messages.

To create a custom (JSON) template

  1. If you haven’t already, create a rich messaging template and select Custom (JSON).

    The custom template configuration page appears.

  2. In Template name, enter a name for the template.

    The name cannot have spaces or any special characters other than hyphens (-) and underscores (_). This name appears in the list of messaging templates and is the shorthand you’ll use to add the template in a dialogue.

  3. (Optional) In Description, enter a brief description of the template, such as its intended purpose.
  4. In the code field, enter the JSON for the custom template you want to create.

    For help, see Template messages.

  5. Click Create.

Adding a rich messaging template in a dialogue

After you create a rich messaging template, you have to add it in a dialogue so that it’s presented to a customer at the appropriate time during a conversation with an advanced AI agent.

To add a rich messaging template in a dialogue

  1. In AI agents - Advanced, select the advanced AI agent you want to work with.
  2. Click Settings in the sidebar, then select CRM integration.
  3. Select the Templates tab.
  4. Find the template you want to add and click the entry in the Shorthand column.

    The template shorthand is copied to your clipboard.
  5. Open the dialogue you want to add the template to.
  6. Select the AI agent message block where you want the AI agent to present the template to the customer.
  7. Paste the template shorthand you copied earlier.

Viewing all rich messaging templates

You can view a list of all messaging templates you’ve created.

To view all messaging templates

  1. In AI agents - Advanced, select the advanced AI agent you want to work with.
  2. Click Settings in the sidebar, then select CRM integration.
  3. Select the Templates tab.

    The Templates page opens.

    From this page, you can see a list of all messaging templates, with information shown in the following columns:
    • Details: The name of the template.
    • Shorthand: Click to copy the text you should enter when you add the template in a dialogue.
    • Type: The type of messaging template (form, webview, or custom).
    • Created by: The user who created the template.
    • Last modified by: The date the template was last updated.

Editing a rich messaging template

After you create a messaging template, you can edit it at any time.

To edit a messaging template

  1. In the list of messaging templates, find the messaging template you want to edit.
  2. Click the options menu () and select View information.

    The template configuration page opens.

  3. Edit the template as needed.

    For help, see Creating a rich messaging template.

  4. Click Save.

Deleting a rich messaging template

If you no longer need a messaging template, you can delete it.

To delete a messaging template

  1. In the list of messaging templates, find the messaging template you want to edit.
  2. Click the options menu () and select Delete.

    A confirmation dialog appears.

  3. Click Delete.
Powered by Zendesk