Roraima Vendor Guide
Use the AI-assisted builder
Draft a scenario from plain language
AI Draft helps turn a clear description into a starting scenario. It does not save, activate or arm the scenario. Review the generated trigger, conditions and actions in the Guided builder before saving.
Menu path
Owner: Vendor Back Office → Locks and devices → Scenarios → Add scenario or Edit → AI Draft
Authorized Supplier: select the customer in the supplier dashboard, open that customer's Scenarios area, add or edit a scenario, then choose AI Draft.
The editor may reopen the last tab used in the browser. Select AI Draft explicitly when another tab is active.
Prepare the request
Name the devices as they appear in Roraima. State what should start the scenario, what each device should do, and any schedule, threshold or safety condition that matters. A specific request produces a more useful draft than a general instruction.
The assistant knows the Zigbee and Matter devices of the Roraima Hub with their readings and commands, and the Notify me email step, so a request such as "when the living-room temperature goes above 25 degrees, switch on the light and notify me" can become a draft. A scenario has a single trigger: if the request contains two, for example one action above a value and another below it, the assistant says so during the free conversation and the draft covers the first one. Each further scenario is a separate draft and a separate save.
| Label | Purpose | Instruction | Requirement or condition |
|---|---|---|---|
| Name * | Identifies the final scenario | Enter a short operational name | Required before saving the scenario |
| Description | Records the scenario purpose | Add a brief summary for later review | Optional |
| Status | Enables or suspends the saved definition | Select Active or Disabled | Defaults to Active; does not arm a trigger |
| What should this scenario do? | Provides the drafting request | Describe devices, trigger, timing, conditions and intended actions | Required to request clarification or generate a draft; up to 1,000 characters |
| Your message | Answers a follow-up question | Add the missing detail requested by the assistant | Appears during the clarification conversation; up to 1,000 characters |
Use free clarification before generation
Select Send message 0/5 to ask for or provide clarification. Clarifying messages are free, up to five for the current draft cycle. The button counter shows how many have been used.
When the description is complete, select Generate draft (30 credits). The current interface shows a cost of 30 AI credits per generation. Generating a draft resets the free-message counter for the next draft.
| Action | Result | Condition |
|---|---|---|
| Send message n/5 | Continues the clarification conversation without using credits | Available until five clarification messages have been used |
| Generate draft (30 credits) | Creates the proposed scenario steps | Requires sufficient AI credits |
| Edit in Guided builder | Opens the generated steps in the visual editor | Appears after a draft is ready |
| Edit prompt | Returns to the request so it can be revised | Appears after a draft is ready |
| Buy AI credits | Opens the visible credit-purchase path | Appears when the balance is insufficient |
Review the result before saving
After generation, choose Edit in Guided builder. Check the trigger, every condition, each device and each action. Replace any step that does not match the real device setup.
Use Save to keep working in the editor or Save and close to return to the scenario list. When creating a new scenario, the page also provides Create. Generating the draft alone does not preserve the scenario.
When the draft cannot be generated
If the page reports insufficient credits, use Buy AI credits or return when the required balance is available. If preparing the draft takes too long, the page says so and no credits are charged: try again a minute later. A draft that comes back without any step is not charged either. If the five free messages have been used, generate the draft or start a new drafting cycle. Shorten a request that exceeds the 1,000-character limit.
The draft can use only devices and capabilities available in the current business or selected customer context. Add or reconnect a missing device before asking the builder to use it.
Related guidance
Return to Manage automations to review the Guided builder, save the scenario, test it and, when it is an automation, start it or link it to a listing so that it runs only during stays.
Matter™ and Zigbee are trademarks of the Connectivity Standards Alliance. Other trademarks mentioned belong to their respective owners.