[{"data":1,"prerenderedAt":841},["ShallowReactive",2],{"navigation_docs":3,"-getting-started-custom-fields":85},[4,39,57,75],{"title":5,"icon":6,"path":7,"stem":8,"children":9,"page":38},"Начало работы","i-lucide-rocket","\u002Fgetting-started","1.getting-started",[10,14,18,22,26,30,34],{"title":11,"path":12,"stem":13},"Введение","\u002Fgetting-started\u002Fintroduction","1.getting-started\u002F1.introduction",{"title":15,"path":16,"stem":17},"Ключ API","\u002Fgetting-started\u002Fapi-key","1.getting-started\u002F2.api-key",{"title":19,"path":20,"stem":21},"Аутентификация","\u002Fgetting-started\u002Fauthentication","1.getting-started\u002F3.authentication",{"title":23,"path":24,"stem":25},"Ошибки","\u002Fgetting-started\u002Ferrors","1.getting-started\u002F4.errors",{"title":27,"path":28,"stem":29},"Пагинация","\u002Fgetting-started\u002Fpagination","1.getting-started\u002F5.pagination",{"title":31,"path":32,"stem":33},"Сценарий записи","\u002Fgetting-started\u002Fbooking-flow","1.getting-started\u002F6.booking-flow",{"title":35,"path":36,"stem":37},"Пользовательские атрибуты","\u002Fgetting-started\u002Fcustom-fields","1.getting-started\u002F7.custom-fields",false,{"title":40,"icon":41,"path":42,"stem":43,"children":44,"page":38},"Вебхуки","i-lucide-webhook","\u002Fwebhooks","2.webhooks",[45,49,53],{"title":46,"path":47,"stem":48},"Обзор","\u002Fwebhooks\u002Foverview","2.webhooks\u002F1.overview",{"title":50,"path":51,"stem":52},"Данные вебхука","\u002Fwebhooks\u002Fpayload","2.webhooks\u002F2.payload",{"title":54,"path":55,"stem":56},"Надёжность доставки","\u002Fwebhooks\u002Freliability","2.webhooks\u002F3.reliability",{"title":58,"icon":59,"path":60,"stem":61,"children":62,"page":38},"Виджет","i-lucide-panel-top","\u002Fwidget","3.widget",[63,67,71],{"title":64,"path":65,"stem":66},"Установка","\u002Fwidget\u002Finstallation","3.widget\u002F1.installation",{"title":68,"path":69,"stem":70},"Загрузчик","\u002Fwidget\u002Floader","3.widget\u002F2.loader",{"title":72,"path":73,"stem":74},"Настройка и устранение неполадок","\u002Fwidget\u002Ftroubleshooting","3.widget\u002F3.troubleshooting",{"title":76,"icon":77,"path":78,"stem":79,"children":80,"page":38},"API reference","i-lucide-braces","\u002Freference","4.reference",[81],{"title":82,"path":83,"stem":84,"to":78},"Открыть reference","\u002Freference\u002Fapi","4.reference\u002F1.api",{"id":86,"title":35,"body":87,"description":833,"extension":834,"links":835,"meta":836,"navigation":838,"path":36,"seo":839,"stem":37,"__hash__":840},"docs\u002F1.getting-started\u002F7.custom-fields.md",{"type":88,"value":89,"toc":828},"minimark",[90,115,120,127,150,164,169,540,593,602,607,611,619,774,777,786,795,799,824],[91,92,93,94,101,102,106,107,110,111,114],"p",{},"Пользовательские атрибуты — это поля, которые аккаунт добавляет к карточке клиента или к записи сверх стандартных: например, «Канал связи» у клиента или «Номер в CRM» у записи. Атрибуты настраиваются в разделе ",[95,96,100],"a",{"href":97,"rel":98},"https:\u002F\u002Fmy.booknow.ru\u002Fsettings\u002Fattributes",[99],"nofollow","Настройки → Данные → Пользовательские атрибуты",". У каждого атрибута есть постоянный ключ ",[103,104,105],"code",{},"slug",": атрибуты клиента начинаются с ",[103,108,109],{},"customer_",", атрибуты записи — с ",[103,112,113],{},"booking_",".",[116,117,119],"h2",{"id":118},"получение-через-api","Получение через API",[91,121,122,123,126],{},"Атрибуты возвращаются в поле ",[103,124,125],{},"custom_fields",":",[128,129,130,137],"ul",{},[131,132,133,136],"li",{},[103,134,135],{},"GET \u002Fcustomers\u002F{uuid}"," — атрибуты карточки клиента;",[131,138,139,140,143,144,146,147,114],{},"полная запись (",[103,141,142],{},"GET \u002Fbookings\u002F{uuid}",", а также ответы на создание и изменение записи) — атрибуты записи в ",[103,145,125],{}," и атрибуты клиента в ",[103,148,149],{},"customer.custom_fields",[91,151,152,153,156,157,160,161,114],{},"Списки ",[103,154,155],{},"GET \u002Fcustomers"," и ",[103,158,159],{},"GET \u002Fbookings"," атрибуты не содержат: чтобы получить их, запросите клиента или запись по ",[103,162,163],{},"uuid",[91,165,166,167,126],{},"Фрагмент ответа ",[103,168,142],{},[170,171,176],"pre",{"className":172,"code":173,"language":174,"meta":175,"style":175},"language-json shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","{\n  \"uuid\": \"0641062b-b28c-4f63-8569-36c2a7dd8740\",\n  \"start_time\": \"2026-11-11T07:00:00Z\",\n  \"custom_fields\": [\n    { \"slug\": \"booking_nomer_v_crm\", \"name\": \"Номер в CRM\", \"value\": \"CRM-1042\" }\n  ],\n  \"customer\": {\n    \"uuid\": \"dc9772d0-4ee7-4a37-9701-4108ac6a5250\",\n    \"first_name\": \"Анастасия\",\n    \"last_name\": \"Соколова\",\n    \"custom_fields\": [\n      { \"slug\": \"customer_liubimyi_napitok\", \"name\": \"Любимый напиток\", \"value\": \"Капучино без сахара\" },\n      { \"slug\": \"customer_kanal_sviazi\", \"name\": \"Канал связи\", \"value\": \"Telegram\" }\n    ]\n  }\n}\n","json","",[103,177,178,187,213,234,248,310,316,331,352,373,394,407,466,522,528,534],{"__ignoreMap":175},[179,180,183],"span",{"class":181,"line":182},"line",1,[179,184,186],{"class":185},"sMK4o","{\n",[179,188,190,193,196,199,201,204,208,210],{"class":181,"line":189},2,[179,191,192],{"class":185},"  \"",[179,194,163],{"class":195},"spNyl",[179,197,198],{"class":185},"\"",[179,200,126],{"class":185},[179,202,203],{"class":185}," \"",[179,205,207],{"class":206},"sfazB","0641062b-b28c-4f63-8569-36c2a7dd8740",[179,209,198],{"class":185},[179,211,212],{"class":185},",\n",[179,214,216,218,221,223,225,227,230,232],{"class":181,"line":215},3,[179,217,192],{"class":185},[179,219,220],{"class":195},"start_time",[179,222,198],{"class":185},[179,224,126],{"class":185},[179,226,203],{"class":185},[179,228,229],{"class":206},"2026-11-11T07:00:00Z",[179,231,198],{"class":185},[179,233,212],{"class":185},[179,235,237,239,241,243,245],{"class":181,"line":236},4,[179,238,192],{"class":185},[179,240,125],{"class":195},[179,242,198],{"class":185},[179,244,126],{"class":185},[179,246,247],{"class":185}," [\n",[179,249,251,254,256,259,261,263,265,268,270,273,275,278,280,282,284,287,289,291,293,296,298,300,302,305,307],{"class":181,"line":250},5,[179,252,253],{"class":185},"    {",[179,255,203],{"class":185},[179,257,105],{"class":258},"sBMFI",[179,260,198],{"class":185},[179,262,126],{"class":185},[179,264,203],{"class":185},[179,266,267],{"class":206},"booking_nomer_v_crm",[179,269,198],{"class":185},[179,271,272],{"class":185},",",[179,274,203],{"class":185},[179,276,277],{"class":258},"name",[179,279,198],{"class":185},[179,281,126],{"class":185},[179,283,203],{"class":185},[179,285,286],{"class":206},"Номер в CRM",[179,288,198],{"class":185},[179,290,272],{"class":185},[179,292,203],{"class":185},[179,294,295],{"class":258},"value",[179,297,198],{"class":185},[179,299,126],{"class":185},[179,301,203],{"class":185},[179,303,304],{"class":206},"CRM-1042",[179,306,198],{"class":185},[179,308,309],{"class":185}," }\n",[179,311,313],{"class":181,"line":312},6,[179,314,315],{"class":185},"  ],\n",[179,317,319,321,324,326,328],{"class":181,"line":318},7,[179,320,192],{"class":185},[179,322,323],{"class":195},"customer",[179,325,198],{"class":185},[179,327,126],{"class":185},[179,329,330],{"class":185}," {\n",[179,332,334,337,339,341,343,345,348,350],{"class":181,"line":333},8,[179,335,336],{"class":185},"    \"",[179,338,163],{"class":258},[179,340,198],{"class":185},[179,342,126],{"class":185},[179,344,203],{"class":185},[179,346,347],{"class":206},"dc9772d0-4ee7-4a37-9701-4108ac6a5250",[179,349,198],{"class":185},[179,351,212],{"class":185},[179,353,355,357,360,362,364,366,369,371],{"class":181,"line":354},9,[179,356,336],{"class":185},[179,358,359],{"class":258},"first_name",[179,361,198],{"class":185},[179,363,126],{"class":185},[179,365,203],{"class":185},[179,367,368],{"class":206},"Анастасия",[179,370,198],{"class":185},[179,372,212],{"class":185},[179,374,376,378,381,383,385,387,390,392],{"class":181,"line":375},10,[179,377,336],{"class":185},[179,379,380],{"class":258},"last_name",[179,382,198],{"class":185},[179,384,126],{"class":185},[179,386,203],{"class":185},[179,388,389],{"class":206},"Соколова",[179,391,198],{"class":185},[179,393,212],{"class":185},[179,395,397,399,401,403,405],{"class":181,"line":396},11,[179,398,336],{"class":185},[179,400,125],{"class":258},[179,402,198],{"class":185},[179,404,126],{"class":185},[179,406,247],{"class":185},[179,408,410,413,415,418,420,422,424,427,429,431,433,435,437,439,441,444,446,448,450,452,454,456,458,461,463],{"class":181,"line":409},12,[179,411,412],{"class":185},"      {",[179,414,203],{"class":185},[179,416,105],{"class":417},"sbssI",[179,419,198],{"class":185},[179,421,126],{"class":185},[179,423,203],{"class":185},[179,425,426],{"class":206},"customer_liubimyi_napitok",[179,428,198],{"class":185},[179,430,272],{"class":185},[179,432,203],{"class":185},[179,434,277],{"class":417},[179,436,198],{"class":185},[179,438,126],{"class":185},[179,440,203],{"class":185},[179,442,443],{"class":206},"Любимый напиток",[179,445,198],{"class":185},[179,447,272],{"class":185},[179,449,203],{"class":185},[179,451,295],{"class":417},[179,453,198],{"class":185},[179,455,126],{"class":185},[179,457,203],{"class":185},[179,459,460],{"class":206},"Капучино без сахара",[179,462,198],{"class":185},[179,464,465],{"class":185}," },\n",[179,467,469,471,473,475,477,479,481,484,486,488,490,492,494,496,498,501,503,505,507,509,511,513,515,518,520],{"class":181,"line":468},13,[179,470,412],{"class":185},[179,472,203],{"class":185},[179,474,105],{"class":417},[179,476,198],{"class":185},[179,478,126],{"class":185},[179,480,203],{"class":185},[179,482,483],{"class":206},"customer_kanal_sviazi",[179,485,198],{"class":185},[179,487,272],{"class":185},[179,489,203],{"class":185},[179,491,277],{"class":417},[179,493,198],{"class":185},[179,495,126],{"class":185},[179,497,203],{"class":185},[179,499,500],{"class":206},"Канал связи",[179,502,198],{"class":185},[179,504,272],{"class":185},[179,506,203],{"class":185},[179,508,295],{"class":417},[179,510,198],{"class":185},[179,512,126],{"class":185},[179,514,203],{"class":185},[179,516,517],{"class":206},"Telegram",[179,519,198],{"class":185},[179,521,309],{"class":185},[179,523,525],{"class":181,"line":524},14,[179,526,527],{"class":185},"    ]\n",[179,529,531],{"class":181,"line":530},15,[179,532,533],{"class":185},"  }\n",[179,535,537],{"class":181,"line":536},16,[179,538,539],{"class":185},"}\n",[541,542,543,556],"table",{},[544,545,546],"thead",{},[547,548,549,553],"tr",{},[550,551,552],"th",{},"Поле",[550,554,555],{},"Описание",[557,558,559,572,581],"tbody",{},[547,560,561,566],{},[562,563,564],"td",{},[103,565,105],{},[562,567,568,569,571],{},"Постоянный ключ атрибута. Используйте его для сопоставления с полями вашей системы: название атрибута в панели можно изменить, а ",[103,570,105],{}," при этом не меняется.",[547,573,574,578],{},[562,575,576],{},[103,577,277],{},[562,579,580],{},"Название атрибута на языке аккаунта.",[547,582,583,587],{},[562,584,585],{},[103,586,295],{},[562,588,589,590,114],{},"Значение. Для атрибута-списка возвращается название выбранного варианта, для скрытого атрибута без значения — значение по умолчанию. Если атрибут не заполнен, возвращается ",[103,591,592],{},"null",[91,594,595,596,598,599,601],{},"В ",[103,597,125],{}," перечислены все пользовательские атрибуты аккаунта, включая незаполненные. Стандартные поля формы (имя, телефон, почта, комментарий, внутренняя заметка к записи) в ",[103,600,125],{}," не входят.",[91,603,604,606],{},[103,605,135],{}," всегда возвращает актуальные данные карточки, в том числе изменения, сделанные сотрудником в панели.",[116,608,610],{"id":609},"передача-при-создании-записи","Передача при создании записи",[91,612,595,613,616,617,126],{},[103,614,615],{},"POST \u002Fbookings"," атрибуты передаются на верхнем уровне тела запроса, ключом служит ",[103,618,105],{},[170,620,622],{"className":172,"code":621,"language":174,"meta":175,"style":175},"{ \"reserved_on\": \"2026-11-11T07:00:00Z\",\n  \"location_uuid\": \"1ed7fb3d-…\", \"service_uuid\": \"099fa474-…\", \"staffer_uuid\": \"7a561987-…\",\n  \"customer_phone\": \"+79150010203\", \"customer_first_name\": \"Анастасия\", \"customer_last_name\": \"Соколова\",\n  \"booking_nomer_v_crm\": \"CRM-1042\" }\n",[103,623,624,646,702,756],{"__ignoreMap":175},[179,625,626,629,631,634,636,638,640,642,644],{"class":181,"line":182},[179,627,628],{"class":185},"{",[179,630,203],{"class":185},[179,632,633],{"class":195},"reserved_on",[179,635,198],{"class":185},[179,637,126],{"class":185},[179,639,203],{"class":185},[179,641,229],{"class":206},[179,643,198],{"class":185},[179,645,212],{"class":185},[179,647,648,650,653,655,657,659,662,664,666,668,671,673,675,677,680,682,684,686,689,691,693,695,698,700],{"class":181,"line":189},[179,649,192],{"class":185},[179,651,652],{"class":195},"location_uuid",[179,654,198],{"class":185},[179,656,126],{"class":185},[179,658,203],{"class":185},[179,660,661],{"class":206},"1ed7fb3d-…",[179,663,198],{"class":185},[179,665,272],{"class":185},[179,667,203],{"class":185},[179,669,670],{"class":195},"service_uuid",[179,672,198],{"class":185},[179,674,126],{"class":185},[179,676,203],{"class":185},[179,678,679],{"class":206},"099fa474-…",[179,681,198],{"class":185},[179,683,272],{"class":185},[179,685,203],{"class":185},[179,687,688],{"class":195},"staffer_uuid",[179,690,198],{"class":185},[179,692,126],{"class":185},[179,694,203],{"class":185},[179,696,697],{"class":206},"7a561987-…",[179,699,198],{"class":185},[179,701,212],{"class":185},[179,703,704,706,709,711,713,715,718,720,722,724,727,729,731,733,735,737,739,741,744,746,748,750,752,754],{"class":181,"line":215},[179,705,192],{"class":185},[179,707,708],{"class":195},"customer_phone",[179,710,198],{"class":185},[179,712,126],{"class":185},[179,714,203],{"class":185},[179,716,717],{"class":206},"+79150010203",[179,719,198],{"class":185},[179,721,272],{"class":185},[179,723,203],{"class":185},[179,725,726],{"class":195},"customer_first_name",[179,728,198],{"class":185},[179,730,126],{"class":185},[179,732,203],{"class":185},[179,734,368],{"class":206},[179,736,198],{"class":185},[179,738,272],{"class":185},[179,740,203],{"class":185},[179,742,743],{"class":195},"customer_last_name",[179,745,198],{"class":185},[179,747,126],{"class":185},[179,749,203],{"class":185},[179,751,389],{"class":206},[179,753,198],{"class":185},[179,755,212],{"class":185},[179,757,758,760,762,764,766,768,770,772],{"class":181,"line":236},[179,759,192],{"class":185},[179,761,267],{"class":195},[179,763,198],{"class":185},[179,765,126],{"class":185},[179,767,203],{"class":185},[179,769,304],{"class":206},[179,771,198],{"class":185},[179,773,309],{"class":185},[91,775,776],{},"Для атрибута-списка передаётся ключ варианта.",[91,778,779,780,785],{},"API принимает только атрибуты, добавленные в форму записи в разделе ",[95,781,784],{"href":782,"rel":783},"https:\u002F\u002Fmy.booknow.ru\u002Fsettings\u002Fscheduler\u002Fform",[99],"Настройки → Онлайн-запись → Конструктор форм","; остальные ключи не сохраняются. Если клиент с таким телефоном уже есть, пустой атрибут в его карточке заполняется, а заполненный заменяется новым значением, только если в настройках поля формы включён параметр «Перезаписывать значение при записи».",[91,787,788,156,791,794],{},[103,789,790],{},"POST \u002Fcustomers",[103,792,793],{},"PUT \u002Fcustomers\u002F{uuid}"," пользовательские атрибуты не принимают.",[116,796,798],{"id":797},"получение-через-вебхуки","Получение через вебхуки",[91,800,801,802,156,805,808,809,156,812,815,816,818,819,821,822,114],{},"В данных вебхуков записи атрибуты передаются отдельными полями ",[103,803,804],{},"customer_attributes.\u003Cslug>",[103,806,807],{},"booking_attributes.\u003Cslug>",", например ",[103,810,811],{},"\"booking_attributes.booking_nomer_v_crm\": \"CRM-1042\"",[103,813,814],{},"\"customer_attributes.customer_kanal_sviazi\": \"Telegram\"",". Значения формируются по тем же правилам, что и ",[103,817,295],{}," в API, но вместо ",[103,820,592],{}," передаётся пустая строка. Подробнее — в статье ",[95,823,50],{"href":51},[825,826,827],"style",{},"html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .spNyl, html code.shiki .spNyl{--shiki-light:#9C3EDA;--shiki-default:#C792EA;--shiki-dark:#C792EA}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .sBMFI, html code.shiki .sBMFI{--shiki-light:#E2931D;--shiki-default:#FFCB6B;--shiki-dark:#FFCB6B}html pre.shiki code .sbssI, html code.shiki .sbssI{--shiki-light:#F76D47;--shiki-default:#F78C6C;--shiki-dark:#F78C6C}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":175,"searchDepth":189,"depth":189,"links":829},[830,831,832],{"id":118,"depth":189,"text":119},{"id":609,"depth":189,"text":610},{"id":797,"depth":189,"text":798},"Как получить через API и вебхуки поля, которые аккаунт добавил в карточку клиента и в запись, и как передать их при создании записи.","md",null,{"related":837},[32,51,78],true,{"title":35,"description":833},"0fwDsFjBT5OBnCLxYOpa8aNghmcDVFAC938j1_9Lf_8",1793700274049]