Перейти к основному содержимому

AgentIntegrationRead

Связывает агента с интеграцией компании (календарём) и хранит конфигурацию календаря, используемую агентом для записи на встречи.

idIdrequired

Уникальный числовой идентификатор записи.

agent_idAgent Idrequired

Идентификатор агента (настроенного ИИ-ассистента/бота), которому принадлежит запись.

integration_idIntegration Idrequired

Идентификатор интеграции компании, с которой эта связка соединяет агента.

config objectrequired

Конфигурация календаря для этого агента (доступные аккаунты, услуги, расписание).

enabledEnabled
Default value: true
max_lookahead_hoursMax Lookahead Hours
Default value: 168
meeting_duration_minutesMeeting Duration Minutes
Default value: 30
booking_lead_time_working_daysBooking Lead Time Working Days

Количество ближайших рабочих дней, на которые все календарные слоты скрываются, а попытки записи отклоняются. Текущий день учитывается, если он отмечен рабочим; 0 отключает ограничение.

Possible values: >= 0

Default value: 0
daily_booking_limitDaily Booking Limit

Максимальное количество активных встреч, которые агент может записать во всех настроенных календарных аккаунтах за один локальный календарный день. 0 означает отсутствие лимита.

Possible values: >= 0

Default value: 0
slot_step_minutesSlot Step Minutes

Шаг в минутах, с которым строятся возможные времена начала встречи внутри свободного окна календаря. Не зависит от длительности встречи meeting_duration_minutes.

Possible values: > 0

Default value: 5
attach_crm_link_to_eventAttach Crm Link To Event
Default value: true
titleTitle
Default value: Meeting with Lead (auto)
create_description_summaryCreate Description Summary
Default value: true
accounts object
property name* CalendarAccountConfig
account objectrequired

Аккаунт календаря, доступный для записи (например, календарь менеджера), предоставляемый интеграцией календаря.

idIdrequired

Идентификатор аккаунта у провайдера календаря.

nameNamerequired

Отображаемое имя аккаунта.

enabled_services_idsstring[]

Идентификаторы услуг, доступных для записи в этом аккаунте.

schedule object

Сопоставляет каждому дню недели его конфигурацию рабочих часов.

days objectrequired

Карта «день недели ("0"=понедельник … "6"=воскресенье) → конфигурация рабочих часов этого дня».

property name* ScheduleDayConfig

Конфигурация рабочих часов для одного дня недели.

is_working_dayIs Working Dayrequired

Можно ли отправлять сообщения в этот день.

time_startTime Start

Начало рабочего интервала, "ЧЧ:ММ" (24-часовой формат).

Default value: 00:00
time_endTime End

Конец рабочего интервала, "ЧЧ:ММ" (24-часовой формат).

Default value: 00:00
timezoneTimezone
Default value: Europe/Moscow
crm_id object

Идентификатор соответствующей записи в подключённой внешней CRM, если есть.

anyOf
string
static_meeting_link object
anyOf
string
use_google_meet_linkUse Google Meet Link
Default value: false
create_crm_task_on_create_meetingCreate Crm Task On Create Meeting
Default value: true
create_crm_task_on_cancel_meetingCreate Crm Task On Cancel Meeting
Default value: true
service_selector_subagent_enabledService Selector Subagent Enabled
Default value: false
services object[]
  • Array [
    • idIdrequired

    Идентификатор услуги у провайдера календаря.

    nameNamerequired

    Отображаемое название услуги.

    category_id object

    Необязательный идентификатор категории, которой принадлежит услуга.

    anyOf
    string
    llm_context object

    Необязательное описание для LLM, помогающее выбрать эту услугу.

    anyOf
    string
    is_enabled_in_calendarIs Enabled In Calendar

    Доступна ли услуга для записи сейчас.

    Default value: true
  • ]
    • reminders object[]
  • Array [
    • step_numberStep Numberrequired
    before_minutesBefore Minutesrequired
    source objectrequired

    Задаёт содержимое отправляемого сообщения ссылкой ровно на один источник — произвольный текст, промпт, подготовленное сообщение, WABA-шаблон или файл(ы).

    text object
    anyOf
    string
    prompt_id object
    anyOf
    integer
    prompt_version_id object
    anyOf
    integer
    prepared_message_id object
    anyOf
    integer
    waba_template_id object
    anyOf
    integer
    file_idsinteger[]
    caption object
    anyOf
    string
  • ]
    • created_atdate-timerequired

    Время создания (UTC, ISO 8601).

    AgentIntegrationRead
    {
      "id": 0,
      "agent_id": 0,
      "integration_id": 0,
      "config": {
        "enabled": true,
        "max_lookahead_hours": 168,
        "meeting_duration_minutes": 30,
        "booking_lead_time_working_days": 0,
        "daily_booking_limit": 0,
        "slot_step_minutes": 5,
        "attach_crm_link_to_event": true,
        "title": "Meeting with Lead (auto)",
        "create_description_summary": true,
        "accounts": {},
        "service_selector_subagent_enabled": false,
        "services": [
          {
            "id": "string",
            "name": "string",
            "category_id": "string",
            "llm_context": "string",
            "is_enabled_in_calendar": true
          }
        ],
        "reminders": [
          {
            "step_number": 0,
            "before_minutes": 0,
            "source": {
              "text": "string",
              "prompt_id": 0,
              "prompt_version_id": 0,
              "prepared_message_id": 0,
              "waba_template_id": 0,
              "file_ids": [
                0
              ],
              "caption": "string"
            }
          }
        ]
      },
      "created_at": "2024-07-29T15:51:28.071Z"
    }