Да, именно бесплатная - теперь можно не платить сервисам интеграции за возможность приёма и отправки сообщений между CRM Bitrix24 и WhatsApp.

Рад представить вашему вниманию мой open source проект - thoth (https://github.com/vaestvita/thoth)

Интеграция работает на базе официального WhatsApp Business API (WABA)

• Сервер (LInux, Windows). Мин. 512 Mb RAM
• Python > 3.10
• Доменное имя с SSL сертификатом (thoth.example.kz). Это желательно, но не обязательно. Можно ограничиться IP адресом по которому будет доступен портал thoth
• Аккаунт Facebook без банов и блокировок
• Номер телефона, отвязанный от WhatsApp

Первый делом необходимо установить thoth (тот) на ваш сервер.

cd /opt
git clone https://github.com/vaestvita/thoth
cd thoth

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements/production.txt

cp docs/example/env_example .env 
nano .env
заменить ALLOWED_HOSTS, CSRF_TRUSTED_ORIGINS на свои значения

python manage.py migrate
python manage.py collectstatic
python manage.py createsuperuser


python manage.py runserver 0.0.0.0:8000 (для тестирования и отладки)

После запуска сервера в файле .env будет создан ADMIN_URL, который необходимо исопльзовать для входа в админку.

Далее переходим к подключению вашего Битрикс24 к thoth.

Видеоинструкция - https://youtu.be/ti99AeGAr4k

В админке созадем токен

• В разделе Sites переименуйте example.com в домен по котрому будет доступен thoth
• Bitrix > Apps - Add App. Заполнить имя (waba), выбрать домен, установить чекбокс "Connector", Скопировать полученный Id
• В Битрикс24 создайте серверное локальное приложение без интерфейса (Приложения – Разработчикам – Другое – Локальное приложение) в Битрикс24 и заполните соответствующие поля (Путь вашего обработчика и Путь для первоначальной установки). Необходимые права (Настройка прав): crm, imopenlines, contact_center, user, messageservice, im, imconnector, disk.

url обработчка https://example.kz/api/bitrix/?api-key=XXXXXXX
url установки https://example.kz/api/bitrix/?api-key=XXXXXXX&app-id=YYYYYYY
XXXXXXX - ваш токен
YYYYYYY - id приложения из предыдущего шага

• "Код приложения" (client_id) и "Ключ приложения" (client_secret) копируем в Bitrix > Apps - ваше приложение. Они были выданы Битриксом в предыдущем шаге при установке локального приложения
• В битриксе в разделе "контакт-центр" должны появиться коннектор "THOTH WABA" как на заглавной картинке

Битрикс готов, переходим к настройке WABA

Видеоинструкция https://youtu.be/cSirpfq5rPQ

• Создайте приложение на портале разработчиков
• В панели подключите продукты Webhooks, WhatsApp
• В админке THOTH - WABA - Add waba (Access token - Постоянный или временный маркер, Verify token - скопируйте)
• На портале разработчиков - Quickstart > Configuration >
• Callback URL - https://example.kz/api/waba/?api-key=XXXXXXX (XXXXXXX - ваш токен thoth)
• Verify token - Verify token из предыдущего шага

• В админке thoth - waba - phones и добавляем номера (Phone - номер, Phone id - id из приложения фейсбук). Выбрать объект waba, созданный ранее
• Выбрать App instance (портал битрикс) к котрому привязать номер waba
• если все пройдет успешно, то в контакт центре Битрикс24 коннектор станет зеленым и к нему будет прикрпелена открытая линия

На этом всё!

И помните, что при использовании WABA первыми вы можете писать только шаблонными сообщениями, предварительно одобренными модераторами Facebook.

Успехов в интеграции, а если понадобится помощь пишите в телеграм @antgulin