Привет, мир! Меня зовут Павел, я IT инженер и руководитель службы технической поддержки.
Эта статья - финальная третья часть инструкции по внедрению коннектора WhatsApp и Telegram для Открытых линий CRM Bitrix24. С реализации коннектора вы можете ознакомиться в первой и второй частях, а в этой статье мы рассмотрим процесс настройки коннектора со стороны Bitrix24.
Деплой в продакшн
Принципиальной разницы в том, как ваше приложение будет задеплоено нет. В нашем случае, я использовал Docker и k8s для продакшн среды. Однако стоит отметить, что для работы с битриксом ваш коннектор должен быть доступен по https с валидным SSL сертификатом. Для упрощения DevOps процессов, прилагаю Dockerfile:
FROM python:3.12-slim
WORKDIR /usr/src/b24hub
ENV PYTHONDONTWRITEBYTECODE 1
ENV PYTHONUNBUFFERED 1
RUN apt-get update && apt-get install -y \
libpq-dev \
python3-dev \
default-libmysqlclient-dev \
gcc \
libmagic1 \
build-essential \
redis-server \
&& apt-get clean
RUN mkdir /usr/src/b24hub/staticfiles
RUN mkdir /usr/src/b24hub/static
RUN mkdir /usr/src/b24hub/files
RUN pip install --upgrade pip
COPY ./src/requirements.txt .
RUN pip install -r requirements.txt
RUN apt install -y netcat-traditional
COPY ./src .
RUN sed -i 's/\r$//g' /usr/src/b24hub/entrypoint.sh
RUN chmod +x /usr/src/b24hub/entrypoint.sh
ENTRYPOINT ["/usr/src/b24hub/entrypoint.sh"]Первичная настройка коннектора
Для начала создайте администратора приложения. Для этого в консоли приложения необходимо выполнить команду python manage.py createsuperuser
Переходим в админку коннектора - https://example.com/admin/.
Для начала нужно перейти в пункт Сайты и изменить example.com на ваш домен, по которому будет доступен коннектор
Далее создадим пользователя и токен, по которому Коннектор Открытых линий Bitrix24 будет свзываться с нашим порталом. Для начала создадим пользователя в Users -> Пользователи
Далее переходим в Токены аутентификации -> Токены. Создаем новый токен и выбираем нашего пользователя
В разделе Bitrix > Connectors добавьте коннектор с SVG иконкой
Bitrix > Apps - добавить приложение. Заполнить имя (waba, waweb, telegram) и выбрать домен, выберите необходимые коннекторы. После сохранения записи, необходимо скопировать Id, который отображается в списке приложений.
В Bitrix24 создайте серверное локальное API приложение (Приложения – Разработчикам – Другое – Локальное приложение) и заполните соответствующие поля (Путь вашего обработчика и Путь для первоначальной установки)
Для локального приложения необходмо настроить следующие права: crm, imopenlines, contact_center, user, messageservice, im, imconnector, disk
url установки https://example.com/api/bitrix/?api-key=XXXXXXX&app-id=YYYYYYY url обработчка https://example.com/api/bitrix/?api-key=XXXXXXX XXXXXXX - ваш токен YYYYYYY - id приложения из пред шага
"Код приложения" (client_id) и "Ключ приложения" (client_secret) копируем в Bitrix > Apps - ваше приложение. Они были выданы Битриксом в предыдущем шаге при установке локального приложения
После выполнения этих шагов, в разделе "контакт-центр" должны появиться коннекторы.
Подключение Telegram
После установки локального приложения в Битрикс, необходимо вернуться в админ. панель. Для подключения телеграм бота, создадим объект в Telegram > Telegram bots
Bot Token: API токен телеграм, выданный при регистрации бота
Bot Username: Имя пользователя тг бота (как зарегистрировано в Telegram)
Owner: аккаунт-интегратор
App Instance укажите необходимый Битрикс24
Line укажите подключенную открытую линию для Telegram
На этом подключение Telegram бота к Открытой линии завершено. Переходим к настройке WhatsApp коннектора.
Подключение WhatsApp
Создадим еще одно локальное приложение и пользователя коннектора, чтобы данные между открытыми линиями не смешивались. (Повторяем шаг Первичная настройка коннектора)
Когда новое Локальное приложение создано и подключено, в браузере переходим по адресу - https://example.com/waweb/ (где example.com - ваш домен, по которому доступен портал коннекторов). Нажимаем Добавить номер. Сканируем отобразившийся QR код в приложении WhatsApp и возвращаемся на главную. Дальнейшая настройка подключения WhatsApp будет произведена автоматически.
Завершение
На этом подключение коннекторов завершено, а вместе с тем подошла к концу моя серия статей по реализации и внедрению коннекторов Whatsapp и Telegram в Bitrix24.
Надеюсь, эта серия была полезна и помогла вам лучше понять, как интегрировать мессенджеры с CRM, автоматизировать коммуникации и сделать работу с клиентами эффективнее.
Если вы внедряете подобные решения в своих проектах - не бойтесь эксперементировать, дорабатывать и адаптировать под собственные задачи. Спасибо, что следили за серией! Впереди еще много интересных технических разборов и практических кейсов
