JavaScript WhatsАpp API Calls Client Library#
Бета-версия
Функциональность находится в режиме бета-версии. Функции могут быть изменены, а также могут работать нестабильно. В будущем за функционал может взиматься дополнительная плата.
Подключение к функционалу можно запросить через техподдержку GREEN-API
Библиотека JavaScript WhatsАpp API Calls Client для интеграции с мессенджером WhatsApp через API сервиса green-api.com. Библиотека позволяет легко создавать JavaScript/TypeScript приложения для приема входящих звонков и создания исходящих звонков через WhatsApp. Чтобы воспользоваться библиотекой, нужно получить регистрационный токен и ID инстанса в личном кабинете. Для тестирования рекомендуем воспользоваться бесплатным тарифом "Разработчик".
API#
Документация к REST API находится по ссылке, она понадобится для работой с инстансом Green-API. API библиотеки JavaScript Whatsapp API Calls Client Library основана на WebSockets и WebRTC(Web Real-Time Communication — коммуникация в режиме реального времени) протоколе.
Плюсы использования WebRTC:
- Доступность в браузерах
- Низкая задержка (на уровне долей секунды), sub-second latency
- Контроль перегрузки (congestion control)
- Обязательное шифрование
Авторизация в личном кабинете#
Чтобы отправить сообщение или выполнить другие методы GREEN-API, инстанс должен быть в авторизованном состоянии. Для авторизации инстанса перейдите в личный кабинет и сканируйте QR-код с использованием приложения WhatsApp.
Примеры использования#
В этом разделе можно ознакомиться с созданием основного файла для интеграции голосовых вызовов WhatsApp с использованием класса GreenApiVoipClient. Обрабатывая ключевые события, такие как входящие вызовы, удаленные потоки и состояния вызовов, вы сможете эффективно управлять жизненным циклом вызовов WhatsApp в своем приложении. Этот раздел поможет вам в создании прочной основы для дальнейшей настройки клиента и интеграции дополнительных функций по мере необходимости.
- Создание HTML страницы
- Установка и импорт библиотеки
- Как выполнить инициализацию и авторизацию в клиенте
- Создание события готовности к трансляции
- Обработка состояний вызовов
- Как создать исходящий вызов
- Как обработать входящий вызов
- Как окончить или сбросить вызов
Усовершенствуйте наши примеры, добавляя элементы пользовательского интерфейса, обработку ошибок и любую другую пользовательскую логику, необходимую для создания вашего уникального сервиса.
Сборка и запуск демонстрационных клиентов#
Документация по методам сервиса GREEN-API#
Сторонние продукты#
- socket.io-client - WebSocket библиотека
- freeice - Один из бесплатных STUN/TURN сервер для WebRTC приложения
Лицензия#
Лицензировано на условиях Creative Commons Attribution-NoDerivatives 4.0 International (CC BY-ND 4.0).