# Lyro - Proactive roles Section: Lyro - AI Agent Description: Let Lyro start conversations on your website with proactive roles: triggers, first message and instructions, templates, conflicting triggers, and how roles count toward your Guidance and Flows limits. Verified against Tidio panel 12.304.0 Last updated: 2026-11-07 Source: https://help.tidio.com/articles/lyro-proactive-roles/ Your AI agent can now go beyond customer support and start sending **proactive messages** to boost your conversion goals: sell more, generate leads, enrich visitor profiles, recommend tailored products or collect user feedback. With **predefined setups** that let you expand your AI agent's abilities, Lyro can easily step in at the right time (on pricing pages, during cart actions, or after repeated visits) and initiate a conversation automatically. **In this article, you will learn:** - [What proactive roles are]() - [How proactive roles work]() - [How to use role templates]() - [How to create your own roles from scratch]() - [How to manage your existing roles]() - [What the limits of proactive roles are]() [Video]() Silent walkthrough. Create a proactive role from scratch for visitors who open the pricing page, write its first message and instructions, test it, activate it and check it in the list. ## What are proactive roles? The **proactive roles** feature enables Lyro to start conversations automatically, without waiting for a user to type a message. Lyro can now proactively engage visitors based on their behavior or scripted events. By setting up roles properly, Lyro can be used for lead capture, collecting feedback, onboarding users, or upselling. Providing detailed, specific instructions allows Lyro to deliver tailored experiences for different objectives. There are also several **templates** to choose from and customise for a quick start. Apart from using several available triggers, it is also possible to set up custom events that Lyro can be triggered with. To manage your Lyro roles, head over to the **Proactive roles** tab inside the **Lyro AI Agent \> Behavior **section: ![The Lyro sidebar has Behavior expanded and "Proactive roles" selected.]() ## How do proactive roles work? Each proactive role consists of three elements: - one **trigger** (which decides when the proactive message should be sent); - one proactive **message**; - **instructions** (guidance that Lyro will follow for the rest of that conversation). ![The "Create Proactive role" form contains Name, trigger, First message, and Instructions fields, with testing, saving, and activation controls.]() Once a trigger's conditions are met, a message is sent to your website visitor proactively (this is usually a question that the visitor will hopefully engage with). Once the visitor decides to interact and send a response, Lyro will start chatting with them, using the instructions set defined in the role. For example: 1. A user visits your pricing page (this serves as the **trigger**). 2. The user receives a **message** saying "Need help choosing the right plan?" 3. The user responds, and Lyro continues the conversation (obeying your **instructions**, e.g. "First understand what the visitor's real needs are, ask about company size, and then suggest the best plan."). The proactive message itself uses your Tidio project's **Flows quota** (it counts toward your visitors reached), as it is essentially a simple flow that is being executed. Once the user responds to it, Lyro takes over, seeing the whole conversation and understanding the context. Since proactive roles require creating **Guidance** instructions, each active proactive role is also counted as one piece of active Guidance. To learn more, please see [the limits of proactive roles]() below. Proactive roles only work **inside the Tidio widget**; they are not available for external channels such as Facebook Messenger, Instagram, WhatsApp, or email. That is because the triggers need to be tracked directly by the Tidio widget. Please note that proactive roles do **not** integrate with external platforms; that is possible, however, with [Lyro **Actions**]() (through the use of API). ## Using proactive role templates When you open the **Proactive roles** section, you will see the option to add a suggested **template**, or browse all of the existing templates. ![The empty Proactive roles page offers Returning visitors and Shopping assistant templates, "Create new", and "Explore templates".]() You can either use the **Explore more** or **Explore templates** buttons, or use the **Create new** button in the top-right, where the option **Create from template** is visible as well: ![The "Create new" menu offers "Create from template" and "Create from scratch".]() There are four different templates available to choose from. For the purpose of this guide, we will cover the **Returning visitors **template - it instructs Lyro to greet returning visitors and then find out what they need help with. ![The "Create from template" dialog offers Returning visitors, Shopping assistant, Sales Development Rep, and Researcher templates.]() Once you click on the **Returning visitors **template, you will see the role creation page, with all the fields already configured. You can, of course, customize the template any way you wish. ![The Returning visitors role is prefilled with a return-visit trigger, a welcome message, and instructions for warm, relevant, low-pressure assistance.]() The first two fields define the role's **name** and **trigger**: ![The role name is "Returning visitors win-back" and its trigger is "Visitor returns to the site".]() When you click on the **trigger**, you will see its available settings - in this case, that is the **Trigger limitation** setting, allowing you to decide how often the trigger should work: **send once per 24 hours**, **send only once for a unique visitor**, or **unlimited (send on each visit)**: ![The "Edit trigger" panel for "Visitor returns to the site" shows the Trigger limitation set to "send once per 24 hours".]() The next field is the** first message** that will be proactively sent to your visitor, once the trigger is executed. Lyro sends this message as-is, and it won't be translated. Sending this message consumes your **Flows** quota: ![The First message field contains "Welcome back\! What brings you in today?", with a note that the message is sent as-is without translation.]() Lastly, the **instructions** field lets you define how Lyro should behave during the conversation. It is important to be as clear and detailed with this guidance: ![The Instructions field tells Lyro to greet returning visitors warmly, tailor suggestions to their needs, address complaints, and avoid pushing promotions.]() You can use the **Test it out** option in the bottom-right, and see how the proactive role works. When testing, the initial proactive message is triggered and sent immediately, allowing you to respond to it. Please note: **Test it out** works once the trigger, first message and instructions are filled in. Once you're happy with how the template works, you can either use the **Save and close** button (which will save the proactive role, but leave it inactive) or the **Activate** button (which will save the role and activate it immediately). ![The proactive role form provides "Test it out", "Save and close", and "Activate" buttons.]() ## Creating proactive roles from scratch When you open the **Proactive roles** section, you will see the option to use the suggested templates, but you can also create a brand new role **from scratch**. ![The empty Proactive roles page offers Returning visitors and Shopping assistant templates, "Create new", and "Explore templates".]() To create a new role, click on the **Create new** button in the top-right, where the option **Create from scratch** is available: ![The "Create new" menu offers "Create from template" and "Create from scratch".]() You will be taken to the role creation page, with all of the fields empty: ![The "Create Proactive role" form contains Name, trigger, First message, and Instructions fields, with testing, saving, and activation controls.]() ### Name First, you need to define a **name** for your new role. This will only be used for easy identification inside your Lyro settings. ![The empty Name field is ready for the new proactive role’s name.]() ### Trigger Next, you need to decide about the **trigger** - only one can be used, and it will determine when your proactive message is going to be sent. ![The "When should Lyro start the conversation?" section contains a "Select a trigger" field and notes that proactive roles use Flows quota.]() Once you click on the **Select a trigger **field, you will see a drop-down list with the available triggers: ![The trigger menu offers a specific-page visit, return visit, new event, Shopify cart addition, and abandoned form.]() The available triggers are: - Visitor opens a specific page - Visitor returns to the site - New event - Shopify - Visitor adds to a cart (for Shopify stores) - Form abandoned If you are already familiar with **Flows**, then these triggers may be familiar to you as well\! Select a trigger that you'd like to use for the purposes of your new role, and configure it as needed. For example, the **Visitor opens a specific page** trigger needs you to define the URL (and choose **Exact address** or **Address contains**), so that the proactive message will be sent to any visitor who lands on that page: ![The specific-page trigger editor has a URL field, "Exact address" and "Address contains" options, and a Trigger limitation dropdown.]() Every trigger also has the **Trigger limitation** setting: **send once per 24 hours** (the default), **send only once for a unique visitor**, or **unlimited (send on each visit)**. The **New event** trigger starts the role after an event - one of your tracking events, or a custom one you fire through the OpenAPI. If you'd like to learn more about triggers in general, please see [this dedicated guide](). ### First message In this field, you compose the actual message that will be** proactively sent **to the visitor who has triggered the role. It is usually a question, encouraging the visitor to respond with their own message, which will start a conversation with Lyro. Lyro sends this message exactly as you write it - it won't be translated. ![The empty First message field notes that Lyro sends the message as-is immediately after the trigger without translating it.]() ### Instructions In this field, you compose a set of instructions for Lyro on how to behave during the conversation, once it starts. If you are already familiar with Lyro **Guidance**, then you may already be familiar with how these instructions work. Most importantly, be as detailed and clear as possible, defining any circumstances and scenarios that are relevant for this particular interaction. To learn more about **Guidance**, please see [this dedicated article](). ![The empty Instructions field asks for guidance on what Lyro should say, what context to use, and what to avoid.]() ### Testing and saving your role You can use the **Test it out **option in the bottom-right, and see how the proactive role works. When testing, the initial proactive message is triggered and sent immediately, allowing you to respond to it. Once you're happy with how the role works, you can either use the **Save and close** button (which will save the proactive role, but leave it inactive) or the **Activate** button (which will save the role and activate it immediately). If one of your Flows or another proactive role already starts with the same trigger, you'll see the **Conflicting triggers** window when you activate the role: all of them may be triggered at the same time, and the visitor could get several messages at once. Click on **Back to editing** to change the trigger, or **Yes, I'm sure** to activate the role anyway: ![The Conflicting triggers window: "You already have a Flows or Proactive roles that starts with the same trigger.", the warning that all Flows that use "Visitor returns to the site" may be triggered at the same time, "Are you sure you want to activate this configuration?", and the Back to editing and Yes, I'm sure buttons]() ![The proactive role form provides "Test it out", "Save and close", and "Activate" buttons.]() ## Managing your proactive roles Once you've added some roles, in the **Proactive roles** section you can see all of them listed, along with the number of times each one was **Executed** (proactive messages sent by Lyro in the last 30 days): ![The roles list shows Shopping assistant and Researcher enabled, Returning visitors win-back disabled, and an Executed column.]() You can **activate and deactivate** each role using the toggles on the right. When you click on the three-dots menu, you can also see the option to **edit** the role, or to **delete** it entirely: ![The circled three-dot menu beside a proactive role is open with "Edit" and "Delete" options.]() If a role has already been triggered and executed, you can use the **View conversations** icon to see the conversations where the role has been used: ![The conversation icon beside a proactive role is circled and displays the "View conversations" tooltip.]() In the window that pops up, you will see a list of all the associated Lyro conversations, along with the visitors' **names**, **emails**, and the conversation **dates**. You can use the **Go to conversation** link to view each conversation fully within your project's **Inbox**, and use the **calendar** in the top-right to view conversations from a specific period: ![The "Lyro conversations" dialog lists a proactive role’s conversations with contact details, dates, "Go to conversation" links, and a date-range selector.]() Back in your** Proactive roles** list: If you have many roles to browse through, you can use the **Search** field in the upper-right of the list and find the one you need quickly. You can also change how the list displays your roles - by date of creation, name, or status: ![The roles list has a Search field and sorting options for creation date, alphabetical name, and active or inactive status.]() ## The limits of proactive roles ### Proactive roles and your Guidance limit Active proactive roles count toward the same limit as your active Guidance (including your handoff guidance): **up to 5**, or **up to 10** on the **Plus** plan. For example, with a limit of 5, three active pieces of guidance and two active proactive roles use up the whole limit. Once you reach the limit, the switch next to any inactive role is grayed out. Hover over it to see **Your current plan includes 5 active Guidance.** (with your plan's number). To switch on another role, switch off a role or a piece of Guidance first. For details, please see [Lyro Guidance](). ### Proactive roles and your Flows quota As proactive messages use your **Flows** quota, you'll see an alert at the top of the **Proactive roles** page once you've used 80% of your visitors reached limit, for example **Proactive roles uses Flows, but you've used 85% of your visitors reached limit.**: ![Lyro AI Agent \> Behavior \> Proactive roles with the alert at the top reading "Proactive roles uses Flows, but you've used 85% of your visitors reached limit. Upgrade to avoid interruptions." with the Manage usage and Upgrade links, and the list of roles below]() If you activate a role after reaching the limit, the **Flows limit has been reached** window lets you know that you can still create and activate proactive roles, but they won't be triggered until the limit is replenished. Click on **Got it** to save the role. To learn how the Flows quota works, please see [The monthly flow limit](). ## Further reading - [Lyro Guidance]() - Lyro - the conversational AI agent - [Test Lyro before it goes live]() - [Flow editor: Triggers]()