{"protocolVersion":"0.3.0","name":"Business assistants","description":"A business's assistants by text: the owner's assistant (bookings, contacts, group-text and website drafts for the owner's OK), the flyer reader (a flyer picture becomes a website draft), the front desk (answers customers from the business's own approved facts) and its voice on the phone. They never publish, approve or pay. Choose one with metadata.skill.","url":"https://api.hookvak.com/a2a","preferredTransport":"JSONRPC","additionalInterfaces":[{"url":"https://api.hookvak.com/a2a","transport":"JSONRPC"}],"provider":{"organization":"Parent Vertical LLC","url":"https://api.hookvak.com"},"version":"0.1.0","capabilities":{"streaming":true,"pushNotifications":true,"stateTransitionHistory":false},"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["text/plain","application/json"],"securitySchemes":{"platform":{"type":"apiKey","in":"header","name":"X-Hookware-Internal-Secret","description":"The platform's internal secret, with X-Tenant-ID naming the business."},"business_key":{"type":"http","scheme":"bearer","description":"The business's own key (it acts for that business only)."},"passvak":{"type":"oauth2","description":"passvak OAuth 2.1 (sub = the owner, client_id = the agent; the token names the business; outside assistants need the owner's grant).","flows":{"authorizationCode":{"authorizationUrl":"https://api.passvak.com/oauth/authorize","tokenUrl":"https://api.passvak.com/oauth/token","scopes":{"hookware:owner_assistant":"Ask the owner's assistant","hookware:flyer_reader":"Read a flyer into a draft","hookware:front_desk":"Ask the front desk","hookware:voice":"Answer one phone turn"}}}}},"security":[{"platform":[]},{"business_key":[]},{"passvak":["hookware:owner_assistant","hookware:flyer_reader","hookware:front_desk","hookware:voice"]}],"supportsAuthenticatedExtendedCard":false,"skills":[{"id":"owner_assistant","name":"Owner assistant","description":"One owner message in (text part, metadata.owner_ref, optional lang en|es and channel sms|chat), a short reply out. Uses the family tools as owner_assistant; the data part carries tool_calls, approvals and link {purpose} when the answer needs a page.","tags":["owner","sms","chat","drafts"],"examples":["text all my salsa students: no class Friday","who's booked tomorrow?","pon esto en la página: Salsa social viernes 9pm $15"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"]},{"id":"flyer_reader","name":"Flyer reader","description":"A flyer picture (a file part with an https uri, and metadata.image_sha256 = its SHA-256; metadata.owner_ref) becomes a website draft with the words read as evidence; the reply lists the facts and what is missing.","tags":["owner","image","content","drafts"],"examples":["a flyer photo: Salsa social Fri 9pm $15"],"inputModes":["image/png","image/jpeg","image/webp","text/plain"],"outputModes":["text/plain","application/json"]},{"id":"front_desk","name":"Front desk","description":"A customer's message in (text part; the contextId is the conversation), the business's reply out. Answers only from the business's own facts; booking requests and hand-offs are in the data part.","tags":["customer","sms","chat","bookings"],"examples":["What time do you open on Saturday?","¿Tienen clases de salsa para principiantes?"],"inputModes":["text/plain"],"outputModes":["text/plain","application/json"]},{"id":"voice","name":"Voice front desk","description":"One turn of a phone call (text part = the caller's words, metadata.call_id + metadata.turn, optional lang en|es). The front desk answers from the business's own facts in at most two short sentences; the data part carries say, end_call, transfer_to_owner and sms_followup. Never takes card numbers by voice; at most 12 turns. The full contract (and the owner's note at the end of the call) is POST /v1/voice/turn and /v1/voice/end.","tags":["customer","voice","phone","bookings"],"examples":["Do you have salsa classes on Saturday?","¿Puedo hablar con una persona?"],"inputModes":["text/plain"],"outputModes":["text/plain","application/json"]}]}