> For the complete documentation index, see [llms.txt](https://help.cleverapp.pro/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.cleverapp.pro/sozdanie-referalnoi-sistemy-v-telegram.md).

# Создание реферальной системы в Telegram

На платформе CleverApp можно создать бесконечную реферальную систему, сколько уровней выбрать в реферальной программе — решать вам. Для этого у нас есть специальное API для получения информации о рефералах — <https://help.cleverapp.pro/dlya-razrabotchikov/dokumentaciya-i-rabota-s-api/kontakty/referalnaya-sistema>

С помощью метода API getCountReferrals можно указать линию (параметр level) по которой считать количество рефералов.

{% hint style="info" %}
**`Вы можете:`**

* работать с любым уровнем рефереров и рефералов в режиме реального времени&#x20;
* изменить реферера даже если текущий контакт имеет своих рефералов
  {% endhint %}

### 1. `{{ getTelegramInviteLink() }}` - Реферальная ссылка контакта в Телеграм боте

Если разместить в поле для текста `{{ getTelegramInviteLink() }},` тогда в боте сформируется ссылка в формате: `https://app.cleverapp.pro/u/hcjn` с доменом CleverApp

### `{{ getDirectTelegramInviteLink() }}` - Реферальная ссылка контакта в боте Телеграм

Если разместить в поле для текста `{{ getDirectTelegramInviteLink() }},` тогда в боте сформируется ссылка в формате: `https://t.me/botvsem_bot?start=dvnka214-aa79-44f8-gj88-efg9e337160` без домена CleverApp

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

### 2. `{{ getTelegramLinkBySchema(123) }}`, где 123 - id сценария - Получить ссылку на сценарий

Особенности: Если ссылка на доп. сценарий не была создана ранее в разделе Каналы -> Telegram -> Прямые ссылки на дополнительные сценарии, то она создается автоматически

### `{{ getTelegramInviteLinkWithSchema(123) }}`, где 123 - id сценария - Получить реферальную ссылку на дополнительный сценарий

### 3. `{{ getTelegramReferrals() }}` -Получить список своих рефералов первой линии

`{{ getTelegramReferrals() }}` - Получить список рефералов первой линии контакта \
(последние 100 шт).

Получить первые 10 рефералов: `{{ getTelegramReferrals(10) }}`\
Получить первые 20 рефералов с тегом "Купил": \
`{{ getTelegramReferrals(20,  "Купил") }}`

Вывести первую линию рефералов **`{{ getTelegramReferralsByDepth(1) }}`** \
Вывести первую линию рефералов 10 шт **`{{ getTelegramReferralsByDepth(1, 10) }}`**

Вывести пятую линию рефералов 30 шт с тегом Купил" \
**`{{ getTelegramReferralsByDepth(5, 30, "Купил") }}`**

### 4. `{{ getTelegramReferralsCount() }}` - Получить количество рефералов всей сети контакта (всех уровней).

Получить количество рефералов с тегом "Купил": \
`{{ getTelegramReferralsCount("Купил") }}`

### 5. `{{ getTelegramReferralsCountByDepth() }}` - Получить количество рефералов на указанном уровне.

Получить количество рефералов 20 уровня \
`{{ getTelegramReferralsCountByDepth(20) }}`

Получить количество рефералов 5 линии, которые содержат тег «Купил»\
`{{ getTelegramReferralsCountByDepth(5, "Купил") }}`

### 6. `{{ getTelegramReferrer() }}` - Получить своего реферера

Получить своего реферера 5 уровня: `{{ getTelegramReferrer(5) }}`

{% hint style="info" %}
Кто есть кто?&#x20;

**Реферер** – тот кто пригласил в реферальную программу (пользователь стоящий выше в уровнях / папа)

**Реферал** – тот, кого пригласили в реферальную программу (пользователь стоящий ниже / сын )
{% endhint %}

**Функции, необходимо вставлять в блок цепочка сообщений:**

{{ getTelegramInviteLink() }} — Сформировать реферальную ссылку

{{ getTelegramReferrals() }} — Получить список рефералов контакта (последние 100 шт).

Получить первые 10 рефералов: {{ getTelegramReferrals(10) }}

Получить первые 20 рефералов с тегом «Купил»: {{ getTelegramReferrals(20, «Купил») }}

{{ getTelegramReferralsCount() }} — Получить количество рефералов всей сети контакта (всех уровней).

Получить количество рефералов с тегом «Купил»: {{ getTelegramReferralsCount(«Купил») }}

{{ getTelegramReferrer() }} — Получить своего реферера

Получить своего реферера 5 уровня: {{ getTelegramReferrer(5) }}, 5 — это максимум, для более высокого уровня воспользуйтесь API.

{{ getDirectTelegramInviteLink() }} – Вывести прямую реферальную ссылку (<https://t.me/bot…>)

{{ getDirectTelegramInviteLink(123) }} – Вывести прямую реферальную ссылку на указанный сценарий (id 123)

{{ getTelegramReferralsByDepth(100, 10, “ИмяТега”) }} – Получить рефералов любой линии с содержанием тега

{{ getTelegramReferralsCountByDepth(20) }} – Получить количество рефералов 20 линии

{{ getTelegramReferralsCountByDepth(5, “Купил”) }} – Получить количество рефералов 5 линии, которые содержат тег «Купил»