# Создание реферальной системы в 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 шт с тегом Купил" \
\&#xNAN;**`{{ 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 линии, которые содержат тег «Купил»


---

# 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://help.cleverapp.pro/sozdanie-referalnoi-sistemy-v-telegram.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.