tungo-sdk 0.2.0

data/lib/tungo/resources/automations.rb

@@ -0,0 +1,681 @@
+# frozen_string_literal: true
+
+# Code generated by tungo-sdkgen from the Tungo Platform API contract. DO NOT EDIT.
+
+module Tungo
+  module Resources
+    # Автоматизации компании: входящие хуки, сценарии, цепочки шагов, запуски и уровень автономности ИИ
+    class Automations
+      # @api private
+      def initialize(client)
+        @client = client
+        freeze
+      end
+
+      # Принять событие по адресу хука
+      #
+      # +POST /hooks/{token}+
+      #
+      # @param token [String] Токен хука (th_…) из адреса, выданного при заведении или rotate
+      # @param payload [String, Hash, Array, Tungo::Model, nil] the body: a String is sent byte for byte,
+      #   anything else is sent as JSON
+      # @param event_id [String] То же, что Idempotency-Key, если отправитель шлёт такой заголовок
+      # @param signature [String] Подпись тела, если у хука есть секрет: HMAC-SHA256(секрет, сырое тело) в
+      #   hex, можно с приставкой sha256= (имя заголовка — signature_header хука)
+      # @param secret [String, nil] the hook's signing secret: the exact bytes sent are signed in the
+      #   X-Signature header
+      # @param content_type [String] defaults to application/octet-stream for a String and application/json
+      #   otherwise
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationHookAccepted]
+      def post_hook(
+        token,
+        payload = nil,
+        event_id: OMIT,
+        signature: OMIT,
+        secret: nil,
+        content_type: OMIT,
+        request_options: nil
+      )
+        @client.request(
+          method: :post,
+          path: "/hooks/{token}",
+          path_params: { token: token },
+          raw_body: payload,
+          content_type: content_type,
+          signature_header: "X-Signature",
+          secret: secret,
+          headers: { "X-Event-Id" => event_id, "X-Signature" => signature },
+          auth: :none,
+          idempotency_header: "Idempotency-Key",
+          idempotency_default: event_id,
+          model: :AutomationHookAccepted,
+          options: request_options
+        )
+      end
+
+      # Хуки компании
+      #
+      # +GET /v1/companies/{co}/automations/hooks+
+      #
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::ListCompanyAutomationsHooksResponse]
+      def list_hooks(company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/automations/hooks",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          model: :ListCompanyAutomationsHooksResponse,
+          options: request_options
+        )
+      end
+
+      # Завести хук
+      #
+      # +POST /v1/companies/{co}/automations/hooks+
+      #
+      # @param name [String] Название хука для людей (1–200 знаков): откуда приходят события.
+      # @param id_path [String, nil] Путь через точку к id события в JSON тела — номер платежа или чека у
+      #   отправителя. Задан и поле есть — повтор с тем же id считается тем же событием, даже с новым
+      #   Idempotency-Key. null или нет — id берётся из заголовка Ide…
+      # @param signature_header [String] Имя заголовка с подписью: латиница, цифры, дефис, до 64 знаков;
+      #   приводится к нижнему регистру. Не передан при заведении — `x-signature`.
+      # @param signature_secret [String, nil] Секрет подписи (16–500 знаков), общий с отправителем. Задан —
+      #   каждое событие обязано нести в заголовке signature_header HMAC-SHA256(секрет, сырое тело) в hex
+      #   (можно с приставкой `sha256=`), иначе приём отвечает 401. Хран…
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationHookWithToken]
+      def create_hook(
+        name:,
+        id_path: OMIT,
+        signature_header: OMIT,
+        signature_secret: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.request(
+          method: :post,
+          path: "/v1/companies/{co}/automations/hooks",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          body: {
+            "name" => name,
+            "id_path" => id_path,
+            "signature_header" => signature_header,
+            "signature_secret" => signature_secret
+          },
+          idempotency_header: "Idempotency-Key",
+          model: :AutomationHookWithToken,
+          options: request_options
+        )
+      end
+
+      # Хук
+      #
+      # +GET /v1/companies/{co}/automations/hooks/{id}+
+      #
+      # @param id [String] id хука (hk_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationHook]
+      def get_hook(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/automations/hooks/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          model: :AutomationHook,
+          options: request_options
+        )
+      end
+
+      # Изменить хук
+      #
+      # +PATCH /v1/companies/{co}/automations/hooks/{id}+
+      #
+      # @param id [String] id хука (hk_…)
+      # @param enabled [Boolean] false — выключить: события на адрес хука получают 404, как на неизвестный.
+      #   Включить хук, питающий сценарий с автоодобрением, может только тот, у кого есть proposals.approve.
+      # @param id_path [String, nil] Путь через точку к id события в JSON тела — номер платежа или чека у
+      #   отправителя. Задан и поле есть — повтор с тем же id считается тем же событием, даже с новым
+      #   Idempotency-Key. null или нет — id берётся из заголовка Ide…
+      # @param name [String] Название хука для людей (1–200 знаков): откуда приходят события.
+      # @param signature_header [String] Имя заголовка с подписью: латиница, цифры, дефис, до 64 знаков;
+      #   приводится к нижнему регистру. Не передан при заведении — `x-signature`.
+      # @param signature_secret [String, nil] Секрет подписи (16–500 знаков), общий с отправителем. Задан —
+      #   каждое событие обязано нести в заголовке signature_header HMAC-SHA256(секрет, сырое тело) в hex
+      #   (можно с приставкой `sha256=`), иначе приём отвечает 401. Хран…
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationHook]
+      def update_hook(
+        id,
+        enabled: OMIT,
+        id_path: OMIT,
+        name: OMIT,
+        signature_header: OMIT,
+        signature_secret: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.request(
+          method: :patch,
+          path: "/v1/companies/{co}/automations/hooks/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          body: {
+            "enabled" => enabled,
+            "id_path" => id_path,
+            "name" => name,
+            "signature_header" => signature_header,
+            "signature_secret" => signature_secret
+          },
+          model: :AutomationHook,
+          options: request_options
+        )
+      end
+
+      # Удалить хук
+      #
+      # +DELETE /v1/companies/{co}/automations/hooks/{id}+
+      #
+      # @param id [String] id хука (hk_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationDeleted]
+      def delete_hook(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :delete,
+          path: "/v1/companies/{co}/automations/hooks/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          model: :AutomationDeleted,
+          options: request_options
+        )
+      end
+
+      # Новый токен хука
+      #
+      # +POST /v1/companies/{co}/automations/hooks/{id}/rotate+
+      #
+      # @param id [String] id хука (hk_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationHookWithToken]
+      def rotate_hook(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :post,
+          path: "/v1/companies/{co}/automations/hooks/{id}/rotate",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          idempotency_header: "Idempotency-Key",
+          model: :AutomationHookWithToken,
+          options: request_options
+        )
+      end
+
+      # Пробное событие хука
+      #
+      # +POST /v1/companies/{co}/automations/hooks/{id}/test+
+      #
+      # @param id [String] id хука (hk_…)
+      # @param body [Object] Тело события, как его пришлёт отправитель: любое значение JSON (объект, массив,
+      #   число…) — оно берётся как JSON-текст; строка — как сырой текст тела (так можно проверить и тело
+      #   не-JSON). Не больше hook_body_max_bytes.
+      # @param body_content_type [String] Content-Type, с которым пришло бы событие (по умолчанию
+      #   application/json) — сохраняется у пробного события и виден ИИ.
+      # @param run [Boolean] true — сохранить событие как пробное и поставить пробные запуски подошедшим
+      #   включённым сценариям (ИИ вызывается и стоит как обычно; в 1С само ничего не пишется). Нет или false
+      #   — только разбор: ничего не сохраняется, ИИ н…
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationHookTestResult]
+      def test_hook(id, body:, body_content_type: OMIT, run: OMIT, company_id: nil, request_options: nil)
+        @client.request(
+          method: :post,
+          path: "/v1/companies/{co}/automations/hooks/{id}/test",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          body: { "body" => body, "content_type" => body_content_type, "run" => run },
+          model: :AutomationHookTestResult,
+          options: request_options
+        )
+      end
+
+      # Журнал запусков
+      #
+      # +GET /v1/companies/{co}/automations/runs+
+      #
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param event_id [String] Только запуски этого события хука (hev_… из ответа на приём)
+      # @param external_id [String] Только запуски по событию с этим id у отправителя (поле по id_path хука,
+      #   Idempotency-Key или X-Event-Id) — найти запуск по своему заказу или платежу
+      # @param limit [Integer, nil] Сколько запусков на странице: 1–100, по умолчанию 20
+      # @param scenario [String] Только запуски этого сценария (scn_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Page<Tungo::Models::AutomationRun>]
+      def list_runs(
+        cursor: OMIT,
+        event_id: OMIT,
+        external_id: OMIT,
+        limit: OMIT,
+        scenario: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.page(
+          method: :get,
+          path: "/v1/companies/{co}/automations/runs",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          query: {
+            "cursor" => cursor,
+            "event_id" => event_id,
+            "external_id" => external_id,
+            "limit" => limit,
+            "scenario" => scenario
+          },
+          model: :ListCompanyAutomationsRunsResponse,
+          options: request_options
+        )
+      end
+
+      # Журнал запусков. Iterates over every item of every page, fetching pages lazily.
+      #
+      # +GET /v1/companies/{co}/automations/runs+
+      #
+      # @param cursor [String] next_cursor из ответа прошлой страницы; без него — первая (самая свежая)
+      #   страница. Остальные фильтры — те же, что у первой страницы.
+      # @param event_id [String] Только запуски этого события хука (hev_… из ответа на приём)
+      # @param external_id [String] Только запуски по событию с этим id у отправителя (поле по id_path хука,
+      #   Idempotency-Key или X-Event-Id) — найти запуск по своему заказу или платежу
+      # @param limit [Integer, nil] Сколько запусков на странице: 1–100, по умолчанию 20
+      # @param scenario [String] Только запуски этого сценария (scn_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Enumerator<Tungo::Models::AutomationRun>]
+      def list_runs_all(
+        cursor: OMIT,
+        event_id: OMIT,
+        external_id: OMIT,
+        limit: OMIT,
+        scenario: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        Tungo::Page.auto_paging do
+          list_runs(
+            cursor: cursor,
+            event_id: event_id,
+            external_id: external_id,
+            limit: limit,
+            scenario: scenario,
+            company_id: company_id,
+            request_options: request_options
+          )
+        end
+      end
+
+      # Запуск
+      #
+      # +GET /v1/companies/{co}/automations/runs/{id}+
+      #
+      # @param id [String] id запуска (run_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationRunDetail]
+      def get_run(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/automations/runs/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          model: :AutomationRunDetail,
+          options: request_options
+        )
+      end
+
+      # Отменить запуск
+      #
+      # +POST /v1/companies/{co}/automations/runs/{id}/cancel+
+      #
+      # @param id [String] id запуска (run_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationRun]
+      def cancel_run(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :post,
+          path: "/v1/companies/{co}/automations/runs/{id}/cancel",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          model: :AutomationRun,
+          options: request_options
+        )
+      end
+
+      # Повторить упавший запуск
+      #
+      # +POST /v1/companies/{co}/automations/runs/{id}/retry+
+      #
+      # @param id [String] id запуска (run_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationRun]
+      def retry_run(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :post,
+          path: "/v1/companies/{co}/automations/runs/{id}/retry",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          model: :AutomationRun,
+          options: request_options
+        )
+      end
+
+      # Сценарии компании
+      #
+      # +GET /v1/companies/{co}/automations/scenarios+
+      #
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::ListCompanyAutomationsScenariosResponse]
+      def list_scenarios(company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/automations/scenarios",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          model: :ListCompanyAutomationsScenariosResponse,
+          options: request_options
+        )
+      end
+
+      # Завести сценарий
+      #
+      # +POST /v1/companies/{co}/automations/scenarios+
+      #
+      # @param name [String] Название сценария (1–200 знаков).
+      # @param trigger [Object] Когда запускать: по событию хука, по расписанию, по событию внутри Tungo или
+      #   только вручную. Вид — в kind.
+      # @param action [String] Старая форма — один шаг (вместо него можно steps). Что делать при запуске.
+      #   `agent` (по умолчанию) — ход ИИ-бухгалтера по поручению instruction: ИИ разбирает событие и данные
+      #   1С и готовит предложения — документы для запис…
+      # @param auto_approve [Tungo::Models::AutomationScenarioInputAutoApprove, nil] Правило автоодобрения —
+      #   только у сценария с шагом agent (action: agent или шаг agent в steps); сохраняет только тот, у кого
+      #   есть proposals.approve. null или нет — всё подготовленное ждёт решения человека.
+      # @param enabled [Boolean] Включён ли (по умолчанию true). Выключенный не запускается ни событием, ни
+      #   по расписанию; вручную (…/run) — запускается.
+      # @param instruction [String] Старая форма — поручение единственного шага. Поручение ИИ обычными
+      #   словами. Для action: agent обязательно (длина — не больше настройки платформы
+      #   instruction_max_chars); для checks и directbank не нужно.
+      # @param output [Hash{String=>Object}, nil] Старая форма — итог единственного шага. Форма итога —
+      #   только для action: agent. ИИ в конце хода отдаёт итог в этой форме, он приходит в запуске (output) и
+      #   в вебхуке automation.run.completed — например, чтобы CRM закрыла …
+      # @param steps [Array<Tungo::Models::AutomationStep>] Цепочка шагов (1–5) вместо action, instruction и
+      #   output — передайте что-то одно. Пример «каждое утро»:
+      #   `[{"action":"directbank"},{"action":"agent","instruction":"Разнеси
+      #   выписку","when":"previous_created_proposals"},{"ac…
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationScenarioSaved]
+      def create_scenario(
+        name:,
+        trigger:,
+        action: OMIT,
+        auto_approve: OMIT,
+        enabled: OMIT,
+        instruction: OMIT,
+        output: OMIT,
+        steps: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.request(
+          method: :post,
+          path: "/v1/companies/{co}/automations/scenarios",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          body: {
+            "name" => name,
+            "trigger" => trigger,
+            "action" => action,
+            "auto_approve" => auto_approve,
+            "enabled" => enabled,
+            "instruction" => instruction,
+            "output" => output,
+            "steps" => steps
+          },
+          idempotency_header: "Idempotency-Key",
+          model: :AutomationScenarioSaved,
+          options: request_options
+        )
+      end
+
+      # Сценарий
+      #
+      # +GET /v1/companies/{co}/automations/scenarios/{id}+
+      #
+      # @param id [String] id сценария (scn_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationScenario]
+      def get_scenario(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/automations/scenarios/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          model: :AutomationScenario,
+          options: request_options
+        )
+      end
+
+      # Заменить сценарий
+      #
+      # +PUT /v1/companies/{co}/automations/scenarios/{id}+
+      #
+      # @param id [String] id сценария (scn_…)
+      # @param name [String] Название сценария (1–200 знаков).
+      # @param trigger [Object] Когда запускать: по событию хука, по расписанию, по событию внутри Tungo или
+      #   только вручную. Вид — в kind.
+      # @param action [String] Старая форма — один шаг (вместо него можно steps). Что делать при запуске.
+      #   `agent` (по умолчанию) — ход ИИ-бухгалтера по поручению instruction: ИИ разбирает событие и данные
+      #   1С и готовит предложения — документы для запис…
+      # @param auto_approve [Tungo::Models::AutomationScenarioInputAutoApprove, nil] Правило автоодобрения —
+      #   только у сценария с шагом agent (action: agent или шаг agent в steps); сохраняет только тот, у кого
+      #   есть proposals.approve. null или нет — всё подготовленное ждёт решения человека.
+      # @param enabled [Boolean] Включён ли (по умолчанию true). Выключенный не запускается ни событием, ни
+      #   по расписанию; вручную (…/run) — запускается.
+      # @param instruction [String] Старая форма — поручение единственного шага. Поручение ИИ обычными
+      #   словами. Для action: agent обязательно (длина — не больше настройки платформы
+      #   instruction_max_chars); для checks и directbank не нужно.
+      # @param output [Hash{String=>Object}, nil] Старая форма — итог единственного шага. Форма итога —
+      #   только для action: agent. ИИ в конце хода отдаёт итог в этой форме, он приходит в запуске (output) и
+      #   в вебхуке automation.run.completed — например, чтобы CRM закрыла …
+      # @param steps [Array<Tungo::Models::AutomationStep>] Цепочка шагов (1–5) вместо action, instruction и
+      #   output — передайте что-то одно. Пример «каждое утро»:
+      #   `[{"action":"directbank"},{"action":"agent","instruction":"Разнеси
+      #   выписку","when":"previous_created_proposals"},{"ac…
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationScenarioSaved]
+      def put_scenario(
+        id,
+        name:,
+        trigger:,
+        action: OMIT,
+        auto_approve: OMIT,
+        enabled: OMIT,
+        instruction: OMIT,
+        output: OMIT,
+        steps: OMIT,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.request(
+          method: :put,
+          path: "/v1/companies/{co}/automations/scenarios/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          body: {
+            "name" => name,
+            "trigger" => trigger,
+            "action" => action,
+            "auto_approve" => auto_approve,
+            "enabled" => enabled,
+            "instruction" => instruction,
+            "output" => output,
+            "steps" => steps
+          },
+          model: :AutomationScenarioSaved,
+          options: request_options
+        )
+      end
+
+      # Включить или выключить сценарий
+      #
+      # +PATCH /v1/companies/{co}/automations/scenarios/{id}+
+      #
+      # @param id [String] id сценария (scn_…)
+      # @param enabled [Boolean] true — включить, false — выключить. Включить сценарий с автоодобрением
+      #   может только тот, у кого есть proposals.approve.
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationScenario]
+      def update_scenario(id, enabled:, company_id: nil, request_options: nil)
+        @client.request(
+          method: :patch,
+          path: "/v1/companies/{co}/automations/scenarios/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          body: { "enabled" => enabled },
+          model: :AutomationScenario,
+          options: request_options
+        )
+      end
+
+      # Удалить сценарий
+      #
+      # +DELETE /v1/companies/{co}/automations/scenarios/{id}+
+      #
+      # @param id [String] id сценария (scn_…)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationDeleted]
+      def delete_scenario(id, company_id: nil, request_options: nil)
+        @client.request(
+          method: :delete,
+          path: "/v1/companies/{co}/automations/scenarios/{id}",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          model: :AutomationDeleted,
+          options: request_options
+        )
+      end
+
+      # Запустить сценарий вручную или на прошлом событии
+      #
+      # +POST /v1/companies/{co}/automations/scenarios/{id}/run+
+      #
+      # @param id [String] id сценария (scn_…)
+      # @param event_id [String] id прошлого события хука этой компании (hev_… — event_id из ответа приёма
+      #   или из журнала запусков). Передан — запуск пробный (trial): ИИ разбирает это событие по нынешнему
+      #   поручению, а в 1С само ничего не пишется, даже п…
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationManualRun]
+      def run_scenario(id, event_id: OMIT, company_id: nil, request_options: nil)
+        @client.request(
+          method: :post,
+          path: "/v1/companies/{co}/automations/scenarios/{id}/run",
+          path_params: { co: @client.resolve_company_id(company_id), id: id },
+          body: { "event_id" => event_id },
+          body_required: false,
+          idempotency_header: "Idempotency-Key",
+          model: :AutomationManualRun,
+          options: request_options
+        )
+      end
+
+      # Пауза автоматизаций компании
+      #
+      # +GET /v1/companies/{co}/automations/state+
+      #
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationState]
+      def get_state(company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/automations/state",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          model: :AutomationState,
+          options: request_options
+        )
+      end
+
+      # Поставить на паузу или снять паузу
+      #
+      # +PUT /v1/companies/{co}/automations/state+
+      #
+      # @param paused [Boolean] true — поставить все автоматизации компании на паузу: новые запуски не
+      #   начинаются (идущий доводит текущий шаг, остановить его — POST …/runs/{id}/cancel), события хуков
+      #   принимаются и ждут в очереди; false — снять паузу (п…
+      # @param reason [String, nil] Почему пауза — для журнала и коллег (до 500 знаков)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::AutomationState]
+      def put_state(paused:, reason: OMIT, company_id: nil, request_options: nil)
+        @client.request(
+          method: :put,
+          path: "/v1/companies/{co}/automations/state",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          body: { "paused" => paused, "reason" => reason },
+          model: :AutomationState,
+          options: request_options
+        )
+      end
+
+      # Доверие ИИ в компании
+      #
+      # +GET /v1/companies/{co}/autonomy+
+      #
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::CompanyAutonomy]
+      def get_autonomy(company_id: nil, request_options: nil)
+        @client.request(
+          method: :get,
+          path: "/v1/companies/{co}/autonomy",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          model: :CompanyAutonomy,
+          options: request_options
+        )
+      end
+
+      # Изменить доверие ИИ в компании
+      #
+      # +PUT /v1/companies/{co}/autonomy+
+      #
+      # @param levels [Tungo::Models::CompanyAutonomyInputLevels] Уровень доверия по видам документов (ключ
+      #   — вид, как в kinds правила автоодобрения). Не указанный вид — L1. Отмены документа (revert) в списке
+      #   нет: её всегда решает человек, подпись ЭСФ и закрытие месяца не поднимаются н…
+      # @param max_amount_per_day_tiyn [Integer, nil] Потолок суммы всех записей компании без человека за
+      #   день по Алматы (все сценарии и выписка DirectBank вместе), в тиынах. null — по умолчанию платформы
+      # @param max_amount_per_document_tiyn [Integer, nil] Потолок одного документа, записанного без
+      #   человека, в тиынах (1 ₸ = 100 тиын). null — по умолчанию платформы (настройка automations.money)
+      # @param company_id [String, nil] overrides the client's company
+      # @param request_options [Tungo::RequestOptions, Hash, nil] per-request overrides
+      # @return [Tungo::Models::CompanyAutonomy]
+      def put_autonomy(
+        levels:,
+        max_amount_per_day_tiyn:,
+        max_amount_per_document_tiyn:,
+        company_id: nil,
+        request_options: nil
+      )
+        @client.request(
+          method: :put,
+          path: "/v1/companies/{co}/autonomy",
+          path_params: { co: @client.resolve_company_id(company_id) },
+          body: {
+            "levels" => levels,
+            "max_amount_per_day_tiyn" => max_amount_per_day_tiyn,
+            "max_amount_per_document_tiyn" => max_amount_per_document_tiyn
+          },
+          model: :CompanyAutonomy,
+          options: request_options
+        )
+      end
+    end
+  end
+end