Пользовательские данные

Email

Омниканальность

Автоматизация

Отслеживание событий и поведения

Выключение или включение уведомлений для пользователей в Telegram

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

На нашей платформе это возможно сделать для пользователей, имеющих токены Telegram. Эта функция реализована с помощью двух API методов, описанных ниже.

Выключение уведомлений 

Чтобы отключить уведомления, отправьте запрос на:

  • POST /v1/apps/{app_uuid}/token/mute
    где замените {app_uuid} в ссылке на UUID вашего приложения.

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

Пользователи или чаты, для которых отключены сообщения, могут получать транзакционные сообщения (smartsend, тестовые).

Параметры метода и их описание приведены в следующей таблице.

Параметр Тип Описание
token string

Обязательный параметр.

Токен Telegram пользователя.

duration long

Необязательный параметр.

Продолжительность отключения уведомлений в секундах:

  • Минимальное значение – 5 секунд.
  • Максимальное значение – 31536000 секунд (примерно 1 год).

Если продолжительность не указана, для отключения звука устанавливается значение 9999-12-31 23:59:59, отключающее уведомления «навсегда».

Чтобы изменить продолжительность отключения уведомлений, отправьте другой запрос с новым значением.

В ответе могут вернуться ошибки, приведенные в таблице.

Статус Сообщение Описание
400 Wrong app uuid Неверный uuid приложения.
400 Tokens must be specified Токен не указан.
400 Duration must be positive int Значение продолжительности должно быть положительным целым числом.
404 Not registered application Приложение не зарегистрировано.

Контакты с отключенными сообщениями отображаются в отчетах рассылки как "Недоступные контакты" с типом ошибки "Другие ошибки".

Відображення у звітах помилок для контактів, яким вимкнено повідомленняНазвание ошибки в деталях: CHANNEL_WAS_MUTED.

Назва помилки

Включение сообщений

Чтобы включить уведомления, отправьте запрос на:

  • POST /v1/apps/{app_uuid}/token/unmute
    где замените {app_uuid} в ссылке на UUID вашего приложения.

В запросе необходимо передать следующий параметр:

Параметр Тип Описание
token string

Обязательный параметр.

Токен Telegram пользователя.

В ответе могут вернуться ошибки, приведенные в таблице.

Статус Сообщение Описание
400 Wrong app uuid Неверный uuid приложения.
400 Tokens must be specified Токен не указан.
404 Not registered application Приложение не зарегистрировано.
Остались вопросы?
Специалисты обязательно ответят и помогут решить вашу проблему!
Обратный звонок
Оставьте заявку – и наш специалист свяжется с вами в рабочее время.
Отправить заявку
Консультация в чате
Готовы к вашим вопросам!
Написать в чат
Электронная почта
Напишите в службу поддержки eSputnik.
Отправить email