Как получить номер телефона из Telegram в n8n: Полное руководство

В n8n для получения номера телефона из Telegram необходимо использовать правильную комбинацию нод Telegram Trigger и Wait for Webhook, настроив их на обработку callback-запросов при отправке контакта. Ключевая проблема заключается в том, что Telegram отправляет callback-запрос немедленно при нажатии кнопки “Поделиться номером”, и n8n должна быть настроена на его обработку, а не на ожидание обычного сообщения.

Содержание

• Основной подход к получению номера телефона
• Настройка Telegram Trigger
• Использование Wait for Webhook
• Обработка callback-запросов
• Полный пример workflow
• Распространенные проблемы
• Альтернативные методы

Основной подход к получению номера телефона

Для получения номера телефона из Telegram в n8n нужно понимать механизм работы кнопок с request_number. Когда пользователь нажимает “Поделиться номером”, Telegram отправляет callback-запрос, а не обычное сообщение. Поэтому стандартный Telegram Trigger не сработает должным образом.

Правильный подход включает:

1. Использование Telegram Trigger с настроенным прослушиванием callback-запросов
2. Настройку Wait for Webhook для ожидания ответа от Telegram
3. Обработку полученного callback-запроса и извлечение номера телефона
4. Сохранение номера в нужном формате

Важно: При настройке request_number=true в inline-клавиатуре, Telegram отправляет callback_query, который содержит информацию о нажатии кнопки, но не сам номер телефона. Номер телефона нужно запрашивать отдельно после получения callback.

Настройка Telegram Trigger

Для proper настройки получения номеров телефонов в n8n выполните следующие шаги:

1. Добавьте ноду Telegram Trigger на canvas

2. В настройках ноды выберите операцию “On Trigger”

3. В разделе “Choose Trigger” установите:

   • Bot Token (ваш токен Telegram бота)
   • Trigger Type: “Callback Query”
   • Webhook URL: ваш локальный URL для приема webhook (например, http://localhost:5678/webhook/telegram)

4. В настройках Security:

   • Установите флажок “Validate Certificate”
   • В поле “Secret” укажите секретный ключ для подписи webhook

{
  "operation": "onTrigger",
  "parameters": {
    "botToken": "ваш_токен_бота",
    "webhookUrl": "http://localhost:5678/webhook/telegram",
    "secret": "ваш_секретный_ключ",
    "validateCertificate": true
  }
}

Использование Wait for Webhook

После получения callback-запроса необходимо дождаться ответа от Telegram с номером телефона:

1. Добавьте ноду Wait for Webhook после Telegram Trigger

2. Настройте ее параметры:

   • Webhook Name: telegram_phone_response (уникальное имя)
   • Timeout: 30000 (30 секунд)
   • Continue On Timeout: false

3. В разделе “Response Type” выберите “JSON”

4. В настройках “Response Mapping” укажите путь к данным номера телефона

{
  "operation": "waitForWebhook",
  "parameters": {
    "webhookName": "telegram_phone_response",
    "timeout": 30000,
    "continueOnTimeout": false,
    "responseType": "json",
    "responseMapping": {
      "phoneNumber": "$.data.contact.phone_number"
    }
  }
}

Обработка callback-запросов

При получении callback-запроса от Telegram, содержащего информацию о нажатии кнопки “Поделиться номером”, необходимо:

1. Идентифицировать callback: В данных callback_query будет поле data, содержащее информацию о нажатой кнопке
2. Отправить запрос на получение контакта: Используйте метод getContact Telegram API
3. Обработать полученный контакт: Извлеките номер телефона из объекта контакта

Пример обработки в Set node:

{
  "operation": "set",
  "parameters": {
    "values": {
      "callbackId": "={{ $json.callback_query.id }}",
      "chatId": "={{ $json.callback_query.message.chat.id }}",
      "buttonData": "={{ $json.callback_query.data }}",
      "requestContact": "={{ $json.callback_query.data.includes('request_contact') }}"
    }
  }
}

Затем используйте ноду HTTP Request для вызова метода Telegram API:

{
  "operation": "httpRequest",
  "parameters": {
    "url": "https://api.telegram.org/bot{{ $credentials.telegramBotToken }}/getContact",
    "method": "POST",
    "headers": {
      "Content-Type": "application/json"
    },
    "body": {
      "chat_id": "={{ $json.chatId }}",
      "user_id": "={{ $json.callback_query.from.id }}"
    }
  }
}

Полный пример workflow

Вот полный пример workflow для получения номера телефона:

1. Telegram Trigger (настроен на callback_query)
2. Set (извлечение данных из callback)
3. HTTP Request (получение контакта через Telegram API)
4. Set (сохранение номера телефона)
5. HTTP Response (отправка ответа пользователю)

graph TD
    A[Telegram Trigger] --> B[Set - Извлечение данных]
    B --> C{Есть callback?}
    C -->|Да| D[HTTP Request - getContact]
    C -->|Нет| E[Ожидание ответа]
    D --> F[Set - Сохранение номера]
    F --> G[HTTP Response - Подтверждение]
    G --> A

Шаги настройки:

1. Telegram Trigger

   • Bot Token: ваш токен
   • Trigger Type: Callback Query
   • Webhook URL: ваш локальный URL

2. Set Node 1

   json

   {
     "callbackId": "={{ $json.callback_query.id }}",
     "chatId": "={{ $json.callback_query.message.chat.id }}",
     "buttonData": "={{ $json.callback_query.data }}"
   }
   

3. HTTP Request Node

   json

   {
     "url": "https://api.telegram.org/bot{{ $credentials.telegramBotToken }}/getChat",
     "method": "POST",
     "body": {
       "chat_id": "={{ $json.chatId }}",
       "user_id": "={{ $json.callback_query.from.id }}"
     }
   }
   

4. Set Node 2

   json

   {
     "phoneNumber": "={{ $json.result.contact.phone_number }}",
     "firstName": "={{ $json.result.contact.first_name }}",
     "lastName": "={{ $json.result.contact.last_name }}"
   }
   

5. HTTP Response Node

   json

   {
     "callbackQueryId": "={{ $json.callbackId }}",
     "text": "Спасибо! Ваш номер телефона сохранен."
   }
   

Распространенные проблемы

Проблема 1: Process завершается до получения номера

Решение: Используйте Wait for Webhook с правильной настройкой callback. Убедитесь, что ваш Telegram Trigger настроен на прием callback_query, а не обычных сообщений.

Проблема 2: Wait возвращает старый ответ

Решение: Настройте Wait for Webhook для конкретного callback, используя уникальный webhook name в каждом запросе.

Проблема 3: Multiple triggers не работают

Решение: Из документации n8n известно, что из-за ограничений Telegram API можно использовать только один Telegram Trigger для каждого бота одновременно. Используйте один trigger с различными типами обработок.

Проблема 4: Номер телефона не извлекается

Решение: Проверьте структуру ответа Telegram API. Номер телефона обычно находится в $json.result.contact.phone_number при использовании метода getChat.

Альтернативные методы

Метод 1: Использование Contact Sharing

Если стандартный метод не работает, можно использовать встроенную функцию обмена контактами:

1. Создайте inline-клавиатуру с кнопкой “Поделиться контактом”
2. В настройках кнопки установите request_contact: true
3. Настройте Telegram Trigger на прием сообщений с контактами

{
  "inline_keyboard": [
    [
      {
        "text": "Поделиться номером",
        "request_contact": true,
        "callback_data": "share_contact"
      }
    ]
  ]
}

Метод 2: Использование Custom Forms

Как указано в документации n8n, можно использовать custom forms:

1. Создайте форму с полем для ввода номера телефона
2. Используйте Telegram Trigger для приема сообщений
3. Валидируйте формат номера телефона в n8n

Метод 3: HTTP Request + Telegram API

Для более сложных сценариев можно использовать прямой вызов Telegram API через HTTP Request ноду:

{
  "operation": "httpRequest",
  "parameters": {
    "url": "https://api.telegram.org/bot{{ $credentials.telegramBotToken }}/sendMessage",
    "method": "POST",
    "body": {
      "chat_id": "={{ $json.chat_id }}",
      "text": "Пожалуйста, поделитесь вашим номером телефона",
      "reply_markup": {
        "keyboard": [
          [
            {
              "text": "Поделиться номером",
              "request_contact": true
            }
          ]
        ],
        "one_time_keyboard": true,
        "resize_keyboard": true
      }
    }
  }
}

Заключение

Получение номеров телефонов из Telegram в n8n требует правильной настройки обработки callback-запросов. Ключевые моменты:

1. Используйте правильный Trigger: Настройте Telegram Trigger на прием callback_query, а не обычных сообщений
2. Обрабатывайте callback немедленно: Когда пользователь нажимает “Поделиться номером”, Telegram отправляет callback, который нужно обработать сразу
3. Используйте Wait for Webhook: Для ожидания ответа с контактными данными
4. Обрабатывайте данные правильно: Извлекайте номер телефона из полученного ответа Telegram API
5. Учитывайте ограничения API: Помните, что можно использовать только один Telegram Trigger на бота

Для локального обучения убедитесь, что ваш n8n сервер доступен из интернета или использует ngrok для создания публичного URL для webhook. Это позволит Telegram отправлять callback-запросы в ваш локальный n8n экземпляр.

Источники

1. Telegram node Callback operations documentation | n8n Docs
2. Telegram - can’t use query buttons and callbacks - by design - Questions - n8n Community
3. Ask a question via Telegram and wait for response? - Questions - n8n Community
4. Telegram node Message operations documentation | n8n Docs
5. n8n Telegram Bot Integration​ - MpireSolutions