Retrieve Botstar app ID when a Drive file matches
When a file matches a Drive query, retrieve the Botstar application ID so the next setup step has the identifier it needs.
Trigger
New File Matching Query
Triggers when a new Google Drive file matches a provided query. This is the legacy query-centric trigger: it preserves Drive API query config such as ``corpora`` / ``driveId`` aliases and emits the historical ``file_matching_query`` event type. ``FileCreatedTrigger`` covers the broader "new file" case and emits ``file_created``.
Action
Get BotStar Application IDs
Tool to retrieve the botstar application id (`appid`). use when initializing or reinitializing the live chat widget.
Why this helps
Starting a widget flow can stall when the application identifier is not at hand.
- Retrieve the app identifier at a useful workflow moment.
- Reduce manual lookup during widget setup.
- Use the dedicated Botstar action for initialization context.
Setup
Build it in a few focused steps.
- 1Connect Google Drive and Botstar once in the Notis portal.
- 2Create an automation in the portal or tell Notis from any channel.
- 3In one instruction, ask Notis to retrieve the Botstar application ID when a new file matching your Drive query appears.
- 4Pick the New File Matching Query trigger and choose where run reports should go.
- 5Test with one real file that matches the query.
Questions about this workflow
Is this the same as triggering on any new Drive file?
No. This trigger is query-centric and preserves Drive query configuration such as corpora or driveId aliases.
What is the app ID used for?
The Botstar application ID, or appid, is used when initializing or reinitializing the live chat widget.
When this happens · Trigger
Do this · Action
Supported Triggers and Actions
Notis builds workflows that link Google Drive to Botstar. A trigger fires from one place; an action lands in another.
Google Drive triggers
Botstar actions
Recurring trigger
Notis starts this workflow on a schedule, such as daily, weekly, or during business hours.
BotStar LiveChat onClose Callback
Tool to register a callback when the chat window is closed. use after the widget is initialized. example prompt: "register an onclose handler that logs 'goodbye!' to the console."
Webhook trigger
Notis starts this workflow when an external tool or custom backend sends an HTTP request.
Get BotStar Application IDs
Tool to retrieve the botstar application id (`appid`). use when initializing or reinitializing the live chat widget.
Comment Added (Docs/Sheets/Slides)
Triggers when a new comment is added to Google Docs, Sheets, or Slides.
Livechat boot
Tool to reinitialize the live chat widget with provided data. use after initial load to reset or update widget configuration.
File Created
Triggers when a new file is created in Google Drive.
Close BotStar Livechat Widget
Tool to hide the live chat window. use when the chat widget is configured in livechat or popup mode.
File Deleted or Trashed
Triggers when a file is moved to trash or permanently deleted in Drive.
Livechat on open
Tool to register a callback when the chat window is opened. use after widget initialization.
File Shared (Permissions Added)
Triggers when new sharing permissions are granted to a file or folder. Uses Drive's `changes.list` endpoint with inline `permissions` in the `fields` mask so each change carries the file's current permission set provider-atomically. We diff that against `seen_permission_keys` to identify newly added grants. Drive page tokens are the primary cursor; if Drive rejects a stored token, the trigger raises `PollingTriggerError` without clearing state rather than silently re-baselining and dropping events. Limitation: truly ephemeral permissions (added and revoked between two polls without any other file modification in between) are not detected. Drive Activity API would catch those but requires an additional OAuth scope and a different payload contract.
Livechat open
Tool to show the live chat window. use after the widget has been bootstrapped with botstarapi('boot') to programmatically open the chat window (mode must be 'livechat' or 'popup').
File Updated
Triggers when a file's metadata or content changes in Google Drive.
Livechat update
Tool to update user details on the current live chat session. use when you need to modify user profile attributes during an active conversation.
Google Drive Changes
Triggers when changes are detected in a Google Drive.
Get BotStar Webview Parameter
Tool to retrieve a parameter value passed from the botstar chatbot to the webview. use inside onchatbotready after your page loads in modal mode with bs:input meta tags.
Connect any two apps with Notis in the middle.
Google Drive and Botstar, or any other combination from 1,000+ integrations.
When this happens · Trigger
Do this · Action
Save your first hour today.
7-day trial of any paid plan, with 20$ of usage included.
No card. Works with personal or business Botstar.