# Ошибки при работе с Битрикс24

## Ошибки при интеграции Битрикс24 и их решение

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

***

### Агент Савви отвечает только вначале диалоге

**Проблема**

Сообщение корректно доходит, Агент отвечает, но в какой-то момент перестает отвечать

**Причина**

В настройках открытой линии указан перевод на оператора через какое-то время после начала диалога.

**Решение**

Проверьте настройки Открытой линии, если стоит переводить на оператора через заданное время - поставьте значение Не переводить.

<figure><img src="/files/RFo7lNPQbJkVl7iX7Jta" alt=""><figcaption></figcaption></figure>

***

### Агент не подключен в каналы коммуникаций

**Проблема**

Интеграция подключена, но Агент не работает в нужном канале.

**Причина**

Агента не добавили в канал коммуникации в Битрикс24.

**Решение**

В Битрикс24 откройте настройки Открытой линии и убедитесь, что Агент Савви добавлен в нужный канал.

{% hint style="info" %}
Агента нужно подключать в каждой открытой линии, в которой Вы хотите, чтобы он работал.
{% endhint %}

<figure><img src="/files/AvrzeDD8C259PuLmzElu" alt=""><figcaption></figcaption></figure>

***

### Сообщения не приходят в Битрикс24

**Проблема**

Агент должен отправлять ответы, но сообщения не отображаются в Битрикс24.

Сообщения есть в мессенджере, но в Битрикс24 не появляются, не создается лид/сделка.

**Возможные причины**

* слетела интеграция канала на стороне Битрикс24;
* подключение работает некорректно.

**Решение**

Переподключите канал коммуникации на стороне Битрикса. В большинстве случаев это обновляет соединение и решает проблему. Если после переподключения сообщения все равно не приходят, проверьте настройки Открытой линии.

<figure><img src="/files/DJoQqJTvEWBgoWyrPOtT" alt=""><figcaption></figcaption></figure>

***

### Ошибка авторизации на стороне Битрикс24

**Проблема**

При подключении Битрикс24 заполняете данные для входа в Савви, страница обновляется и ничего не происходит.

<figure><img src="/files/gMKrgVaYalISKpT4yhgf" alt=""><figcaption></figcaption></figure>

**Что можно попробовать**

1. Проверьте разрешены ли в вашем браузере cookie со сторонних сайтов.

Пример настроек в браузере Google Chrome

<figure><img src="/files/PWCBm7CmcGIyqxnyDNS0" alt=""><figcaption></figcaption></figure>

2. Очистить кэш браузера.
3. Попробовать другой браузер.

***

### Устарел токен доступа

**Проблема**

Интеграция работала, но затем Агент перестал отвечать или отправлять сообщения.

**Причина**

Токен доступа мог устареть.

**Решение**

Переподключите интеграцию со стороны Савви. После переподключения будет обновлен токен доступа, и Агент сможет снова работать с Битрикс24.

1. Перезайдите в приложение на стороне Битрикса, после этого токен должен обновиться.

   <figure><img src="/files/Mz9tGRDEQjEEVOEnmcFV" alt=""><figcaption></figcaption></figure>
2. Если первый пункт не помог, то переподключите интеграцию полностью, удалите подключение Савви в Маркетплейсе (важно открыть приложение именно через поиск Маркетплейса). А затем установите снова.

<figure><img src="/files/CZeqmnzdyXwD7XEeCi31" alt=""><figcaption></figcaption></figure>

***

### Сообщения доходят в Савви, но ответ Агента не отправляется

**Проблема**

Сообщения корректно доходят из Битрикса в Савви, у нас появляется ответ Агента, но он перечеркнут и не появляется в Битрикс24.

**Причина**

* В доступе приложения указан пользователь
* У вас включен режим Co-pilot

**Решение**

1. Проверьте настройки доступа приложения в Битрикс24, найдите Савви в Маркетплейсе, откройте вкладку с Доступами. В доступе не должны быть указаны пользователи, в доступах должно быть пусто. Если у вас выбран пользователь, удалите его.

<figure><img src="/files/GQ5a4uGOXoprVJTyzCAa" alt=""><figcaption></figcaption></figure>

2. Проверьте не включен ли у вас режим co-pilot в настройках подключения Битрикс24 на стороне Савви.

<figure><img src="/files/PjgtCux8k0ZZ7gVannxF" alt=""><figcaption></figcaption></figure>

***

### Не показывается поле для заполнения

**Проблема**

Агент должен записывать данные в поля лида или сделки, но нужное поле не отображается в настройках интеграции Битрикс24

**Причина**

* Поле относится к неподдерживаемому у нас типу.

**Решение**

Проверьте к какому типу относится поле, которое вы хотите заполнять, доступные типы полей у нас:

> "string",\
> "double",\
> "integer",\
> "boolean",\
> "date",\
> "datetime"\
> "enumeration",\
> "crm\_multifield",\
> "crm\_status",\
> "file",\
> "user"

Рекомендуем использовать универсальный тип поля - Строка.

***

### Данные не записываются в поля карточки

**Проблема**

Агент должен записывать данные в поля лида или сделки, но при записи возникает ошибка

**Возможные причины**

* Диалог с Агентом в тестовом чате Савви
* Диалог с Агентом в Онлайн чате

**Решение**

1. Агент не может заполнять поля из тестового чата, так как тестовый чат не имеет доступа в Битрикс, следовательно выходит ошибка, в настоящем чате поля должны заполняться корректно.
2. Когда клиент обращается через Онлайн чат - у него нет сущности Лида или Сделки, поэтому Агент некуда заполнять поля, настройте в Онлайн чате автоматическое создание Лида.

***

### Агент не меняет статус или ответственного

**Проблема**

Агент должен менять статус, этап сделки или ответственного, но действие не выполняется.

**Возможные причины**

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

**Решение**

Проверьте автоматизации в Битрикс24 и инструкцию Агента. В инструкции должны быть четко прописаны условия: когда менять статус, на какой статус менять и в какой ситуации назначать ответственного.

Смена ответственного и движение по воронке у нас происходит с помощью действий в файлах Прямых вопросов:

1. Создайте файл в Базе знаний в Прямых вопросах.

<figure><img src="/files/cQviYN4miGPk3vu003Gf" alt=""><figcaption></figcaption></figure>

2. Во вкладке Действия в Битрикс 24, выберите нужные Вам - смена этапа в воронке, перевод диалога на оператора. При вызове этого файла будут срабатывать действия, которые Вы в нем указали.

<figure><img src="/files/Hq6xb8EtItPituaVKJik" alt=""><figcaption></figcaption></figure>

3. Теперь нужно прописать в Главной инструкции Агенту, когда вызывать этот файл, например:

`Когда клиент оставит номер телефона вызывай файл get_file_text(название вашего файла).`

<figure><img src="/files/9CquvnxPADmsaT3qVQE6" alt=""><figcaption></figcaption></figure>

***

### Агент не подхватывает старые чаты

**Проблема**

Чат был начат в Битрикс24 до подключения Агента, и Агент не реагирует на сообщения в этом диалоге.

**Причина**

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

**Решение**

Закройте старый диалог через принудительное завершение и начните новый диалог. После этого Агент должен корректно обрабатывать сообщения.

<figure><img src="/files/6y3GBoJNjfWj2gURw4VV" alt=""><figcaption></figcaption></figure>

Обращение должно быть направлено на Агента:

<figure><img src="/files/YKurvTePvFw1B8XNWJAr" alt=""><figcaption></figcaption></figure>

***

### Сообщения дублируются, расход токенов растёт

\
**Причина:**

Несколько ботов подключены к одним и тем же статусам в CRM

\
**Решение:**

Распределите статусы между ботами. Если используете подчинённых ботов (на которые переключаете вручную), выключите у них ответы (переключатель справа вверху в настройках бота)

<figure><img src="/files/bTKxSGHuPfjHqMgDJAyJ" alt=""><figcaption></figcaption></figure>

***

### Быстрый чек-лист проверки

Если интеграция работает некорректно, проверьте по порядку:

1. Канал коммуникации подключен в Битрикс24.
2. Агент добавлен в нужный канал.
3. У приложения есть нужные права.
4. В доступах не выбран пользователь.
5. Токен не устарел.
6. Интеграция не слетела на стороне Битрикс24.
7. Лид или сделка создается при обращении клиента.
8. Воронки и статусы настроены корректно.
9. В инструкции Агента прописаны нужные действия.
10. Диалог начат после подключения Агента.

Если после проверки проблема сохраняется, переподключите интеграцию и проверьте работу на новом тестовом диалоге.


---

# 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.suvvy.ai/ru/kanaly/crm-sistemy/bitriks24/oshibki-pri-rabote-s-bitriks24.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.
