Привет, это первая часть интеграции между Getcourse и Salebot(telegram), в следующей статье рассмотрим интеграцию в обратную сторону. Для того что бы интеграция сработала нужно иметь премиум тариф на salebot.
Цены на тарифы, можно посмотреть в статье о лучших конструкторах чат-ботов.
Задача: настроить добавление пользователя в нужный блок на Salebot с помощью POST-запроса после заполнения формы на сайте, чтобы тот получил в правильном порядке заданную цепочку сообщений.
- В Salebot создаем следующую цепочку сообщений:
- Сообщение: Привет, это Алексей, вы попали в бота «Дом технаря»
- Сообщение с задержкой 15 секунд, с текстом: Спасибо, за регистрацию.
- В геткурсе необходимо создать страницу с формой сбора данных (имя и номер телефона).
- После заполнения формы пользователь должен попадать в процесс, который отправит POST-запрос в Salebot и запустит цепочку сообщений из пункта 1.
- Ссылка на форму должна высылаться пользователю в телеграм после команды “Ссылка”.
- СодержаниеНастройка Getcourse Создание доп.поля клиента salebot client _id Создание формы регистрации на Getcourse Настройка веб хука При настройке процесса по заказам: При настройке процесса по пользователям: Цепочка сообщений в salebot Первый блок Второй блок Третий блок Четвертый блок Документация Salebot: Настройка Getcourse
Первым делом нам нужно интегрировать Getcourse и salebot по ключу API, что его взять переходим по этой ссылке : http://ВАШ_АККАУНТ.getcourse.ru/saas/account/api (вместо ВАШ_АККАУНТ, вставляем название вашего аккаунта).
После того как вы перешли на страницу, вам нужно скопировать Account_name и Ваш секретный ключ:
Теперь переходим в salebot:
- Заходим в проект, настройки проекта
- Добавляем переменные проекта:
getcourse_account_name — Account name
getcourse_secret — Ваш секретный ключ
Создание доп.поля клиента salebot client _id
Переходим в Getcourse, раздел пользователи, дополнительные поля:
Нажимаем: Добавить поле, выбираем тип «Строка»
В поле «заголовок» и «название при выводе» прописываем: sb_id, описание можно добавить, можно не добавлять, нажимаем кнопку сохранить.
Проверяем, появилось ли доп.поле у пользователя:
- Создание формы регистрации на Getcourse
Для этого переходим в раздел страницы:
Создаем новую страницу или редактируем уже созданую:
Добавляем форму, переходим в настройки формы и добавляем поле пользователя:
Выбираем то поле, которое мы создали выше(sb_id), прописываем заголовок sb_id, для того что бы это поле не было видно клиентам, добавляем CSS класс элемента: hide, sb_id:
Сохраняем настройки формы, и добавляем новый блок:
Переходим в настройки этого блога и вписываем этот код:
$(document).ready(function(){
var regex = new RegExp(‘[\\?&]sid=([^&#]+)’);
var match = regex.exec(window.location.href);
if (match && match.length) {
$(‘.sb_id input’).val(decodeURIComponent(match[1]));
}
});
Сохраняем этот элемент и обновляем страницу, теперь вы можете из бота выдать ссылку клиенту с доп.параметром sid после знака вопроса:
https://testzadanie21123.getcourse.ru/page0?sid=#{client_id}, если он перейдет по ней и зарегистрируется, в доп.поле появится client_id из salebot.
Теперь можно отправлять вебхук этого пользователя из getcourse в salebot.
- Настройка веб хука
Переходим в задачи — процессы — создать процесс.
Я сделал такие настройки, когда человек заполняет форму он попадает в группу test_sale:
Переходим на вкладку «Процесс» и нажимаем добавить блок «Операция«- вызвать URL.
Вставьте метод POST
В URL вставьте адрес вебхука, который передает параметры:
При настройке процесса по заказам:
https://chatter.salebot.pro/getcourse_webhook/<Ваш токен из настроек Salebot>?client_id={object.user.sb_id}&callback_text=вписываете свое значение, например: fomenko&… —
(также рекомендуется добавить емейл &email={object.user.email})
При настройке процесса по пользователям:
https://chatter.salebot.pro/getcourse_webhook/<Ваш токен из настроек Salebot>?client_id={object.sb_id}&callback_text=вписываете свое значение, например: fomenko&…
Также рекоменду. добавить емейл &email={object.email}, для того что бы искать клиента, если он не найдет по номеру телефона или client_id
<Ваш токен из настроек Salebot> — вместо этого вставьте токен из раздела настройки в Salebot
phone – здесь подтягиваете номер телефона пользователя
client_id – здесь подтягиваете значение, которое записано в дополнительное поле в Геткурсе (в нем значение #{client_id} из Salebot)
callback_text – текст, который служит условием в зеленых или серых блоках Salebot, чтобы отправлять сообщения пользователю. Только в условии к нему добавится еще getcourse
Важно: если в переменой callback_text будет значение fomenko, то в Salebot в условии нужно прописать так: getcourse fomenko. Рассмотрим это ниже во втором блоке.
Должно получится примерно так:
https://chatter.salebot.pro/getcourse_webhook/<ВАШ ТОКЕН>?client_id={object.sb_id}&callback_text=fomenko&first_name={object.first_name}&email={object.email}
- Цепочка сообщений в salebot
Первый блок
Создаем блок «Начало диалога» — этот блок будет срабатывать когда при попадании человека в бот он нажмет «/start«.
Пишем сообщение, которое бот будет отправлять нам при входе в бот: Привет, напиши кодовое слово! (кодовое слово у нас будет «ссылка«, после этого нам будет приходить ссылка).
Второй блок
Создаем блок «Проверка условия» и в условие просписываем наше кодовое слово: «Ссылка», а в ответ бота прописываем ссылку на нашу форму https://testzadanie21123.getcourse.ru/page0?sid=#{client_id}, не забываем добавить в конце ссылки ?sid=#{client_id}, сохраняем настройки блока и переходим к 3 блоку.
Третий блок
Протягиваем стрелку от второго блока и создаем блок с сообщением: Привет, это Алексей, вы попали в бота «Дом технаря».
Переходим в настройки стрелки и ставим условие: getcourse fomenko, выбор соответствия: полное совпадение.
Когда пользователь оставит данные в нашей форме, запустится процесс на getcourse, и передаст в salebot переменную calback_text, после этого сработает условие и мы попадем в третий блок
Четвертый блок
Осталось протянуть стрелку от третьего блока к четвертому и поставить задержку в 15 сек., в четвертом блоке бот будет отвечать нам: Спасибо за регистрацию!
Таким образом мы получили данные от пользователя в getcourse и отправили вебхук в salebot, который активировал отправку смс в боте telegram.
Документация Salebot:
https://docs.salebot.pro/integracii/servisy-dlya-marketologov/getcourse#kak-dobavit-zakaz
Спасибо за просмотр, оставляйте комментарии, задавайте вопросы, а так же подписывайте на мой канал в телеграмм: https://t.me/+0FX3CId0ggQ0NDY6