Skip to main content
The Navigate to Page action enables your AI agent to automatically navigate visitors to relevant pages on your site after answering their questions. The system constructs the navigation URL from your configured template and fills in dynamic parameters based on the conversation context.

​
How it Works

After the AI finishes responding, the system automatically checks the response for data that matches your URL template variables. If a match is found, a navigation button appears below the chatbot’s response (or the page navigates automatically, depending on your configuration). The Navigate to Page action supports two modes:

​
Source URL Mode

When your URL template contains no variables, the system uses the first source URL from the chatbot’s knowledge base results. This is useful for navigating visitors to pages your chatbot has indexed. For example, if a visitor asks β€œTell me about your pricing” and the AI pulls information from https://yoursite.com/pricing, a β€œGo to page” button appears linking directly to that page.

​
Template Mode

When your URL template contains variables (e.g., {{category_id}}), the system looks for matching values in the tool results from your chatbot’s actions (such as MySQL Database or Custom API Action). If the AI ran a database query that returned a category_id column, the system uses that value to construct the navigation URL. For example, with a URL template of https://yoursite.com/products?category={{category_id}}&sort={{sort_by}}, if the AI’s MySQL query returns category_id: 42 and sort_by: price, the navigation URL becomes https://yoursite.com/products?category=42&sort=price.
Template variables are matched automatically. You don’t need to configure anything special in your MySQL or API action. The system scans all tool results for columns matching your URL template variable names. If the AI’s query doesn’t return the exact columns, the system runs a supplementary lookup using the same database connection and query filters.
You can choose how the navigation is triggered:
ModeBehavior
Show a clickable buttonA button appears below the AI’s response. The visitor clicks to navigate.
Navigate immediatelyThe page navigates automatically as soon as the AI finishes responding.
Show message then navigate after delayA countdown message appears (e.g., β€œNavigating in 3s…”) with options to β€œGo now” or β€œCancel”.

​
Add a Navigate to Page Action

1

Go to Tools & Actions

In your chatbot dashboard, click Configuration in the sidebar, then select Tools & Actions.
2

Click Add Action

Click the + Add Action button.
3

Search for Navigate to Page

Type β€œNavigate” in the search field to filter the available actions.
4

Select Navigate to Page

Click Add next to Navigate to Page.

​
Configure the Action

1

Set Name and Description

  • Name: Give your action a descriptive name (e.g., navigate_to_products)
  • Description: Describe when the AI should navigate the visitor (e.g., β€œNavigate visitors to the filtered product listing page after answering product questions.”)
2

Set URL Template

Enter the URL to navigate to. Use {{variable_name}} for dynamic values that will be filled in from tool results.Examples:
  • Static (source URL mode): https://yoursite.com - navigates to the source page from knowledge base results
  • Dynamic: https://yoursite.com/search?category={{category_id}}&location={{state_id}} - constructs the URL from tool result fields
3

Set Parameters (optional)

If your URL template contains variables, define them as a JSON object. Keys are the variable names, values are descriptions.
{
  "category_id": "The product category ID",
  "state_id": "The state or location ID"
}
4

Choose Navigation Mode

Select how the navigation should be triggered:
  • Show a clickable button (default) - safest option, gives visitors control
  • Navigate immediately - best for search result pages
  • Show message then navigate after delay - gives visitors a chance to cancel
5

Configure Additional Options

  • Button Label (button mode only): The text shown on the button (default: β€œGo to page”)
  • Delay (delay mode only): Seconds to wait before navigating (default: 3)
6

Save

Click Add Action to save your configuration.

​
Using with MySQL Database

When combined with the MySQL Database action, the Navigate to Page action can construct URLs from database query results. The URL template variable names must match column names or aliases in the database. For example, if your database has an interests table with id and name columns, and your URL expects ?interests=42:
  1. Set the URL template to https://yoursite.com/search?interests={{interests}}
  2. Ensure the database table or view the AI queries contains a column named interests with the numeric ID
The system automatically runs a supplementary lookup if the AI’s query doesn’t include the required columns. It extracts the WHERE clause from the AI’s query and runs a targeted query to fetch the missing values using the same database connection.

​
MySQL Table Filter

If your database has many tables, use the Tables field on the MySQL Database action to specify which tables the AI should use. This limits the schema discovery to only the relevant tables, improving accuracy and performance.

​
Embed Script Requirement

The Navigate to Page action works by sending a postMessage from the chatbot iframe to the parent page. The parent page must have the SiteSpeak embed script installed for navigation to work. This means:
  • Navigation works on any page where the chatbot widget is embedded via the standard JavaScript snippet
  • Navigation does not work on the share page (/share/{chatbotId}) since there is no parent page to navigate

Ready to automate your customer service with AI?

Join over 1000+ businesses, websites and startups automating their customer service and other tasks with a custom trained AI agent.
Last modified on April 2, 2026