Добро пожаловать!
Справочный центр платформы
Спасибо, что выбрали LEADTEX.
Задайте свой вопрос и оставьте контакты для связи.
Быстрый старт
Это видео поможет вам быстро понять основы работы с платформой LeadTex
Часто задаваемые вопросы
Как рекламировать чат-бот в рекламных каналах, где запрещён редирект, таких как Google.Adwords, Instagram, MyTarget, VK?
Перейдите по своей ссылке, и скопируйте конечную ссылку из адресной строки браузера после редиректа.
Либо в разделе Опубликовать -> Подготовленные сообщения для WhatsApp кликните на редактирование подготовленного сообщения и поставьте галочку Использовать промежуточную страницу LeadTex
Блокируются ли ссылки на телеграмм в РФ?
Нет, не блокируются
Можно ли установить WhatsApp на городской телефон?
Да, можно
Нужно ли иметь отдельный WhatsApp для хранения чат-бота?
Обслуживание устройства с чат-ботом и номера мы берём на себя
Сколько сообщений выдерживает чат-бот WhatsApp?
Чат-бот способен выдержать 5000 сообщений в сутки
Как подставить Имя клиента в сообщение?
Добавьте в текст: {{name}}
Как подставить номер телефона клиента в сообщение?
Добавьте в текст: {{phone}}
Как подставить id клиента в сообщение?
Добавьте в текст: {{id}}
Как подставить пользовательскую переменную в сообщение?
Добавьте в текст: {{$ИмяПеременной}}
Какой максимальный размер файла можно загрузить в сообщение?
200 МБ для загрузки в конструктор
Для каждого мессенджера свои ограничения, если файл превышает норму он отправится в виде ссылки.
  • 64 МБ для отправки в WhatsApp
  • 50 МБ для отправки в Telegram
  • 50 МБ для отправки в Viber
  • 50 МБ для отправки в ICQ
Как перезагрузить бота к началу диалога?
Для Telegram, ICQ - /start

Для остальных мессенджеров команда из 3 нулей - 000
Какие форматы картинок можно прикреплять к сообщению?
jpeg, jpg, png, gif
Какие форматы видео можно прикреплять к сообщению?
mp4, mpeg, mov, webm, ogv, 3gp
Какие форматы файлов можно прикреплять к сообщению?
doc, dot, docx, xls, xlsx, ppt, pptx, pdf, odt, zip, psd, vcard, vcf
Сколько файлов можно прикрепить к сообщению?
10 файлов
Какие форматы аудио можно прикреплять к сообщению?
mp3, wav, ogg
Куда передаются данные из пользовательских переменных?
Они сохраняются до тех пор пока не создастся заявка и отправится уведомление, в котором они будут указаны
Куда могут отправляться уведомления о заявках?
Почта, WhatsApp, Telegram, amoCRM, Bitrix24, SamoTourAgent, внешние скрипты через http запросы
Полезные видео
Как создать интернет-магазин в Telegram всего за час
Больше обучающих видео на нашем YouTube канале
Автоподстановка
Все подстановки в текст должны быть обвернуты в двойные фигурные скобки.
Константы
Константа - постоянное значение, которое можно подставить в текст сообщения бота. Просто добавьте в текст {{имя}}, где имя - имя константы, см. ниже.

{{name}} - Подставить имя клиента в сообщение

{{phone}} - Подставить номер телефона клиента в сообщение

Свои константы вы можете создать в разделе Ваш бот > Списки > Переменные
Пользовательские переменные
Пользовательская переменная - переменное значение, которое заполняется пользователем. Переменные вы можете создать в окне редактирования блока сценария.

{{$ИмяПеременной}} - Подставить пользовательскую переменную в сообщение

Системные функции
Функция - подпрограмма, которую можно вызвать. Результат выполнения функции подставляется в сообщение от бота. В функцию можно передать аргументы (параметры), от которых зависит результат выполнения функции.
Арифметические операции
{{ sum(1, 2) }} - Сумма чисел
Сумма пользовательских переменных: {{ sum($переменная1, $переменная2) }}
Сумма нескольких значений: {{ sum($переменная1, 1, 2) }}
Псевдоним функции: {{ сумма(1, 2) }}

{{ diff(4, 2) }} - Разность чисел
Разность пользовательских переменных: {{ diff($переменная1, $переменная2) }}
Разность нескольких значений: {{ diff($переменная1, 1, 2) }}
Псевдоним функции: {{ разность(4, 2) }}

{{ multiplication(2, 2) }} - Произведение чисел
Произведение пользовательских переменных: {{ multiplication($переменная1, $переменная2) }}
Произведение нескольких значений: {{ multiplication($переменная1, 1, 2) }}
Псевдоним функции: {{ произведение(2, 2) }}

{{ div(4, 2) }} - Деление чисел

Деление пользовательских переменных: {{ div($переменная1, $переменная2) }}
Деление нескольких значений: {{ div($переменная1, 4, 2) }}
Псевдоним функции: {{ деление(4, 2) }}

{{ setSumVariablesIntoVariable("сумма", "а", "б") }} - Записать сумму переменных/чисел в переменную
В переменную $cумма запишется сумма переменных и . В функцию передаются имена переменных в двойных кавычках или числа. Количество аргументов для передачи в функцию может быть до 100 шт.

{{ setMultiplicationVariablesIntoVariable("произведение", "а", "б") }} - Записать произведение переменных/чисел в переменную
В переменную $произведение запишется произведение переменных и . В функцию передаются имена переменных в двойных кавычках или числа. Количество аргументов для передачи в функцию может быть до 100 шт.


Генератор случайных чисел и строк
{{ rand() }} - Сгенерировать случайное число
Сгенерировать случайное число от 5 до 100: {{ rand(5, 100) }}

{{ strRandom() }} - Сгенерировать случайную строку
Сгенерировать случайную строку длинной 20 символов: {{ strRandom(20) }}
Сгенерировать случайную строку длинной 20 символов заглавными буквами: {{ strRandom(20, true) }}


Сообщение для определенного мессенджера
{{ messageToTelegram("Сообщение") }} - Сообщение в Telegram
Пример: {{ messageToTelegram("Это сообщение отобразится только в Telegram") }}

{{ messageToViber("Сообщение") }} - Сообщение в Viber
Пример: {{ messageToViber("Это сообщение отобразится только в Viber") }}

{{ messageToWhatsApp("Сообщение") }} - Сообщение в WhatsApp
Пример: {{ messageToWhatsApp("Это сообщение отобразится только в WhatsApp") }}

{{ messageToFacebook("Сообщение") }} - Сообщение в Facebook
Пример: {{ messageToFacebook("Это сообщение отобразится только в Facebook") }}

{{ messageToIcq("Сообщение") }} - Сообщение в ICQ
Пример: {{ messageToIcq("Это сообщение отобразится только в ICQ") }}


Счета
{{ getBalance("Код валюты") }} - Получить баланс контакта
В рублях: {{ getBalance("RUB") }}
В долларах: {{ getBalance("USD") }}
Реферальная система Telegram
{{ getTelegramInviteLink() }} - Реферальная ссылка контакта в телеграм боте

{{ getTelegramReferrals() }} - Получить список рефералов контакта (последние 100 шт).
Получить первые 10 рефералов: {{ getTelegramReferrals(10) }} Получить первые 20 рефералов с тегом "Купил": {{ getTelegramReferrals(20, "Купил") }}

Результат выполнения этой функции сохраняется на 10 минут в кеш, т.е. получить вычисление по новым данным возможно через 10 минут.

{{ getTelegramReferralsCount() }} - Получить количество рефералов всей сети контакта (всех уровней).
Получить количество рефералов с тегом "Купил": {{ getTelegramReferralsCount("Купил") }}

Результат выполнения этой функции сохраняется на 10 минут в кеш, т.е. получить вычисление по новым данным возможно через 10 минут.

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

Результат выполнения этой функции сохраняется на 10 минут в кеш, т.е. получить вычисление по новым данным возможно через 10 минут.

Валидация
Для блоков "Цепочка" и "Простое сообщение"
Валидация - проверка введенных данных пользователя на соответствии указанному формату. Если валидация считается не пройденной, клиенту возвращается сообщение об ошибке с просьбой повторить введение данных в корректном формате. Валидация активируется когда нет совпадений по пунктам меню.
На данный момент поддерживаются следующие типы валидации:
  • Текст - любой текст
  • Цифры - только цифры
  • Буквы - только буквы
  • Буквы и цифры - только буквы и цифры
  • Диапазон чисел - диапазон чисел в рамках указанных значений
  • Дата и время - дата и время по заданному шаблону
  • Номер телефона - номер телефона в международном формате
  • Email - адрес электронной почты
  • URL - ссылка на сайт или его страницу
  • Регулярное выражение - этот тип валидации для профессионалов, который позволяет проверить любой формат введенных данных. Для его настройки попросите знакомого программиста помочь вам или обратитесь в службу поддержки. Пример регулярного выражения для проверки на число: ^\d+$
Ограничение по количеству символов
Собственное сообщение об ошибке
Сообщение об ошибке формируется системой в соответствии типу валидации. Так же имеется возможность задать свое собственное сообщение об ошибке.
Блоки
Блок для разветвления сценария по условию
Блок Условие
Разветвление сценария по условию
Блок условие можно создать в сценарии кликнув на плюсик связи. На выходе блока вы можете видеть два пункта меню "Да", "Нет", они обозначают куда направится пользователь при выполнении или не выполнении условия
На данный момент доступны следующие типы условий:
  • Контакт содержит теги
  • Контакт не содержит теги
  • Сообщение содержит текст
  • Сообщение совпадает с
Можно задать несколько условий одновременно и настроить тип их обработки:
  • Выполняются все условия одновременно
  • Выполняется хотя бы одно из условий


Блок HTTP-запрос
Шаг №1 - Создание блока HTTP-запрос



Шаг №2 - Настройка
Укажите тип запроса и ваш URL для обработки запроса. На данный момент поддерживаются методы GET и POST.
Чтение записей из списка
Данный блок позволяет боту отправлять клиенту записи из списка. Для этого в разделе Сценарий нажмите Создать блок и во вкладке Эксперт выберите соответствующий блок.
Вы можете указать поле для поиска, по которому будет производится поиск по любой другой фразе из предыдущего блока.
Каждая запись отправляется отдельным сообщением последовательно, кроме того, картинка или файл приходят так же отдельным сообщением. Текстовое сообщение настраивается в виде шаблона, в котором поля списка прописываются в виде переменных, просто нажмите на кнопку ниже с именем нужного поля и оно вставится в текст.
Когда записей много, вы можете включить постраничную навигацию и настроить количество записей для отправки клиенту. Так же вы можете задать произвольный шаблон для выбора страницы, где {n} обозначает номер страницы. Например клиент отправляет боту команду «Страница 2» и бот в ответ присылает еще 10 записей со второй страницы списка.
Для настройки сортировки списка вы можете добавить необходимые поля:
Для установки дополнительных условий выборки данных из списка добавили раздел Дополнительные фильтры.
Чтение списка из Клиентской Базы
Шаг №1 - Создание блока Чтение списка из Клиентской Базы
Шаг №2 - Настройка
Выберите таблицу из которой будут выводится данные. Так же вы можете задать текста, которые вставятся перед и после сформированного списка.
Поля для формирования списка записей
Настройте необходимые поля для отображения в сообщении бота. Так же вы можете указать постфикс, который добавится после значения поля. Для каждого элемента поля возможно указать стиль шрифта. Каждое поле можно перетаскивать мышкой для того чтобы изменить порядок.
Фильтры для выборки данных
Настройка сортировки записей
Настройки
Чтение записи
из Клиентской Базы
Шаг №1 - Создание блока Чтение записи из Клиентской Базы
Шаг №2 - Настройка
Выберите таблицу из которой будут выводится данные. Так же вы можете задать текста, которые вставятся перед и после сформированного списка.
Поля для формирования списка записей
Настройте необходимые поля для отображения в сообщении бота. Так же вы можете указать постфикс, который добавится после значения поля. Для каждого элемента поля возможно указать стиль шрифта. Каждое поле можно перетаскивать мышкой для того чтобы изменить порядок.
Настройка сортировки записей
Переменные полей
Вы можете указать поля которые запишутся в переменные и отправятся в заявку.
Пополнение баланса ваших клиентов для совершения будущих покупок в боте
1. Пополнение баланса
Создайте блок оплата Яндекс.Касса, откройте его настройки и поставьте галочку «Зачислять деньги на счет пользователя».

Теперь средства будут зачислятся на счет пользователя. Впервую очередь для него будет создан счет в той валюте, которую вы настроили для платежной системы. Список счетов можно посмотреть в разделе: Ваш бот > Списки > Контакты > Необходимый Контакт
2. Списание средств (покупка)
На данный момент списывать средства возможно только через API. Подробнее по клику
Текущие возможности API:
  1. Получение списка счетов.
  2. Создание счета по коду валюты ISO 4217
  3. Удаление счета
  4. Пополнение счета
  5. Списание средств со счета
3. Отображение баланса
Для отображение баланса клиента добавьте в сообщение бота вызов функции: {{ getBalance("USD") }}, где USD - код валюты.
Платежи в ботах
Прием платежей в ботах WhatsApp, Viber, Telegram, ICQ
Общая схема
Чтобы принимать платежи в ботах нужно в разделе Настройки -> Интеграции подключить платежную систему Яндекс.Касса.
Заполните соответствующие поля во вкладке Основное и нажмите кнопку Сохранить, после чего система сгенерирует webhook (ссылку), который нужно скопировать и сохранить в личном кабинете сервиса Яндекс.Касса в настройках в поле URL для уведомлений.
Во вкладке Оповещения вы можете указать URL для уведомлений (только https), на который будет приходить информация о платежах. Ответ должен содержать код состояния 200. В случае ошибки, система будет пытаться доставить уведомление в течение суток, постепенно увеличивая интервал между запросами.
О каких статусах вы будете получать уведомления:
  • pending - платеж создан, но не завершен.
  • waiting_for_capture - платеж выполнен и ожидает подтверждения.
  • succeeded - платеж успешно завершен.
  • canceled - платеж отменен.

Пример оповещения для статуса pending. Платеж на 900 руб.
Настройка приема платежей в Телеграм
Для Телеграм вы можете подключить встроенные платежи, для этого в разделе Опубликовать -> Telegram добавьте платежный токен, выданный ботом

Вы можете указать URL для уведомлений (только https), на который будет приходить информация о платежах. Ответ должен содержать код состояния 200. В случае ошибки, система будет пытаться доставить уведомление в течение суток, постепенно увеличивая интервал между запросами.

О каких статусах вы будете получать уведомления:
  • pending - платеж создан, но не завершен.
  • pre_checkout_query - система готова принять платеж.
  • succeeded - платеж успешно завершен.
  • canceled - платеж отменен.
Создание авторассылки
Инструкция для создания авторассылок
Шаг №1 - Открыть интерфейс авторассылок
Выберите вашего бота, затем в левом меню выберите пункт Авторассылки
Шаг №2 - Настройка авторассылки
Создайте авторассылку
Шаг №3 - Добавление шагов авторассылки
Шаг №4 - Запуск авторассылки
Кнопка запуска находится во вкладке Настройки
Рассылка клиентам Битрикс24
Инструкция для создания авторассылок
1. Выбор воронки
Откройте личный кабинет, перейдите в вашего бота в раздел Авторассылки, выберите существующую рассылку или создайте новую. Далее кликните на кнопку Добавить указанную на рисунке ниже.
2. Выбор этапов
Выберите нужные этапы и сохраните рассылку. Готово!
Получение заявок с другого email
Получение заявок с другого email
Эта настройка позволяет получать заявки на email от другого (небрендированного) домена без упоминания Leadteh.
Для этого откройте настройки вашего бота, перейдите в раздел Дополнительно, установите необходимый флажок и сохраните настройки.
Интеграция Битрикс24
1. Создание ключа доступа
Войдите в свой личный кабинет Битрикс24, затем перейдите в раздел Приложения, далее откройте вкладку Вебхуки и нажмите конпку Добавить вебхук > Входящие вебхук.
Выберите права доступа: CRM, Пользователи и нажмите Сохранить.
2. Настройки интеграции
Откройте личный кабинет, перейдите в вашего бота в раздел Настройки > Интеграции > Битрикс24
3. Сохранение
Нажмите Сохранить, и перейдите на вкладку Статус, нажмите иконку обновления статуса
Интеграция amoCRM
1. Установка виджета в amoCRM
Откройте свой личный кабинет amoCRM, затем перейдите в раздел Настройки > Интеграции и установите виджет LEADTEX (в разделе Онлайн чаты).
2. Настройка интеграции
Откройте свой личный кабинет Leadteh, выберите нужного бота и перейдите в раздел Настройки > Интеграции, выберите amoCRM и введите свои данные.
3. Воронка, этап, ответственный
Перейдите на вкладку Дополнительно на которой вы сможете выбрать ответственного для новых сделок, а также указать воронку и этап, куда будут попадать новые сделки.
При создании сделок вы можете настроить создание задач. Задачи назначаются на ответственного за сделку.
Так же вы можете настроить создание сделок при каждой заявке клиента в LeadTeh.
4. Отключение бота
Если вы хотите использовать виджет amoCRM только для переписки с клиентами, отключите бота в настройках, в разделе Дополнительно.
Интеграция с Клиентской Базой
1. Настройка интеграции
Откройте свой личный кабинет LeadTeh, выберите нужного бота и перейдите в раздел Настройки > Интеграции, выберите Клиентская База и введите свои данные
2. Настройка таблиц
Далее необходимо настроить таблицы куда будут записываться клиенты, переписка и сделки.
Таблица для контактов
Для таблицы контактов доступны следующие соотношения полей:
  • Имя контакта
  • Телефон
  • Текст (произвольный текст)
  • Мессенджер
  • Telegram Username
Отправить сообщение
Этот метод позволяет отправить сообщение по ID контакта.
https://app.leadteh.ru/api/v1/sendMessage
POST
Request
Query Parameters
Response
  • 200: OK
Сообщение успешно отправлено.
  • 403: Forbidden
Доступ запрещен.
  • 422: Unprocessable Entity
Переданные данные некорректны.
  • 429: Too Many Requests
Превышен лимит отправки сообщений.
  • 501: Not Implemented
Отправка для мессенджера еще контакта не реализована.
Отправить сообщение по внешнему ID




Этот метод позволяет отправить сообщение по номеру телефона или по внешнему ID контакта в мессенджере или социальной сети.
https://app.leadteh.ru/api/v1/sendMessage
POST
Request
Query Parameters
Response
  • 200: OK
Сообщение успешно отправлено.
  • 403: Forbidden
Доступ запрещен.
  • 422: Unprocessable Entity
Переданные данные некорректны.
  • 429: Too Many Requests
Превышен лимит отправки сообщений.
Поле messenger может принимать следующие значения:

whatsapp
telegram
viber
icq

В поле contact_external_id можно передавать номер телефона не только для мессенджера WhatsApp но и для других, если к контакту привязан номер. Привязка номера может произойти при первом платеже вашего клиента.
Отправить сообщение в WhatsApp
Этот метод позволяет отправить сообщение на WhatsApp по номеру телефона
https://app.leadteh.ru/api/v1/sendMessageToWhatsApp
POST
Request
Query Parameters
Response
  • 200: OK
Сообщение успешно отправлено.
Ограничение: не больше 1-го сообщения в секунду.
Счета
С помощью представленных методов вы можете создавать счета для ваших контактов в рамках ISO 4217, а так же проводить операции по ним - начисление/списание
Этот метод позволяет получить список счетов указанного контакта.


https://app.leadteh.ru/api/v1/getContactAccounts
GET
Request
Query Parameters
  • Response
  • 200: OK
Этот метод позволяет создать счет для указанного контакта.



https://app.leadteh.ru/api/v1/addContactAccount
POST
Request
Form Data Parameters
Response
  • 201: Created
Счет успешно создан
  • 422: Unprocessable Entity
Аккаунт уже существует.
Этот метод позволяет удалить счет контакта.


https://app.leadteh.ru/api/v1/deleteContactAccount
POST
Request
Form Data Parameters
Response
  • 204: No Content
Счет успешно создан
  • 422: Unprocessable Entity
Счет не может быть удален, т.к. имеет положительный баланс.
Этот метод позволяет зачислить средства на счет контакта.

https://app.leadteh.ru/api/v1/addFundsToContactAccount
POST
Request
Form Data Parameters
Response
  • 200: OK
Счет успешно пополнен
Этот метод позволяет зачислить средства на счет контакта.

https://app.leadteh.ru/api/v1/withdrawFundsFromContactAccount
POST
Request
Form Data Parameters
Response
  • 200: OK
Сумма успешно списана
  • 422: Unprocessable Entity
Недостаточно средств для списания.
Основы
Для доступа к API необходимо подключить соответствующий тарифный план.
В каждом запросе API необходимо отправлять токен в GET-параметре api_token.Токен вы можете получить в разделе https://app.leadteh.ru/settings.
Так же необходимо передавать следующий заголовок:
Лимиты
К API сервиса LeadTeh разрешено делать не более 2 запросов в секунду (120 запросов в минуту). Иначе API будет возвращать ошибку 429 Too Many Requests Так же на некоторые методы могут накладываться свои ограничения.

ID Бота
В некоторых методах API необходимо отправлять ID бота, на рисунке изображено где его найти.
ID Бота = 13
НАШИ
КОНТАКТЫ
+7 (911) 788-42-02
kasyanov@leadteh.ru

199178, Россия, г. Санкт-Петербург, 13-я линия В.О., д. 78 литера А, помещ. 1-н офис 430

ООО "Лид Технологии"
ИНН 7801698911, КПП 780101001
Оставьте Вашу заявку на консультацию
И мы бесплатно ответим на Ваши вопросы