Set up a store before it goes live
set_up_storeSets up a store that is not live yet, in one call: the shop's website (only that site may then show the chat; its www twin is added), the chat's colours and button position, the header title, greeting and starter questions in one language, the tone and wording, a welcome and a goodbye popup, the countries the shop sells to, and switches (add to cart, ratings, photos, suggested replies). Only the given fields change. A greeting that does not say, in its language, that shoppers are talking to an AI assistant is refused. Voice is switched on or off only on the dashboard. Order lookup is not set here: it needs the Order status rule, added and tested in Rules on the dashboard. Refused once the store's chat is live on the shop.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"store_id": "<store_id>"
},
"name": "set_up_store"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tone | No | ||
| title | No | ||
| photos | No | Shoppers can send a photo, e.g. of a product. | |
| ratings | No | Shoppers are asked to rate the chat after it. | |
| website | No | The shop's address, e.g. 'https://myshop.com'. | |
| greeting | No | The welcome message. | |
| language | No | Language of title, greeting and starter questions, e.g. 'en'. One language per call. | |
| position | No | ||
| store_id | Yes | The store's store_id (not its name). | |
| add_to_cart | No | ||
| primary_color | No | Buttons and header, e.g. '#1e1b4b'. | |
| goodbye_message | No | A short popup when a visitor is about to leave, in language. '' switches it off. | |
| secondary_color | No | ||
| welcome_message | No | A short popup new visitors see after a few seconds, in language. '' switches it off. | |
| sell_to_countries | No | Two-letter codes of the countries the shop sells to; the chat answers only visitors there. [] answers everyone. Not needed for a shop that sells worldwide. | |
| starter_questions | No | Questions shoppers can tap, in a shopper's own words. Replaces that language's list. | |
| custom_instructions | No | Wording preferences per situation. Wording only: facts and prices belong on the shop's pages. | |
| follow_up_suggestions | No | Suggested replies under the chat's answers. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| changed | Yes | ||
| install | No | ||
| try_url | No | ||
| store_id | Yes | ||
| chat_settings | Yes | ||
| allowed_domains | No |