Esek

Run an explicit current WhatsApp readiness check for the connected business. Admin only. Contacts Meta using the existing connection, checks registration, webhook routing, payment-method presence and display name, and saves refreshed connection/verification state. Unknown is not failed. Does not send a test message, connect a new number, accept terms or buy anything. Complete required secure actions in Esek or Meta; readiness alone is not verified message delivery.

whatsapp_connection_get_readiness

Refresh the connected business’s WhatsApp and phone setup progress. Admin only. Persists progress, activity and operator summaries, and may recheck the existing WhatsApp connection with Meta. Returns observed state, current steps and detected failures. Does not connect a number, place a call or activate answering. Start here for setup guidance; use go_live_guide_show_step for the returned step and the returned Esek links for actions on the merchant’s device.

go_live_guide_get_state

Read the cached morning briefing: appointments, changes and items needing attention. Owner/admin only. Same briefing as the Today card; follow up with normal tools for decisions and confirmation. Sends nothing and stays in the current session.

get_today_briefing

Perform get weekly for get hours and closures. This tool performs only this operation. Read weekly hours, dated overrides, national holiday settings (get_holiday_settings), and effective dated hours including holiday names and override status (get_calendar_days). For any specific date, use get_calendar_days: explicit date overrides take precedence over holiday closures, which take precedence over weekly hours. Read-only and open to any staff member, admin or not. Use it to answer "when are we open", "are we closed on that date", and to check the current schedule before proposing an edit via manage_hours_and_closures. get_weekly returns hours_status: "confirmed" hours are the business hours; "suggested" (is_default true) is a default week bookings are placed in but customers are told hours are not set, so never present it as the business hours and offer to confirm or set them. get_weekly also returns schedule_enabled, the Business Hours master switch: when false, weekly hours do not restrict availability, but national holiday closures and explicit date overrides still apply. Resolve relative dates in the workspace timezone; use the calendar selectedDate for "this date".

get_hours_and_closures_get_weekly

Inspect one existing number from business_numbers_list in this connected business. Admin only. Reconciles missing internal number-registry rows idempotently before selecting the number. Does not buy, verify, configure or cancel it, and does not certify working calls.

business_numbers_get

Free slot start times for a service, soonest first (same logic as the customer booking picker; not Google free/busy). With no date it returns the next openings from now. THE tool for "what is free on Thursday", "anything open next Monday", "can I fit someone in tomorrow" — pass date for those; answering a question about a named day from the next-from-now list is how a merchant ends up reading another day's times as that day's. Every slot comes back tagged with the calendar day it falls on in the workspace timezone, and the reply reports how many are on the day that was asked about; when that is zero the times returned are the next availability AFTER it and must be presented as such. To read what is already BOOKED rather than what is free, use search_bookings.

list_available_slots

List canonical workspace catalog items. Read-only usage_charges, when returned, are the current billing rates shown in the catalog Additional usage section and supplied to the customer agent; prefer them over usage prices in authored descriptions. Returns id, name, sku, pricing (source, base currency and every authored amount; a platform-referenced price is read_only and edited in Billing), active, imageUrl, stock fields, merchant-facing category, item type, fulfillment mode, and Meta sync status. A currency absent from the buckets is quoted the primary price in the primary currency, never converted. Filter by active state or a name/sku/description substring. Use this before update_catalog_item or set_catalog_items_availability so the merchant can see what changed.

list_catalog_items

List the connected business’s existing numbers and their channel states. Requires membership. Reconciles missing internal number-registry rows with insert-if-absent writes; repeated calls do not duplicate them. Does not buy, verify, configure or cancel a number. Use returned IDs with business_numbers_get; channel status alone is not proof of successful forwarding.

business_numbers_list

When the merchant asks for support or accepts an offered support handoff, find or create their Esek support thread. Requires membership. Idempotently creates the thread and a support-visible mirror when needed. Returns an Esek link where the merchant writes their message, or the configured email/WhatsApp support alternative. Sends no message and requests no callback or guided call.

help_sessions_open_session

Prepare an appointment reschedule without moving the calendar. Present the summary before asking for approval.

prepare_booking_reschedule

Record the merchant’s explicit report that a setup step succeeded or is stuck. Admin only. Appends a progress signal, updates counters and refreshes state immediately. Use only after the merchant reports the outcome; do not repeat automatically. A recorded done report does not prove activation: step_now_done and track_state retain the server’s verification requirements. Returns failure guidance and a support option when needed.

go_live_guide_record

List appointments for this business in time order. THE tool for schedule questions — "what are the plans today", "what's my schedule", "what's coming up" → call with from_iso=now (add to_iso=today to stop at midnight) and brief the results. from_iso and to_iso accept the words now/today/tomorrow/yesterday as well as dates and ISO instants, resolved in the workspace timezone. Omitting from_iso lists appointments from now onward, so PAST appointments need an explicit from_iso or a past to_iso. The reply echoes the window it queried and flags truncation; if truncated is true, more appointments match than were returned. Returns id, service, status, slot times, contact phone/name, and holder (who goes: id, label, number; a blank label is "person <number>" in the app). holder_id narrows to one person's appointments. Individual appointments only: for the recurring arrangements behind them ("which customers do I see every week", "who is on a standing slot", pausing or ending one) use manage_standing_bookings. A repeating booking shows up here only as the dates it has already generated.

search_bookings

Search the whole contact book of this workspace by name, phone, or username. Returns id, name, phone, signals, and has_conversation (false means the contact is in the book but has never messaged in, which is normal for a contact you or the merchant just added). Use for "find John's number" or "look up the contact for +972...".

search_contacts

Return one WhatsApp or phone setup step with exact instructions, warnings, reference images and any existing carrier codes. Admin only. Refreshes saved progress and increments the shown counter. ChatGPT must display the returned guidance; no card or button has been opened. The merchant completes secure setup actions in Esek or Meta and dials any supplied code on their own phone. This operation neither activates service nor runs a test call.

go_live_guide_show_step

Change the specified weekdays only, preserving the other days. This applies the change immediately.

update_weekly_hours