Завести сценарий

curl --request POST \
  --url https://api.tungo.kz/v1/companies/{co}/automations/scenarios \
  --header 'Content-Type: application/json' \
  --cookie tungo.session_token= \
  --data '
{
  "name": "Разнести поступления с сайта",
  "trigger": {
    "kind": "hook",
    "hook_id": "hk_01h455vb4pex5vsknk084sn02q"
  },
  "enabled": true,
  "instruction": "Разнеси оплату из события: найди покупателя по БИН и проведи поступление на расчётный счёт.",
  "output": {
    "order_id": {
      "type": "id",
      "description": "Номер заказа из события"
    },
    "amount_tiyn": {
      "type": "integer",
      "description": "Сумма оплаты в тиынах"
    },
    "status": {
      "type": "enum",
      "values": [
        "written",
        "waiting"
      ],
      "description": "written — поступление записано в 1С, waiting — ждёт человека"
    }
  },
  "steps": [
    {
      "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
  }
}
'

import requests

url = "https://api.tungo.kz/v1/companies/{co}/automations/scenarios"

payload = {
    "name": "Разнести поступления с сайта",
    "trigger": {
        "kind": "hook",
        "hook_id": "hk_01h455vb4pex5vsknk084sn02q"
    },
    "enabled": True,
    "instruction": "Разнеси оплату из события: найди покупателя по БИН и проведи поступление на расчётный счёт.",
    "output": {
        "order_id": {
            "type": "id",
            "description": "Номер заказа из события"
        },
        "amount_tiyn": {
            "type": "integer",
            "description": "Сумма оплаты в тиынах"
        },
        "status": {
            "type": "enum",
            "values": ["written", "waiting"],
            "description": "written — поступление записано в 1С, waiting — ждёт человека"
        }
    },
    "steps": [
        {
            "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
    }
}
headers = {
    "cookie": "tungo.session_token=",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Разнести поступления с сайта',
    trigger: {kind: 'hook', hook_id: 'hk_01h455vb4pex5vsknk084sn02q'},
    enabled: true,
    instruction: 'Разнеси оплату из события: найди покупателя по БИН и проведи поступление на расчётный счёт.',
    output: {
      order_id: {type: 'id', description: 'Номер заказа из события'},
      amount_tiyn: {type: 'integer', description: 'Сумма оплаты в тиынах'},
      status: {
        type: 'enum',
        values: ['written', 'waiting'],
        description: 'written — поступление записано в 1С, waiting — ждёт человека'
      }
    },
    steps: [
      {
        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
    }
  })
};

fetch('https://api.tungo.kz/v1/companies/{co}/automations/scenarios', 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",
  "warnings": [
    "<string>"
  ]
}

{
  "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"
}

{
  "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"
}

Автоматизации

Завести сценарий

Сценарий с ИИ (action: agent) сохраняет тот, у кого есть chat.use; правило автоодобрения — тот, у кого есть proposals.approve; ключ API с пределами записи — только не шире своих пределов (видов и потолков), иначе 403 с error.code = key_write_limit. Сохранённый ключом сценарий и при запуске пишет в 1С сам только в пределах этого ключа на тот момент; отозванный ключ — не запускается. Запуск идёт от имени сохранившего. Сколько сценариев у компании — предел настройки automations (scenarios_per_company), сверх — 429.

Idempotency-Key: повтор с тем же ключом и тем же телом отдаёт прежний ответ (статус и тело) с заголовком Idempotent-Replayed: true и ничего не делает второй раз; тот же ключ с другим адресом или телом — 422 (error.code = idempotency_key_reused); первый запрос с этим ключом ещё идёт — 409 (error.code = idempotency_in_progress). Запоминается только удачный ответ (2xx): после отказа повтор с тем же ключом выполнится заново. Ключ живёт сутки (настройка idempotency.keys), область — организация и тот, кто прислал (ключ API или человек).

Доступ: automations.manage | company.manage.

Доступно по ключу API.

POST

companies

{co}

automations

scenarios

Завести сценарий

curl --request POST \
  --url https://api.tungo.kz/v1/companies/{co}/automations/scenarios \
  --header 'Content-Type: application/json' \
  --cookie tungo.session_token= \
  --data '
{
  "name": "Разнести поступления с сайта",
  "trigger": {
    "kind": "hook",
    "hook_id": "hk_01h455vb4pex5vsknk084sn02q"
  },
  "enabled": true,
  "instruction": "Разнеси оплату из события: найди покупателя по БИН и проведи поступление на расчётный счёт.",
  "output": {
    "order_id": {
      "type": "id",
      "description": "Номер заказа из события"
    },
    "amount_tiyn": {
      "type": "integer",
      "description": "Сумма оплаты в тиынах"
    },
    "status": {
      "type": "enum",
      "values": [
        "written",
        "waiting"
      ],
      "description": "written — поступление записано в 1С, waiting — ждёт человека"
    }
  },
  "steps": [
    {
      "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
  }
}
'

import requests

url = "https://api.tungo.kz/v1/companies/{co}/automations/scenarios"

payload = {
    "name": "Разнести поступления с сайта",
    "trigger": {
        "kind": "hook",
        "hook_id": "hk_01h455vb4pex5vsknk084sn02q"
    },
    "enabled": True,
    "instruction": "Разнеси оплату из события: найди покупателя по БИН и проведи поступление на расчётный счёт.",
    "output": {
        "order_id": {
            "type": "id",
            "description": "Номер заказа из события"
        },
        "amount_tiyn": {
            "type": "integer",
            "description": "Сумма оплаты в тиынах"
        },
        "status": {
            "type": "enum",
            "values": ["written", "waiting"],
            "description": "written — поступление записано в 1С, waiting — ждёт человека"
        }
    },
    "steps": [
        {
            "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
    }
}
headers = {
    "cookie": "tungo.session_token=",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {cookie: 'tungo.session_token=', 'Content-Type': 'application/json'},
  body: JSON.stringify({
    name: 'Разнести поступления с сайта',
    trigger: {kind: 'hook', hook_id: 'hk_01h455vb4pex5vsknk084sn02q'},
    enabled: true,
    instruction: 'Разнеси оплату из события: найди покупателя по БИН и проведи поступление на расчётный счёт.',
    output: {
      order_id: {type: 'id', description: 'Номер заказа из события'},
      amount_tiyn: {type: 'integer', description: 'Сумма оплаты в тиынах'},
      status: {
        type: 'enum',
        values: ['written', 'waiting'],
        description: 'written — поступление записано в 1С, waiting — ждёт человека'
      }
    },
    steps: [
      {
        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
    }
  })
};

fetch('https://api.tungo.kz/v1/companies/{co}/automations/scenarios', 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",
  "warnings": [
    "<string>"
  ]
}

{
  "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"
}

{
  "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"
}

Авторизации

tungo.session_token

string

обязательно

Сессия кабинета: cookie ставит вход через /v1/auth/* (Better Auth), браузер шлёт её сам — фронтенду кабинета ничего добавлять не нужно (fetch с credentials: 'include'). За HTTPS имя cookie — __Secure-tungo.session_token. Сессия кончилась — 401 authentication_error: отправить на вход.

Заголовки

Idempotency-Key

string

Ключ повтора (например, UUID): повтор с тем же ключом и тем же телом не выполняет действие второй раз, а отдаёт прежний ответ

Maximum string length: 255

Параметры пути

string

обязательно

id компании, co_… — из GET /v1/companies

Тело

application/json

Сценарий целиком — при заведении и замене.

name

string

обязательно

Название сценария (1–200 знаков).

Required string length: 1 - 200

Пример:

"Разнести поступления с сайта"

trigger

object

обязательно

Когда запускать: по событию хука, по расписанию, по событию внутри Tungo или только вручную. Вид — в kind.

Option 1
Option 2
Option 3
Option 4

Show child attributes

enabled

boolean

по умолчанию:true

Включён ли (по умолчанию true). Выключенный не запускается ни событием, ни по расписанию; вручную (…/run) — запускается.

action

enum<string>

Старая форма — один шаг (вместо него можно steps). Что делать при запуске. agent (по умолчанию) — ход ИИ-бухгалтера по поручению instruction: ИИ разбирает событие и данные 1С и готовит предложения — документы для записи в 1С; расход ИИ оплачивается как обычный. checks — проверки учёта компании (без ИИ и без предложений; находки — в ленте). directbank — опрос выписки DirectBank из живой 1С (без ИИ, нужно право proposals.create): предложения ложатся выпиской дня. Сам Tungo выписку не опрашивает — только этим сценарием или POST …/statements/directbank.

Доступные опции:

agent,

checks,

directbank

instruction

string

Старая форма — поручение единственного шага. Поручение ИИ обычными словами. Для action: agent обязательно (длина — не больше настройки платформы instruction_max_chars); для checks и directbank не нужно.

Maximum string length: 100000

Пример:

"Разнеси оплату из события: найди покупателя по БИН и проведи поступление на расчётный счёт."

output

object | null

Старая форма — итог единственного шага. Форма итога — только для action: agent. ИИ в конце хода отдаёт итог в этой форме, он приходит в запуске (output) и в вебхуке automation.run.completed — например, чтобы CRM закрыла заказ. null или нет — итог только текстом (answer).

Show child attributes

Пример:

{
  "order_id": {
    "type": "id",
    "description": "Номер заказа из события"
  },
  "amount_tiyn": {
    "type": "integer",
    "description": "Сумма оплаты в тиынах"
  },
  "status": {
    "type": "enum",
    "values": ["written", "waiting"],
    "description": "written — поступление записано в 1С, waiting — ждёт человека"
  }
}

steps

object[]

Цепочка шагов (1–5) вместо action, instruction и output — передайте что-то одно. Пример «каждое утро»: [{"action":"directbank"},{"action":"agent","instruction":"Разнеси выписку","when":"previous_created_proposals"},{"action":"checks"},{"action":"notify","when":"checks_found_issues"}]. Каждый шаг agent — отдельный платный ход ИИ: запуск стоит до 5 ходов. Правило автоодобрения применяется после каждого шага agent.

Required array length: 1 - 5 elements

Show child attributes

auto_approve

object | null

Правило автоодобрения — только у сценария с шагом agent (action: agent или шаг agent в steps); сохраняет только тот, у кого есть proposals.approve. null или нет — всё подготовленное ждёт решения человека.

Show child attributes

Ответ

Сценарий заведён

Сохранённый сценарий и предупреждения о правиле автоодобрения.

string

обязательно

id сценария — для адресов …/automations/scenarios/{id} (scn_…)

Пример:

"scn_01jz8x3m4n5p6q7r8s9t0v1w2x"

name

string

обязательно

Название сценария

Пример:

"Разнести поступления с сайта"

enabled

boolean

обязательно

Включён ли. Выключенный не запускается событием и расписанием; вручную — запускается

trigger

object

обязательно

Когда запускается сценарий; вид — в kind (hook, schedule, event, manual).

Option 1
Option 2
Option 3
Option 4

Show child attributes

next_run_at

string<date-time> | null

обязательно

Когда сценарий по расписанию сработает в следующий раз, ISO 8601 UTC. null — сценарий ручной, по событию (хука или Tungo) или выключен, а у расписания с last_workday — ещё и когда производственного календаря сейчас нет (запуск отложен до его появления). Пока компания на паузе, запуск в этот срок встанет в очередь и начнётся после снятия паузы

Пример:

"2026-10-05T09:30:00.000Z"

action

enum<string>

обязательно

Старая форма: действие (у цепочки — первого шага, полностью — steps). agent — ход ИИ-бухгалтера по поручению instruction (готовит предложения — документы для 1С); checks — проверки учёта без ИИ и без предложений; directbank — опрос выписки DirectBank без ИИ (предложения — выпиской дня)

Доступные опции:

agent,

checks,

directbank

instruction

string

обязательно

Поручение ИИ обычными словами (первого шага); у checks, directbank и цепочки, начатой не с agent, — пустая строка

output

object | null

обязательно

Форма итога шага ИИ (у сценария из одного шага); null — итог только текстом (answer) или сценарий — цепочка

Show child attributes

Пример:

{
  "order_id": {
    "type": "id",
    "description": "Номер заказа из события"
  },
  "amount_tiyn": {
    "type": "integer",
    "description": "Сумма оплаты в тиынах"
  },
  "status": {
    "type": "enum",
    "values": ["written", "waiting"],
    "description": "written — поступление записано в 1С, waiting — ждёт человека"
  }
}

steps

object[]

обязательно

Шаги сценария (1–5). У сценария старой формы — один шаг из action, instruction и output. Каждый шаг agent — отдельный платный ход ИИ.

Show child attributes

auto_approve

object | null

обязательно

Правило автоодобрения; null — всё подготовленное ждёт решения человека

Show child attributes

run_as

string

обязательно

От чьего имени идут запуски — кто сохранил сценарий последним (usr_…): с его правами, расход ИИ — как у него

Пример:

"usr_01h455vb4pex5vsknk084sn02q"

created_at

string<date-time>

обязательно

Когда заведён, ISO 8601 UTC

Пример:

"2026-10-05T09:30:00.000Z"

updated_at

string<date-time>

обязательно

Когда менялся последний раз, ISO 8601 UTC

Пример:

"2026-10-05T09:30:00.000Z"

warnings

string[]

Есть, только когда правило автоодобрения сейчас запишет само не всё (или ничего): организация пока не доверила ИИ записывать эти виды без человека. Тексты для человека — показать рядом с формой. Нет поля — правило работает как задано (или правила нет)