Для AI-агентов: markdown этой страницы — /docs/mcp-onboarding.mdиндекс документации — /llms.txt
MCP: onboarding
Обновлено
MCP: onboarding
Это определения инструментов из текущего ToolRegistry, включая полные inputSchema/outputSchema, scope, required_scopes (ALL), risk и версию платформы. Наличие определения не означает, что инструмент уже установлен вашим хостом или разрешён вашим credential. Обновляйте tools/list после изменения бизнеса, readiness и прав. Progressive disclosure через load_domain/describe_tool и существующий meta-dispatch описаны в MCP-руководстве. Scopes и права применяются при вызове; risk не заменяет согласие и отдельные требования денежной операции. JSON ниже — схема, а не успешный результат вызова.
cancel_auto_renew
Cancel automatic renewal while keeping access through the paid period.
{
"description": "Cancel automatic renewal while keeping access through the paid period.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "cancel_auto_renew",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Cancel Auto Renew"
}check_free_conditions
Check the current conditions for keeping your business site on the free plan.
{
"description": "Check the current conditions for keeping your business site on the free plan.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "check_free_conditions",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Check Free Conditions"
}check_slug_availability
Check address format and availability for the authenticated owner or scoped tenant without reserving it.
{
"description": "Check address format and availability for the authenticated owner or scoped tenant without reserving it.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"slug": {
"description": "Public business address to check. Atomic claim remains authoritative.",
"maxLength": 63,
"minLength": 1,
"type": "string"
}
},
"required": [
"slug"
],
"type": "object"
},
"name": "check_slug_availability",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"reason": {
"enum": [
"format",
"reserved"
],
"type": "string"
},
"slug": {
"maxLength": 63,
"type": "string"
},
"status": {
"enum": [
"free",
"taken",
"invalid",
"owned"
],
"type": "string"
}
},
"required": [
"slug",
"status"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Check Slug Availability"
}claim_slug
Claim the immutable public address and language; automatic site preparation starts immediately. Read get_onboarding_state until site_operation completes; no business questionnaire is required.
{
"description": "Claim the immutable public address and language; automatic site preparation starts immediately. Read get_onboarding_state until site_operation completes; no business questionnaire is required.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"language": {
"description": "Language of this business.",
"enum": [
"ru",
"en"
],
"type": "string"
},
"new_business": {
"description": "Create another business for this owner.",
"type": "boolean"
},
"slug": {
"description": "Public business subdomain.",
"maxLength": 63,
"minLength": 1,
"type": "string"
},
"src": {
"description": "Source label from the onboarding invitation.",
"maxLength": 64,
"pattern": "^[a-z0-9_-]+$",
"type": "string"
}
},
"required": [
"slug",
"language"
],
"type": "object"
},
"name": "claim_slug",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"site_operation": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"anyOf": [
{
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"generation": {
"const": 0,
"type": "number"
},
"next_attempt_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": "object"
},
{
"type": "null"
}
]
},
"site_url": {
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"language",
"site_url",
"site_operation"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Claim Slug"
}confirm_supergroups
Confirm three discovered groups by candidate number and fingerprint. If discovery is stale, follow next_action to refresh it.
{
"description": "Confirm three discovered groups by candidate number and fingerprint. If discovery is stale, follow next_action to refresh it.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"fingerprint": {
"description": "Fingerprint returned by discovery.",
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"roles": {
"additionalProperties": false,
"description": "Candidate numbers assigned to the three operator roles.",
"properties": {
"open_lines": {
"description": "Value for open lines.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"operations": {
"description": "Value for operations.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"settings": {
"description": "Value for settings.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
}
},
"required": [
"settings",
"operations",
"open_lines"
],
"type": "object"
}
},
"required": [
"fingerprint",
"roles"
],
"type": "object"
},
"name": "confirm_supergroups",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Confirm Supergroups"
}create_quest_product
Create a free quest product with delivery content for your trial business. Completion is recorded after the actual purchase and delivery.
{
"description": "Create a free quest product with delivery content for your trial business. Completion is recorded after the actual purchase and delivery.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"card": {
"additionalProperties": false,
"description": "Value for card.",
"properties": {
"mediaRefs": {
"default": [],
"description": "Immutable descriptors from media_finalize. URLs and bytes are forbidden.",
"items": {
"additionalProperties": false,
"description": "Value for media Refs item.",
"properties": {
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"captionEntities": {
"description": "Value for caption Entities.",
"items": {
"additionalProperties": false,
"description": "Value for caption Entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^-?\\d+$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"type": "array"
},
"captionHtml": {
"description": "Value for caption Html.",
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"expectedSizeBytes": {
"description": "Value for expected Size Bytes.",
"exclusiveMinimum": 0,
"maximum": 4294967296,
"type": "integer"
},
"generatedFileName": {
"description": "Value for generated File Name.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"kind": {
"description": "Value for kind.",
"enum": [
"voice",
"audio",
"video_note"
],
"type": "string"
},
"mediaRef": {
"description": "Value for media Ref.",
"maxLength": 512,
"pattern": "^media-ingress\\/v1\\/[a-f0-9]{64}\\/[A-Za-z0-9_-]{16,128}\\/objects\\/[a-z][a-z0-9-]{0,63}\\/[a-f0-9]{64}\\/[a-f0-9]{24}\\.blob$",
"type": "string"
},
"mimeType": {
"description": "Value for mime Type.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"description": "Value for sha256.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"mediaRef",
"expectedSizeBytes",
"sha256",
"mimeType"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"text": {
"anyOf": [
{
"description": "Value for text option.",
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
{
"const": "",
"description": "Value for text option.",
"type": "string"
}
],
"description": "Value for text."
}
},
"required": [
"mediaRefs"
],
"type": "object"
},
"delivery": {
"additionalProperties": false,
"description": "Value for delivery.",
"properties": {
"mediaRefs": {
"default": [],
"description": "Immutable descriptors from media_finalize. URLs and bytes are forbidden.",
"items": {
"additionalProperties": false,
"description": "Value for media Refs item.",
"properties": {
"caption": {
"description": "Value for caption.",
"maxLength": 1024,
"type": "string"
},
"captionEntities": {
"description": "Value for caption Entities.",
"items": {
"additionalProperties": false,
"description": "Value for caption Entities item.",
"properties": {
"custom_emoji_id": {
"description": "Value for custom emoji id.",
"type": "string"
},
"language": {
"description": "Value for language.",
"type": "string"
},
"length": {
"description": "Value for length.",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"offset": {
"description": "Value for offset.",
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"type": {
"description": "Value for type.",
"enum": [
"mention",
"hashtag",
"cashtag",
"bot_command",
"url",
"email",
"phone_number",
"bold",
"italic",
"underline",
"strikethrough",
"spoiler",
"blockquote",
"expandable_blockquote",
"code",
"pre",
"text_link",
"text_mention",
"custom_emoji"
],
"type": "string"
},
"url": {
"description": "Value for url.",
"type": "string"
},
"user": {
"additionalProperties": false,
"description": "Value for user.",
"properties": {
"firstName": {
"description": "Value for first Name.",
"type": "string"
},
"id": {
"description": "Value for id.",
"pattern": "^-?\\d+$",
"type": "string"
},
"lastName": {
"description": "Value for last Name.",
"type": "string"
},
"username": {
"description": "Value for username.",
"type": "string"
}
},
"required": [
"id"
],
"type": "object"
}
},
"required": [
"type",
"offset",
"length"
],
"type": "object"
},
"type": "array"
},
"captionHtml": {
"description": "Value for caption Html.",
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
"expectedSizeBytes": {
"description": "Value for expected Size Bytes.",
"exclusiveMinimum": 0,
"maximum": 4294967296,
"type": "integer"
},
"generatedFileName": {
"description": "Value for generated File Name.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"kind": {
"description": "Value for kind.",
"enum": [
"voice",
"audio",
"video_note"
],
"type": "string"
},
"mediaRef": {
"description": "Value for media Ref.",
"maxLength": 512,
"pattern": "^media-ingress\\/v1\\/[a-f0-9]{64}\\/[A-Za-z0-9_-]{16,128}\\/objects\\/[a-z][a-z0-9-]{0,63}\\/[a-f0-9]{64}\\/[a-f0-9]{24}\\.blob$",
"type": "string"
},
"mimeType": {
"description": "Value for mime Type.",
"maxLength": 255,
"minLength": 1,
"type": "string"
},
"sha256": {
"description": "Value for sha256.",
"pattern": "^[0-9a-f]{64}$",
"type": "string"
},
"type": {
"description": "Value for type.",
"enum": [
"photo",
"video",
"document"
],
"type": "string"
}
},
"required": [
"type",
"mediaRef",
"expectedSizeBytes",
"sha256",
"mimeType"
],
"type": "object"
},
"maxItems": 10,
"type": "array"
},
"text": {
"anyOf": [
{
"description": "Value for text option.",
"maxLength": 16384,
"minLength": 1,
"type": "string"
},
{
"const": "",
"description": "Value for text option.",
"type": "string"
}
],
"description": "Value for text."
}
},
"required": [
"mediaRefs"
],
"type": "object"
},
"idempotency_key": {
"description": "Value for idempotency key.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"journey_revision": {
"const": 1,
"description": "Value for journey revision.",
"type": "number"
},
"title": {
"description": "Value for title.",
"maxLength": 200,
"minLength": 1,
"type": "string"
}
},
"required": [
"title",
"card",
"delivery",
"idempotency_key",
"journey_revision"
],
"type": "object"
},
"name": "create_quest_product",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"delivery_state": {
"enum": [
"pending",
"ready",
"failed"
],
"type": "string"
},
"phase": {
"enum": [
"accepted",
"card_pending",
"delivery_pending",
"ready",
"failed"
],
"type": "string"
},
"product_seq_num": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"title": {
"type": "string"
}
},
"required": [
"product_seq_num",
"title",
"delivery_state"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Create Quest Product"
}create_quick_site
Publish a business site from a description or structured fields.
{
"description": "Publish a business site from a description or structured fields.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"fields": {
"additionalProperties": false,
"description": "Structured business information when text parsing is unavailable.",
"properties": {
"avatar_media_ref": {
"description": "Durable public HTTPS business image URL; opaque references and signed expiring URLs are not accepted",
"format": "uri",
"type": "string"
},
"business_name": {
"description": "Business name",
"type": "string"
},
"contacts": {
"description": "Business contact methods",
"items": {
"additionalProperties": false,
"description": "Value for contacts item.",
"properties": {
"kind": {
"description": "Contact method",
"enum": [
"phone",
"email",
"telegram",
"url"
],
"type": "string"
},
"value": {
"description": "Contact value",
"type": "string"
}
},
"required": [
"kind",
"value"
],
"type": "object"
},
"type": "array"
},
"offer": {
"description": "What the business offers",
"type": "string"
},
"tagline": {
"description": "Short business description",
"type": "string"
}
},
"required": [
"business_name",
"offer",
"contacts"
],
"type": "object"
},
"text": {
"description": "Describe the business in free text.",
"maxLength": 2000,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "create_quick_site",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Create Quick Site"
}discover_supergroups
Discover existing operator supergroups after an owner action. Read get_onboarding_state for the next action.
{
"description": "Discover existing operator supergroups after an owner action. Read get_onboarding_state for the next action.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"refresh": {
"description": "Refresh the candidate groups after an owner action.",
"type": "boolean"
}
},
"type": "object"
},
"name": "discover_supergroups",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Discover Supergroups"
}get_billing_state
Read the current plan, paid period and automatic renewal state.
{
"description": "Read the current plan, paid period and automatic renewal state.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_billing_state",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Get Billing State"
}get_catalog_topic_link
Get the deeplink to the Catalog topic in the tenant Settings supergroup (where products are added). Returns null with guidance if the Settings supergroup / catalog topic is not provisioned yet.
{
"description": "Get the deeplink to the Catalog topic in the tenant Settings supergroup (where products are added). Returns null with guidance if the Settings supergroup / catalog topic is not provisioned yet.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "get_catalog_topic_link",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Get Catalog Topic Link"
}get_onboarding_state
Read onboarding progress and the next action for the current business.
{
"description": "Read onboarding progress and the next action for the current business.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"intent": {
"default": "auto",
"description": "Value for intent.",
"enum": [
"auto",
"new_business"
],
"type": "string"
},
"src": {
"description": "Source label from the onboarding invitation.",
"maxLength": 64,
"pattern": "^[a-z0-9_-]+$",
"type": "string"
}
},
"required": [
"intent"
],
"type": "object"
},
"name": "get_onboarding_state",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"assistant_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"completedSteps": {
"items": {
"type": "string"
},
"type": "array"
},
"discovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"candidates": {
"items": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS"
],
"type": "string"
},
"type": "array"
},
"ordinal": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"ordinal",
"title",
"issues"
],
"type": "object"
},
"type": "array"
},
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"fingerprint",
"candidates"
],
"type": "object"
},
{
"type": "null"
}
]
},
"entry_context": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"continue",
"choose_business",
"work_or_create",
"create_business"
],
"type": "string"
},
"active_business": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"role": {
"enum": [
"owner",
"operator"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role"
],
"type": "object"
},
{
"type": "null"
}
]
},
"intent": {
"enum": [
"auto",
"new_business"
],
"type": "string"
},
"owned_businesses": {
"items": {
"additionalProperties": false,
"properties": {
"onboarding_complete": {
"type": "boolean"
},
"role": {
"const": "owner",
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role",
"onboarding_complete"
],
"type": "object"
},
"type": "array"
},
"recommended_business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"intent",
"active_business",
"owned_businesses",
"recommended_business_slug",
"action"
],
"type": "object"
},
"infrastructure": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"blocked_reason": {
"anyOf": [
{
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"SG_BOT_CAP_REACHED",
"CLIENT_BOT_RIGHTS_MISSING",
"terminal_capability"
],
"type": "string"
},
{
"type": "null"
}
]
},
"bots_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"observed_cap": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"target": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"target",
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"next_attempt_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"pins_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sa_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"titles_done": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"type": "boolean"
},
"OPERATIONS": {
"type": "boolean"
},
"SETTINGS": {
"type": "boolean"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"titles_done",
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"AWAITING_OWNER",
"QUEUED",
"RUNNING",
"BLOCKED",
"COMPLETE",
"FAILED"
],
"type": "string"
},
"topics_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"sa_report",
"bots_report",
"topics_report",
"pins_report",
"blocked_reason",
"next_attempt_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"catalog": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"tariffs": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"catalog",
"tariffs"
],
"type": "object"
},
"site_operation": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"anyOf": [
{
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"generation": {
"const": 0,
"type": "number"
},
"next_attempt_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": "object"
},
{
"type": "null"
}
]
},
"tariff_offers": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"period_days": {
"exclusiveMinimum": 0,
"maximum": 365,
"type": "integer"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^(?:0|[1-9]\\d{0,7})\\.\\d{2}$",
"type": "string"
},
"currency": {
"const": "RUB",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"plan",
"title",
"description",
"price",
"period_days"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
}
},
"required": [
"site_operation",
"language",
"completedSteps",
"discovery",
"infrastructure"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Get Onboarding State"
}init_managed_bot
Get a two-tap Telegram deeplink to connect a new managed bot. The server derives its name from the published business site and its username from the claimed address.
{
"description": "Get a two-tap Telegram deeplink to connect a new managed bot. The server derives its name from the published business site and its username from the claimed address.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "init_managed_bot",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Init Managed Bot"
}onboarding_check_test_product
Check that the saved test product and its digital delivery are ready.
{
"description": "Check that the saved test product and its digital delivery are ready.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "onboarding_check_test_product",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"delivery_state": {
"enum": [
"pending",
"ready",
"failed"
],
"type": "string"
},
"product_seq_num": {
"anyOf": [
{
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
{
"type": "null"
}
]
},
"ready": {
"type": "boolean"
}
},
"required": [
"product_seq_num",
"ready",
"delivery_state"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Onboarding Check Test Product"
}onboarding_check_test_purchase
Verify the owner’s test purchase, actual delivery and granted bonus from server facts.
{
"description": "Verify the owner’s test purchase, actual delivery and granted bonus from server facts.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {},
"type": "object"
},
"name": "onboarding_check_test_purchase",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"completed",
"bonus_state",
"tokens_granted"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:read"
],
"risk": "read",
"scope": "onboarding:read",
"title": "Onboarding Check Test Purchase"
}onboarding_complete
After explicit owner confirmation, verify every mandatory condition and finish this business onboarding.
{
"description": "After explicit owner confirmation, verify every mandatory condition and finish this business onboarding.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"confirm": {
"const": true,
"description": "Value for confirm.",
"type": "boolean"
},
"questions_revision": {
"const": 1,
"description": "Value for questions revision.",
"type": "number"
}
},
"required": [
"confirm",
"questions_revision"
],
"type": "object"
},
"name": "onboarding_complete",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"completed": {
"const": true,
"type": "boolean"
},
"completed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
}
},
"required": [
"completed",
"completed_at"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Onboarding Complete"
}onboarding_defer_first_payment
Record the owner’s decision to receive their first live payment later.
{
"description": "Record the owner’s decision to receive their first live payment later.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "onboarding_defer_first_payment",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
}
},
"required": [
"decisions"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Onboarding Defer First Payment"
}onboarding_defer_tariff
Record the owner’s decision to select and pay for a tariff later, preserving progress.
{
"description": "Record the owner’s decision to select and pay for a tariff later, preserving progress.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "onboarding_defer_tariff",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
}
},
"required": [
"decisions"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Onboarding Defer Tariff"
}onboarding_save_ai_preferences
Save the owner’s explicitly confirmed device, AI application and subscription answers.
{
"description": "Save the owner’s explicitly confirmed device, AI application and subscription answers.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"app": {
"description": "Value for app.",
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"device": {
"description": "Value for device.",
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"description": "Value for other app.",
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"description": "Value for questions revision.",
"type": "number"
},
"subscription": {
"description": "Value for subscription.",
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision"
],
"type": "object"
},
"name": "onboarding_save_ai_preferences",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"preferences": {
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
}
},
"required": [
"preferences"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Onboarding Save Ai Preferences"
}onboarding_send_tariff_checkout_card
Send the selected live platform tariff checkout card to the owner for this explicit business. The owner completes checkout in Telegram; card presentation does not confirm payment or finish onboarding.
{
"description": "Send the selected live platform tariff checkout card to the owner for this explicit business. The owner completes checkout in Telegram; card presentation does not confirm payment or finish onboarding.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"idempotency_key": {
"description": "Retain this command key while presentation is pending or its acknowledgement is unknown.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"plan": {
"description": "Value for plan.",
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
},
"slug": {
"description": "Business slug from the displayed onboarding envelope; never substitute the current active business.",
"maxLength": 32,
"minLength": 3,
"pattern": "^[a-z][a-z0-9-]*[a-z0-9]$",
"type": "string"
}
},
"required": [
"plan",
"slug",
"idempotency_key"
],
"type": "object"
},
"name": "onboarding_send_tariff_checkout_card",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"bot_username": {
"pattern": "^[A-Za-z0-9_]{5,32}$",
"type": "string"
},
"card_delivery_state": {
"enum": [
"pending",
"sent"
],
"type": "string"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
}
},
"required": [
"plan",
"card_delivery_state",
"bot_username"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Onboarding Send Tariff Checkout Card"
}register_existing_bot
Connect the owner’s existing Telegram bot using the bot_token supplied in this agent conversation. The existing registration pipeline validates and finalizes the connection; connected:true means completed finalization. Never echo or place the token in a subsequent instruction. Retry the same token safely, or use resume_bot_connection after a lost response.
{
"description": "Connect the owner’s existing Telegram bot using the bot_token supplied in this agent conversation. The existing registration pipeline validates and finalizes the connection; connected:true means completed finalization. Never echo or place the token in a subsequent instruction. Retry the same token safely, or use resume_bot_connection after a lost response.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"bot_token": {
"description": "Value for bot token.",
"maxLength": 59,
"minLength": 44,
"pattern": "^(\\d{8,12}):([A-Za-z0-9_-]{35,46})$",
"type": "string"
}
},
"required": [
"bot_token"
],
"type": "object"
},
"name": "register_existing_bot",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"connected": {
"const": true,
"type": "boolean"
}
},
"required": [
"connected"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Register Existing Bot"
}register_mini_app_origin
Record an HTTPS Telegram Mini App origin only after the tenant owner has configured the same URL in BotFather. This does not call Bot API or automate BotFather; it confirms the tenant-scoped origin registration used for Mini App launch validation.
{
"description": "Record an HTTPS Telegram Mini App origin only after the tenant owner has configured the same URL in BotFather. This does not call Bot API or automate BotFather; it confirms the tenant-scoped origin registration used for Mini App launch validation.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"origin": {
"description": "Value for origin.",
"format": "uri",
"type": "string"
},
"zone": {
"description": "Value for zone.",
"enum": [
"ru",
"com"
],
"type": "string"
}
},
"required": [
"zone",
"origin"
],
"type": "object"
},
"name": "register_mini_app_origin",
"outputSchema": null,
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Register Mini App Origin"
}resume_bot_connection
Resume the selected business’s frozen bot connection operation without sending a token again. connected:true requires the existing durable finalized result matching the currently bound bot; a partial or unfinished connection returns BOT_CONNECTION_NOT_READY.
{
"description": "Resume the selected business’s frozen bot connection operation without sending a token again. connected:true requires the existing durable finalized result matching the currently bound bot; a partial or unfinished connection returns BOT_CONNECTION_NOT_READY.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "resume_bot_connection",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"connected": {
"const": true,
"type": "boolean"
}
},
"required": [
"connected"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Resume Bot Connection"
}resume_infrastructure
After the owner repairs the reported permissions or group settings, resume infrastructure for the current business using its existing confirmed groups and durable convergence operation. This does not rediscover or bind groups. Terminal platform failures require the repair described by next_action before setup can continue.
{
"description": "After the owner repairs the reported permissions or group settings, resume infrastructure for the current business using its existing confirmed groups and durable convergence operation. This does not rediscover or bind groups. Terminal platform failures require the repair described by next_action before setup can continue.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "resume_infrastructure",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"assistant_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"completedSteps": {
"items": {
"type": "string"
},
"type": "array"
},
"discovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"candidates": {
"items": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS"
],
"type": "string"
},
"type": "array"
},
"ordinal": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"ordinal",
"title",
"issues"
],
"type": "object"
},
"type": "array"
},
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"fingerprint",
"candidates"
],
"type": "object"
},
{
"type": "null"
}
]
},
"entry_context": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"continue",
"choose_business",
"work_or_create",
"create_business"
],
"type": "string"
},
"active_business": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"role": {
"enum": [
"owner",
"operator"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role"
],
"type": "object"
},
{
"type": "null"
}
]
},
"intent": {
"enum": [
"auto",
"new_business"
],
"type": "string"
},
"owned_businesses": {
"items": {
"additionalProperties": false,
"properties": {
"onboarding_complete": {
"type": "boolean"
},
"role": {
"const": "owner",
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role",
"onboarding_complete"
],
"type": "object"
},
"type": "array"
},
"recommended_business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"intent",
"active_business",
"owned_businesses",
"recommended_business_slug",
"action"
],
"type": "object"
},
"infrastructure": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"blocked_reason": {
"anyOf": [
{
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"SG_BOT_CAP_REACHED",
"CLIENT_BOT_RIGHTS_MISSING",
"terminal_capability"
],
"type": "string"
},
{
"type": "null"
}
]
},
"bots_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"observed_cap": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"target": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"target",
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"next_attempt_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"pins_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sa_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"titles_done": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"type": "boolean"
},
"OPERATIONS": {
"type": "boolean"
},
"SETTINGS": {
"type": "boolean"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"titles_done",
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"AWAITING_OWNER",
"QUEUED",
"RUNNING",
"BLOCKED",
"COMPLETE",
"FAILED"
],
"type": "string"
},
"topics_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"sa_report",
"bots_report",
"topics_report",
"pins_report",
"blocked_reason",
"next_attempt_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"catalog": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"tariffs": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"catalog",
"tariffs"
],
"type": "object"
},
"site_operation": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"anyOf": [
{
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"generation": {
"const": 0,
"type": "number"
},
"next_attempt_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": "object"
},
{
"type": "null"
}
]
},
"tariff_offers": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"period_days": {
"exclusiveMinimum": 0,
"maximum": 365,
"type": "integer"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^(?:0|[1-9]\\d{0,7})\\.\\d{2}$",
"type": "string"
},
"currency": {
"const": "RUB",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"plan",
"title",
"description",
"price",
"period_days"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
}
},
"required": [
"site_operation",
"language",
"completedSteps",
"discovery",
"infrastructure"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Resume Infrastructure"
}retry_onboarding_site
Retry a failed automatic first-site operation using its saved work. Read get_onboarding_state for phases and the final two-zone bio result; no description is required.
{
"description": "Retry a failed automatic first-site operation using its saved work. Read get_onboarding_state for phases and the final two-zone bio result; no description is required.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"bot": {
"description": "Optional slug of the bot you expect to act on (get_active_bot). If the active bot differs, the call is refused with ACTIVE_BOT_CHANGED and nothing runs.",
"maxLength": 128,
"minLength": 1,
"type": "string"
}
},
"type": "object"
},
"name": "retry_onboarding_site",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"assistant_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"completedSteps": {
"items": {
"type": "string"
},
"type": "array"
},
"discovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"candidates": {
"items": {
"additionalProperties": false,
"properties": {
"issues": {
"items": {
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS"
],
"type": "string"
},
"type": "array"
},
"ordinal": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"title": {
"type": "string"
}
},
"required": [
"ordinal",
"title",
"issues"
],
"type": "object"
},
"type": "array"
},
"fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
}
},
"required": [
"fingerprint",
"candidates"
],
"type": "object"
},
{
"type": "null"
}
]
},
"entry_context": {
"additionalProperties": false,
"properties": {
"action": {
"enum": [
"continue",
"choose_business",
"work_or_create",
"create_business"
],
"type": "string"
},
"active_business": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"role": {
"enum": [
"owner",
"operator"
],
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role"
],
"type": "object"
},
{
"type": "null"
}
]
},
"intent": {
"enum": [
"auto",
"new_business"
],
"type": "string"
},
"owned_businesses": {
"items": {
"additionalProperties": false,
"properties": {
"onboarding_complete": {
"type": "boolean"
},
"role": {
"const": "owner",
"type": "string"
},
"slug": {
"type": "string"
}
},
"required": [
"slug",
"role",
"onboarding_complete"
],
"type": "object"
},
"type": "array"
},
"recommended_business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"intent",
"active_business",
"owned_businesses",
"recommended_business_slug",
"action"
],
"type": "object"
},
"infrastructure": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"blocked_reason": {
"anyOf": [
{
"enum": [
"SG_NOT_FORUM",
"SA_NOT_MEMBER",
"SA_NOT_ADMIN",
"SA_RIGHTS_MISSING",
"SA_ANONYMOUS",
"SG_BOT_CAP_REACHED",
"CLIENT_BOT_RIGHTS_MISSING",
"terminal_capability"
],
"type": "string"
},
{
"type": "null"
}
]
},
"bots_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"observed_cap": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"cap_reached": {
"type": "boolean"
},
"client_bot": {
"enum": [
"admin_ok",
"missing",
"rights_missing"
],
"type": "string"
},
"pool_admin_ok": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"pool_missing": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"client_bot",
"pool_admin_ok",
"pool_missing",
"cap_reached"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"target": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
}
},
"required": [
"target",
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"next_attempt_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"pins_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"pinned": {
"type": "boolean"
},
"skipped_reason": {
"type": "string"
}
},
"required": [
"pinned"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"sa_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"admin": {
"type": "boolean"
},
"anonymous": {
"type": "boolean"
},
"member": {
"type": "boolean"
},
"rights_ok": {
"type": "boolean"
}
},
"required": [
"member",
"admin",
"rights_ok",
"anonymous"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
},
"titles_done": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"type": "boolean"
},
"OPERATIONS": {
"type": "boolean"
},
"SETTINGS": {
"type": "boolean"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"titles_done",
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
},
"status": {
"enum": [
"AWAITING_OWNER",
"QUEUED",
"RUNNING",
"BLOCKED",
"COMPLETE",
"FAILED"
],
"type": "string"
},
"topics_report": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"per_sg": {
"additionalProperties": false,
"properties": {
"OPEN_LINES": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"OPERATIONS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
},
"SETTINGS": {
"additionalProperties": false,
"properties": {
"adopted_by_alias": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"adopted_by_registry": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"created": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"expected": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"missing": {
"items": {
"type": "string"
},
"type": "array"
}
},
"required": [
"expected",
"created",
"adopted_by_registry",
"adopted_by_alias",
"missing"
],
"type": "object"
}
},
"required": [
"SETTINGS",
"OPERATIONS",
"OPEN_LINES"
],
"type": "object"
}
},
"required": [
"per_sg"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"status",
"sa_report",
"bots_report",
"topics_report",
"pins_report",
"blocked_reason",
"next_attempt_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"language": {
"enum": [
"ru",
"en"
],
"type": "string"
},
"links": {
"additionalProperties": false,
"properties": {
"catalog": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
},
"tariffs": {
"anyOf": [
{
"format": "uri",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"catalog",
"tariffs"
],
"type": "object"
},
"site_operation": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"completed_phases": {
"items": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing"
],
"type": "string"
},
"maxItems": 5,
"type": "array"
},
"error_code": {
"anyOf": [
{
"enum": [
"BIO_NOT_PUBLISHABLE",
"LEGACY_BIO_RESULT_MISSING",
"RECONCILIATION_CONFLICT",
"ARTIFACT_MISSING",
"ARTIFACT_INVALID",
"PROFILE_UNAVAILABLE",
"PUBLICATION_FAILED",
"LEASE_EXPIRED",
"VERIFICATION_FAILED"
],
"type": "string"
},
{
"type": "null"
}
]
},
"generation": {
"const": 0,
"type": "number"
},
"next_attempt_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"phase": {
"enum": [
"sections",
"profile",
"page",
"publishing",
"finalizing",
"ready"
],
"type": "string"
},
"published_zones": {
"items": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"maxItems": 2,
"type": "array"
},
"result": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"bio_url": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"bio_urls": {
"additionalProperties": false,
"properties": {
"com": {
"format": "uri",
"maxLength": 512,
"type": "string"
},
"ru": {
"format": "uri",
"maxLength": 512,
"type": "string"
}
},
"required": [
"ru",
"com"
],
"type": "object"
},
"title": {
"maxLength": 160,
"minLength": 1,
"type": "string"
}
},
"required": [
"bio_url",
"bio_urls",
"title"
],
"type": "object"
},
{
"type": "null"
}
]
},
"retry_allowed": {
"type": "boolean"
},
"status": {
"enum": [
"queued",
"running",
"failed",
"completed"
],
"type": "string"
}
},
"required": [
"generation",
"status",
"phase",
"completed_phases",
"published_zones",
"retry_allowed",
"error_code",
"next_attempt_at",
"result"
],
"type": "object"
},
{
"type": "null"
}
]
},
"tariff_offers": {
"items": {
"additionalProperties": false,
"properties": {
"description": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"period_days": {
"exclusiveMinimum": 0,
"maximum": 365,
"type": "integer"
},
"plan": {
"enum": [
"starter",
"ai_manager",
"ai_coach"
],
"type": "string"
},
"price": {
"additionalProperties": false,
"properties": {
"amount": {
"pattern": "^(?:0|[1-9]\\d{0,7})\\.\\d{2}$",
"type": "string"
},
"currency": {
"const": "RUB",
"type": "string"
}
},
"required": [
"amount",
"currency"
],
"type": "object"
},
"title": {
"minLength": 1,
"type": "string"
}
},
"required": [
"plan",
"title",
"description",
"price",
"period_days"
],
"type": "object"
},
"maxItems": 3,
"type": "array"
}
},
"required": [
"site_operation",
"language",
"completedSteps",
"discovery",
"infrastructure"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Retry Onboarding Site"
}set_tax_profile
Set the business tax profile for payment setup. Returns onboarding progress and the next action.
{
"description": "Set the business tax profile for payment setup. Returns onboarding progress and the next action.",
"domain": "onboarding",
"inputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"oneOf": [
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"business_type": {
"const": "ip",
"description": "Value for business type.",
"type": "string"
},
"jurisdiction": {
"const": "ru",
"description": "Value for jurisdiction.",
"type": "string"
},
"taxation_system": {
"description": "Value for taxation system.",
"enum": [
"osn",
"usn_income",
"usn_income_outcome",
"esn",
"patent"
],
"type": "string"
}
},
"required": [
"jurisdiction",
"business_type",
"taxation_system"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"business_type": {
"const": "ooo",
"description": "Value for business type.",
"type": "string"
},
"jurisdiction": {
"const": "ru",
"description": "Value for jurisdiction.",
"type": "string"
},
"taxation_system": {
"description": "Value for taxation system.",
"enum": [
"osn",
"usn_income",
"usn_income_outcome",
"esn",
"patent"
],
"type": "string"
}
},
"required": [
"jurisdiction",
"business_type",
"taxation_system"
],
"type": "object"
},
{
"additionalProperties": false,
"description": "Value for input option.",
"properties": {
"business_type": {
"const": "self_employed",
"description": "Value for business type.",
"type": "string"
},
"jurisdiction": {
"const": "ru",
"description": "Value for jurisdiction.",
"type": "string"
}
},
"required": [
"jurisdiction",
"business_type"
],
"type": "object"
}
]
},
"name": "set_tax_profile",
"outputSchema": {
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false,
"properties": {
"active_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"billing": {
"additionalProperties": false,
"properties": {
"auto_renew": {
"type": "boolean"
},
"grace_until": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"next_charge_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"period_end": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"plan": {
"type": "string"
},
"status": {
"enum": [
"free",
"trial",
"active",
"grace",
"expired",
"cancelled"
],
"type": "string"
},
"trial_ends_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"trial_started_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"plan",
"period_end",
"auto_renew",
"next_charge_at"
],
"type": "object"
},
"body": {
"additionalProperties": false,
"properties": {
"business_type": {
"enum": [
"ip",
"ooo",
"self_employed"
],
"type": "string"
},
"taxation_system": {
"anyOf": [
{
"enum": [
"osn",
"usn_income",
"usn_income_outcome",
"esn",
"patent"
],
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"business_type",
"taxation_system"
],
"type": "object"
},
"journey": {
"additionalProperties": false,
"properties": {
"ai_preferences": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"app": {
"enum": [
"claude",
"chatgpt",
"codex",
"claude-code",
"other"
],
"type": "string"
},
"confirmed_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"device": {
"enum": [
"desktop",
"web",
"phone"
],
"type": "string"
},
"other_app": {
"maxLength": 80,
"minLength": 1,
"type": "string"
},
"questions_revision": {
"const": 1,
"type": "number"
},
"subscription": {
"enum": [
"paid",
"free"
],
"type": "string"
}
},
"required": [
"device",
"app",
"subscription",
"questions_revision",
"confirmed_at"
],
"type": "object"
},
{
"type": "null"
}
]
},
"bonus_state": {
"enum": [
"not_eligible",
"pending",
"settled"
],
"type": "string"
},
"completed": {
"type": "boolean"
},
"completed_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"decisions": {
"additionalProperties": false,
"properties": {
"first_payment_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
},
"tariff_deferred_at": {
"anyOf": [
{
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"first_payment_deferred_at",
"tariff_deferred_at"
],
"type": "object"
},
"first_payment": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"amount": {
"maxLength": 32,
"pattern": "^\\d+(?:\\.\\d{1,8})?$",
"type": "string"
},
"currency": {
"maxLength": 16,
"minLength": 1,
"type": "string"
},
"is_active": {
"const": true,
"type": "boolean"
},
"payload_hash": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"phase": {
"enum": [
"accepted",
"price_committed",
"card_pending",
"sent"
],
"type": "string"
},
"preparation_id": {
"maxLength": 128,
"minLength": 1,
"type": "string"
},
"product_seq_num": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"purchase_zone": {
"enum": [
"ru",
"com"
],
"type": "string"
},
"title": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"phase",
"product_seq_num",
"title",
"provider",
"amount",
"currency",
"purchase_zone",
"is_active",
"preparation_id",
"payload_hash"
],
"type": "object"
},
{
"type": "null"
}
]
},
"infrastructure_ready": {
"type": "boolean"
},
"provider_readiness": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"authentication": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"checked_at": {
"format": "date-time",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$",
"type": "string"
},
"checkout_creation": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"configuration_confirmation_token": {
"anyOf": [
{
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
{
"type": "null"
}
]
},
"configuration_fingerprint": {
"pattern": "^[a-f0-9]{64}$",
"type": "string"
},
"limitations": {
"items": {
"type": "string"
},
"type": "array"
},
"live_payment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"next_action": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"production_environment": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"provider": {
"enum": [
"robokassa",
"yookassa",
"stars",
"cryptobot",
"stripe",
"paypal",
"paddle",
"tinkoff",
"prodamus"
],
"type": "string"
},
"ready": {
"type": "boolean"
},
"webhook_configuration": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
},
"webhook_configuration_assurance": {
"anyOf": [
{
"enum": [
"provider_api",
"signed_delivery",
"owner_attested"
],
"type": "string"
},
{
"type": "null"
}
]
},
"webhook_delivery": {
"enum": [
"verified",
"failed",
"unknown"
],
"type": "string"
}
},
"required": [
"provider",
"configuration_fingerprint",
"checked_at",
"ready",
"authentication",
"production_environment",
"checkout_creation",
"webhook_configuration",
"webhook_delivery",
"live_payment",
"limitations",
"next_action"
],
"type": "object"
},
{
"type": "null"
}
]
},
"revision": {
"const": 1,
"type": "number"
},
"rewards": {
"additionalProperties": false,
"properties": {
"tokens_granted": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"tokens_remaining": {
"maximum": 9007199254740991,
"minimum": 0,
"type": "integer"
},
"trial_days": {
"minimum": 0,
"type": "number"
}
},
"required": [
"tokens_granted",
"tokens_remaining",
"trial_days"
],
"type": "object"
},
"test_completed": {
"type": "boolean"
},
"test_required": {
"type": "boolean"
}
},
"required": [
"revision",
"completed",
"completed_at",
"infrastructure_ready",
"test_required",
"test_completed",
"bonus_state",
"ai_preferences",
"decisions",
"provider_readiness"
],
"type": "object"
},
"next_action": {
"additionalProperties": false,
"properties": {
"collect": {
"items": {
"additionalProperties": false,
"properties": {
"field": {
"type": "string"
},
"hint": {
"type": "string"
}
},
"required": [
"field",
"hint"
],
"type": "object"
},
"type": "array"
},
"execution": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"business_slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"continue_with": {
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"minLength": 1,
"type": "string"
},
"tool": {
"anyOf": [
{
"const": "get_onboarding_state",
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments"
],
"type": "object"
},
"executor": {
"enum": [
"agent",
"owner",
"server"
],
"type": "string"
},
"prepared_execute": {
"additionalProperties": false,
"properties": {
"arguments_fields": {
"prefixItems": [
{
"const": "preparation_id",
"type": "string"
},
{
"const": "payload_hash",
"type": "string"
}
],
"type": "array"
},
"requires_human_review": {
"const": true,
"type": "boolean"
},
"tool": {
"const": "onboarding_execute_first_payment",
"type": "string"
}
},
"required": [
"tool",
"requires_human_review",
"arguments_fields"
],
"type": "object"
},
"recovery": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"arguments": {
"additionalProperties": {},
"propertyNames": {
"type": "string"
},
"type": "object"
},
"say_to_user": {
"type": "string"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"tool",
"arguments",
"say_to_user"
],
"type": "object"
},
{
"type": "null"
}
]
},
"requires": {
"items": {
"type": "string"
},
"type": "array"
},
"step": {
"minLength": 1,
"type": "string"
},
"success": {
"additionalProperties": false,
"properties": {
"fact": {
"minLength": 1,
"type": "string"
}
},
"required": [
"fact"
],
"type": "object"
},
"tool": {
"anyOf": [
{
"minLength": 1,
"type": "string"
},
{
"type": "null"
}
]
},
"wait": {
"anyOf": [
{
"additionalProperties": false,
"properties": {
"retry_after_seconds": {
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"type": "integer"
},
"stop_when": {
"minLength": 1,
"type": "string"
}
},
"required": [
"retry_after_seconds",
"stop_when"
],
"type": "object"
},
{
"type": "null"
}
]
}
},
"required": [
"business_slug",
"step",
"executor",
"tool",
"arguments",
"requires",
"success",
"wait",
"recovery",
"continue_with"
],
"type": "object"
},
"goal": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_blocked",
"infrastructure_ready",
"quest_product_pending",
"quest_product_ready",
"quest_product_failed",
"payment_provider_alive",
"payment_provider_failed",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free",
"address_new_business",
"entry_choose_business",
"entry_work_or_create",
"infrastructure_ready_nth_bot"
],
"type": "string"
},
"media": {
"additionalProperties": false,
"properties": {
"kind": {
"enum": [
"video",
"image_steps"
],
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"kind",
"url"
],
"type": "object"
},
"say_to_user": {
"type": "string"
},
"switch_to": {
"type": "string"
},
"wait_for": {
"additionalProperties": false,
"properties": {
"event": {
"type": "string"
},
"retry_after_seconds": {
"minimum": 0,
"type": "number"
}
},
"required": [
"event"
],
"type": "object"
}
},
"required": [
"goal",
"say_to_user",
"collect"
],
"type": "object"
},
"owner_onboardings": {
"items": {
"additionalProperties": false,
"properties": {
"slug": {
"type": "string"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
}
},
"required": [
"slug",
"stage"
],
"type": "object"
},
"type": "array"
},
"stage": {
"enum": [
"address",
"site",
"bot",
"supergroups_create",
"supergroups_admin",
"supergroups_confirm",
"infrastructure",
"infrastructure_ready",
"quest_1",
"quest_2",
"warmup",
"quest_product",
"quest_purchase",
"payments",
"first_payment",
"ai_preferences",
"finish",
"completed",
"tariff",
"paid",
"free"
],
"type": "string"
},
"status": {
"enum": [
"todo",
"in_progress",
"waiting_owner",
"blocked",
"done"
],
"type": "string"
},
"tenant": {
"additionalProperties": false,
"properties": {
"bot_username": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"slug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"required": [
"slug",
"bot_username"
],
"type": "object"
}
},
"required": [
"active_slug",
"tenant",
"owner_onboardings",
"stage",
"status",
"next_action",
"body"
],
"type": "object"
},
"platform_version": "1.0.19",
"required_scopes": [
"onboarding:write"
],
"risk": "write",
"scope": "onboarding:write",
"title": "Set Tax Profile"
}