BeautyOS

List only linked salons for which live membership still permits access.

beautyos_salons_list

Read an owned persistent preview or operation receipt and its external-step states. The operation rechecks its original scope and salon access.

beautyos_get_operation

Prepare cancelling a connection attempt. This closes its presentation and does not disconnect the provider.

beautyos_channel_cancel

Prepare enabling AI on a verified connected channel. If the user explicitly declines testing, pass skipTest=true. This never marks a test as passed.

beautyos_channel_activate

Prepare connecting the selected salon channel, keeping AI inactive. Review and confirm before setup. Replacing a pending attempt invalidates its QR. An owned expired attempt starts a fresh session with a new operationKey. Never replay an unknown start or provide bot tokens.

beautyos_channel_begin

Prepare actual provider disconnection; existing credentials and message access may be removed.

beautyos_channel_disconnect

Prepare pausing AI; keep the channel connected.

beautyos_channel_pause

Use this when the user wants to enable the salon text AI receptionist. Accepts salonId and optional skipTest. Checks access, email verification, existing plan entitlement and operational readiness, then saves a proposed activation and returns its change ID and preview. If the user explicitly declines the optional test, set skipTest=true; otherwise a current successful test is required. Does not enable replies during preparation. After confirmation, beautyos_apply_change applies activation; existing connected channels may then receive automatic replies.

beautyos_agent_activate_prepare

Use this when the user wants to change the salon text AI receptionist settings. Accepts salonId and a non-empty patch of supported settings, such as assistant name, language, greeting, reply style, escalation rules or working schedule. Saves a proposed change and returns its change ID and before/after preview. Does not apply settings or enable or pause replies. Apply the saved change with beautyos_apply_change only after the user confirms its effects.

beautyos_agent_configure_prepare

Use this when the user wants to pause automatic replies from the salon text AI receptionist. Accepts salonId. Saves a proposed change setting the text agent enabled state to false and returns its change ID and before/after preview. Preparation does not pause replies. Apply the saved change with beautyos_apply_change only after the user confirms. Pausing leaves messaging channel connections and the subscription in place.

beautyos_agent_pause_prepare

Use this when the user requests an optional isolated text AI receptionist test. Accepts salonId and a test message. Saves a test proposal and returns its change ID and preview; it does not run the test yet. After confirmation, beautyos_apply_change runs the isolated test using the existing AI allowance. Customer changes, booking writes, notifications and custom write tools are blocked during the test. A successful test does not verify real-channel delivery.

beautyos_agent_test_prepare

Prepare an isolated product-backend agent test. Explicit confirmation is required because it consumes existing AI allowance. Does not send to real customers or verify customer delivery.

beautyos_agent_test

Start a complete new-salon setup: request the catalog, staff, channel and agent permissions together before preparing the salon and platform workspace. Does not subscribe, pay, invite others or activate the agent.

beautyos_salon_create_prepare

Preview exact local and platform profile edits. External CRM core fields remain provider-owned.

beautyos_salon_update_prepare

Read memberships, exact emails, roles, invitation status, retry eligibility and calendar bindings for salonId. Requires members.manage and beautyos.members.read. Does not expose invitation links or tokens. Use beautyos_catalog_get for scheduling employees; memberships are distinct from employees.

beautyos_members_list

Read the existing text-agent configuration and current activation state.

beautyos_agent_get

Read native services, staff, assignments and weekly schedules.

beautyos_catalog_get

Read salon details and current data-source capabilities.

beautyos_salon_get

Read dated staff schedule where the current provider supports it; native mode returns weekly rules and appointment conflicts.

beautyos_staff_schedule_get

Resend an expired or undelivered invitation for an existing member with canRetryInvitation=true. Rotates the link while preserving the employee, membership and rights. Requires members.manage and beautyos.members.write. Returns a saved change ID with exact recipient, role, calendar and email effects. No access changes or email before confirmation. Show the effects and call beautyos_apply_change only after explicit approval. Ownership changes and self-role changes are forbidden; external CRM/legacy permissions are unchanged. If a receipt reports accessSaved=true and deliveryError, tell the user the invitation email failed and propose a new confirmed resend; replaying the original operation never resends.

beautyos_member_resend_prepare

Restore a revoked member with the same rights and employee. Sends an invitation only if the member has never activated access. Reuses both records. Requires members.manage and beautyos.members.write. Returns a saved change ID with exact recipient, role, calendar and email effects. No access changes or email before confirmation. Show the effects and call beautyos_apply_change only after explicit approval. Ownership changes and self-role changes are forbidden; external CRM/legacy permissions are unchanged. If a receipt reports accessSaved=true and deliveryError, tell the user the invitation email failed and propose a new confirmed resend; replaying the original operation never resends.

beautyos_member_restore_prepare

Revoke BeautyOS access for the resolved memberId while retaining the employee and calendar. Requires members.manage and beautyos.members.write. Returns a saved change ID with exact recipient, role, calendar and email effects. No access changes or email before confirmation. Show the effects and call beautyos_apply_change only after explicit approval. Ownership changes and self-role changes are forbidden; external CRM/legacy permissions are unchanged. If a receipt reports accessSaved=true and deliveryError, tell the user the invitation email failed and propose a new confirmed resend; replaying the original operation never resends.

beautyos_member_revoke_prepare

Read aggregate BeautyOS analytics for one linked salon over 7, 30, 90 or 180 days. Native catalog and Altegio return appointments, booked service value (not collected payments), clients and utilization with daily charts. Other connected providers support dialogue analytics for 7 or 30 days only. Respects current insights.read permission; never returns client names or conversations. Reports cache freshness and data limitations. Does not generate a paid AI report.

beautyos_get_analytics

Save the selected setup step and assistance preference. Does not mark customer delivery or readiness as verified.

beautyos_update_onboarding

Use after a confirmed channel.begin operation, or to resume a pending connection. Opens the Telegram Personal/WhatsApp/MAX QR or provider setup in a private card. Show setupUrl if the host cannot render the card; the owner signs in there. Pairing secrets stay outside the conversation.

beautyos_channel_setup_link

Check recent real messaging channels for provider-confirmed assistant delivery. Returns only aggregate evidence; never customer conversations or contact data.

beautyos_verify_first_reply

Use this to preview generation of an AI growth report with the existing BeautyOS calculations. Consumes existing AI allowance and requires the current advanced-analytics entitlement; obtain explicit confirmation before applying.

beautyos_analytics_report_prepare

Use this to read an existing AI growth report for the chosen period and staff/service filters. Existing advanced-analytics entitlements apply. Reading does not generate a report or consume AI allowance.

beautyos_get_analytics_report

Use this to preview cancelling a selected booking. Existing cancellation and notification rules apply after confirmation.

beautyos_appointment_cancel_prepare

Use this to preview a booking for an existing verified client, staff member and services. Never invent IDs or a free time slot. Existing scheduling checks and booking notifications apply after confirmation.

beautyos_appointment_create_prepare

Use this to preview moving a selected booking. Supply its current start time from the latest list. Existing conflict checks and rescheduling notifications apply after confirmation.

beautyos_appointment_reschedule_prepare

Use this to review appointments over an explicit period of at most 90 days. Returns only essential client/staff names and service details, with pagination and provider limitations.

beautyos_list_appointments

Use this to read the current plan, trial, usage and feature entitlements. Returns a first-party cabinet link. Does not create checkout, pay, upgrade, extend a trial or open a payment-provider portal.

beautyos_get_billing

Use this to preview publication or unpublication of online booking. Publication exposes the existing public catalog; existing infrastructure/provider/readiness restrictions apply. Confirm before applying.

beautyos_booking_publish_prepare

Use this to review online-booking settings, readiness and the public URL. May initialize missing default settings like the existing web cabinet. Does not publish the page.

beautyos_get_booking_settings

Use this to preview online-booking text, address slug, time windows and cancellation rules. Publication is a separate operation.

beautyos_booking_settings_prepare

Use this to preview creation of a client from user-supplied details. Do not guess contact information; confirm before applying.

beautyos_client_create_prepare

Use this to preview changes to the selected client found with the supplied search. Only name and contact fields are supported; confirm before applying.

beautyos_client_update_prepare

Use this to find an existing client by a user-supplied name or contact search. Returns IDs, names and only a phone suffix. Does not expose full contact lists without a search.

beautyos_find_clients

Use this to preview transferring one selected conversation to a human. Pauses AI ownership for that conversation, without sending a message. Supply the page offset on which it was found; related conversations are not changed automatically.

beautyos_conversation_handoff_prepare