Telegram

Аккаунт Telegram подключается к Gratio новым устройством — как Telegram на компьютере. Gratio видит личные чаты, группы и каналы аккаунта и работает с ними от его имени. Это обычный аккаунт, не бот: писать можно людям, группам и каналам, где аккаунт состоит.

Подключение

В кабинете: карточка канала Telegram → «Привязать номер».

По QR-коду. На телефоне: «Настройки» → «Устройства» → «Подключить устройство», наведите камеру на код в кабинете.

По номеру телефона. Введите номер — Telegram пришлёт код в приложение, в чат «Telegram». Введите код в кабинете. Код нельзя пересылать: пересланный код Telegram аннулирует.

Включена двухэтапная аутентификация — кабинет попросит облачный пароль.

Чтобы канал работал

• Подключайте рабочий аккаунт, а не личный: Gratio видит все личные чаты аккаунта.
• В Telegram придёт уведомление о входе нового устройства — это Gratio. Не нажимайте «Это не я» и не завершайте сеанс Gratio в «Устройствах».
• Секретные чаты Gratio не видит — они есть только на телефоне.

Адреса

idMessage — номер сообщения строкой: "4815". В личных чатах и обычных группах нумерация общая для аккаунта, в супергруппах и каналах — своя у каждого чата. Поэтому сообщение всегда адресуется парой chatId + idMessage.

Особенности Telegram

• Текст — до 4096 символов.
• Номер собеседника виден, только если он его открыл или вы нашли его по номеру.
• Поиск по номеру — не больше 20 в час; при отказе Telegram — пауза на час.
• Статусы исходящих — sent и read.
• Голосовые: файл OGG/Opus в sendFileByUpload уходит голосовым сообщением с длительностью.
• Опрос — только в группу: в личный чат Telegram его не пускает (400 poll_private_chat).
• Группы: createGroup создаёт супергруппу — у неё постоянный адрес -100…. Обычная группа при росте становится супергруппой с новым id — об этом придёт событие группы.
• Профиль собеседника в getContactInfo подробнее, чем в других каналах: статус «в сети», ники, отметки, день рождения, бизнес-профиль. См. getContactInfo.
• Истории — публикация, просмотр, статистика. См. Истории Telegram.
• Поиск и вступление в каналы и группы, заявки, приглашения. См. searchChats.
• Звонки приходят событиями; звук звонков Telegram Gratio не ведёт (501).
• Пока нет (501): кнопки, архив и закрепы.

Проверить подключение

После привязки номера проверьте канал из своего приложения:

curl "$GRATIO_URL/waInstance$GRATIO_ID/getStateInstance/$GRATIO_TOKEN"

Ответ {"stateInstance": "authorized"} — канал работает. Что умеет канал — getCapabilities.

Если канал отключился

notAuthorized — сеанс Gratio завершили в «Устройствах» или Telegram его сбросил. Привяжите аккаунт в кабинете снова: тот же аккаунт — тот же ключ и история.

Что дальше

• WhatsApp — особенности следующего канала.
• Истории Telegram и Поиск и вступление: правила и лимиты — возможности, которые есть только здесь.