Перейти к содержанию

Настройка интеграции n8n и Telegram#

В сервисе n8n платформа GREEN-API имеет свое приложение. Сейчас мы рекомендуем использовать локальную установку n8n.

Порядок настройки интеграции:

  1. Установка nodejs
  2. Установка ngrok
  3. Создание инстанса GREEN-API
  4. Установить community node GREEN-API
  5. Примеры использования приложения GREEN-API

1. Установка nodejs#

  1. Скачайте и установите Node.js LTS
  2. Убедитесь в успешной установке – в командной строке node -v
  3. Установите n8n - в командной строке npm install n8n -g
  4. Запустить n8n – в командной строке n8n
  5. Консоль будет доступна по адресу http://localhost:5678

2. Установка ngrok#

Для работы вебхук-сервера необходимо, чтобы сервер был доступен снаружи. Для этого установим ngrok или его аналог.

  1. Скачайте и установите ngrok
  2. Запустить ngrok – в командной строке ngrok http 5678
  3. Будет получен адрес сервера в сети. Передайте его в n8n через переменную окружения WEBHOOK_URL и запустите n8n:

    • В командной строке (cmd): set WEBHOOK_URL={полученный адрес}&& n8n start
    • В PowerShell: $env:WEBHOOK_URL="{полученный адрес}"; n8n start
    • При запуске n8n через Docker или Docker Compose можно указать параметр WEBHOOK_URL={полученный адрес} в файле .env

    Запускайте n8n в том же окне терминала, в котором задана переменная WEBHOOK_URL, — в другом окне переменная не будет действовать.

3. Создание инстанса GREEN-API#

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

  1. Войдите или зарегистрируйте учетную запись в GREEN-API
  2. Создайте инстанс Telegram на бесплатном тарифе "Developer".
    Для этого в личном кабинете нажмите кнопку Создать инстанс и выберите тариф

    create-instance

    developer

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

    • Можно отсканировать QR-код на странице настройки инстанса.
      В мобильном приложении Telegram откройте раздел «Устройства» и отсканируйте QR-код, полученный по кнопке Получить QR.

      scan-qr

    • Или авторизоваться по коду авторизации.
      Запросите код методом StartAuthorization — код поступит в сервисный чат Telegram либо по SMS. Отправьте полученный код методом SendAuthorizationCode. Если аккаунт защищён паролем, укажите его в поле password.

      code

    Рекомендуем выполнять авторизацию по QR-коду. Подробнее о способах авторизации — в разделе Перед началом работы

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

  4. Скопируйте значения idInstance и apiTokenInstance для дальнейшей работы с n8n

    console

4. Установить community node GREEN-API#

Перейдите на страницу n8n по адресу http://localhost:5678.

  • В левом нижнем углу нажмите Settings и в открывшемся меню выберите пункт Community nodes (раздел Integrations).

    go-to-scenarios

  • Нажмите кнопку Install a community node.

    go-to-scenarios

  • В поле npm Package Name введите @green-api/n8n-nodes-telegram-greenapi.

  • Отметьте пункт I understand the risks of installing unverified code from a public source и нажмите кнопку Install.

    go-to-scenarios


Примеры использования приложения GREEN-API#

Как сделать эхо-бота в Telegram