> For the complete documentation index, see [llms.txt](https://docs.suvvy.ai/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.suvvy.ai/ru/kanaly/socialnye-seti/instagram.md).

# Instagram\*

Instagram\* — это популярная социальная сеть, которая позволяет пользователям не только делиться фотографиями и видео, но и является мощной бизнес-площадкой благодаря своей визуальной природе.

## Что позволяет?

Данный канал предназначен для автоматизации общения с клиентами на площадке социальной сети **Instagram\*.**

## Как подключить?

Условия подключения:

* У вас должен быть бизнес-аккаунт на платформе **Instagram\***;
* В настойках **Instagram\*** должен быть разрешен доступ к управлению личными сообщениями.

\*Бизнес-аккаунт может быть автоматически создан при подключении.

{% stepper %}
{% step %}

### Перейдите в раздел Каналы платформы Савви:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fq06E6FWcKXsX1l8wRbg0%2Fimage.png?alt=media&amp;token=769d4957-4d85-4047-adf9-9581d3f3ac67" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Нажмите на кнопку Подключить:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F1NzMFaG7niYEBy3ZntGU%2Fimage.png?alt=media&amp;token=81e7de24-af2f-405f-a63f-d25a6f722589" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Введите логин и пароль от вашего аккаунта в **Instagram\***

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FczWikwbJihyznPoiYZT4%2Fimage.png?alt=media&amp;token=706fb71f-a22f-4103-ae60-48c8790a9a55" alt="" width="298"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Разрешите доступ к следующим параметрам:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FrTfvGboxdYQzOM99i1j4%2F2025-04-14_21-02-45.png?alt=media&amp;token=6a179dfb-2690-4389-b03f-9df3ebe52115" alt="" width="367"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Настройки интеграции в Савви

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FNzVKEYHM2jbGip2DpaMZ%2Fimage.png?alt=media&amp;token=5d2108d5-a9f1-4976-a513-303735b3a249" alt=""><figcaption></figcaption></figure>

* **Отвечать на личные сообщения** - Если этот флаг включён, то агент будет отвечать только на личные сообщения в директе.
* **Отвечать на комментарии** - если включён только этот ползунок, то агент будет в Instagram\* отвечать только на комментарии к постам.
* **Останавливать диалог, если его начал сотрудник** - Работает только при включённой общей настройке агента «Не отвечать при прерывании диалога сотрудником" в [Дополнительных настройках.](/ru/osnovnye-nastroiki/dopolnitelnye-nastroiki.md#usloviya-preryvaniya-dialoga)
* **Удалить подключение** - полностью отключить интеграцию.
  {% endstep %}

{% step %}

### Настройка ответов на комментарии

При выборе флага Отвечать на комментарии открываются следующие возможности:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FRkcRrVqB44ReCnPY3xjF%2Fimage.png?alt=media&amp;token=7c178066-e633-48a0-9b82-381374ecb652" alt=""><figcaption></figcaption></figure>

* **Отвечать в комментариях только при упоминании** - агент будет отвечать, только если его упомянут. Также есть возможность прописать ключевые слова, по которым агент будет отвечать на комментарий.
* **Добавлять в диалог все комментарии (даже если не нужно отвечать)** - нужно, чтобы отслеживать все комментарии пользователей к посту.
* **Добавлять юзернейм и ID комментария перед сообщением** - это полезно, чтобы было удобно отслеживать, на какой комментарий агент дал ответ.
* **Отвечать в личные сообщения** - в ответ на комментарий пользователя агент будет отправлять этому пользователю сообщение в директ.
  {% endstep %}

{% step %}

### Ответы подписчикам

При отметке флага настройки **Отвечать только на личные сообщения** появится возможность давать ответы только тем, кто подписался на канал в соцсети. Для этого перетяните флаг **Отвечать только подписчикам**

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FeeZyz8Yu9deB3l6U5wow%2Fimage.png?alt=media&amp;token=74274d91-c53d-49fe-bc2a-171ce120fa8c" alt=""><figcaption></figcaption></figure>

Это возможно только в директе, поскольку клиент должен сперва сам написать сообщение, чтобы была возможность запросить информацию по нему (клиенту).
{% endstep %}
{% endstepper %}

## Отправка ответа на комментарий в директ

{% stepper %}
{% step %}

### Переходим в раздел Действия

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FXuVuRTfYSka6KbhI3UDv%2Fimage.png?alt=media&amp;token=7d4c87c2-714b-4877-a9b5-30eea486ac21" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Выбираем тип шага Instargam\*

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FdhSd7hrIrglMrtAP1s5a%2Fimage.png?alt=media&amp;token=bbd08b5b-c2d2-4cb8-b408-a92bb3d11c11" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Прописываем текст сообщения

Этот текст агент будет высылать в ответ на комментарий или реакцию клиенту в директ

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FjvAxHj5XHJWvCnNwbXoE%2Fimage.png?alt=media&amp;token=3dd16dfe-36ac-4854-ad61-5c1290e1ada1" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Настраиваем условия срабатывания

Прописываем название и описание функции

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Ffi4bU9Plnzn1X5NlOmzi%2Fimage.png?alt=media&amp;token=c5c59f13-a650-407a-9d6c-321f14be6d09" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### При желании настраиваем переменные действия

Пусть в качестве переменной будет комментарий клиента

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FUZNRSUVXbvWGbaTAt5NJ%2Fimage.png?alt=media&amp;token=f266638c-7df4-45f1-9728-aca69c8a7e07" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}

### Используем переменную в запросе, немного изменив текст сообщения

При этом не забываем добавить переменную через шестерёнку справа от поля текста, нажав на неё:

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FK4BctZDXremB2KY6JMzr%2Fimage.png?alt=media&amp;token=4c816317-1c1e-4025-bbc5-b4c0d58edf45" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Кнопки в Instagram\*

Агент может отправлять клиенту в директ сообщения с кнопками — так клиент не набирает ответ вручную, а нажимает нужный вариант.

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

Кнопки не уходят отдельным сообщением: они прикрепляются к ответу агента, который отправляется сразу после вызова функции. В переписке в кабинете Савви отправка дополнительно отмечается системным событием со списком кнопок.

Кнопки работают только в личных сообщениях (директ). К комментариям под постами кнопки не добавляются.

#### Шаг 1. Включите обработку нажатий на кнопки

В настройках канала Instagram\* активируйте флаг **«Обрабатывать нажатия на кнопки»**. Без него нажатия клиента не будут доходить до агента.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2Fu1X58u36TVBj73ReNfZC%2Fimage.png?alt=media&amp;token=52bafe2e-5e9a-4803-93b9-b9d3ba5b033c" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
Для включения этой опции требуется разрешение аккаунта на управление сообщениями — возможно, потребуется переподключить Instagram с расширенными правами.

Флаг обязателен только для кнопок типа **«Кнопка»**. Кнопки типа **«Ссылка»** работают и без него.
{% endhint %}

#### Шаг 2. Создайте действие с кнопками

1. Перейдите на вкладку **«Действия»** и нажмите **«Добавить»**.
2. Выберите тип шага **«Instagram\*»**. Процедура добавления данного действия аналогична добавлению других действий.
3. В выпадающем списке шага выберите вариант **«Отправить кнопки»**. Второй доступный вариант — «Ответить на комментарий в директ» — описан выше.
4. Заполните поле **«Текст результата»**. Это текст, который возвращается агенту после отправки кнопок, клиент его не видит. По умолчанию там стоит `Buttons were sent!`. Формулировка напрямую влияет на то, что напишет агент клиенту: от текста «Кнопки отправлены клиенту» агент пишет в чат «Я отправил вам сообщение с кнопками» — хотя кнопки прикреплены к этому же сообщению, и фраза может выглядеть странно. Полезнее заложить в поле инструкцию для агента, например: «Кнопки прикреплены к твоему следующему сообщению. Напиши короткую подводку вроде «Выберите подходящий вариант 👇». Не пиши, что отправил кнопки отдельным сообщением и не перечисляй варианты текстом».
5. В блоке **«Кнопки»** нажмите **«Добавить кнопку»**. Добавить можно от 1 до 3 кнопок — это ограничение Instagram. После третьей кнопки ссылка «Добавить кнопку» перестаёт отображаться.
6. Нажмите на иконку шестерёнки справа от кнопки — откроется окно **«Настройки кнопки»**. Иконка корзины удаляет кнопку.
7. В окне настроек задайте **тип кнопки**, её **текст** и, для типа «Ссылка», адрес в поле **«Ссылка (URL)»**.
8. На вкладке **«Условия срабатывания»** задайте название и описание функции, по которой запускается действие, и нажмите **«Сохранить»**.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FwkggpCb2b0jFt30hp1T2%2Fimage.png?alt=media&amp;token=a8bbbbde-9ecb-401c-833c-70869d8f634a" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FU2p7H64e75ASJmoWAxvv%2Fimage.png?alt=media&amp;token=bae98a5f-2afd-4881-8c93-16ece897ac78" alt=""><figcaption></figcaption></figure>

{% hint style="info" %}
В тексте кнопки и в ссылке можно использовать переменные и аргументы действия — добавляйте их через кнопку в виде шестерёнки в поле ввода. Так содержимое кнопок можно формировать динамически прямо во время диалога.
{% endhint %}

#### Как это выглядит у клиента

Клиент получает обычное сообщение агента, под которым стоят до трёх кнопок. После нажатия на кнопку типа «Кнопка» её текст появляется в переписке как сообщение самого клиента — и агент отвечает на него, как на любое другое.

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FszhOHcd29c5us5GKquaj%2Fimage.png?alt=media&amp;token=00f1cfea-bd09-4bb3-96c5-ebae0223d8e8" alt=""><figcaption><p>Отображение действия в окне Савви.</p></figcaption></figure>

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2F1pkiQIgGSgb0BTaNE5U5%2Fimage.png?alt=media&amp;token=07659fce-1b56-4efb-9d76-5021988910f7" alt=""><figcaption><p>Отображение действия в переписке клиента.</p></figcaption></figure>

#### Типы кнопок

| Тип        | Как работает                                                                                                                                                                                                       | Что требуется                                                        |
| ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------------------------------------------------------------------- |
| **Кнопка** | Обычная кнопка. Нажатие приходит в диалог как обычное сообщение клиента с текстом кнопки — агент продолжает диалог или запускает нужное действие. Подходит для быстрых ответов: «Записаться», «Позвать менеджера». | Включённый флаг «Обрабатывать нажатия на кнопки» в настройках канала |
| **Ссылка** | Кнопка, открывающая ссылку: сайт, каталог, форму записи. В ссылке можно использовать переменные и аргументы.                                                                                                       | —                                                                    |

{% hint style="warning" %}
Если в действии есть кнопки типа «Кнопка», а флаг «Обрабатывать нажатия на кнопки» выключен, Савви покажет предупреждение прямо в шаге действия.
{% endhint %}

#### Вызов кнопок в инструкции

Кнопки отправляются только тогда, когда агент вызывает функцию действия. Пропишите условие вызова в инструкции. Например, если функция называется `send_instagram_buttons`:

{% code overflow="wrap" %}

```
#РАБОТА С ФУНКЦИЯМИ
Когда клиент спрашивает про услуги и цены, вызови функцию send_instagram_buttons.
```

{% endcode %}

<figure><img src="https://1280958077-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCfQs1g1wTlkieX5CuhTI%2Fuploads%2FpnBwgT6ksjb4QC7mtyoX%2Fimage.png?alt=media&amp;token=5cedda1d-d4b5-4fad-9d13-6c4fe6175bef" alt=""><figcaption><p>Описание в Условиях срабатывания.</p></figcaption></figure>

{% hint style="info" %}
Всегда задавайте название функции так, чтобы выбранное слово или фраза описывали само действие, а описание было максимально точным. Это обеспечит стабильную работу действия.
{% endhint %}

#### Частые ошибки

**Кнопка запускает сама себя по кругу.** Нажатие приходит агенту как обычное сообщение с текстом кнопки. Если этот текст совпадает с фразой, по которой вызывается функция, агент вызовет её снова и снова отправит те же кнопки. Например, кнопка «Узнать цены» при описании функции «вызывай, когда клиент спрашивает про цены»: клиент нажимает — агент повторно шлёт кнопки и так и не отвечает по существу. Чтобы этого не было, не дублируйте в тексте кнопки фразу-триггер и добавьте в описание функции условие «не вызывай повторно, если кнопки уже отправлены в этом диалоге».

#### Ограничения

* В одном шаге — от 1 до 3 кнопок. Действие с четырьмя платформа сохранить не даст. Если вариантов больше, разбейте их на несколько действий.
* Кнопки отправляются только в директ, в комментариях они не работают.
* Канал Instagram\* должен быть подключён к тому же агенту, в котором создано действие. Иначе в шаге появится предупреждение «Исходный агент должен быть подключён к каналу для выполнения действия».
* Если в поле «Ссылка (URL)» не указать протокол, платформа подставит `http://` автоматически. Указывайте ссылку сразу с `https://`.
* Текст результата — до 2048 символов.
* Делайте подписи кнопок короткими — длинные плохо читаются в переписке.
* В тестовом чате личного кабинета кнопки не отправляются: шаг отрабатывает без ошибки и возвращает агенту текст результата, но самого сообщения с кнопками нет. Проверять кнопки нужно в реальном диалоге Instagram\*.

\*Instagram принадлежит компании Meta, признанной экстремистской организацией и запрещенной в Российской Федерации.

\*\*Facebook принадлежит компании Meta, признанной экстремистской организацией и запрещенной в Российской Федерации.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.suvvy.ai/ru/kanaly/socialnye-seti/instagram.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.