# API \*\*cebook {% hint style="danger" %} **\*****На территории Российской Федерации ****запрещена деятельность**** социальных сетей ****Facebook****, принадлежащих компании Meta Platforms Inc**., признанная экстремистской! {% endhint %} {% hint style="danger" %} Мы не призываем Пользователей к использованию ресурса. Помните! 1. Действия, связанные с приобретением товаров или услуг у запрещенной организации могут быть расценены как финансирование экстремистской деятельности, согласно ст. 282.3 УК РФ. 2. Также с 1 сентября 2025 запрещено распространять рекламу на информационных ресурсах тех организаций, деятельность которых запрещена в РФ (согласно ч. 3 ст. 12 ФЗ от 25 июля 2002 № 114-ФЗ). {% endhint %} ### Что такое постоянное меню
Постоянное меню позволяет создавать и отправлять меню основных функций вашего бизнеса, таких, как часы работы, расположение магазинов и продукты, которые всегда отображаются в разговоре человека с вашей компанией в Messenger. #### Поддерживаемые кнопки: Постоянное меню состоит из набора кнопок . В постоянном меню поддерживаются следующие типы кнопок:\ ● кнопки-ссылки URL (web\_url)\ ● колбек-кнопки (postback) ### Добавление меню постоянного на уровне страницы **response = fb\_set\_persistent\_menu("group\_id", buttons)** где:\ **group\_id** - идентификатор бота в facebook\*\ **buttons** - словарь с кнопками **Пример оформления словаря с кнопками:**\ buttons = {"default": \[\["postback", "Button 1", "callback\_text 1"], \["postback", "Button 2", "callback\_text 2"], \["web\_url", "Site link", " **default** - обязательный ключ, описывает массив кнопок, которые будут в меню по умолчанию, не зависимо от локализации пользователя.\ В качестве значения указывается массив с кнопками. Каждая кнопка описывается отдельным массивом:\ \["тип кнопки", "Отображаемый текст кнопки", "Текст, который придет в бот - callback"] Типы кнопок и их описание:\ \- колбек-кнопки postback:\ \["postback", "Отображаемый текст кнопки", "Текст, который придет в бот"]\ \- кнопки-ссылки web\_url\ \["web\_url", "Отображаемый текст ссылки", "Ссылка"] ### Как настроить меню с учетом локализации клиента Настроить кнопки отдельно для разных регионов можно, используя для этого дополнительный ключ в словаре кнопок. Например, добавим кнопки для русской локали: buttons = {"default": \[\["postback", "Button 1", "callback\_text 1"], \["postback", "Button 2", "callback\_text 2"], \["web\_url", "Site link", ""]], **"ru\_RU"**: \[\["postback", "Кнопа", "callback\_text 1"], \["postback", "Кнопа 2", "callback\_text 2"], \["web\_url", "Ссылка", " Обратите внимание, что в данном случае ключ - это локаль, для которой будут отображаться кнопки. **Список всех доступных локалей**:\ af\_ZA, ar\_AR, as\_IN, az\_AZ, be\_BY, bg\_BG, bn\_IN, br\_FR, bs\_BA, ca\_ES, cb\_IQ, co\_FR, cs\_CZ, cx\_PH, cy\_GB, da\_DK, de\_DE, el\_GR, en\_GB, en\_UD, en\_US, es\_ES, es\_LA, et\_EE, eu\_ES, fa\_IR, ff\_NG, fi\_FI, fo\_FO, fr\_CA, fr\_FR, fy\_NL, ga\_IE, gl\_ES, gn\_PY, gu\_IN, ha\_NG, he\_IL, hi\_IN, hr\_HR, hu\_HU, hy\_AM, id\_ID, is\_IS, it\_IT, ja\_JP, ja\_KS, jv\_ID, ka\_GE, kk\_KZ, km\_KH, kn\_IN, ko\_KR, ku\_TR, lt\_LT, lv\_LV, mg\_MG, mk\_MK, ml\_IN, mn\_MN, mr\_IN, ms\_MY, mt\_MT, my\_MM, nb\_NO, ne\_NP, nl\_BE, nl\_NL, nn\_NO, or\_IN, pa\_IN, pl\_PL, ps\_AF, pt\_BR, pt\_PT, qz\_MM, ro\_RO, ru\_RU, rw\_RW, sc\_IT, si\_LK, sk\_SK, sl\_SI, so\_SO, sq\_AL, sr\_RS, sv\_SE, sw\_KE, sz\_PL, ta\_IN, te\_IN, tg\_TJ, th\_TH, tl\_PH, tr\_TR, tz\_MA, uk\_UA, ur\_PK, uz\_UZ, vi\_VN, zh\_CN, zh\_HK, zh\_TW

Перечень локалей, применяемы в Facebook

## Как добавить меню, постоянное на уровне пользователя Для этого в функции fb\_set\_persistent\_menu укажите третий параметр, равный 1, т.е.:\ **response = fb\_set\_persistent\_menu('group\_id', buttons, 1)** Это меню будет доступно пользователю, для которого была вызвана функция. {% hint style="info" %} **ПРИМЕЧАНИЕ** . **Обновление меню**, постоянного **на уровне пользователя**, происходит **в режиме реального времени**. При этом обновление меню, постоянного на уровне страницы, может занять до 24 часов. Настройки на уровне пользователя ограничены скоростью до 10 вызовов на пользователя за 10 минут. {% endhint %} ### Как отключить все коммуникации, кроме постоянного меню Для того, чтобы постоянное меню было единственным способом взаимодействия человека с вашим ботом Messenger, необходимо отключить композитор. \ Для чего это может быть нужно? Это полезно, если ваш бот направлен на конкретную цель или набор параметров. Как это сделать? Для этого в функцию нужно передать в качестве четвертого параметра цифру 1:\ \- отключить композитор на уровне страницы (для всех пользователей):\ **response = fb\_set\_persistent\_menu('group\_id', buttons, '', 1)**\ \- отключить композитор для пользователя, для которого вызвана функция:\ **response = fb\_set\_persistent\_menu('group\_id', buttons, 1, 1)**\ где:\ **group\_id** - идентификатор бота в Facebook\*\ **buttons** - словарь с кнопками

Меню в Facebook

В случае успешного исполнения функция возвращает: \ {"result":"success"} Иначе - описание ошибки:\ 'Error parse buttons data' - ошибка в словаре кнопок\ {"error":{"message":"(#100) param persistent\_menu\[0]\[call\_to\_actions] must be non-empty.","type":"OAuthException","code":100,"fbtrace\_id":"AJtVczu7TEJJxbMfnO"}} #### ПРИМЕРЫ: **Добавление меню для всех пользователей, а также для РФ добавить перевод:** ``` buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://salebot.ai/"]], "ru_RU": [["postback", "Кнопа", "callback_text 1"], ["postback", "Кнопа 2", "callback_text 2"], ["web_url", "Ссылка", "https://salebot.pro/"]]} response = fb_set_persistent_menu('123456789', buttons) ``` **Добавление меню для всех пользователей, для РФ добавить перевод, а также для всех сделать это меню единственным способом коммуникации:** ``` buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://salebot.ai/"]], "ru_RU": [["postback", "Кнопа", "callback_text 1"], ["postback", "Кнопа 2", "callback_text 2"], ["web_url", "Ссылка", "https://salebot.pro/"]]} response = fb_set_persistent_menu('123456789', buttons, '', 1) ``` **Добавление меню для пользователя, который перешел в блок с вызовом функции:** ``` buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://salebot.ai/"]]} response = fb_set_persistent_menu('123456789', buttons, 1) ``` **Добавление меню для пользователя, который перешел в блок с вызовом функции, а также для всех сделать это меню единственным способом коммуникации:** ``` buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://salebot.ai/"]]} response = fb_set_persistent_menu('123456789', buttons, 1, 1) ``` ### Удалить постоянное меню на уровне страницы (для всех пользователей) **response = fb\_delete\_persistent\_menu('group\_id')** В случае успешного исполнения функция возвращает:\ {"result":"success"} Иначе описание ошибки:\ 'Bot not found' ### Удалить постоянное меню на уровне пользователя **response = fb\_delete\_persistent\_menu('group\_id', 1)** В случае успешного исполнения функция возвращает:\ {"result":"success"} Иначе - описание ошибки:\ 'Bot not found' --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.salebot.pro/chatbots/channels/cebook-messenger/api-cebook.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.