add_image_to_canva
ChatGPTPut an image the USER gave in this conversation (attached as image, or a public https link as image_url) on their TVs: it is added to the owner's own Canva account (the one connected in Screen Pulse) as a new design sized for the screens, then published to the given screens. Without screens it is only added to Canva and returns its template_id ("saved:…") for push_template_to_screens or a schedule. It is for images the user provided; new menu boards and signs are designed with create_ai_menu. Needs Canva connected in Screen Pulse (the tool returns the connect link otherwise). The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.
add_location
ChatGPTAdd a business location (name + full address) so screens can be grouped under it. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result. BEFORE calling, ask the user: (1) the location name; (2) the full street address.
confirm_change
ChatGPTAnswers the one yes / no question a change asked in the chat: answer is the user's own reply ("yes" / "no") to that question, with its confirm_id. It then makes the change (or cancels it) and returns the result. A change already answered on the card is reported as it stands, not made twice.
create_schedule
ChatGPTCreate a schedule on screens: default content shown all the time, plus optional time windows that show other content on chosen days and times (e.g. breakfast menu Mon–Fri 06:00–11:00). Times are 24h local time in the account timezone unless timezone is given. The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result. BEFORE calling, ask the user: (1) which screens; (2) what to show — which template or AI menu; (3) which days and times; (4) what to show outside those times; (5) a name for the schedule.
delete_schedule
ChatGPTDelete a schedule (id from list_schedules). Its screens fall back to another active schedule covering them, or keep what was last pushed to them. To stop it only for a while, use set_schedule_active instead. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
delete_screen
ChatGPTRemove a screen from the account (un-pair it). The TV stops being managed by Screen Pulse and its pairing slot is freed for another TV. Only when the user clearly asks to delete / remove / un-pair a screen. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
edit_location
ChatGPTRename a location or change its address. Pass the location (name or id) and only the fields to change. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
engage_reputation_info
ChatGPTAbout customers, text messages, campaigns, vouchers and spin wheels (SP Engage) and about reviews, review replies and ratings (SP Reputation) when their tools are not available here: it says why (not part of this account, not available in this app yet, or not allowed on this connection) and what to do.
get_account_overview
ChatGPTAnswer questions about the Screen Pulse account itself: which products are included (Screen Pulse Core, AI Menu Studio), the screen limit and how many more screens can be added, screens online, locations, AI menu credits, trial dates, and whether Canva is connected. Use this for "how many screens can I add?", "what is my plan?", "do I have AI Menu Studio?".
get_alert_settings
ChatGPTShow how alerts reach the owner: for each alert category (device health, content & scheduling, payment, account, menu compliance) whether it is shown in the app, emailed and/or sent by SMS, plus quiet hours, the email digest and vacation mode (the Alert Preferences of the web app).
get_current_content
ChatGPTShow what content is assigned to a screen: the last pushed item (template, Canva design, AI menu or image, with its picture) and any active schedules. Use take_screen_snapshot to see the TV itself.
get_device_details
ChatGPTGet a screen's device details: model, OS, Screen Pulse app version, memory, storage, resolution and network. Asks an online player for a fresh report first.
get_screen_status
ChatGPTGet the live status of one screen: online/offline, last check-in time, orientation and location.
list_alerts
ChatGPTList screen and account alerts (offline screens, content problems…). Default: unresolved alerts only.
list_locations
ChatGPTList the owner's business locations with how many screens each has.
list_schedules
ChatGPTList content schedules (default content plus time windows) on this account, optionally only those on one screen.
list_screens
ChatGPTList the owner's TV screens with name, 6-digit screen number, online/offline status, orientation, location and last check-in. Optionally filter by location name or status. Call this before any tool that needs a screen number — never invent one.
list_templates
ChatGPTShow everything that can be put on a screen, with preview pictures: Screen Pulse templates (the ready-made library), the owner's saved Canva designs and their AI Menu Studio menus. Each item has a template_id (e.g. "predefined:DAF…", "saved:DAF…", "ai_menu:66f…") to use with push_template_to_screens or in a schedule. Filter by source, search text or orientation. The pictures are shown in the Screen Pulse panel.
move_screen_location
ChatGPTMove a screen to another of the owner's locations (by location name from list_locations). The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
pair_screen
ChatGPTAdd a new TV to the account using the 6-digit code shown on the TV by the Screen Pulse app. If the account has more than one location, a location is required (ask the user which one). The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result. BEFORE calling, ask the user: (1) the 6-digit code shown on the new TV; (2) the name for the screen; (3) which location it belongs to (if they have several).
push_template_to_screens
ChatGPTPut a template on one or more screens right away, replacing what they show: a Screen Pulse template, a saved Canva design or an AI menu (template_id from list_templates). When the user has not said which screens (e.g. they tapped "Push to screens"), call it WITHOUT screens: it shows their screens to pick from in the panel (nothing changes, no approval for that step); then call again with the picked screens. Screens that are in a schedule go back to the schedule at its next change unless detach_from_schedules is true. The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.
reload_screen
ChatGPTSoft-restart the Screen Pulse player on a screen (fixes a frozen or stuck display). The screen must be online. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
rename_screen
ChatGPTRename one of the owner's screens. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
reset_screen_id
ChatGPTGive a screen a new 6-digit screen number (e.g. if the number was shared or the TV is being handed over). The screen stays paired with the same name and location, but what it showed is cleared and must be pushed again. The TV must be online and running a recent Screen Pulse app. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
resolve_alert
ChatGPTAcknowledge or resolve one alert (alert id from list_alerts). The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
respond_to_approval
ChatGPTThe Yes / No buttons of the Screen Pulse card about a change: decision approve (Yes) or decline (No) answers the card, and decision status reports the card's current state (read-only). It works only with the one-time code the card holds.
restore_previous_content
ChatGPTPut back what a screen showed before the last change made through this connector (a template, Canva design or AI menu push). The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.
rotate_screen
ChatGPTSwitch a screen's display between landscape and portrait (for a TV mounted the other way). The screen must be online. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
screen_pulse_help
ChatGPTHow-to answers about Screen Pulse Core and AI Menu Studio: getting started, player apps and supported devices, pairing a TV, publishing, Canva, scheduling, images, AI Menu Studio credits, offline screens, plan and billing. Use it for "how do I…" questions instead of guessing.
screen_pulse_web_app_page
ChatGPTThe page in the Screen Pulse web app for what is handled only there in this app: review alert and notification settings (turning alerts by email, text or in the app on or off), social post ideas, review requests to a customer group, SMS blasts, the cost of texts, campaigns or credits, recovery voucher offers and workflows, review threats, SEO details, removing a competitor, staff profiles, menu tracking, automated text sequences, spin-wheel options, disconnecting Square or Canva. Changes nothing; gives the link.
set_schedule_active
ChatGPTPause (active=false) or resume (active=true) a schedule. The account owner approves it in Screen Pulse first: the first call returns an approval link for the user; after they approve, call again with approval_id for the result.
sync_square_pos
ChatGPTFetches the item list and prices from the connected Square POS now (at most once every 15 minutes) and compares them with the menu of the newest Menu Intelligence analysis. Connecting Square is done in Screen Pulse on the web.
take_screen_snapshot
ChatGPTTake a fresh picture of what one or more screens are showing right now and show it. Pass screen (number or name), or screens (several), or screen "all" for every online screen. Offline screens cannot take a new picture; their last snapshot is shown instead.
update_schedule
ChatGPTChange an existing schedule (id from list_schedules). Only pass the fields to change; time_windows, when given, replaces all windows. The account owner approves every change in Screen Pulse: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with the same arguments plus approval_id for the result.
wake_screen
ChatGPTWake a screen whose player is paused or in the background. The account owner approves it in Screen Pulse first: the first call returns a preview and an approval link to give the user (you cannot approve it yourself); after they approve, call again with approval_id for the result.
whoami
ChatGPTShow which Screen Pulse account this connection is signed in as, which products it has, how many screens it owns and the screen limit (how many more can be added). Use it to confirm the connection works.