Skip to main content

CalendarConfig

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

Number of upcoming working days during which all calendar slots are hidden and booking attempts are rejected. The current day counts when it is a configured working day; 0 disables the restriction.

Possible values: >= 0

Default value: 0
daily_booking_limitDaily Booking Limit

Maximum active meetings the agent may book across all configured calendar accounts on one local calendar day. 0 means unlimited.

Possible values: >= 0

Default value: 0
slot_step_minutesSlot Step Minutes

Step, in minutes, used when generating possible meeting start times inside a free calendar window. This is separate from 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

A bookable calendar account (e.g. a sales manager's calendar) exposed by a calendar integration.

idIdrequired

The account's id at the calendar provider.

nameNamerequired

The account's display name.

enabled_services_idsstring[]

IDs of the bookable services enabled for this account.

schedule object

Maps each weekday to its working-hours configuration.

days objectrequired

Map of weekday ("0"=Monday … "6"=Sunday) to that day's working-hours config.

property name* ScheduleDayConfig

Working-hours configuration for a single weekday.

is_working_dayIs Working Dayrequired

Whether messages may be sent on this day.

time_startTime Start

Start of the working window, "HH:MM" (24h).

Default value: 00:00
time_endTime End

End of the working window, "HH:MM" (24h).

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

Identifier of the matching record in the connected external CRM, if any.

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

    The service's id at the calendar provider.

    nameNamerequired

    The service's display name.

    category_id object

    Optional category id the service belongs to.

    anyOf
    string
    llm_context object

    Optional description given to the LLM to help it pick this service.

    anyOf
    string
    is_enabled_in_calendarIs Enabled In Calendar

    Whether the service is currently bookable.

    Default value: true
    booking_modesCalendarBookingMode[]

    Possible values: [individual, group], >= 1

  • ]
    • reminders object[]
  • Array [
    • step_numberStep Numberrequired
    before_minutesBefore Minutesrequired
    source objectrequired

    Specifies the content of a message to send, by reference to exactly one source — raw text, a prompt, a prepared message, a WABA template, or file(s).

    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
    use_event_provider_custom_fieldsUse Event Provider Custom Fields

    Expose all provider event custom fields as template variables for this reminder; currently supported for YClients. Defaults to false; the legacy fields list is ignored without migration. Hyphens in keys become underscores (my-custom-field is used as {{ my_custom_field }}); values are preserved. Event fields override same-named lead fields under the existing enrichment rules, including built-in contact-name precedence. If normalized event keys collide, the last key in the provider response wins. The reminder is skipped when the record is unavailable, custom_fields is empty/invalid, or any value is empty; its step number is not advanced, so the next scheduler tick retries it. Values 0 and false count as filled. When enabled, direct text is rendered before scheduling; other providers perform no external lookup.

    Default value: false
  • ]
    • CalendarConfig
    {
      "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,
          "booking_modes": [
            "individual"
          ]
        }
      ],
      "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"
          },
          "use_event_provider_custom_fields": false
        }
      ]
    }