{"product":"neartail","subproducts":[{"name":"order_form","slug":"order-form","summary":"products, quantities and an order total","catalog":"/api/agent/v1/catalog/neartail/order-form","create":["create_order_form_from_google_form","create_order_form_from_menu","create_order_form","create_order_form_from_website"],"setup":["enable_payment","enable_whatsapp","set_currency","list_payment_methods","get_order_form"],"done_in_create":[]},{"name":"payment_form","slug":"payment-form","summary":"an order form that collects payment (UPI, cards, PayPal, cash) from the first order","catalog":"/api/agent/v1/catalog/neartail/payment-form","create":["create_payment_form_from_google_form","create_payment_form_from_menu","create_payment_form_from_name","create_payment_form_from_website"],"setup":["enable_payment","list_payment_methods","set_currency","get_order_form"],"done_in_create":["set_currency","enable_payment"]},{"name":"whatsapp_form","slug":"whatsapp-form","summary":"an order form whose orders are sent to the owner on WhatsApp","catalog":"/api/agent/v1/catalog/neartail/whatsapp-form","create":["create_whatsapp_form_from_google_form","create_whatsapp_form_from_menu","create_whatsapp_form_from_name","create_whatsapp_form_from_website"],"setup":["enable_whatsapp","set_currency","get_order_form"],"done_in_create":["set_currency","enable_whatsapp"]}],"actions":[{"name":"create_order_form_from_google_form","slug":"from-google-form","phase":"create","description":"Create a Neartail order form from an existing Google Form. A copy of the form is made in the account and set up as an order form; the original is left unchanged. Accepts edit, viewform, preview and forms.gle links. A private form answers access_required with grant_url: the user opens it, picks the form in Drive and grants access, then the call is retried. Returns publish_id, preview_url, edit_url, title and currency. The result carries form_summary (what the form asks and has) and available_setup (every setup menu). After sharing preview_url, decide what this particular form still needs and propose only that to the user as numbered options; do not end the turn without proposing.","input_schema":{"type":"object","properties":{"google_form_url":{"type":"string","minLength":10,"maxLength":2000,"description":"The Google Form link: docs.google.com/forms/d/.../edit|viewform|preview, forms.gle/..., or forms.google.com/..."},"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."}},"required":["google_form_url"],"additionalProperties":false},"output_schema":null,"next_actions":["set_currency","enable_payment"],"subproduct":"order_form","intent":{"chip":"Google Form link","line":"Turn this Google Form into an order form:"}},{"name":"create_order_form_from_menu","slug":"from-menu","phase":"create","description":"Create a new Neartail order form from a photo or PDF of a menu or price list. Send the file as base64 (png, jpeg, webp or pdf, up to 4 MB). Products, prices and options are read off the document and the form is published at once. Prices use currency_code, confirmed with the user first. Returns publish_id, preview_url and edit_url. The result carries form_summary (what the form asks and has) and available_setup (every setup menu). After sharing preview_url, decide what this particular form still needs and propose only that to the user as numbered options; do not end the turn without proposing.","input_schema":{"type":"object","properties":{"file":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"File name with extension, e.g. menu.jpg."},"mime_type":{"type":"string","enum":["image/png","image/jpeg","image/jpg","image/webp","application/pdf"]},"base64":{"type":"string","minLength":4,"maxLength":6000000,"description":"The file bytes, base64 encoded, no data: prefix."}},"required":["name","mime_type","base64"],"additionalProperties":false},"currency_code":{"type":"string","minLength":3,"maxLength":3,"description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"instructions":{"type":"string","maxLength":2000,"description":"Notes for the form. Not yet applied while reading the menu; use edit actions afterwards."}},"required":["file"],"additionalProperties":false},"output_schema":null,"next_actions":["set_currency","enable_payment"],"subproduct":"order_form","intent":{"chip":"Menu photo or price list","line":"Make an order form from this menu:"}},{"name":"create_order_form","slug":"from-name","phase":"create","description":"Create a new Neartail order form from a name such as \"Diwali sweets order form\" and optional instructions (what to sell, sizes, delivery notes). Products and fields are drafted for you and the form is published at once. Prices use currency_code, confirmed with the user first. Returns publish_id, preview_url (share with buyers) and edit_url. The result carries form_summary (what the form asks and has) and available_setup (every setup menu). After sharing preview_url, decide what this particular form still needs and propose only that to the user as numbered options; do not end the turn without proposing.","input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":3,"maxLength":120,"description":"What the form is for, e.g. \"Bakery pre-order form\"."},"instructions":{"type":"string","maxLength":2000,"description":"What to sell, sizes, prices, delivery or pickup notes."},"currency_code":{"type":"string","minLength":3,"maxLength":3,"description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"language":{"type":"string","default":"en","description":"Form language code, default en."}},"required":["name"],"additionalProperties":false},"output_schema":null,"next_actions":["set_currency","enable_payment"],"subproduct":"order_form","intent":{"chip":"Describe your business","line":"Make an order form for my business:"}},{"name":"create_order_form_from_website","slug":"from-website","phase":"create","description":"Create a Neartail order form from a website or online menu. The page is read, linked product pages too when deep is true (default), and an order form with the products, prices and photos is built. instructions narrows what to include. Prices use currency_code, confirmed with the user first, unless the site shows another currency. Takes one to three minutes. Returns publish_id, preview_url, edit_url, currency and the number of products. The result carries form_summary (what the form asks and has) and available_setup (every setup menu). After sharing preview_url, decide what this particular form still needs and propose only that to the user as numbered options; do not end the turn without proposing.","input_schema":{"type":"object","properties":{"url":{"type":"string","minLength":4,"maxLength":2000,"description":"The website or menu page to read, such as https://example.com/menu."},"instructions":{"type":"string","maxLength":2000,"description":"Optional: what to include or leave out, for example \"only the lunch menu\"."},"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions. If the website itself shows prices in a currency, that currency is used when omitted; the result reports it."},"deep":{"type":"boolean","default":true,"description":"Read linked product pages for sizes, prices and photos. false keeps to the given page."}},"required":["url"],"additionalProperties":false},"output_schema":null,"next_actions":["set_currency","enable_payment"],"subproduct":"order_form","intent":{"chip":"Website link","line":"Make an order form from my website:"}},{"name":"enable_payment","slug":"enable-payment","phase":"setup","description":"Turn on payment methods for an order form. Call list_payment_methods first: the methods depend on the form's currency. payment_details takes one entry per method with exactly the fields that method needs (the schema lists them per method); every instant method in the call is enabled at once. cards and paypal_checkout come back as pending with connect_url: give the owner that link, and call again with that method when they have connected. Without payment_details: reports what is enabled and which methods can still be added.","input_schema":{"type":"object","properties":{"publish_id":{"type":"string","description":"The form id."},"payment_details":{"type":"array","minItems":1,"description":"One entry per payment method to turn on, each with the fields that method needs. A method appears once. Omit the whole field to be told which methods the form can take.","items":{"anyOf":[{"type":"object","properties":{"payment_method":{"type":"string","enum":["upi"],"description":"UPI (GPay, PhonePe, Paytm). INR only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UPI id such as name@bank."},"payee_name":{"type":"string","maxLength":100,"description":"Name buyers see when paying (the account holder)."}},"required":["payment_method","handle","payee_name"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paynow"],"description":"PayNow. SGD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UEN or mobile number."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["venmo"],"description":"Venmo. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Venmo username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cashapp"],"description":"Cash App. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Cashtag."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["zelle"],"description":"Zelle. USD only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_me"],"description":"PayPal.me link. AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, RUB, SGD, SEK, CHF, THB, USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's paypal.me username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["lydia"],"description":"Lydia. EUR only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cash_on_delivery"],"description":"Cash on delivery."},"instructions":{"type":"string","maxLength":2000,"description":"Optional note for buyers."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["bank_transfer"],"description":"Bank transfer."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cheque"],"description":"Cheque."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cards"],"description":"Credit or debit cards (Stripe). The owner connects Stripe once through connect_url."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_checkout"],"description":"PayPal checkout. The owner connects PayPal once through connect_url."}},"required":["payment_method"],"additionalProperties":false}]}}},"required":["publish_id"],"additionalProperties":false},"output_schema":null,"next_actions":[]},{"name":"enable_whatsapp","slug":"enable-whatsapp","phase":"setup","description":"Send each order of a form to a WhatsApp number. After submitting, the buyer is taken to WhatsApp with the order text addressed to this number. phone is E.164 with country code (+919876543210); whatsapp_message is an optional template for that text (max 500 characters). Calling it again replaces the number and the message (omitting whatsapp_message clears it). Answers preview_url and edit_url.","input_schema":{"type":"object","properties":{"publish_id":{"type":"string","description":"The form id."},"phone":{"type":"string","minLength":8,"maxLength":24,"description":"WhatsApp number with country code, e.g. +919876543210."},"whatsapp_message":{"type":"string","maxLength":500,"description":"Optional text sent with each order; the order summary follows it."}},"required":["publish_id","phone"],"additionalProperties":false},"output_schema":null,"next_actions":[]},{"name":"get_order_form","slug":"get-order-form","phase":"setup","description":"Read an order form in this account: title, sections and every field with its id, type and choices, plus the current layout, theme and thank-you message. Answers preview_url and edit_url. Call it before changing a form so later calls can refer to field ids.","input_schema":{"type":"object","properties":{"publish_id":{"type":"string","description":"The form id from a create action or the dashboard url."}},"required":["publish_id"],"additionalProperties":false},"output_schema":null,"next_actions":[]},{"name":"list_payment_methods","slug":"list-payment-methods","phase":"setup","description":"List the payment methods available for a form in its currency (publish_id), or for a currency before the form exists (currency_code), what each needs from the owner (a handle, a name, instructions, or nothing), and which are already enabled. Call it before enable_payment and offer the owner these methods by label; several can be turned on in one enable_payment call. Read-only.","input_schema":{"type":"object","properties":{"publish_id":{"type":"string","description":"The form id. Its currency decides the list."},"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"Without a form yet: the currency the form will use, to see the methods before creating it."}},"required":[],"additionalProperties":false},"output_schema":null,"next_actions":[]},{"name":"set_currency","slug":"set-currency","phase":"setup","description":"Set the currency of an order form by 3-letter code such as USD, INR or EUR. Updates the symbol on every product and total; amounts are not converted. Calling it with the current currency is harmless. Answers the new and previous currency, the number of products touched, preview_url and edit_url.","input_schema":{"type":"object","properties":{"publish_id":{"type":"string","description":"The form id."},"currency_code":{"type":"string","minLength":3,"maxLength":3,"description":"3-letter ISO code, e.g. USD, INR, GBP, EUR."}},"required":["publish_id","currency_code"],"additionalProperties":false},"output_schema":null,"next_actions":[]},{"name":"create_payment_form_from_google_form","slug":"payment-form/from-google-form","phase":"create","description":"Create a Neartail payment form from an existing Google Form. A copy of the form is made in the account and set up as a payment form; the original is left unchanged. Accepts edit, viewform, preview and forms.gle links. A private form answers access_required with grant_url: the user opens it, picks the form in Drive and grants access, then the call is retried. Returns publish_id, preview_url, edit_url, title and currency. Payment is turned on in this same call. Use the currency the source shows (ask only when it shows none), call list_payment_methods with that currency_code to get the methods it allows, offer them as one short question whose whole text is the choices (its message gives the wording), then ask in one message for the fields each chosen one needs; pass them as payment_details. cards and paypal_checkout come back as pending with connect_url for the owner.","input_schema":{"type":"object","properties":{"google_form_url":{"type":"string","minLength":10,"maxLength":2000,"description":"The Google Form link: docs.google.com/forms/d/.../edit|viewform|preview, forms.gle/..., or forms.google.com/..."},"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"payment_details":{"type":"array","minItems":1,"description":"One entry per payment method to turn on, each with the fields that method needs. A method appears once. Omit the whole field to be told which methods the form can take.","items":{"anyOf":[{"type":"object","properties":{"payment_method":{"type":"string","enum":["upi"],"description":"UPI (GPay, PhonePe, Paytm). INR only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UPI id such as name@bank."},"payee_name":{"type":"string","maxLength":100,"description":"Name buyers see when paying (the account holder)."}},"required":["payment_method","handle","payee_name"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paynow"],"description":"PayNow. SGD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UEN or mobile number."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["venmo"],"description":"Venmo. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Venmo username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cashapp"],"description":"Cash App. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Cashtag."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["zelle"],"description":"Zelle. USD only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_me"],"description":"PayPal.me link. AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, RUB, SGD, SEK, CHF, THB, USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's paypal.me username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["lydia"],"description":"Lydia. EUR only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cash_on_delivery"],"description":"Cash on delivery."},"instructions":{"type":"string","maxLength":2000,"description":"Optional note for buyers."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["bank_transfer"],"description":"Bank transfer."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cheque"],"description":"Cheque."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cards"],"description":"Credit or debit cards (Stripe). The owner connects Stripe once through connect_url."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_checkout"],"description":"PayPal checkout. The owner connects PayPal once through connect_url."}},"required":["payment_method"],"additionalProperties":false}]}}},"required":["google_form_url","currency_code","payment_details"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"payment_form","intent":{"chip":"Google Form link","line":"Turn this Google Form into a payment form:"}},{"name":"create_payment_form_from_menu","slug":"payment-form/from-menu","phase":"create","description":"Create a new Neartail payment form from a photo or PDF of a menu or price list. Send the file as base64 (png, jpeg, webp or pdf, up to 4 MB). Products, prices and options are read off the document and the form is published at once. Prices use currency_code, confirmed with the user first. Returns publish_id, preview_url and edit_url. Payment is turned on in this same call. Use the currency the source shows (ask only when it shows none), call list_payment_methods with that currency_code to get the methods it allows, offer them as one short question whose whole text is the choices (its message gives the wording), then ask in one message for the fields each chosen one needs; pass them as payment_details. cards and paypal_checkout come back as pending with connect_url for the owner.","input_schema":{"type":"object","properties":{"file":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"File name with extension, e.g. menu.jpg."},"mime_type":{"type":"string","enum":["image/png","image/jpeg","image/jpg","image/webp","application/pdf"]},"base64":{"type":"string","minLength":4,"maxLength":6000000,"description":"The file bytes, base64 encoded, no data: prefix."}},"required":["name","mime_type","base64"],"additionalProperties":false},"currency_code":{"type":"string","minLength":3,"maxLength":3,"description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"instructions":{"type":"string","maxLength":2000,"description":"Notes for the form. Not yet applied while reading the menu; use edit actions afterwards."},"payment_details":{"type":"array","minItems":1,"description":"One entry per payment method to turn on, each with the fields that method needs. A method appears once. Omit the whole field to be told which methods the form can take.","items":{"anyOf":[{"type":"object","properties":{"payment_method":{"type":"string","enum":["upi"],"description":"UPI (GPay, PhonePe, Paytm). INR only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UPI id such as name@bank."},"payee_name":{"type":"string","maxLength":100,"description":"Name buyers see when paying (the account holder)."}},"required":["payment_method","handle","payee_name"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paynow"],"description":"PayNow. SGD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UEN or mobile number."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["venmo"],"description":"Venmo. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Venmo username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cashapp"],"description":"Cash App. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Cashtag."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["zelle"],"description":"Zelle. USD only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_me"],"description":"PayPal.me link. AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, RUB, SGD, SEK, CHF, THB, USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's paypal.me username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["lydia"],"description":"Lydia. EUR only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cash_on_delivery"],"description":"Cash on delivery."},"instructions":{"type":"string","maxLength":2000,"description":"Optional note for buyers."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["bank_transfer"],"description":"Bank transfer."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cheque"],"description":"Cheque."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cards"],"description":"Credit or debit cards (Stripe). The owner connects Stripe once through connect_url."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_checkout"],"description":"PayPal checkout. The owner connects PayPal once through connect_url."}},"required":["payment_method"],"additionalProperties":false}]}}},"required":["file","currency_code","payment_details"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"payment_form","intent":{"chip":"Menu photo or price list","line":"Make a payment form from this menu:"}},{"name":"create_payment_form_from_name","slug":"payment-form/from-name","phase":"create","description":"Create a new Neartail payment form from a name such as \"Diwali sweets payment form\" and optional instructions (what to sell, sizes, delivery notes). Products and fields are drafted for you and the form is published at once. Prices use currency_code, confirmed with the user first. Returns publish_id, preview_url (share with buyers) and edit_url. Payment is turned on in this same call. Use the currency the source shows (ask only when it shows none), call list_payment_methods with that currency_code to get the methods it allows, offer them as one short question whose whole text is the choices (its message gives the wording), then ask in one message for the fields each chosen one needs; pass them as payment_details. cards and paypal_checkout come back as pending with connect_url for the owner.","input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":3,"maxLength":120,"description":"What the form is for, e.g. \"Bakery pre-order form\"."},"instructions":{"type":"string","maxLength":2000,"description":"What to sell, sizes, prices, delivery or pickup notes."},"currency_code":{"type":"string","minLength":3,"maxLength":3,"description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"language":{"type":"string","default":"en","description":"Form language code, default en."},"payment_details":{"type":"array","minItems":1,"description":"One entry per payment method to turn on, each with the fields that method needs. A method appears once. Omit the whole field to be told which methods the form can take.","items":{"anyOf":[{"type":"object","properties":{"payment_method":{"type":"string","enum":["upi"],"description":"UPI (GPay, PhonePe, Paytm). INR only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UPI id such as name@bank."},"payee_name":{"type":"string","maxLength":100,"description":"Name buyers see when paying (the account holder)."}},"required":["payment_method","handle","payee_name"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paynow"],"description":"PayNow. SGD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UEN or mobile number."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["venmo"],"description":"Venmo. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Venmo username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cashapp"],"description":"Cash App. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Cashtag."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["zelle"],"description":"Zelle. USD only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_me"],"description":"PayPal.me link. AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, RUB, SGD, SEK, CHF, THB, USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's paypal.me username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["lydia"],"description":"Lydia. EUR only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cash_on_delivery"],"description":"Cash on delivery."},"instructions":{"type":"string","maxLength":2000,"description":"Optional note for buyers."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["bank_transfer"],"description":"Bank transfer."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cheque"],"description":"Cheque."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cards"],"description":"Credit or debit cards (Stripe). The owner connects Stripe once through connect_url."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_checkout"],"description":"PayPal checkout. The owner connects PayPal once through connect_url."}},"required":["payment_method"],"additionalProperties":false}]}}},"required":["name","currency_code","payment_details"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"payment_form","intent":{"chip":"Describe your business","line":"Make a payment form for my business:"}},{"name":"create_payment_form_from_website","slug":"payment-form/from-website","phase":"create","description":"Create a Neartail payment form from a website or online menu. The page is read, linked product pages too when deep is true (default), and a payment form with the products, prices and photos is built. instructions narrows what to include. Prices use currency_code, confirmed with the user first, unless the site shows another currency. Takes one to three minutes. Returns publish_id, preview_url, edit_url, currency and the number of products. Payment is turned on in this same call. Use the currency the source shows (ask only when it shows none), call list_payment_methods with that currency_code to get the methods it allows, offer them as one short question whose whole text is the choices (its message gives the wording), then ask in one message for the fields each chosen one needs; pass them as payment_details. cards and paypal_checkout come back as pending with connect_url for the owner.","input_schema":{"type":"object","properties":{"url":{"type":"string","minLength":4,"maxLength":2000,"description":"The website or menu page to read, such as https://example.com/menu."},"instructions":{"type":"string","maxLength":2000,"description":"Optional: what to include or leave out, for example \"only the lunch menu\"."},"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions. If the website itself shows prices in a currency, that currency is used when omitted; the result reports it."},"deep":{"type":"boolean","default":true,"description":"Read linked product pages for sizes, prices and photos. false keeps to the given page."},"payment_details":{"type":"array","minItems":1,"description":"One entry per payment method to turn on, each with the fields that method needs. A method appears once. Omit the whole field to be told which methods the form can take.","items":{"anyOf":[{"type":"object","properties":{"payment_method":{"type":"string","enum":["upi"],"description":"UPI (GPay, PhonePe, Paytm). INR only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UPI id such as name@bank."},"payee_name":{"type":"string","maxLength":100,"description":"Name buyers see when paying (the account holder)."}},"required":["payment_method","handle","payee_name"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paynow"],"description":"PayNow. SGD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's UEN or mobile number."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["venmo"],"description":"Venmo. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Venmo username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cashapp"],"description":"Cash App. USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's Cashtag."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["zelle"],"description":"Zelle. USD only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_me"],"description":"PayPal.me link. AUD, BRL, CAD, CNY, CZK, DKK, EUR, HKD, HUF, ILS, JPY, MYR, MXN, TWD, NZD, NOK, PHP, PLN, GBP, RUB, SGD, SEK, CHF, THB, USD only."},"handle":{"type":"string","maxLength":200,"description":"The owner's paypal.me username."}},"required":["payment_method","handle"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["lydia"],"description":"Lydia. EUR only."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cash_on_delivery"],"description":"Cash on delivery."},"instructions":{"type":"string","maxLength":2000,"description":"Optional note for buyers."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["bank_transfer"],"description":"Bank transfer."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cheque"],"description":"Cheque."},"instructions":{"type":"string","maxLength":2000,"description":"Payment details buyers follow (account details, email or phone to send to, payee for a cheque)."}},"required":["payment_method","instructions"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["cards"],"description":"Credit or debit cards (Stripe). The owner connects Stripe once through connect_url."}},"required":["payment_method"],"additionalProperties":false},{"type":"object","properties":{"payment_method":{"type":"string","enum":["paypal_checkout"],"description":"PayPal checkout. The owner connects PayPal once through connect_url."}},"required":["payment_method"],"additionalProperties":false}]}}},"required":["url","currency_code","payment_details"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"payment_form","intent":{"chip":"Website link","line":"Make a payment form from my website:"}},{"name":"create_whatsapp_form_from_google_form","slug":"whatsapp-form/from-google-form","phase":"create","description":"Create a Neartail WhatsApp order form from an existing Google Form. A copy of the form is made in the account and set up as a WhatsApp WhatsApp order form; the original is left unchanged. Accepts edit, viewform, preview and forms.gle links. A private form answers access_required with grant_url: the user opens it, picks the form in Drive and grants access, then the call is retried. Returns publish_id, preview_url, edit_url, title and currency. The WhatsApp number is linked in this same call: use the currency the source shows (ask only when it shows none) and ask the user for the number orders should go to, then pass it as whatsapp_number.","input_schema":{"type":"object","properties":{"google_form_url":{"type":"string","minLength":10,"maxLength":2000,"description":"The Google Form link: docs.google.com/forms/d/.../edit|viewform|preview, forms.gle/..., or forms.google.com/..."},"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"whatsapp_number":{"type":"string","minLength":8,"maxLength":24,"description":"The owner's WhatsApp number with country code, e.g. +919876543210. Ask the user for it."},"whatsapp_message":{"type":"string","maxLength":500,"description":"Optional text sent with each order; the order summary follows it."}},"required":["google_form_url","currency_code","whatsapp_number"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"whatsapp_form","intent":{"chip":"Google Form link","line":"Turn this Google Form into a WhatsApp order form:"}},{"name":"create_whatsapp_form_from_menu","slug":"whatsapp-form/from-menu","phase":"create","description":"Create a new Neartail WhatsApp order form from a photo or PDF of a menu or price list. Send the file as base64 (png, jpeg, webp or pdf, up to 4 MB). Products, prices and options are read off the document and the form is published at once. Prices use currency_code, confirmed with the user first. Returns publish_id, preview_url and edit_url. The WhatsApp number is linked in this same call: use the currency the source shows (ask only when it shows none) and ask the user for the number orders should go to, then pass it as whatsapp_number.","input_schema":{"type":"object","properties":{"file":{"type":"object","properties":{"name":{"type":"string","minLength":1,"maxLength":200,"description":"File name with extension, e.g. menu.jpg."},"mime_type":{"type":"string","enum":["image/png","image/jpeg","image/jpg","image/webp","application/pdf"]},"base64":{"type":"string","minLength":4,"maxLength":6000000,"description":"The file bytes, base64 encoded, no data: prefix."}},"required":["name","mime_type","base64"],"additionalProperties":false},"currency_code":{"type":"string","minLength":3,"maxLength":3,"description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"instructions":{"type":"string","maxLength":2000,"description":"Notes for the form. Not yet applied while reading the menu; use edit actions afterwards."},"whatsapp_number":{"type":"string","minLength":8,"maxLength":24,"description":"The owner's WhatsApp number with country code, e.g. +919876543210. Ask the user for it."},"whatsapp_message":{"type":"string","maxLength":500,"description":"Optional text sent with each order; the order summary follows it."}},"required":["file","currency_code","whatsapp_number"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"whatsapp_form","intent":{"chip":"Menu photo or price list","line":"Make a WhatsApp order form from this menu:"}},{"name":"create_whatsapp_form_from_name","slug":"whatsapp-form/from-name","phase":"create","description":"Create a new Neartail WhatsApp order form from a name such as \"Diwali sweets WhatsApp order form\" and optional instructions (what to sell, sizes, delivery notes). Products and fields are drafted for you and the form is published at once. Prices use currency_code, confirmed with the user first. Returns publish_id, preview_url (share with buyers) and edit_url. The WhatsApp number is linked in this same call: use the currency the source shows (ask only when it shows none) and ask the user for the number orders should go to, then pass it as whatsapp_number.","input_schema":{"type":"object","properties":{"name":{"type":"string","minLength":3,"maxLength":120,"description":"What the form is for, e.g. \"Bakery pre-order form\"."},"instructions":{"type":"string","maxLength":2000,"description":"What to sell, sizes, prices, delivery or pickup notes."},"currency_code":{"type":"string","minLength":3,"maxLength":3,"description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions."},"language":{"type":"string","default":"en","description":"Form language code, default en."},"whatsapp_number":{"type":"string","minLength":8,"maxLength":24,"description":"The owner's WhatsApp number with country code, e.g. +919876543210. Ask the user for it."},"whatsapp_message":{"type":"string","maxLength":500,"description":"Optional text sent with each order; the order summary follows it."}},"required":["name","currency_code","whatsapp_number"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"whatsapp_form","intent":{"chip":"Describe your business","line":"Make a WhatsApp order form for my business:"}},{"name":"create_whatsapp_form_from_website","slug":"whatsapp-form/from-website","phase":"create","description":"Create a Neartail WhatsApp order form from a website or online menu. The page is read, linked product pages too when deep is true (default), and a WhatsApp WhatsApp order form with the products, prices and photos is built. instructions narrows what to include. Prices use currency_code, confirmed with the user first, unless the site shows another currency. Takes one to three minutes. Returns publish_id, preview_url, edit_url, currency and the number of products. The WhatsApp number is linked in this same call: use the currency the source shows (ask only when it shows none) and ask the user for the number orders should go to, then pass it as whatsapp_number.","input_schema":{"type":"object","properties":{"url":{"type":"string","minLength":4,"maxLength":2000,"description":"The website or menu page to read, such as https://example.com/menu."},"instructions":{"type":"string","maxLength":2000,"description":"Optional: what to include or leave out, for example \"only the lunch menu\"."},"currency_code":{"type":"string","pattern":"^[A-Za-z]{3}$","description":"The currency of the prices: a 3-letter code such as USD, INR or SGD. Take it from the source when the source shows it (the prices on the Google Form, website or menu, or what the user already said) and do not ask. Ask only when no currency is shown or it is unclear (a bare \"$\"), or the form is made from a name alone: then confirm it as one short question whose whole text is the choices, for example \"Prices in USD or SGD?\"; no explanation, no price questions. If the website itself shows prices in a currency, that currency is used when omitted; the result reports it."},"deep":{"type":"boolean","default":true,"description":"Read linked product pages for sizes, prices and photos. false keeps to the given page."},"whatsapp_number":{"type":"string","minLength":8,"maxLength":24,"description":"The owner's WhatsApp number with country code, e.g. +919876543210. Ask the user for it."},"whatsapp_message":{"type":"string","maxLength":500,"description":"Optional text sent with each order; the order summary follows it."}},"required":["url","currency_code","whatsapp_number"],"additionalProperties":false},"output_schema":null,"next_actions":[],"subproduct":"whatsapp_form","intent":{"chip":"Website link","line":"Make a WhatsApp order form from my website:"}}]}