# API Instagram

### Що таке постійне меню

<div data-with-frame="true"><figure><img src="/files/169c63269fb2c1b4264b4291d1d923722e7a3f30" alt="" width="230"><figcaption></figcaption></figure></div>

Постійне меню дає змогу створювати й надсилати меню з основними функціями вашого бізнесу, такими як години роботи, адреси магазинів і товари. Воно завжди буде видно під час розмови людини з вашою компанією в Messenger.

#### Підтримувані кнопки:

Постійне меню складається з набору кнопок. У постійному меню підтримуються такі типи кнопок:

● Кнопки URL (web\_url)\
● Кнопки зворотного виклику (postback)

### Як додати постійне меню

**response = ig\_set\_persistent\_menu(login, buttons),** де:\
**login** - ваш логін Instagram (можна знайти в **"Channel"** меню MaviBot)\
**buttons** - словник, що містить кнопки

**Приклад того, як структурувати словник кнопок**:\
buttons = {"default": \[\["postback", "Button 1", "callback\_text 1"], \["postback", "Button 2", "callback\_text 2"], \["web\_url", "Site link", "<https://mavibot.ai/"]]}\\>
**default** - обов’язковий ключ, який визначає масив кнопок, що відображатимуться в меню за замовчуванням, незалежно від локалізації користувача.\
Значення має бути масивом кнопок. Кожна кнопка описується як окремий масив у такому форматі:

\["button\_type", "Button display text", "Callback text sent to the bot"]

**Типи кнопок і їхній опис:**\
\&#xNAN;*- кнопка зворотного виклику:*\
\["postback", "Button display text", "Callback text sent to the bot"]\
\&#xNAN;*- кнопка URL:*\
\["web\_url", "Link display text", "<https://example.com>"]

### Як налаштувати меню залежно від локалізації користувача

Ви можете налаштувати кнопки для різних регіонів, додавши до словника кнопок додаткові ключі, що відповідають певним локалям.

Наприклад, щоб додати кнопки для англійської локалі:

buttons = {"default": \[\["postback", "Button 1", "callback\_text 1"], \["postback", "Button 2", "callback\_text 2"], \["web\_url", "Site link", "<https://mavibot.ai/>"]], **"en\_EN"**: \[\["postback", "Button", "callback\_text 1"], \["postback", "Button 2", "callback\_text 2"], \["web\_url", "Link", "<https://mavibot.ai/"]]}>

{% hint style="info" %}
Примітка: у цьому випадку ключ представляє локаль, для якої відображатимуться кнопки.
{% endhint %}

**Підтримувані локалі**:\
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

**Приклад запиту:**

```
buttons = {"default": [["postback", "Button 1", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Site link", "https://mavibot.ai/"]], "en_EN": [["postback", "Button", "callback_text 1"], ["postback", "Button 2", "callback_text 2"], ["web_url", "Link", "https://mavibot.ai/"]]}
response = ig_set_persistent_menu('login', buttons)
```

У разі успішного виконання функція повертає:\
{"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"}}

### Як видалити постійне меню

**response = ig\_delete\_persistent\_menu('login')**, де login - назва облікового запису

<div data-with-frame="true"><figure><img src="/files/f450507a1a4130312abd180ba2c30882313e9e34" alt=""><figcaption></figcaption></figure></div>

У разі успішного виконання функція повертає:

{"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.mavibot.ai/doc/uk/chatbot/mesendzheri/instagram/api.md?ask=<question>
```

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.