> For the complete documentation index, see [llms.txt](https://docs.olchat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.olchat.io/capabilities/peredacha-parametrov-analitiki/roistat.md).

# Roistat

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

При отсутствии соответствующего опыта рекомендуем обратиться к квалифицированному подрядчику или интегратору. Это обеспечит стабильную работу виджета и корректную передачу данных аналитики.
{% endhint %}

### Настройка бота-помощника <a href="#nastroika-bota-pomoshnika" id="nastroika-bota-pomoshnika"></a>

В [Настройках коннектора](https://docs.olchat.io/ustanovka-i-nastroika/interfeisy-prilozheniya/opisanie-nastroek-konnektora) есть функционал бота-помощника, который с помощью настройки «Привязать параметр аналитики к полю CRM» позволяет передавать параметры аналитики Roistat, ClientID, UserID и т.д. в любое строковое пользовательское поле.

Для начала необходимо установить бот-помощник на линию.

<figure><img src="/files/7Dtc6C3z1T4wDuuwlGKN" alt=""><figcaption></figcaption></figure>

Затем необходимо выбрать поле для настройки «Привязать параметр аналитики к полю CRM».

Для этого необходимо создать поле заранее и в выпадающем списке выбрать то поле лида, в которое необходимо записывать параметры аналитики.

Данная настройка будет работать только в том случае, если выбрано автоматическое создание лидов или сделок в настройках линии.

{% hint style="info" %}
Выбор поля «Привязать параметр аналитики к полю CRM» может быть недоступен, если выбрано ручное создание сущности из чата в разделе Очереди в настройках Открытой линии.
{% endhint %}

### Настройка виджета

1. Зайдите в настройки коннектора.
2. В разделе «Настройка виджета на сайт» в текст приветственного сообщения добавьте идентификатор Roistat **{visit id}.**

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

{% hint style="warning" %}
Обратите внимание, что если клиент удалит параметр **{visit id}** из первого отправляемого сообщения, данные аналитики вы получить не сможете.

Для того, чтобы клиент был заинтересован в отправке сообщения с параметром **{visit id}**, вы можете проявить креативность и как-то модифицировать текст сообщения. Например, таким образом: «Здравствуйте! Мой код для получения подарка: **{visit id}**».
{% endhint %}

{% hint style="info" %}
При передаче параметров аналитики бот не ищет цифры по всем тексту - бот вытягивает цифры, которые подставились в {visit id} и записывает в поле.

В тексте приветствия не должно быть переносов сроки. Также лучше, чтобы {visit id} находился в конце текста. В ином случае бот не сможет распознать параметр аналитики и записать в поле CRM (системы управления взаимоотношениями с клиентами).
{% endhint %}

### Настройка сайта

Модифицируйте на сайте код следующим образом:

```javascript
<script>

window.roistatVisitCallback = function (visitId) {
    const b24w = setInterval(() => {
        const l = document.querySelector('[data-b24-crm-button-widget=openline_olchat_wa_connector_2]');
        if (l !== null) {
            clearInterval(b24w);
            l.href = l.href.replace(/\{visit id\}/, visitId);
        }
    }, 250);
}

/* КОД ВИДЖЕТА БИТРИКС24 */

/* КОД АНАЛИТИКИ ROISTAT */

</script>
```


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.olchat.io/capabilities/peredacha-parametrov-analitiki/roistat.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.