> For the complete documentation index, see [llms.txt](https://multyai.gitbook.io/home/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://multyai.gitbook.io/home/education/examples/parsing-ref-ssylok.md).

# Парсинг ref-ссылок

**Разделитель между ссылкой и ref-данными:**

Для ссылок ВКонтакте типа: \_<https://vk.me/club218206216_\\>
Добавляем в конце: `?ref=`

Для ссылок ВКонтакте типа: *<https://vk.com/im?sel=-218206216>* \
Добавляем в конце: `&ref=`

Для ссылок Telegram типа:  \_<https://t.me/multy\\_psyho\\_bot_\\>
Добавляем в конце: `?start=`

**Добавляем ref-данные:**

> Для Telegram в ссылке поддерживается максимум 64 символа, поэтому сперва тестируйте, и старайтесь ограничивать количество данных внутри ссылки, делать более лаконичными параметры. Например: utm\_s или s вместо utm\_source или vk вместо vkontakte и т.д.

Возьмем для примера четыре параметра:

* ref
* utm\_source
* utm\_medium
* campaign

Но вы можете использовать свои значения.

**Прописываем данные после разделителя:**

Для ввода данных мы используем знаки - и --

Знак "-" означает присваивание значения.\
Знак "--" означает разделитель между значениями.

Например:\
`ref-{var:platform.user.id}--utm_source-tg--utm_medium-mess--campaign-promo`\
Где `{var:platform.user.id}` автоматически подставляет id пользователя

**Выводим результат:**

Вывести результат можно через `{var:utm}`

Например:\
{var:utm.ref}\
{var:utm.utm\_source}\
{var:utm\_medium}\
{var:campaign}

Соответственно мы можем сохранить значения в полях профиля пользователя задав данные переменные.

**Пример итоговой ссылки:**

<https://t.me/multy\\_psyho\\_bot?start=ref-{var:platform.user.id}--utm\\_source-tg--utm\\_medium-mess--campaign-promo>

**Реакция на запуск по реферальной ссылке**

Создайте блок Событие - "Входящее сообщение" и добавьте контейнер условия "Текстовая переменная". В этом случае, чтобы человек не написал, запустится схема, которую вы соберете. Но бот будет реагировать только на параметры, которые вы укажете в текстовой переменной. Например, {var:utm.tariff} = VIP или {var:utm.utm\_source} = tg и так далее...

<figure><img src="https://2249269224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLmohxxJlESle3zPCwerN%2Fuploads%2FOx28nWj5zovE1L2Rtsu4%2Fimage.png?alt=media&amp;token=d81e3859-9a8e-4d32-b3da-cf67cdbb50a2" alt=""><figcaption></figcaption></figure>

Еще можно сделать хитрее: {var:utm.ref} не равен "undefined", тем самым, если это не реферал, то блок события реагировать не будет.

<figure><img src="https://2249269224-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLmohxxJlESle3zPCwerN%2Fuploads%2FAGnV5M4fld5NatGqTHAf%2Fimage.png?alt=media&amp;token=1dc0cafc-b38d-4295-8ca7-1998038cf41a" alt=""><figcaption></figcaption></figure>

&#x20;