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

Описание команд интеграции Telegram#

Список команд приложения#

Команда Использование Описание
/help /help Справка по командам
/start /start Начало работы с ботом
/me /me Информация о текущем пользователе
(telegram chat_id, username, name)
/language [lang]
/lang [lang]		 /language en
/lang ru		 Смена языка бота
(доступные языки - ru и en)
/instance [idInstance] [apiTokenInstance] /instance 1101111111 abcdef123456789abcde Привязка инстанса GREEN-API
/resetInstance /resetInstance Отключение текущего инстанса от интеграции
/status
/getStateInstance		 /status
/getStateInstance		 Проверка статуса инстанса
(Instance ID, статус инстанса, подключенный номер телефона, настройки уведомлений)
/setchat [chat_id] /setchat 123456798 Настроить пересылку в другой телеграм чат
/sendMessage [номер WhatsApp] [текст] /sendMessage 79876543210 Привет! Отправить сообщение в WhatsApp
/notifications [type] [on/off] /notifications all on
/notifications incoming on
/notifications outgoing off
/notifications status off		 Управление уведомлениями:
- incoming - входящие WhatsApp сообщения
- outgoing - статусы сообщений, отправленных в WhatsApp
- status - уведомления о смене статуса инстанса

Примеры использования команд#

Команда /instance#

Назначение:
Привязка инстанса GREEN-API к телеграм-боту.

Пример запроса: 

/instance 1101111111 abcdef123456789abcde

Пример ответа:

Успешное подключение: 

Инстанс успешно привязан!

Вебхук автоматически установлен.

Теперь вы можете получать и отправлять сообщения через WhatsApp.

Доступные команды:
• /status - статус инстанса
• /resetInstance - сменить инстанс
• /help - помощь

Ошибка подключения: 

Неверный формат. Используйте:
/instance 1101111111 abc123abc123abc123abc123abc123

Где:
• 1101111111 - idInstance
• abc123... - apiTokenInstance

idInstance и apiTokenInstance можно получить в личном кабинете GREEN-API после создания инстанса.

Команда /me#

Назначение:
Получение информации о текущем пользователе Telegram.

Пример запроса: 

/me

Пример ответа бота: 

Ваша информация

Ваш Telegram ID: 123456789
Username: your_username
Имя: Василиса

Пересылка сообщений:
В этот чат

Команда /status или /getStateInstance#

Назначение:
Проверка статуса привязанного инстанса.

Пример запроса: 

/status

Пример ответа бота:

Инстанс авторизован: 

Статус инстанса:

• ID инстанса: 1101111111
• Статус: authorized
• Номер телефона: 79876543210@c.us

• Получение входящих сообщений: включено
• Получение статусов отправленных сообщений: включено
• Получение статуса инстанса: включено

Для смены инстанса используйте /resetInstance

Инстанс не авторизован: 

Статус инстанса:

• ID инстанса: 1101111111
• Статус: notAuthorized
• Номер телефона: не указан

• Получение входящих сообщений: выключено
• Получение статусов отправленных сообщений: выключено
• Получение статуса инстанса: выключено

Для смены инстанса используйте /resetInstance

Инстанс не подключен: 

Инстанс не привязан. Используйте /instance для привязки.

Пошаговая инструкция для начала работы: /start

Команда /setchat#

Назначение:
Настройка пересылки сообщений в указанный чат/канал.

Пример запроса:

/setchat -1001234567890

Префикс - означает, что это супергруппа или канал. chat_id можно узнать с помощью бота @userinfobot или из ответа команды /me (для личных чатов).

Обратите внимание!

Бот может отправлять сообщения только тем личным чатам, с которыми у него уже была переписка.
Поэтому при настройке отправки сообщений другому пользователю telegram, необходимо, чтобы этот пользователь начал диалог с ботом (отправил /start)

Пример ответа бота:

Успешная установка: 

Настройки обновлены!

Все сообщения из WhatsApp теперь будут пересылаться в:
-1001234567890

Чтобы сбросить настройку и получать сообщения себе:
/resetchat

Ошибка установки: 

Не удалось отправить сообщение в указанный чат

Возможные причины:
• Бот не добавлен в этот чат/канал
• Указан неверный chat_id
• Чат не существует

Убедитесь, что:
1. Бот добавлен в целевой чат/канал
2. Бот имеет права на отправку сообщений
3. Chat_id указан верно

Команда /sendMessage#

Назначение:
Отправка сообщения в WhatsApp.

Пример запроса:

/sendMessage 79876543210 Добрый день! Это тестовое сообщение из Telegram.

Пример ответа бота:

Сообщение отправлено в WhatsApp: 

Чат: 79876543210@c.us
Текст: Привет! Это тестовое сообщение из Telegram
ID сообщения: BAE56B72848CD42F
Ошибка отправки: 
Неверный формат. Используйте:
/reply <номер_телефона> <сообщение>

Например:
/reply 79876543210 Привет!

Команда /notifications#

Назначение:
Управление уведомлениями о событиях WhatsApp.

Примеры запросов:

Включить все уведомления: 

/notifications all on

Включить уведомления о входящих сообщениях: 

/notifications incoming on

Выключить уведомления остатусах исходящих сообщенийх: 

/notifications outgoing off

Выключить уведомления о смене статуса инстанса: 

/notifications status off

Типы уведомлений:

  • incoming - входящие WhatsApp сообщения
  • outgoing - статусы отправленных сообщений
  • status - уведомления о смене статуса инстанса
  • all - все типы уведомлений (incoming, outgoing и status)

Команда /language#

Назначение:
Выбор языка интерфейса бота.

Пример запроса: 

/language ru

Пример ответа бота:

Успешная смена языка: 

Язык изменен на русский

Ошибка в установке языка: 

Данный язык не поддерживается. 
Пожалуйста, отправьте /language ru либо /language en