Бұл жазба автоматты түрде аударылған. Бастапқы тіл: Орысша
Иә, бұл тегін-енді сіз CRM Bitrix24 және WhatsApp арасында хабарламаларды қабылдау және жіберу мүмкіндігі үшін интеграциялық қызметтерге ақы төлей алмайсыз.
Сіздердің назарларыңызға менің open source жобамды ұсынуға қуаныштымын - thoth (https://github.com/vaestvita/thoth)
Интеграция ресми WhatsApp Business API (WABA)негізінде жұмыс істейді
- Сервер (LInux, Windows). Мин. 512 Мб жедел жады
- Python > 3.10
- SSL сертификаты бар домендік атау (thoth.example.kz). бұл қажет, бірақ қажет емес. Сіз thoth порталы қол жетімді болатын IP мекен жаймен шектеле аласыз
- Facebook есептік жазбасы тыйым салынбаған және бұғатталмаған
- WhatsApp-тан ажыратылған телефон нөмірі
Бірінші қадам-Сіздің серверіңізге thoth (tot) орнату.
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 арқылы жасалады, оны әкімшіге кіру үшін пайдалану керек.
Әрі қарай, Bitrix24-ті thoth-қа қосуға көшейік.
Бейне нұсқаулық - https://youtu.be/ti99AeGAr4k
Әкімшіде біз токен жасаймыз
- Сайттар бөлімінде атын өзгертіңіз example.com the thoth қол жетімді болатын домен
- Bitrix > Apps - Add App. Атауды толтыру (waba), доменді таңдау, "Connector" чекбоксын орнату, алынған Идентификаторды көшіру
- The Bitrix24 интерфейсі жоқ серверлік жергілікті қосымшаны жасаңыз (әзірлеуші қосымшалары – басқа Жергілікті бағдарлама) Bitrix24 және тиісті өрістерді толтырыңыз (өңдеуші жолы және бастапқы орнату жолы). Қажетті құқықтар (құқықтарды орнату): 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-алдыңғы қадамнан қолданба идентификаторы- "Қолданба коды "(client_id) және" Қолданба кілті " (client_secret) біз Bitrix > Apps - ке көшіреміз-сіздің қолданбаңыз. Олар жергілікті қосымшаны орнату кезінде алдыңғы қадамда Bitrix арқылы шығарылды
- Битриксте "байланыс орталығы" бөлімінде тақырыптық суреттегідей "Thoth WABA" қосқышы пайда болуы керек
Bitrix дайын, 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 - phone әкімшісінде және нөмірлерді қосыңыз (телефон нөмірі, Facebook қосымшасынан телефон идентификаторы). Бұрын жасалған waba нысанын таңдаңыз
- Таңдаңыз app instance (Bitrix порталы) оған WABA нөмірін байлаңыз
- егер бәрі ойдағыдай болса, онда Bitrix24 байланыс орталығында қосқыш жасыл түске боялады және оған ашық сызық бекітіледі
Бұл туралы бәрі!
Есіңізде болсын, WABA-ны бірінші болып қолданған кезде Сіз тек Facebook модераторлары алдын-ала мақұлдаған шаблондық хабарламалармен жаза аласыз.
Интеграцияда сәттілік, егер сізге көмек қажет болса, @antgulin жеделхатына жазыңыз
Да, именно бесплатная - теперь можно не платить сервисам интеграции за возможность приёма и отправки сообщений между 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
Бөлісу
