Руководства → Подключить Битрикс24

Подключить Битрикс24

Оплаты будут появляться в ленте сделки сами, а новые клиенты из воронки — заводиться в KazPayment. Менеджеру больше не нужно отмечать поступления руками и переносить людей между двумя окнами.

Настройка занимает минут пятнадцать и делается один раз. Программировать ничего не нужно: всё делается кнопками в вашем портале и в кабинете.

Что получится

Оплата пришла → запись в сделке. Клиент оплатил счёт через Kaspi — в течение минуты в ленте сделки появляется «Оплата получена: 15 000 ₸» с датой и периодом. Если вы выберете стадию, сделка автоматически перейдёт на неё.

Кнопка «Принять оплату» в сделке. По желанию: KazPayment добавляется в способы оплаты Битрикса, и менеджер запускает оплату не выходя из сделки.

Сделка появилась → клиент в биллинге. Менеджер завёл сделку с контактом — у вас в KazPayment появляется плательщик с этим телефоном. Если вы выбрали тариф, ему сразу оформляется абонемент, и счета начинают выставляться сами.

Чего не происходит: мы ничего в вашей CRM не создаём, не удаляем и не переписываем. Единственное, что мы там пишем, — отметка об оплате.

Что нужно от вашего Битрикса

Платный тариф или активный пробный период. На бесплатном тарифе Битрикс24 не даёт создавать вебхуки — это его ограничение, не наше, и обойти его нельзя. Перед покупкой можно включить пробный период (15 дней): в нём всё работает, и подключение можно проверить целиком, ничего не оплачивая.

Если вы ведёте клиентов в CRM всерьёз, платный тариф у вас, скорее всего, уже есть — тогда ничего дополнительно покупать не нужно.

Шаг 1. Входящий вебхук в Битриксе

Это адрес, по которому мы будем писать в ваши сделки.

  1. В портале откройте Приложения → Разработчикам (в части версий — «Ресурсы разработчика»). Прямой адрес: ваш-портал.bitrix24.kz/devops/
  2. Вкладка «Готовые сценарии» → Другое → Входящий вебхук.
  3. В правах отметьте CRM (crm) — этого достаточно, других прав не нужно.
  4. Сохраните. Битрикс покажет адрес вида https://ваш-портал.bitrix24.kz/rest/1/xxxxxxxxxxxx/ — скопируйте его целиком.

Этот адрес — доступ к вашей CRM. Обращайтесь с ним как с паролем: не пересылайте в мессенджерах и не публикуйте. У нас он хранится зашифрованным и используется только для записи об оплате. Если адрес всё же утёк — удалите вебхук в Битриксе и создайте новый, старый перестанет работать сразу.

Шаг 2. Подключение в кабинете

  1. В кабинете KazPayment откройте Настройки → карточка Битрикс24.
  2. Вставьте скопированный адрес и нажмите Подключить.

Мы сразу проверим адрес живым запросом к вашему порталу. Если вставлена ссылка на сам портал или на страницу настроек — подключение не пройдёт, и вы увидите это сразу, а не через неделю по неотмеченным оплатам.

Шаг 3. Стадия «оплачено» (по желанию)

После подключения нажмите Выбрать стадию «оплачено» — список подтянется из вашей воронки. Выберите стадию и нажмите Сохранить стадию.

Если стадию не выбирать, мы просто напишем в ленту сделки, а двигать её не будем. Это нормальный рабочий режим: многие предпочитают, чтобы стадию менял человек.

Шаг 4. Обратное направление (по желанию)

Нужно, если вы хотите, чтобы клиенты из воронки сами появлялись в биллинге.

  1. В портале: Приложения → Разработчикам → Другое → Исходящий вебхук.
  2. События: onCrmDealAdd и onCrmDealUpdate.
  3. Адрес обработчика: https://kazpayment.kz/api/crm/bitrix24
  4. Сохраните. Битрикс сам выдаст токен приложения — скопируйте его.
  5. Вернитесь в карточку Битрикс24 в кабинете, вставьте токен в поле и нажмите Сохранить токен.

Токен придумывает сам Битрикс, вписать туда своё значение нельзя — поэтому он и переносится из портала к нам, а не наоборот.

Что произойдёт дальше: при появлении сделки мы возьмём телефон её контакта и заведём плательщика. Если в настройках выбран тариф по умолчанию, ему сразу оформится абонемент.

Повторные события безопасны. Битрикс шлёт onCrmDealUpdate на каждое касание сделки — в том числе на нашу же смену стадии. Плательщик ищется по телефону, а абонемент — по паре «плательщик и тариф», поэтому второй раз ничего не заведётся.

Ссылка на оплату в сделке

Когда клиенту выставляется счёт, мы кладём в ленту его сделки готовую ссылку: сумма, срок и адрес, по которому человек платит через Kaspi или QR любого банка. Менеджеру остаётся скопировать её и отправить клиенту в мессенджер.

Это работает всегда и ничего дополнительно настраивать не нужно. Если хочется, чтобы менеджер не копировал ссылку вообще, — см. следующий раздел.

Оплата прямо из сделки (по желанию)

Можно добавить KazPayment в способы оплаты самого Битрикса. Тогда менеджер нажимает в сделке «Принять оплату», выбирает KazPayment — и клиент попадает на страницу с Kaspi QR. Деньги пришли — оплата в Битриксе отмечается оплаченной сама, в течение минуты.

Что нужно от вебхука. Одних прав на CRM здесь мало: откройте свой входящий вебхук и добавьте ещё два — «Интернет-магазин (sale)» и «Платёжные системы (pay_system)». Без них включение не пройдёт и вы увидите отказ.

Как включить. Кабинет → Настройки → вкладка CRM → блок «Оплата прямо из сделки» → «Включить приём оплат в Битриксе». Мы заведём в вашем портале способ оплаты «KazPayment (Kaspi QR)» — и для сделок, и для смарт-счетов.

Чего мы при этом не делаем. Не трогаем ваши остальные способы оплаты, не меняем суммы и не создаём счета. Единственное, что мы пишем в оплату Битрикса, — отметку «оплачено», и только после того, как деньги подтвердила касса Kaspi.

Если в портале нет ни сделок с оплатами, ни смарт-счетов — включение честно откажет: привязывать способ оплаты не к чему. Это зависит от вашего тарифа Битрикс24, а не от нас.

Выключить можно там же. Мы уберём заведённый способ оплаты из портала; если портал в этот момент недоступен, способ останется в списке, но оплатить через него будет нельзя — уберите его в портале руками.

Как понять, что всё работает

В карточке Битрикс24 видно время последней записи в CRM и текст последней ошибки, если она была. Пустая ошибка и свежее время — всё в порядке.

Проверить целиком проще всего в тестовом режиме: отметьте начисление оплаченным в разделе «Начисления» и посмотрите ленту сделки — запись появится в течение минуты.

Если что-то не сходится

«Оплата прошла, а в сделке ничего нет». Мы ищем сделку по телефону контакта — и только среди открытых. Если все сделки контакта закрыты, писать некуда: отметка об оплате в закрытой сделке годичной давности хуже, чем её отсутствие, — менеджер поверит, что деньги пришли по ней. Заведите открытую сделку на контакт с тем же номером.

У клиента несколько открытых сделок. Мы выбираем ту, сумма которой совпала с оплатой: это самый надёжный признак «заплатили именно за это». Если совпадения нет, берём последнюю созданную. Чтобы не гадать, держите открытой одну сделку на клиента или ставьте в ней сумму, равную сумме счёта.

«Не удалось перевести сделку на стадию». Стадии больше нет в воронке или у вебхука нет прав на изменение сделок. Запись об оплате при этом уже сделана — поправьте стадию в карточке, повторно ничего дублироваться не будет.

«Подключение не проходит». Проверьте, что адрес содержит /rest/ и скопирован целиком, вместе с завершающей косой чертой, и что вебхуку выданы права на CRM.

Клиенты из воронки не появляются. Проверьте, что в исходящем вебхуке указан именно наш адрес и правильный токен, а у контакта в сделке есть казахстанский номер телефона.

Отключение

Кнопка Отключить CRM в той же карточке. Мы перестанем и писать в ваши сделки, и принимать события; сохранённый адрес вебхука перестаёт использоваться. Данные, которые уже завелись в KazPayment, остаются — это ваши плательщики и ваши абонементы.

Полностью отозвать доступ можно и со стороны Битрикса: удалите созданные вебхуки в разделе «Разработчикам».

amoCRM и другие CRM

Пока поддержан Битрикс24 — он распространённее в Казахстане, и подключение в нём делается без программиста. Если вам нужна amoCRM или другая система, напишите на support@kazpayment.kz: у нас есть открытое API, через которое интеграция пишется в один вечер, и мы подскажем, с чего начать.

Не помогло? Напишите на support@kazpayment.kz — отвечает разработчик сервиса.