Интеграция WhatsApp в Telegram с помощью GREEN-API#

Хотите объединить возможности WhatsApp с удобством платформы Telegram? С нашей библиотекой greenapi-integration-telegram это легко!

В этом руководстве вы создадите Telegram-бота, который будет получать сообщения из WhatsApp и позволит отвечать на них, не покидая удобный чат Telegram.

Содержание#

• Шаг 1. Подготовка WhatsApp через Green-API
• Шаг 2. Подготовка Telegram
• Шаг 3. Подготовка локального сервера
• Шаг 4. Установка Интеграции
• Шаг 5. Запуск приложения
• Шаг 6. Начало работы
• Заключение

Шаг 1. Подготовка WhatsApp через Green-API#

Чтобы воспользоваться приложением GREEN-API, нужно получить регистрационный токен и ID инстанса в личном кабинете.

1. Войдите или зарегистрируйте учетную запись в GREEN-API

2. Создайте инстанс. Для тестирования рекомендуем воспользоваться бесплатным тарифом разработчика (Developer).

   • В личном кабинете нажмите кнопку Создать инстанс и выберите тариф
   
   

3. Авторизуйте инстанс. Для этого:

   • Нажмите на кнопку Получить QR на странице настройки инстанса.
   • В мобильном приложении WhatsApp или WhatsApp Business войдите в связанные устройства и отсканируйте полученный QR-код.
   

   После успешной авторизации, инстанс должен получить статус Авторизован.
   Проверить статус инстанса вы можете используя метод GetStateInstance

4. Скопируйте значения idInstance и apiTokenInstance и сохраните их для настройки интеграции

   

Шаг 2. Подготовка Telegram#

1. Найдите в телеграм канал официального бота @BotFather с синей галочкой
2. Нажмите кнопку «Start» или отправьте команду /start
3. Отправьте команду /newbot для создания нового бота
4. Отправьте название для бота - это имя будут видеть пользователи в чате
5. Придумайте и отправьте никнейм, который должен быть уникальным и заканчиваться на bot (например, telegram_bot)
6. BotFather создаст вашего бота и пришлёт вам сообщение с токеном и ссылкой на него
7. Сохраните этот токен для настройки интеграции

Шаг 3. Подготовка локального сервера#

1. Перейдите на dashboard.ngrok.com
   Для работы с сервисом понадобится создать аккаунт.

2. В меню слева выберите раздел Setup & Installation

   

3. Скачайте подходящую версию для вашей ОС, распакуйте архив и установите содержимое

   

4. На сайте ngrok выберите раздел Your Authtoken

   

5. Скопируйте токен, указанный в верхней части экрана

   

6. Выполните в командной строке:

   ngrok config add-authtoken YOUR_AUTH_TOKEN # токен, полученный на сайте 
   

7. Запустите ngrok

   ngrok http 3000
   

8. Откроется сессия переадресации запросов с внешнего адреса. Найдите строку Forwarding (вторая снизу), сохраните этот адрес для настройки интеграции

   Forwarding  https://your-address.ngrok-free.dev -> http://localhost:3000
   

Шаг 4. Установка Интеграции#

Склонируйте или создайте проект:

mkdir greenapi-integration-telegram

Склонируйте репозиторий:

git clone https://github.com/green-api/greenapi-integration-telegram.git

Установите зависимости:

npm install

Настройте переменные окружения в файле .env:

TELEGRAM_BOT_TOKEN=your_telegram_bot_token_here # токен, полученный у BotFather
PORT=3000                                       # порт, по умолчанию 3000
WEBHOOK_URL= https://your-webhook-url/          # публичный адрес сервера для получения уведомлений

Шаг 5. Запуск приложения#

Запуск приложения производится командой:

npm start

Шаг. 6 Начало работы#

Начните диалог с ботом:

/start

Подключите инстанс Green-API для получения сообщений из WhatsApp:

/instance [idInstance] [apiTokenInstance]

• idInstance: ID вашего инстанса GREEN-API
• apiTokenInstance: API токен вашего инстанса GREEN-API

Пример:

/instance 1101111111 abcdef123456789abcdef123456789

Теперь бот будет получать и отправлять вам сообщения из WhatsApp аккаунта, подключенного к инстансу Green-API, в телеграм-чат с ботом.

Полный список команд бота

Заключение#

Следуя этим простым шагам, вы сможете создать Telegram бота, который будет получать сообщения в WhatsApp и позволит отправлять ответные сообщения.

GREEN-API всегда рад помочь вам в интеграции WhatsApp с другими платформами.