Включить или выключить сценарий
curl --request PATCH \
--url https://api.tungo.kz/v1/companies/{co}/automations/scenarios/{id} \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"enabled": true
}
'import requests
url = "https://api.tungo.kz/v1/companies/{co}/automations/scenarios/{id}"
payload = { "enabled": True }
headers = {
"cookie": "tungo.session_token=",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
body: JSON.stringify({enabled: true})
};
fetch('https://api.tungo.kz/v1/companies/{co}/automations/scenarios/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "scn_01jz8x3m4n5p6q7r8s9t0v1w2x",
"name": "Разнести поступления с сайта",
"enabled": true,
"trigger": {
"kind": "hook",
"hook_id": "hk_01jz8x3m4n5p6q7r8s9t0v1w2x",
"filter": {
"all": [
{
"path": "data.status",
"op": "eq",
"value": "paid"
}
]
}
},
"next_run_at": "2026-10-05T09:30:00.000Z",
"action": "agent",
"instruction": "<string>",
"output": {
"order_id": {
"type": "id",
"description": "Номер заказа из события"
},
"amount_tiyn": {
"type": "integer",
"description": "Сумма оплаты в тиынах"
},
"status": {
"type": "enum",
"values": [
"written",
"waiting"
],
"description": "written — поступление записано в 1С, waiting — ждёт человека"
}
},
"steps": [
{
"action": "agent",
"when": "always",
"instruction": "<string>",
"output": {
"order_id": {
"type": "id",
"description": "Номер заказа из события"
},
"amount_tiyn": {
"type": "integer",
"description": "Сумма оплаты в тиынах"
},
"status": {
"type": "enum",
"values": [
"written",
"waiting"
],
"description": "written — поступление записано в 1С, waiting — ждёт человека"
}
}
}
],
"auto_approve": {
"kinds": [
"bank_receipt",
"sale"
],
"max_amount_per_document_tiyn": 50000000,
"max_amount_per_day_tiyn": 200000000,
"directbank": true
},
"run_as": "usr_01h455vb4pex5vsknk084sn02q",
"created_at": "2026-10-05T09:30:00.000Z",
"updated_at": "2026-10-05T09:30:00.000Z"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}Автоматизации
Включить или выключить сценарий
Только enabled; run_as остаётся прежним. Включить сценарий с ИИ (action: agent или шаг agent) — только с chat.use (иначе 403 permission_error, permission chat.use); выключить может любой с automations.manage.
Доступ: automations.manage | company.manage.
Доступно по ключу API.
PATCH
/
v1
/
companies
/
{co}
/
automations
/
scenarios
/
{id}
Включить или выключить сценарий
curl --request PATCH \
--url https://api.tungo.kz/v1/companies/{co}/automations/scenarios/{id} \
--header 'Content-Type: application/json' \
--cookie tungo.session_token= \
--data '
{
"enabled": true
}
'import requests
url = "https://api.tungo.kz/v1/companies/{co}/automations/scenarios/{id}"
payload = { "enabled": True }
headers = {
"cookie": "tungo.session_token=",
"Content-Type": "application/json"
}
response = requests.patch(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'PATCH',
headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
body: JSON.stringify({enabled: true})
};
fetch('https://api.tungo.kz/v1/companies/{co}/automations/scenarios/{id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"id": "scn_01jz8x3m4n5p6q7r8s9t0v1w2x",
"name": "Разнести поступления с сайта",
"enabled": true,
"trigger": {
"kind": "hook",
"hook_id": "hk_01jz8x3m4n5p6q7r8s9t0v1w2x",
"filter": {
"all": [
{
"path": "data.status",
"op": "eq",
"value": "paid"
}
]
}
},
"next_run_at": "2026-10-05T09:30:00.000Z",
"action": "agent",
"instruction": "<string>",
"output": {
"order_id": {
"type": "id",
"description": "Номер заказа из события"
},
"amount_tiyn": {
"type": "integer",
"description": "Сумма оплаты в тиынах"
},
"status": {
"type": "enum",
"values": [
"written",
"waiting"
],
"description": "written — поступление записано в 1С, waiting — ждёт человека"
}
},
"steps": [
{
"action": "agent",
"when": "always",
"instruction": "<string>",
"output": {
"order_id": {
"type": "id",
"description": "Номер заказа из события"
},
"amount_tiyn": {
"type": "integer",
"description": "Сумма оплаты в тиынах"
},
"status": {
"type": "enum",
"values": [
"written",
"waiting"
],
"description": "written — поступление записано в 1С, waiting — ждёт человека"
}
}
}
],
"auto_approve": {
"kinds": [
"bank_receipt",
"sale"
],
"max_amount_per_document_tiyn": 50000000,
"max_amount_per_day_tiyn": 200000000,
"directbank": true
},
"run_as": "usr_01h455vb4pex5vsknk084sn02q",
"created_at": "2026-10-05T09:30:00.000Z",
"updated_at": "2026-10-05T09:30:00.000Z"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}{
"type": "error",
"error": {
"type": "payment_required_error",
"message": "Баланс доп. использования закончился — пополнить его или включить автопополнение могут владелец и админ workspace.",
"code": "balance_exhausted",
"permission": "proposals.approve",
"resets_at": "2026-11-01T19:00:00.000Z",
"allowed_methods": [
"email_otp"
],
"role": "<string>",
"permissions": [
"<string>"
],
"fields": [
{
"path": "bin",
"code": "invalid_format",
"message": "БИН/ИИН — 12 цифр"
}
]
},
"request_id": "req_4f9c2a7e1b3d4c5a8e6f7a9b0c1d2e3f"
}Авторизации
sessionapiKeybearerKey
Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.
Параметры пути
id компании, co_… — из GET /v1/companies
id сценария (scn_…)
Пример:
"scn_01jz8x3m4n5p6q7r8s9t0v1w2x"
Тело
application/json
Включить или выключить сценарий.
true — включить, false — выключить. Включить сценарий с автоодобрением может только тот, у кого есть proposals.approve.
Ответ
Сценарий
Сценарий автоматизации компании: триггер (когда) + действие (что).
id сценария — для адресов …/automations/scenarios/{id} (scn_…)
Пример:
"scn_01jz8x3m4n5p6q7r8s9t0v1w2x"
Название сценария
Пример:
"Разнести поступления с сайта"
Включён ли. Выключенный не запускается событием и расписанием; вручную — запускается
Когда запускается сценарий; вид — в kind (hook, schedule, event, manual).
- Option 1
- Option 2
- Option 3
- Option 4
Show child attributes
Show child attributes
Когда сценарий по расписанию сработает в следующий раз, ISO 8601 UTC. null — сценарий ручной, по событию (хука или Tungo) или выключен, а у расписания с last_workday — ещё и когда производственного календаря сейчас нет (запуск отложен до его появления). Пока компания на паузе, запуск в этот срок встанет в очередь и начнётся после снятия паузы
Пример:
"2026-10-05T09:30:00.000Z"
Старая форма: действие (у цепочки — первого шага, полностью — steps). agent — ход ИИ-бухгалтера по поручению instruction (готовит предложения — документы для 1С); checks — проверки учёта без ИИ и без предложений; directbank — опрос выписки DirectBank без ИИ (предложения — выпиской дня)
Доступные опции:
agent, checks, directbank Поручение ИИ обычными словами (первого шага); у checks, directbank и цепочки, начатой не с agent, — пустая строка
Форма итога шага ИИ (у сценария из одного шага); null — итог только текстом (answer) или сценарий — цепочка
Show child attributes
Show child attributes
Пример:
{
"order_id": {
"type": "id",
"description": "Номер заказа из события"
},
"amount_tiyn": {
"type": "integer",
"description": "Сумма оплаты в тиынах"
},
"status": {
"type": "enum",
"values": ["written", "waiting"],
"description": "written — поступление записано в 1С, waiting — ждёт человека"
}
}
Шаги сценария (1–5). У сценария старой формы — один шаг из action, instruction и output. Каждый шаг agent — отдельный платный ход ИИ.
Show child attributes
Show child attributes
Правило автоодобрения; null — всё подготовленное ждёт решения человека
Show child attributes
Show child attributes
От чьего имени идут запуски — кто сохранил сценарий последним (usr_…): с его правами, расход ИИ — как у него
Пример:
"usr_01h455vb4pex5vsknk084sn02q"
Когда заведён, ISO 8601 UTC
Пример:
"2026-10-05T09:30:00.000Z"
Когда менялся последний раз, ISO 8601 UTC
Пример:
"2026-10-05T09:30:00.000Z"