Как удалить подписчиков в Инстаграм: 3 метода (2021)
В этой статье вы узнаете:
- Как удалить подписчиков в Инстаграм в 2021 году: вручную и автоматически.
- Зачем удалять неактивных пользователей и ботов.
- Можно ли вернуть удаленных фолловеров.
Как удалить подписчиков вручную: step-by-step
Сразу перейдем к практической части статьи. Удалим подписчиков в Инстаграм. Вручную, без автоматизации процесса через сервисы.
Сначала удалим фолловеров с телефона, потом — с компьютера. Этот раздел написан в формате пошаговой инструкции — просто выполняйте действия, описанные ниже.
С телефона
Чтобы удалить подписчиков на телефоне (устройства на Андроид, Айфоны), запустите приложение Instagram. Перейдите на главную страницу профиля и зайдите в раздел «Подписчики».
Откроется список всех подписчиков. Чтобы начать удаление фолловеров, нажмите на три точки справа от кнопки «Подписаться». Выберите функцию «Удалить».
Пользователь не узнает, что вы удалили его из подписчиков — Instagram не отправляет подобных уведомлений.
С компьютера
Удалить фолловеров можно с компьютера через веб-версию Instagram. Но здесь не обойтись без блокировки. Дело в том, что классическая функция удаления не доступна в ПК-версии социальной сети.
Чтобы удалить подписчиков, зайдите в свой Instagram-аккаунт с компьютера. Зайдите в раздел фолловеров.
Откроется список всех подписчиков. Зайдите в профиль нужного человека и нажмите на иконку с тремя точками. Выберите функцию «Заблокировать этого пользователя».
Человек больше не сможет найти ваш аккаунт. При этом он не узнает, что вы его заблокировали.
Важно: главный минус ручного удаления подписчиков в Инстаграм заключается в том, что это занимает очень много времени. Также вы не сможете массово удалить всех фолловеров.
Удаляем подписчиков в Инстаграм автоматически: ботов, неактивных пользователей
Чтобы не выполнять все действия вручную, мы рекомендуем автоматизировать процесс удаления подписчиков. Для этого используйте Spam Guard. Это интеллектуальный сервис очистки Instagram-аккаунтов.
Он предоставляет следующие возможности:
- Очистка от ботов в несколько кликов. Это поможет избавиться от спама и офферов.
- Очистка от всех коммерческих аккаунтов разом. Инструмент удалит все коммерческие профили из подписчиков.
- Очистка от невзаимных подписок. Сервис поможет удалить одним кликом тысячи пользователей, которые не подписались на вас в ответ.
- Удаление неактивных подписчиков — пользователей, которые не ставят лайки, не пишут комментарии. Таким образом на аккаунте останутся только «живые» пользователи».
- Защитник от спама. Spam Guard постоянно анализирует ваш профиль и следит, чтобы в комментариях не появлялись спамеры.
- Оптимизация под все устройства. Пользоваться онлайн-инструментом можно с компьютера, телефона, планшета.
Онлайн-сервис Spam Guard платный. Но есть бесплатный тестовый период, который позволяет проверить функционал.
Удалить подписчиков через Spam Guard >>>
Как вернуть удаленных подписчиков?
К сожалению, бывают случаи, когда пользователи случайно удаляют подписчиков. И главная проблема заключается в том, что вернуть их вручную — невозможно.
Единственный вариант — написать фолловеру личное сообщение в Директ и попросит подписаться обратно. Но если вы удалили сразу несколько сотен (или тысяч) подписчиков, то написать всем будет очень трудно.
Поэтому в этом случае можно дать только один совет: продолжайте развивать свой Instagram-аккаунт и привлекайте новую аудиторию. Подробнее об этом читайте в нашей статье «Как раскрутить Инстаграм самостоятельно».
В крайнем случае, воспользуйтесь накруткой.
Для этого рекомендуем использовать сервис Likemania. Здесь можно быстро и недорого накрутить подписчиков: ботов и живых людей.
А еще это безопасно: ваш аккаунт не заблокируют за накрутку.
Накрутить подписчиков через Likemania >>>
Зачем удалять неактивных подписчиков и ботов: основные причины
В завершение статьи давайте посмотрим основные причины, по которым нужно удалять неактивных подписчиков и ботов в Инстаграм:
- Повышение охвата. Если на аккаунте останется только активная аудитория, то алгоритм социальной сети будет рекомендовать ваши публикации другим пользователям.
- Повышение вовлеченности. Этот параметр также оказывает положительный эффект на органическом приросте новой аудитории.
3 простых способа Как удалить подписчиков в Инстаграм без блокировки
В статье мы вы найдете пошаговую инструкцию, Как удалить подписчиков в Инстаграм, которые подписались на вас несколькими способами — без блокировки и блокируя аккаунты — удаляем по одному пользователю или всех разом. Вы сможете легко и быстро удалить неактивные аккаунты, нежелательных подписчиков.
Практически любой пользователь Instagram рано или поздно сталкивается с необходимостью удалить кого-то из своих подписчиков. Главная цель такого удаления, сделать так чтобы человек больше не мог получать новости с вашей страницы. Делается это из-за разных обстоятельств, но чаще всего причиной является личная неприязнь. Если вы по какой-то причине хотите узнать, как удалить подписчиков в Инстаграм, то эта статья поможет вам с данной проблемой.
Как удалить подписчиков в Инстаграм, которые подписались на вас
Существует несколько способов того как вы можете как удалить подписчиков в инстаграме, которые подписались на вас не блокируя и с помощью блокировки. Разные способы подойдут для разных ситуаций и позволят потратить вам минимум усилий. А потому, прежде чем приступать непосредственно к удалению, изучите их все и выберите подходящий для вас.
Блокировка пользователя
Первый вариант того как удалить подписчиков в Инстаграм — это блокировка. Данный вариант позволит вам не только удалить пользователя, но и полностью ограничить его доступ к вашей странице.
Чтобы заблокировать кого-либо следуйте данной инструкции:
- Откройте приложение.
- Зайдите на страницу вашего профиля.
- Нажмите на количество подписчиков рядом с вашей фотографией.
- После этого вы попадёте в раздел “Подписчики”, где отображаются все люди подписанные на вашу страницу; найдите нужного вам пользователя.
- Перейдите на его страницу.
- Нажмите на изображение трёх точек в правом верхнем углу.
- В появившемся меню выберите пункт “Заблокировать”.
- Подтвердить своё действие нажав “Да, подтверждаю”.
Данная инструкция позволит вам быстро удалить человека из подписчиков и заблокировать его. Заблокированный пользователь не сможет видеть ваши посты, а также не сможет как-либо контактировать с вами через данный аккаунт.
Помните, что заблокированный пользователь не сможет подписаться на вас до тех пор, пока вы его не разблокируете. А потому, если вы захотите вернуть его обратно, то вам нужно будет, как минимум разблокировать его. И не ждите, что после этого он автоматически появится у вас в подписчиках, ему нужно будет подписаться заново.
Как быстро удалить подписчиков в Инстаграм: видео
Как отписать от себя человека в Инстаграме не блокируя: удаляем неактивных подписчиков
Теперь давайте разберёмся, что делать, если вам нужно удалить сразу несколько неактивных подписчиков. Согласитесь, делать это обычным способом не только долго, но и крайне утомительно. К счастью, есть способ, как сделать это более быстро.
- Запустите приложение.
- Нажмите на три точки в правом верхнем углу.
- Выберите пункт “Настройки”.
- Здесь найдите пункт “Закрытый аккаунт” и активируйте ползунок рядом с ним (он окрасится в синий цвет).
- Затем перейдите в раздел “Подписчики” (о том, как это сделать говорилось в предыдущей инструкции).
- Находим нужного пользователя и нажимаем на три точки рядом с ним.
- В появившемся окне выбираем пункт “Удалить”.
Последние два пункта вам нужно повторить для каждого пользователя отдельно. Когда закончите, можно опять открыть свой аккаунт.
Но помните, что удаляя пользователей таким способом, вы обходитесь без блокировки и через какое-то время они могут подписаться на вас снова.
Как удалить всех подписчиков одним разом с помощью приложения: массовое удаление
Предыдущий способ хоть и был быстрее первого, но всё ещё не очень удобен, если речь идёт о действительно большом количестве людей. Стандартный функционал Instagramне предусматривает таких возможностей, но, к счастью, кроме него у нас ещё есть приложения от сторонних разработчиков. Они помогут вам в том случае, когда нужно удалить всех подписчиков одним разом.
Существует множество приложений, которые могут помочь вам справиться с данной задачей, но мы рассмотрим пример с одним конкретным приложением. Речь идёт о программе “Cleaner for Instagram”. С её помощью вы можете удалить всех ваших подписчиков, нажав на одну кнопку. Вот как это делается.
- Откройте приложение.
- Авторизуйтесь, введя ваши данные от Instagram.
- Нажмите на кнопку “Agree” в верхнем правом углу.
- На панели внизу выберите раздел “Followers”.
- Выберите все нужные вам аккаунты, нажав и удерживая палец на них.
- Затем нажмите на значок молнии в нижнем левом углу, чтобы удалить их всех сразу.
- Система предложит вам несколько вариантов, что сделать с отмеченными пользователями; вы можете выбрать вариант “Block”, чтобы заблокировать пользователей, или же “Block and unblock”, что значит удалить, не блокируя их.
Так или иначе, все отмеченные пользователи будут удалены.
Стоит отметить, что данный способ доступен не только с телефона. Для компьютеров также есть похожие приложения, при том, как скачиваемые, так и онлайн.
Как удалить ботов в Инстаграме и увеличить охваты
Теперь вы знаете, как отписать от себя человека в инстаграме не блокируя. Заблокировав пользователей, вы можете полностью перекрыть им доступ к вашей странице и лишите их возможности вернуться обратно.
Благодарим за интерес к статье «3 способа как отписать от себя человека в инстаграме не блокируя». Если она оказалась полезной, то просьба сделать следующее:
- Поделитесь с друзьями с помощью кнопки социальных сетей
- Напишите комментарий внизу страницы — поделитесь советами, выскажите свое мнение
- Посмотрите ниже похожие статьи, возможно, они окажутся вам полезны
Всего вам доброго!
Похожие статьи:
Как убрать людей из подписчиков. Как удалить подписчиков в Вк из мобильной версии
Как известно, все пользователи, которые отправляют вам заявки в друзья, автоматичеки становятся вашими подписчиками. Пока вы не одобрите заявку человека, он так и будет висеть у вас в списке. Если подобный перечень вы хотите почистить, не добавляя людей в друзья из подписчиков, а просто удаляя их, то читайте данную статью.
Как посмотреть подписчиков Вк
Заходим на свою страничку и в левом меню кликаем по ссылке «Друзья»:
У нас открывается новая страничка, в правом меню нажимаем на ссылочку «Заявки в друзья»:
Именно во вкладке «Входящие» и находятся все люди, которые на вас подписались:
Данное окошко не предусматривает функции удаления людей из подписчиков. Хотя, конечно, есть один способ: вы можете перейти отсюда на страницу того, которого хотите удалить и заблокировать его уже на его страничке. Но есть еще один более понятный и часто используемый способ, именно к нему мы и переходим.
Как удалить человека из подписчиков вконтакте в полной версии
Заходим на главную страничку своего аккаунта, и под подробной информацией высвечивается количество тех, кто на вас подписался. На него мы и нажимаем:
Сразу же у нас открывается перечень. Для того чтобы удалить кого-нибудь оттуда нажмите на крестик в правом верхнем углу аватарки:
Нам сообщают, что таким образом мы добавим данный аккаунт в черный список. Мы соглашаемся с этим и нажимаем на кнопочку «Продолжить»:
Вот и все, данный товарищ исчез из подписчиков и попал в черный в вашем аккаунте. Он, конечно же, может там и находиться, но, если вас такое не устраивает, то можно пойти дальше.
Пусть данный аккаунт повисит у вас пару дней в черном списке, а далее уже можно удалять его и оттуда. Если удалить раньше, то, возможно, он опять появится в подписчиках. Как же это сделать. Читаем дальше…
Нажимаем на верхнее меню в правом верхнем углу и из выпавшего меню выбираем пункт «Настройки»:
На следующем этапе в этом же правом меню выбираем пункт «Черный список»:
Открывается у нас он. Находим нужного нам и напротив него жмем на ссылочку «Удалить из списка»:
Таким образом, вы удалите человека из подписчиков, не добавляя его в черный.
Как удалить подписчиков вконтакте с телефона
И так, если у вас смартфон либо планшет на платформе Андроид с установленным мобильным приложением Вконтакте, то читаем инструкцию.
Запускаем приложение, и сразу же на главной страничке у вас выводится количество людей, которые подписаны. Нажимаем на него:
Запускается окошко с людьми, которые на вас подписаны. Находим того, которого хотим удалить и нажимаем на него:
Попадаем на страничку человека и в правом верхнем углу находим меню в виде трех вертикальных кнопок. Нажимаем на него и из выпавшего меню выбираем пункт «Заблокировать».
Доброго времени суток, скажу честно, что я понимаю, что вы знаете, как удалить человека из подписчиков в контакте, но, поскольку, в сети есть много новичков, то данная тема будет им полезна.
Ну, что же, начнем с того, что новый дизайк вк (буду сокращать) принес многим разочарования, так как работать на нем не привычно. Да, в нем есть много плюсов, но есть и минусы. Мне было приятно работать в вк все эти 8 лет, а тут они решили напрочь сменить дизайн.
Ну, да ладно, по-нашему, все равно не будет, раз они так решили, то будет адаптироваться. Иногда нам нужно «убрать» подписчика, чтобы он не читал наши новости. Для этого есть некоторые способы, о которых поговорим дальше в статье.
Прежде всего, если данный человек находится у вас в друзьях, то вы можете запросто его от туда удалить. Сделать это не сложно:
- заходим к нему на страницу;
- под его фото жмем на «У вас в друзьях » — «убрать из друзей ».
Это мы лишь убрали человека и теперь мы с ним не дружим в контакте, но основная часть наших новостей будет ему доступна. Поэтому мы можем пойти дальше и сделать так, чтобы он нас даже не замечал.
Первый способ – написать ему
Да, не удивляйтесь, если вы хотите, чтобы данный человек не писал вам, не читал вашу стенку, не смог комментировать и так далее, то нужно ему написать. В своем послании можете написать, то что данная дружба вам не интересна, что вы его уже удалили и он пускай последует вашему примеру. Вы убираете его, а он убирает подписку на вас, вот так просто. Другое дело, когда он не захочет убирать подписку, то тут придется вам еще кое-что сделать.
Второй способ — черный список
Есть второй способ, который, с этической стороны, может показаться странным, его суть заключается в том, что вы просто заносите человека в черный список или ЧС. Чтобы нам проделать такую процедуру, нужно:
- зайти в список подписчиков;
- найти нужного человека-подписчика;
- навести на его иконку, после чего появится крестик, на который и нужно нажать.
Хотя есть и другой способ занести в этот список человек, он не сложный, вам просто придется нажать на кнопку мышки на 2 раза больше.
- Заходим на страницу нашего подписчика и вверху копируем адрес на его страницу.
- Дальше, заходим на страницу «Настройки».
- Теперь здесь выбираем вкладку «Черный список».
- Вставляем сюда адрес, который мы сохранили до этого, вставляем его, затем нажимаем «Добавить в черный список».
Все, данный человек не сможет заходить на вашу страницу, читать ваши обновления, новости и так далее. Мы ограничили ему доступ и теперь можем спать спокойно.
Ну, а если серьезно, то все равно, если данный человек захочет зайти к вам, то он сможет зарегистрировать новый аккаунт в контакте и все равно это сделает.
Данные способы я использую, хотя еще не писал другому, мол, не удали меня и я тебя удалю, теперь мы не друзья. Как видите способы очень простые, но очень действенные, уверен, теперь вы усвоили, как удалить человека из подписчиков в контакте
Управление подписчиками — документация API
Все необходимое для работы с подписчиками в личном кабинете. От добавления одного подписчика до импорта большого списка. Вы даже можете получить доступ к полной истории каждого подписчика, включая все открытия, клики и многое другое.
Добавление подписчика
После https: // api.createsend.com/api/v3.2/subscribers/{listid}.{xml|json}
Этот метод создан для использования на веб-сайтах и при интеграции, которым необходимо добавлять подписчиков для каждого экземпляра, и добавляет подписчика в существующий список подписчиков, включая данные настраиваемых полей, если они предоставлены. Если подписчик (адрес электронной почты) уже существует, его имя и любые значения настраиваемых полей обновляются с учетом того, что было передано. После этого данные подписчика передаются в очередь обработки в Campaign Monitor для добавления.Для мгновенного добавления или массового добавления подписчиков используйте метод импорта множества подписчиков.
При указании значения для настраиваемого поля даты избегайте неоднозначных форматов даты дд / мм / гггг и мм / дд / гггг. Вместо этого используйте явный формат, например гггг / мм / дд.
Обратите внимание, что каждое значение настраиваемого поля имеет ограничение в 250 символов.
Существующие данные настраиваемого поля не удаляются, если не указаны новые значения настраиваемого поля. Многозначный выбор Многие настраиваемые поля задаются путем предоставления нескольких элементов массива настраиваемых полей с одним и тем же ключом.Пользовательские поля типа даты можно очистить, передав значение «0000-00-00».
Следующее электронное письмо будет отправлено только новым подписчикам, как указано в настройках списка. Если список был настроен как двойной выбор, им будет отправлено письмо с подтверждением, в противном случае им будет отправлено письмо с подтверждением, которое вы настроили для списка, на который подписывается.
Обратите внимание: Если подписчик находится в неактивном состоянии или ранее был отписан от подписки или добавлен в список подавления, и вы укажете входное значение Resubscribe
как истинное, они будут повторно добавлены в список.Поэтому этот метод следует использовать с осторожностью и только там, где это возможно. Если Resubscribe
указано как false, подписчик не будет повторно добавлен в активный список.
По умолчанию повторно подписанные подписчики не будут перезапускать автоматические рабочие процессы, но получат все оставшиеся электронные письма. Однако, если вы укажете входное значение RestartSubscriptionBasedAutoresponders
как true
, любые последовательности будут перезапущены. RestartSubscriptionBasedAutoresponders
влияет только на повторно подписывающихся подписчиков и по умолчанию будет иметь значение false
, если не указано.
- ListID Идентификатор списка подписчиков, в который должен быть добавлен подписчик.
{
"EmailAddress": "[email protected]",
«Имя»: «Новый подписчик»,
"Настраиваемые поля": [
{
«Ключ»: «сайт»,
«Значение»: «http://example.com»
},
{
«Ключ»: «интересы»,
«Значение»: «магия»
},
{
«Ключ»: «интересы»,
«Value»: «романтические прогулки»
}
],
«Повторная подписка»: правда,
"RestartSubscriptionBasedAutoresponders": true,
«ConsentToTrack»: «Да»
}
<Абонент>
подписчик @ пример.ru
Новый подписчик
<Пользовательские поля>
веб-сайт
http://example.com
интересы
магия
интересы
романтические прогулки
true
Да
true
- ConsentToTrack Предоставил ли подписчик разрешение на открытие электронной почты и отслеживание кликов.Это значение применяется ко всем подписчикам с одним и тем же адресом электронной почты в одном клиенте. Если вы передаете значение без изменений для адреса электронной почты, и этот адрес в настоящее время не существует в клиенте или не имеет существующего значения для ConsentToTrack, предполагается, что подписчик дал согласие.
-
Да
Отслеживание разрешено для этого адреса электронной почты -
Нет
Отслеживание для этого адреса электронной почты не разрешено -
Без изменений
Не изменять настройку отслеживания текущего адреса электронной почты
-
Ответ
Содержит адрес электронной почты добавленного подписчика.
HTTP / 1.1 201 Создано
Тип содержимого: приложение / json; charset = utf-8
"[email protected]"
HTTP / 1.1 201 Создано
Тип содержимого: приложение / xml; charset = utf-8
xml version = "1.0" encoding = "utf-8"?>
[email protected]
Ответы об ошибках:
Подробную информацию о возможных ответах на любые запросы API см. В нашей документации по кодам состояния ответов.
Если вы получили ответ 400 Bad Request
на этот запрос, это возможные ошибки, которые могут быть включены в тело ответа:
- 1: неверный адрес электронной почты Адрес электронной почты отсутствует или имеет неправильный формат.
- 204: В списке исключений Адрес электронной почты существовал в выбранном списке раньше и в настоящее время находится в списке подавления.Подписчик не добавлен.
- 205: Удалено Адрес электронной почты существует в удаленном списке. Подписчик не добавлен.
- 206: Отписался Адрес электронной почты есть в списке отписавшихся. Подписчик не добавлен.
- 207: отклонено Адрес электронной почты присутствует в списке отказов. Подписчик не добавлен.
- 208: неподтвержденный Адрес электронной почты существует в неподтвержденном списке. Подписчик не добавлен.
- 214: предоставьте согласие на отслеживание значения
- 215: предоставьте действительное согласие на отслеживание значения
Обновление подписчика
Положить https: // api.createsend.com/api/v3.2/subscribers/{listid}.{xml|json}?email={email}
Обновляет любой аспект существующего подписчика, включая адрес электронной почты, имя и данные настраиваемого поля, если они предоставлены.
При указании значения для настраиваемого поля даты избегайте неоднозначных форматов даты дд / мм / гггг и мм / дд / гггг. Вместо этого используйте явный формат, например гггг / мм / дд.
Обратите внимание, что каждое значение настраиваемого поля имеет ограничение в 250 символов.
Для всех настраиваемых полей, кроме многозначных полей «Выбрать много», любые отсутствующие значения останутся без изменений. При обновлении многозначных настраиваемых полей «Выбрать много» все параметры, выбранные для этого клиента, необходимо передавать при каждом обновлении. Если вы не пройдете через все варианты, которые вы хотите выбрать для этого клиента, все исторически выбранные варианты будут заменены тем, что было включено в ваш последний звонок. Многозначный выбор Многие настраиваемые поля задаются путем предоставления нескольких элементов массива настраиваемых полей с одним и тем же ключом.
Чтобы очистить значение настраиваемого поля, передайте параметр Очистить
со значением true
вместе с именем / значением настраиваемого поля. Чтобы удалить специфичный для вариант Multi-Valued Select Many, передайте имя параметра в поле Value
вместе с параметром Clear: true
. Чтобы очистить все значения поля многозначного выбора «много», передайте пустое значение Value
вместе с параметром Clear: true
. В качестве альтернативы настраиваемые поля типа Date можно очистить, передав значение «0000-00-00».
Примечание: значение электронной почты
в строке запроса — это старый адрес электронной почты. Используйте свойство EmailAddress
в теле запроса, чтобы изменить адрес электронной почты.
Обновление будет применяться независимо от того, активен ли подписчик или неактивен, хотя, если подписчик не существует, новый добавляться не будет.
Неактивные подписчики не будут повторно подписаны, если для параметра Повторная подписка
установлено значение true
. Использование значения Resubscribe
и связанных с ним приветственных и подтверждающих электронных писем идентично добавлению подписчика, и поэтому к ним следует относиться с такой же осторожностью.
По умолчанию повторно подписанные подписчики не будут перезапускать автоматические рабочие процессы, но получат все оставшиеся электронные письма. Однако, если вы укажете входное значение RestartSubscriptionBasedAutoresponders
как true
, любые последовательности будут перезапущены. RestartSubscriptionBasedAutoresponders
влияет только на повторно подписывающихся подписчиков и по умолчанию будет иметь значение false
, если не указано.
Любые зарегистрированные веб-перехватчики обновления
будут активированы независимо от того, является ли подписчик неактивным или нет.
- ListId Идентификатор списка подписчиков, в который должен быть добавлен подписчик.
- Электронная почта Адрес электронной почты подписчика, данные которого будут обновлены. Это считается «старым» адресом электронной почты.
{
"EmailAddress": "[email protected]",
"Имя": "Имя изменено",
"Настраиваемые поля": [
{
«Ключ»: «сайт»,
"Значение": "http: // пример.com "
},
{
«Ключ»: «интересы»,
«Значение»: «магия»
},
{
«Ключ»: «интересы»,
«Значение»: «подземелья и драконы»
},
{
«Ключ»: «возраст»,
"Значение": "",
«Ясно»: верно
}
],
«Повторная подписка»: правда,
"RestartSubscriptionBasedAutoresponders": true,
«ConsentToTrack»: «Да»
}
<Абонент>
changed_address @ example.ru
Измененное имя
<Пользовательские поля>
веб-сайт
http://example.com
интересы
магия
интересы
подземелья и драконы
возраст
true
true
Да
true
- ConsentToTrack Предоставил ли подписчик разрешение на открытие электронной почты и отслеживание кликов.Это значение применяется ко всем подписчикам с одним и тем же адресом электронной почты в одном клиенте. Если вы передаете значение без изменений для адреса электронной почты, и этот адрес в настоящее время не существует в клиенте или не имеет существующего значения для ConsentToTrack, предполагается, что подписчик дал согласие.
-
Да
Отслеживание разрешено для этого адреса электронной почты -
Нет
Отслеживание для этого адреса электронной почты не разрешено -
Без изменений
Не изменять настройку отслеживания текущего адреса электронной почты
-
Ожидаемый ответ: (Одинаковый для всех языков)
HTTP / 1.1 200 ОК
Ответы об ошибках:
Подробную информацию о возможных ответах на любые запросы API см. В нашей документации по кодам состояния ответов.
Если вы получили ответ 400 Bad Request
на этот запрос, это возможные ошибки, которые могут быть включены в тело ответа:
- 1: неверный адрес электронной почты Адрес электронной почты отсутствует или имеет неправильный формат.
- 201: уже подписан Новый адрес электронной почты уже подписан на список. Подписчик не обновлен.
- 203: абонента нет в списке Адрес электронной почты не входит в список. Подписчик не обновлен.
- 211: неверный новый адрес электронной почты Новый адрес электронной почты недействителен. Подписчик не обновлен.
- 214: предоставьте согласие на отслеживание значения
- 215: предоставьте действительное согласие на отслеживание значения
Импорт большого количества подписчиков
После https: // api.createsend.com/api/v3.2/subscribers/{listid}/import.{xml|json}
Позволяет добавлять множество подписчиков в список подписчиков за один запрос API, включая данные настраиваемого поля, если они указаны. Если подписчик (адрес электронной почты) уже существует, его имя и любые значения настраиваемых полей обновляются с учетом того, что было передано. Подписчики будут добавлены мгновенно. Вызов вернется только после того, как будут добавлены все подписчики.
При указании значения для настраиваемого поля даты избегайте неоднозначных форматов даты дд / мм / гггг и мм / дд / гггг.Вместо этого используйте явный формат, например гггг / мм / дд.
Обратите внимание, что каждое значение настраиваемого поля имеет ограничение в 250 символов.
Любые отсутствующие значения настраиваемых полей останутся без изменений. Многозначный выбор Многие настраиваемые поля задаются путем предоставления нескольких элементов массива настраиваемых полей с одним и тем же ключом.
Чтобы очистить значение настраиваемого поля, передайте параметр Очистить
со значением true
вместе с именем / значением настраиваемого поля. Чтобы удалить конкретный параметр «Многозначный выбор множества», передайте имя параметра в поле Value
вместе с параметром Clear: true
.Чтобы очистить все значения поля многозначного выбора «много», передайте пустое значение Value
вместе с параметром Clear: true
. Кроме того, настраиваемые поля типа «Дата» можно очистить, передав значение «0000-00-00»
Следующее электронное письмо будет отправлено только новым подписчикам, как указано в настройках списка. Если список был настроен как двойной выбор, им будет отправлено письмо с подтверждением, в противном случае им будет отправлено письмо с подтверждением, которое вы настроили для списка, на который подписывается.Также будут активированы любые зарегистрированные веб-перехватчики подписки
. Если подписчик не новый, будут запущены все зарегистрированные веб-перехватчики Обновления
.
По умолчанию электронные письма автоматизированного рабочего процесса, основанные на дате подписки, не будут отправляться подписчикам, импортированным с помощью этого метода. Это можно отменить, установив для параметра QueueSubscriptionBasedAutoResponders
значение true
.
Обратите внимание: Если какие-либо подписчики находятся в неактивном состоянии или ранее были отписаны или добавлены в список подавления, и вы укажете входное значение Resubscribe как истинное, они будут повторно добавлены в активный список.Поэтому этот метод следует использовать с осторожностью и только там, где это возможно. Если для повторной подписки указано значение false, подписчики не будут повторно добавлены в активный список.
По умолчанию повторно подписанные подписчики не будут перезапускать какие-либо автоматизированные последовательности рабочих процессов, но получат оставшиеся электронные письма. Однако, если вы укажете входное значение RestartSubscriptionBasedAutoresponders
как true
, любые последовательности будут перезапущены. RestartSubscriptionBasedAutoresponders
влияет только на повторно подписавшихся подписчиков и по умолчанию будет иметь значение false
, если не указано.
- ListID Идентификатор списка подписчиков, в который должны быть добавлены подписчики.
{
«Подписчики»: [
{
"EmailAddress": "[email protected]",
«Имя»: «Первый новый подписчик»,
"Настраиваемые поля": [
{
«Ключ»: «сайт»,
"Значение": "http: // пример.com "
},
{
«Ключ»: «интересы»,
«Значение»: «магия»
},
{
«Ключ»: «интересы»,
«Value»: «романтические прогулки»
},
{
«Ключ»: «возраст»,
"Значение": "",
«Ясно»: верно
}
],
«ConsentToTrack»: «Да»
},
{
"EmailAddress": "subscriber2 @ example.com ",
«Имя»: «Новый подписчик два»,
«ConsentToTrack»: «Нет»
},
{
"EmailAddress": "[email protected]",
«Имя»: «Новый подписчик три»,
«ConsentToTrack»: «Без изменений»
}
],
«Повторная подписка»: правда,
"QueueSubscriptionBasedAutoResponders": false,
"RestartSubscriptionBasedAutoresponders": true
}
<Добавить подписчиков>
<Подписчики>
<Подписчик>
subscriber1 @ example.ru
Новый подписчик
<Пользовательские поля>
веб-сайт
http://example.com
интересы
магия
интересы
романтические прогулки
возраст
true
Да
<Подписчик>
subscriber2 @ example.ru
Новый подписчик два
Нет
<Подписчик>
[email protected]
Новый подписчик три
Без изменений
true
false
true
- ConsentToTrack Предоставил ли подписчик разрешение на открытие электронной почты и отслеживание кликов.Это значение применяется ко всем подписчикам с одним и тем же адресом электронной почты в одном клиенте. Если вы передаете значение без изменений для адреса электронной почты, и этот адрес в настоящее время не существует в клиенте или не имеет существующего значения для ConsentToTrack, предполагается, что подписчик дал согласие.
-
Да
Отслеживание разрешено для этого адреса электронной почты -
Нет
Отслеживание для этого адреса электронной почты не разрешено -
Без изменений
Не изменять настройку отслеживания текущего адреса электронной почты
-
Ответ
Если все подписчики импортированы правильно, вы должны ожидать получения ответа 201 Создано с подробной информацией об импорте.Если только или подписчиков импортированы правильно, вы должны ожидать получения ответа 400 Bad Request , который будет включать детали импорта. Оба этих ответа подробно описаны ниже.
Ожидаемый ответ (когда все подписчики успешно импортированы): JSONXML HTTP / 1.1 201 Создано
Тип содержимого: приложение / json; charset = utf-8
{
"FailureDetails": [],
«TotalUniqueEmailsSubmitted»: 3,
«TotalExistingSubscribers»: 0,
«TotalNewSubscribers»: 3,
"DuplicateEmailsInSubmission": []
}
HTTP / 1.1 201 Создано
Тип содержимого: приложение / xml; charset = utf-8
xml version = "1.0" encoding = "utf-8"?>
3
0
3
Ожидаемый ответ (когда успешно импортированы только некоторые подписчики): JSONXML HTTP / 1.1 400 неверный запрос
Тип содержимого: приложение / json; charset = utf-8
{
"ResultData": {
«TotalUniqueEmailsSubmitted»: 3,
«Всего существующих подписчиков»: 2,
"TotalNewSubscribers": 0,
"DuplicateEmailsInSubmission": [],
"FailureDetails": [
{
"EmailAddress": "example + 1 @ example",
«Код»: 1,
«Сообщение»: «Неверный адрес электронной почты»
}
]
},
«Код»: 210,
«Сообщение»: «При импорте подписчика возникли сбои»
}
HTTP / 1.1 201 Создано
Тип содержимого: приложение / xml; charset = utf-8
xml version = "1.0" encoding = "utf-8"?>
<Результат>
3
2
0
example + 1 @ example
1
Недействительный адрес электронной почты
210
При импорте подписчика произошли сбои
Ответы об ошибках:
Подробную информацию о возможных ответах на любые запросы API см. В нашей документации по кодам состояния ответов.
Если вы получили ответ 400 Bad Request
на этот запрос, это возможные ошибки, которые могут быть включены в тело ответа:
- 209: слишком много подписчиков в этом пакете. Вы можете добавить только 1000 абонентов за один звонок При одновременном импорте нескольких подписчиков вы можете импортировать не более 1000 подписчиков одновременно.Если вам нужно импортировать больше, чем это количество подписчиков, вам нужно будет сделать дополнительные запросы.
- 210: Импорт подписчика имел некоторые сбои При попытке импортировать некоторых подписчиков произошли сбои. Вам нужно будет проверить свойство ResultData результата, чтобы получить полную информацию об этих сбоях.
- 212: в этом пакете не было подписчиков В этом пакете подписчиков не было.
- 214: предоставьте согласие на отслеживание значения
- 215: предоставьте действительное согласие на отслеживание значения
Получение реквизитов подписчика
Получить https: // api.createsend.com/api/v3.2/subscribers/{listid}.{xml|json}?email={email}&includetrackingpreference={true|false}
Получает информацию о подписчике, включая их адрес электронной почты, имя, активное / неактивное состояние и любые данные настраиваемых полей.
- ListID Идентификатор списка подписчиков, к которому принадлежит подписчик.
- Электронная почта Адрес электронной почты подписчика, данные которого необходимо получить.
- includetrackingpreference Включить согласие подписчика на отслеживание стоимости. По умолчанию: false.
Ответ
Содержит данные подписчика. Доступные состояния для подписчиков: Активный, Неподтвержденный, Отказ от подписки, Отказ от подписки и Удален.
HTTP / 1.1 200 ОК
Тип содержимого: приложение / json; charset = utf-8
{
"EmailAddress": "подписчик @ пример.com ",
«Имя»: «Первый подписчик»,
«Дата»: «2010-10-25 10:28:00»,
«Состояние»: «Активный»,
"Настраиваемые поля": [
{
«Ключ»: «сайт»,
«Значение»: «http://example.com»
},
{
«Ключ»: «возраст»,
«Значение»: «24»
},
{
«Ключ»: «дата подписки»,
«Значение»: «2010-03-09»
}
],
"ReadsEmailWith": "Gmail",
«ConsentToTrack»: «Да»
}
HTTP / 1.1 200 ОК
Тип содержимого: приложение / xml; charset = utf-8
xml version = "1.0" encoding = "utf-8"?>
<Подписчик>
[email protected]
Первый подписчик
25.10.2010 10:28:00
Активный
<Пользовательские поля>
веб-сайт
<Значение> http: // пример.ru
возраст
24
дата подписки
09.03.2010
Gmail
Да
Ответы об ошибках:
Подробную информацию о возможных ответах на любые запросы API см. В нашей документации по кодам состояния ответов.
Если вы получили ответ 400 Bad Request
на этот запрос, это возможные ошибки, которые могут быть включены в тело ответа:
- 1: неверный адрес электронной почты Адрес электронной почты отсутствует или имеет неправильный формат.
- 203: абонента нет в списке Адрес электронной почты не входит в список.Подписчик не обновлен.
Получение истории подписчика
Получить https://api.createsend.com/api/v3.2/subscribers/{listid}/history.{xml|json}?email={email}.
Извлекает исторические записи кампаний и электронных писем автоматизированного рабочего процесса, полученных подписчиком.Для каждой кампании или электронного письма с автоматизированным рабочим процессом записываются все действия подписчика, включая тип события, дату и IP-адрес, с которого произошло событие.
- ListID Идентификатор списка подписчиков, к которому принадлежит подписчик.
- Электронная почта Адрес электронной почты подписчика, история которого должна быть получена.
Ответ
Содержит историческую запись всех кампаний и электронных писем автоматизированного рабочего процесса, полученных подписчиком.
HTTP / 1.1 200 ОК
Тип содержимого: приложение / json; charset = utf-8
[
{
«ID»: «fc0ce7105baeaf97f47c99be31d02a91»,
"Тип": "Кампания",
"Название": "Первая кампания",
«Действия»: [
{
«Событие»: «Открыть»,
«Дата»: «2010-10-12 13:18:00»,
«IP-адрес»: «192.168,126,87 ",
"Деталь": ""
},
{
«Событие»: «Клик»,
«Дата»: «2010-10-12 13:16:00»,
«IP-адрес»: «192.168.126.87»,
«Деталь»: «http://example.com/post/12323/»
}
]
}
]
HTTP / 1.1 200 ОК
Тип содержимого: приложение / xml; charset = utf-8
xml version = "1.0" encoding = "utf-8"?>
<Электронная почта>
fc0ce7105baeaf97f47c99be31d02a91
Кампания
Первая кампания
<Действия>
<Действие>
Открыть
12-10-2010 13:18:00
192.168.126.87
<Подробно />
<Действие>
Щелкните
12.10.2010 13:16:00
192.168.126.87
http://example.com/post/12323/
Ответы об ошибках:
Подробную информацию о возможных ответах на любые запросы API см. В нашей документации по кодам состояния ответов.
Если вы получили ответ 400 Bad Request
на этот запрос, это возможные ошибки, которые могут быть включены в тело ответа:
- 1: неверный адрес электронной почты Адрес электронной почты отсутствует или имеет неправильный формат.
- 203: абонента нет в списке Адрес электронной почты не входит в список.Подписчик не обновлен.
Отказ от подписки подписчика
После https://api.createsend.com/api/v3.2/subscribers/{listid}/unsubscribe.{xml|json}
Изменяет статус Активного подписчика на Отписавшегося подписчика, который больше не будет получать кампании, отправленные в список подписчиков, к которому они принадлежат.
Если список настроен на добавление подписчиков, отписавшихся от подписки, в список подавления, то адрес электронной почты подписчика также будет добавлен в список подавления.
- ListID Идентификатор списка подписчиков, от которого необходимо отказаться от подписки.
{
"EmailAddress": "[email protected]"
}
<Абонент>
подписчик @ пример.ru
Ожидаемый ответ: (Одинаковый для всех языков)
HTTP / 1.1 200 ОК
Ответы об ошибках:
Подробную информацию о возможных ответах на любые запросы API см. В нашей документации по кодам состояния ответов.
Если вы получили ответ 400 Bad Request
на этот запрос, это возможные ошибки, которые могут быть включены в тело ответа:
- 1: неверный адрес электронной почты Адрес электронной почты отсутствует или имеет неправильный формат.
- 203: абонента нет в списке Адрес электронной почты не входит в список.Подписчик не обновлен.
Удаление абонента
удалять https://api.createsend.com/api/v3.2/subscribers/{listid}.{xml|json}?email={email}.
Изменяет статус активного подписчика на удаленного подписчика, который больше не будет получать кампании, отправленные на список подписчиков, к которому они принадлежат.
Это не приведет к добавлению адреса электронной почты подписчика в список подавления.
- ListID Идентификатор списка подписчиков, из которого следует удалить подписчика.
- Электронная почта Адрес электронной почты подписчика, который будет удален из списка.
Ожидаемый ответ: (Одинаковый для всех языков)
HTTP / 1.1 200 ОК
Ответы об ошибках:
Подробную информацию о возможных ответах на любые запросы API см. В нашей документации по кодам состояния ответов.
Если вы получили ответ 400 Bad Request
на этот запрос, это возможные ошибки, которые могут быть включены в тело ответа:
- 1: неверный адрес электронной почты Адрес электронной почты отсутствует или имеет неправильный формат.
Viber REST API | Центр разработчиков Viber
Начать
Для реализации API вам потребуется:
- Активная учетная запись Viber на платформе, которая поддерживает ботов (iOS / Android). Эта учетная запись будет автоматически назначена администратором учетной записи в процессе создания учетной записи.
- Активный бот — Создайте бота здесь.
- Токен аутентификации учетной записи — уникальный идентификатор учетной записи, используемый для проверки вашей учетной записи во всех запросах API. Как только ваша учетная запись будет создана, ваш токен аутентификации появится на экране «Изменить информацию» учетной записи (только для администраторов). Каждый запрос, отправленный в Viber учетной записью, должен содержать токен.
- Настройка веб-перехватчика учетной записи — это необходимо сделать один раз в процессе настройки учетной записи, чтобы определить веб-перехватчик и тип ответов, которые вы хотите получать.Для реализации API вам потребуется:
Поддерживаемые платформы
Боты в настоящее время поддерживаются на устройствах iOS и Android с Viber версии 6.5 и выше, а также на настольных компьютерах с версии 6.5.3.
Важные примечания для разработчиков ботов:
- Бот-платформа Viber открыта, и разработчики могут бесплатно создавать ботов в нашей экосистеме. Создав бота, вы можете поделиться им со своими контактами в Viber или продвигать его за пределами Viber на своем веб-сайте или в социальных сетях с помощью deeplink.Обратите внимание, что Viber не несет ответственности за продвижение вашего бота, и что по умолчанию у вашего бота не будет активной целевой страницы под viber.com после создания. Включение этого URL-адреса является частью платных услуг, которые мы предлагаем официальным партнерам. Точно так же после создания вашего бота он не будет отображаться в результатах поиска в Viber, и включение этого также является частью платных услуг, которые мы предлагаем официальным партнерам. Если вы хотите обсудить соглашение о партнерстве или узнать больше о платных каналах для продвижения вашего бота в Viber, отправьте электронное письмо на devsupport @ viber.ru и укажите информацию о своей компании, включая страну вашей компании.
- Мы рекомендуем вам записывать идентификатор подписчика каждого подписчика, так как у вашего бота нет API для получения всех идентификаторов подписчиков. Вы можете найти идентификатор подписчика в свойстве sender.id обратного вызова Message или свойстве user.id обратного вызова с подпиской. Вы можете увидеть, подписан ли пользователь, в параметре
subscribed
callback-функции talk_started. Обратите внимание, что первое сообщение пользователей боту заставит их подписаться, но не приведет к обратному вызову с подпиской. - Если вы хотите отправлять сообщения пользователям по их номерам телефонов и с помощью API, мы предлагаем услугу Business Messages, которая поддерживает это. Заявка на использование этой услуги подается через одного из наших официальных партнеров. Вы можете увидеть, какие партнеры охватывают ваш географический регион, в их описании по ссылке выше. Наши партнеры смогут предоставить вам более подробную информацию об услуге, например о ценах.
Поток сообщений отправки и получения
На следующей диаграмме описывается поток отправки и получения сообщений учетной записью.Все запросы API и обратные вызовы, упомянутые на диаграмме, будут объяснены позже в этом документе.
Токен аутентификации
Маркер аутентификации (также известный как ключ приложения) — это уникальный и секретный идентификатор учетной записи. Он используется для аутентификации запроса в Viber API и предотвращения отправки запросов неавторизованными лицами от имени бота. Каждый запрос API должен включать HTTP-заголовок под названием X-Viber-Auth-Token
, содержащий токен аутентификации учетной записи.
HTTP-заголовок
X-Viber-Auth-Token: 445da6az1s345z78-dazcczb2542zv51a-e0vc5fva17480im9
Токен аутентификации генерируется при создании бота и может быть просмотрен администраторами учетной записи на экране «Изменить информацию» своего бота или в панели администратора Viber. .
Примечание. Отказ отправить токен аутентификации в заголовке приведет к ошибке с сообщением missing_auth_token
.
Вебхуки
Получив токен, вы сможете настроить веб-перехватчик своей учетной записи. Этот веб-перехватчик будет использоваться для получения обратных вызовов и сообщений пользователей от Viber.
Настройка веб-перехватчика будет выполняться путем вызова set_webhook
API с действующим и сертифицированным URL-адресом. Это действие определяет веб-перехватчик аккаунта и тип событий, о которых аккаунт хочет получать уведомления.
По соображениям безопасности будут разрешены только URL-адреса с действующим и официальным сертификатом SSL от доверенного центра сертификации.Сертификат CA должен быть в списке доверенных корневых сертификатов Sun Java.
После отправки запроса set_webhook
Viber отправит обратный вызов веб-перехватчику, чтобы проверить его доступность и вернуть ответ пользователю. Проверка проходит успешно, если сервер Viber получает статус HTTP 200 в ответ на обратный вызов, но не проходит, если получает любой другой статус. Если ваш ответ set_webhook не имеет «status»: 0
, убедитесь, что все запросы к URL вашего веб-перехватчика получают в ответ HTTP-статус 200.
Обратите внимание, что как только вы установите веб-перехватчик, общение один на один с вашей учетной записью станет доступным. Чтобы отключить беседу один на один с вашим аккаунтом, вам нужно удалить веб-перехватчик — см. Раздел об удалении веб-перехватчика ниже.
APIViber позволяет получать имена пользователей и фотографии. Он был обновлен, чтобы соответствовать законам о конфиденциальности и позволить разработчикам, которые не используют имена пользователей и фотографии в рамках своих услуг, отказаться от участия. Если вы не используете фотографии с именами пользователей, откажитесь от значений по умолчанию.
Чтобы установить запрос, передайте флаги send_name
и send_photo
с запросом set_webhook
.
Примечание: Эта функция будет работать, если пользователь разрешил «Персонализацию содержимого» (Подробнее → Конфиденциальность → личные данные). Если пользователь запретил персонализацию контента, вы получите значения заполнителей.
Настройка веб-перехватчика
URL ресурса
https://chatapi.viber.com/pa/set_webhook
Данные публикации
{
"url": "https: // my.host.com ",
"event_types": [
"доставлен",
"видел",
"не удалось",
"подписан",
Обновление с v11 до v12
После долгой разработки Discord.js v12 был официально выпущен, а это значит, что пришло время обновиться с v11, чтобы получить новые функции для ваших ботов! Однако с этими новыми функциями в библиотеку внесено множество изменений, которые нарушат код, написанный для v11. Это руководство послужит удобным справочником для обновления вашего кода, охватывающего наиболее часто используемые методы, которые были изменены, новые темы, такие как частичные и внутреннее сегментирование, а также будет включать в себя полный список изменений методов и свойств в конце. .
СОВЕТ
У этого руководства есть две версии! Обязательно выберите v12 (стабильный)
в раскрывающемся списке в строке заголовка, чтобы получить фрагменты кода и пояснения для новой версии в руководстве.
Перед началом работы
v12 требует для использования Node 12.x или выше, поэтому убедитесь, что у вас установлена последняя версия. Чтобы проверить версию вашего узла, используйте node -v
в вашем терминале или в командной строке, и, если она недостаточно высока, обновите ее! В Интернете есть много ресурсов, которые помогут вам на этом этапе в зависимости от вашей хост-системы.
После обновления Node вы можете установить v12, запустив npm install discord.js
в терминале или командной строке для текстового использования или npm install discord.js @ discordjs / opus
для голоса служба поддержки.
Вы можете проверить свою версию discord.js с помощью npm list discord.js
. Если он по-прежнему показывает удаление v11.x ( npm uninstall discord.js
), переустановите discord.js и убедитесь, что запись в вашем package.json не препятствует обновлению основной версии.Для этого обратитесь к документации npm.
Наиболее часто используемые методы, которые изменились
- Все заголовки разделов названы в соответствии со следующим соглашением:
Class # methodOrProperty
. - Использование скобок означает необязательное включение. Например,
TextChannel # fetch (Pinned) Message (s)
означает, что этот раздел будет включать изменения дляTextChannel # fetchPinnedMessages
,TextChannel # fetchMessages
иTextChannel # fetchMessage
. - Использование звездочек обозначает подстановочный знак. Например,
TextChannel # send ***
означает, что этот раздел будет включать изменения дляTextChannel # sendMessage
,TextChannel # sendFile
,TextChannel # sendEmbed
и т. Д.
ПРЕДУПРЕЖДЕНИЕ
clientOptions.disableEveryone
был удален и заменен на clientOptions.disableMentions
!
Managers / Cache
v12 представляет концепцию менеджеров, вы больше не сможете напрямую использовать методы сбора, такие как Collection # get
, для таких структур данных, как Client # users
.Теперь вам нужно будет напрямую запросить кеш у менеджера, прежде чем пытаться использовать методы сбора. Любой метод, который вызывается непосредственно в диспетчере, вызовет API, например GuildMemberManager # fetch
и MessageManager # delete
.
Коллекция
Коллекция # существует
collection.exists ()
была полностью удалена, collection.some ()
следует использовать для проверки, существует ли в коллекции элемент, удовлетворяющий указанному значению.
Коллекция # filterArray
collection.filterArray ()
была полностью удалена, так как это был всего лишь вспомогательный метод для collection.filter (). Array ()
, и большую часть времени преобразование коллекции в массив выполняется ненужный шаг.
Collection # find
collection.find ('property', value)
был полностью удален, а collection.find ()
принимает функцию только в v12.
Коллекция # findAll
Коллекция.findAll ()
был полностью удален, поскольку он просто дублировал результаты collection.filterArray ()
.
Fetch
Некоторые методы получения некэшированных данных были изменены, преобразованы в форму Менеджера.
Send
Все методы .send *** ()
были удалены в пользу одного общего метода .send ()
.
channel.send (embedVariable)
будет работать, только если эта переменная является экземпляром класса MessageEmbed
; объектные литералы не дадут ожидаемого результата, если ваши данные для встраивания не находятся внутри ключа embed
.
Роли
Коллекция GuildMember.roles
была изменена на Менеджер в версии 12, поэтому многие связанные методы для взаимодействия с ролями участников также изменились. Их больше нет в самом объекте GuildMember, а теперь в GuildMemberRoleManager
. Менеджер содержит методы API и кеш для ролей в виде GuildMemberRoleManager # cache
, который является простой коллекцией.
Кроме того, свойства GuildMember, связанные с ролями, также были перемещены в GuildMemberRoleManager
.
Забанить и разблокировать
Метод запрета участников и пользователей перенесен в GuildMemberManager
.
URL-адреса изображений
Некоторые свойства, связанные с изображениями, например user.avatarURL
, теперь являются методом в версии 12, так что вы можете применить к ним некоторые параметры, например. чтобы повлиять на размер их дисплея.
Динамический тип файла
Версия 12 теперь позволяет динамически устанавливать тип файла для изображений. Если предоставляется опция dynamic
, вы получите .gif
URL, если изображение является анимированным, в противном случае оно вернется к указанному формату
или к своему стандартному .webp
, если не указан.
Конструктор RichEmbed
Конструктор RichEmbed был удален, и теперь используется конструктор MessageEmbed
. В основном он одинаков в использовании, единственное отличие состоит в удалении richEmbed.attachFile
( messageEmbed.attachFiles
также принимает один файл в качестве параметра) и richEmbed.addBlankField
и добавление сообщения messageEmbed.addFields
.
String Concatenation
v12 изменил поведение объектов discord.js при преобразовании в строку. При добавлении в строку структуры теперь будут отображаться как их id, когда это возможно (из-за того, что внутренний метод valueOf
изменяется в соответствии с его спецификацией). Когда toString
вызывается явно, структура преобразуется через конструктор String
или предоставляется как значение в выражениях шаблона (которые внутренне вызывают toString
), отображается формат упоминания <@id>
, который разрешает разногласия в надлежащее упоминание, если структура кэшируется в клиенте просмотра (в v11 и toString
, и valueOf
показали то же поведение, что и toString
, теперь).
Методы только для учетной записи пользователя
Все методы, предназначенные только для учетной записи пользователя, были удалены, так как они больше не являются общедоступными из API.
Voice
v12 имеет новую голосовую систему, которая повышает стабильность, но также содержит некоторые изменения в воспроизведении звука:
Теперь вы также можете воспроизводить файлы Ogg Opus или WebM Opus напрямую без необходимости использования FFmpeg в v12:
It также возможно определить начальные значения для plp
, fec
и битрейта
при воспроизведении потока.Минус битрейт, это новые настраиваемые параметры в версии 12, которые могут помочь при воспроизведении звука при нестабильных сетевых подключениях.
Если вы не хотите изменять громкость потока во время его воспроизведения, вы можете отключить громкость для повышения производительности. Это не может быть отменено во время воспроизведения.
Внутренняя голосовая система в версии 12 теперь использует потоки, где это возможно, и поэтому сам StreamDispatcher теперь является WritableStream. Он также содержит новые изменения:
Вы можете вручную контролировать, сколько аудиопакетов должно быть поставлено в очередь перед воспроизведением звука для более согласованного воспроизведения, используя опцию highWaterMark
(по умолчанию 12)
Если вы часто приостанавливаете / возобновляете звук stream, вы можете включить воспроизведение пакетов тишины во время паузы, чтобы предотвратить сбои звука на клиенте Discord. аудиопоток.
Критические изменения и удаления
Заголовки разделов для критических изменений будут названы в честь классов / методов / свойств v11 и будут располагаться в алфавитном порядке, чтобы вы могли легко найти то, что ищете. Заголовки разделов для дополнений будут названы в честь классов / методов / свойств v12, чтобы соответствующим образом отразить их текущий синтаксис.
Блоки кода «Различия» будут использоваться для отображения старых методов по сравнению с новыми — красный — это то, что было удалено, а зеленый — его замена.Некоторые биты могут иметь более одной версии обработки. Для отображения дополнений будут использоваться стандартные блоки кода синтаксиса JavaScript.
WARNING
Хотя этот список был тщательно составлен, он может быть неполным! Если вы заметили недостающие или неточные данные, мы рекомендуем вам отправить запрос на перенос!
Зависимости
Snekfetch
Обратите внимание, что snekfetch
удален как зависимость и заменен на node-fetch
. snekfetch
устарел разработчиком и больше не поддерживается.
Attachment
Класс Attachment
был удален в пользу класса MessageAttachment
.
Клиент
Клиент # fetchUser
client.fetchUser ()
был удален и преобразован в менеджер.
Client # Broadcasts
client.broadcasts
был удален и теперь находится в классе ClientVoiceManager
.
Client # browser
client.browser
был изменен на внутреннюю константу и больше не доступен публично.
Клиент # каналы
client.channels
изменен с Коллекции на Менеджер.
Client # clientUserGuildSettingsUpdate
Событие client.clientUserGuildSettingsUpdate
было полностью удалено вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
Клиент # clientUserSettingsUpdate
Клиент .Событие clientUserSettingsUpdate
было полностью удалено вместе со всеми другими свойствами и методами только для учетной записи пользователя.
Client # destroy
Метод client.destroy ()
больше не возвращает Promise.
Client # disconnect
Событие client.disconnect
было удалено в пользу события client.shardDisconnect
, чтобы использовать внутреннее сегментирование.
Клиент # emojis
client.emojis
изменен с Коллекции на Менеджер.
Клиент # guildMemberSpeaking
Параметр Speaking
был изменен с логического значения на значение
Speaking
только для чтения.
Client # guilds
client.guilds
изменен с Коллекции на Менеджера.
Client # ping
client.ping
был перемещен в WebSocketManager под client.ws.ping
Client # pings
client.pings
был перемещен в класс WebSocketShard
для использования внутреннего сегментирования. Класс Client
имеет коллекцию
из WebSocketShard
, доступных через client.ws.shards
; в качестве альтернативы WebSocketShard
можно найти как свойство других структур, например guild.shard
.
Клиент # присутствует
client.presences
был удален, чтобы уменьшить количество посторонних получателей.
Клиент # присутствиеОбновление
Клиент .PresenceUpdate
был изменен и теперь передает старый и новый Presence
, а не GuildMember
.
Client # reconnecting
Событие client.reconnecting
было удалено в пользу события client.shardReconnecting
для использования внутреннего сегментирования.
Client # resume
Событие client.resume
было удалено в пользу события client.shardResume
для использования внутреннего сегментирования.
Client # status
Свойство client.status
было удалено и теперь находится в классе WebSocketManager
. Кроме того, он больше не является геттером.
Клиент # syncGuilds
client.syncGuilds ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
Клиент # typingStop
Событие client.typingStop
было полностью удалено, так как это было событие, созданное библиотекой, а не фактическое событие Discord WebSocket.
Клиент # userNoteUpdate
Событие client.userNoteUpdate
было полностью удалено вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
Client # users
client.users
изменен с Коллекции на Менеджер.
Client # voiceConnections
client.voiceConnections
был удален и теперь находится в классе ClientVoiceManager
. Кроме того, Collection
больше не является геттером.
Клиент # voiceStateUpdate
Событие client.voiceStateUpdate
теперь возвращает oldState
и newState
, представляющие VoiceState
участника до и после обновления, в отличие от самого участника.
ClientOptions
Было внесено несколько изменений в объект ClientOptions
, расположенный в client # options
.
ClientOptions # apiRequestMethod
clientOptions.apiRequestMethod
сделан последовательным и используется внутри компании.
ClientOptions # shardId
clientOptions.shardId
был изменен на clientOptions.shards
и теперь также принимает массив чисел.
ClientOptions # shards
clientOptions.shards
был удален и функционально эквивалентен clientOptions.shardCount
в версии 12.
ClientOptions # sync
clientOptions.sync
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientOptions # disabledEvents
clientOptions.disabledEvents
был удален в пользу использования намерений. Пожалуйста, обратитесь к нашей более подробной статье по этой теме
ClientUser
ClientUser # acceptInvite
clientUser.acceptInvite ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # addFriend
clientUser.addFriend ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # avatarURL
clientUser.avatarURL
теперь является методом, а не свойством. Это также позволяет вам определить формат и размер файла, который нужно вернуть. Параметр dynamic
позволяет всегда получать файл .gif,
для анимированных аватаров. В противном случае возвращенная ссылка вернется к формату, указанному в опции формата или
.webp
(по умолчанию), если ничего не указано.
ClientUser # block
clientUser.block ()
был полностью удален вместе со всеми другими свойствами и методами только для учетной записи пользователя.
ClientUser # blocked
clientUser.blocked
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # createGuild
clientUser.createGuild ()
был удален и преобразован в форму Менеджера.Кроме того, второй и третий параметры в clientUser.createGuild ()
были изменены / удалены, оставив всего два параметра. Параметры области и значка
из v11 были объединены в объект в качестве второго параметра.
ClientUser # displayAvatarURL
clientUser.displayAvatarURL
теперь является методом, а не свойством. Это также позволяет вам определить формат и размер файла, который нужно вернуть. Если предоставляется опция dynamic
, вы получите .gif
URL, если изображение является анимированным, в противном случае оно вернется к указанному формату
или к своему стандартному .webp
, если не указан.
ClientUser # email
clientUser.email
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # fetchMentions
clientUser.fetchMentions ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # fetchProfile
clientUser.fetchProfile ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # friends
clientUser.friends
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # guildSettings
clientUser.guildSettings
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # mfaEnabled
clientUser.mfaEnabled
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # mobile
clientUser.mobile
был полностью удален вместе со всеми другими свойствами и методами, предназначенными только для учетной записи пользователя.
ClientUser # note
clientUser.note
был полностью удален вместе со всеми другими свойствами и методами только для учетной записи пользователя.
ClientUser # notes
clientUser.notes
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
clientUser.premium
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # removeFriend
clientUser.removeFriend ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUser # send ***
Как и методы TextChannel # send ***
, все методы .send *** ()
были удалены в пользу одного общего метода .send ()
. Прочтите раздел TextChannel # send *** для получения дополнительной информации.
ClientUser # setGame
clientUser.setGame ()
был изменен на clientUser.setActivity ()
. Второй параметр больше не для предоставления URL-адреса потоковой передачи, а скорее для объекта, который позволяет указать URL-адрес и тип действия.
ClientUser # setNote
clientUser.setNote ()
был полностью удален вместе со всеми другими свойствами и методами только для учетной записи пользователя.
ClientUser # setPassword
clientUser.setPassword ()
был полностью удален вместе со всеми другими свойствами и методами, предназначенными только для учетной записи пользователя.
ClientUser # settings
clientUser.settings
был полностью удален вместе со всеми другими свойствами и методами, предназначенными только для учетной записи пользователя.
ClientUser # unblock
clientUser.unblock ()
был полностью удален вместе со всеми другими свойствами и методами только для учетной записи пользователя.
ClientUserChannelOverride
Класс ClientUserChannelOverride
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUserGuildSettings
Класс ClientUserGuildSettings
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
ClientUserSettings
Класс ClientUserSettings
был полностью удален вместе со всеми другими свойствами и методами только для учетной записи пользователя.
ClientUserChannelOverride
Класс ClientUserChannelOverride
был полностью удален.
ClientUserGuildSettings
Класс ClientUserGuildSettings
был полностью удален.
ClientUserSettings
Класс ClientUserSettings
был полностью удален.
Коллекция
Коллекция # find / findKey
Оба метода теперь возвращают undefined
, если ничего не найдено.
Collection # deleteAll
collection.deleteAll ()
был удален в пользу метода clear ()
карты по умолчанию.
Коллекция # существует
collection.exists ()
была полностью удалена в пользу collection.some ()
Collection # filterArray
collection.filterArray ()
был полностью удален.
Collection # findAll
collection.findAll ()
был полностью удален, поскольку ту же функциональность можно получить с помощью collection.filter ()
.
Коллекция # first / firstKey / last / lastKey / random / randomKey
Параметр amount
этих методов теперь допускает отрицательное число, которое будет запускать запрос с конца коллекции, а не с начала.
Коллекция # tap
Коллекция.tap
запускает определенную функцию над коллекцией вместо имитации
, эта функция была перемещена в collection.each ()
.
Коллектор
Коллектор # cleanup
collector.cleanup ()
был полностью удален.
Collector # handle
collector.handle ()
был изменен на collector.handleCollect ()
.
Коллектор # postCheck
Коллектор.postCheck ()
был заменен на сборщик .checkEnd ()
.
DMChannel
DMChannel # подтверждение
dmChannel.acknowledge ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
DMChannel # createCollector
dmChannel.createCollector ()
удален и заменен на dmChannel.createMessageCollector ()
.
СОВЕТ
Обратите внимание, что поведение параметров коллектора изменилось! Смотрите этот раздел для более подробной информации!
DMChannel # fetch (закреплено) Сообщение (я)
dmChannel.fetchMessage (s)
был преобразован в менеджер. Дополнительные сведения см. В разделе TextChannel # fetch (закрепленные) сообщения.
DMChannel # search
dmChannel.search ()
был полностью удален вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.
DMChannel # send ***
Так же, как методы TextChannel # send ***
, все методы .send *** ()
были удалены в пользу одного общего .send ()
метод. Прочтите раздел TextChannel # send *** для получения дополнительной информации.
Emoji
Emoji
теперь расширяет Base
и представляет собой GuildEmoji
или ReactionEmoji
, и некоторые из конкретных свойств перемещены в соответствующий объект, а не все на базовом объекте Emoji
.
Emoji # *** RestrictedRole (s)
Вспомогательные методы для добавления и удаления роли или ролей из ролей, которым разрешено использовать смайлики, теперь настраиваются через GuildEmojiRoleManager
.
Emoji # deletable
emoji.deletable
был перемещен в guildEmoji.deletable
.
Emoji # fetchAuthor
emoji.fetchAuthor ()
перемещен в guildEmoji.fetchAuthor ()
.
Emoji # guild
emoji.guild
был перемещен в guildEmoji.guild
.
Emoji # setName
emoji.setName ()
был перемещен в guildEmoji.setName ()
.
EvaluatedPermissions
AssessmentPermissions
полностью удален, см. Страницу Permissions
.
Game
Класс Game
был удален в пользу класса Activity
, чтобы соответствовать API. Это также массив из нескольких Activity, поскольку у пользователя может быть несколько.
GroupDMChannel
Класс GroupDMChannel
исключен из Discord API.Пока он все еще доступен через Gamebridge, но в будущем он также будет удален. Кроме того, групповые DM всегда были ненадежными и хакерскими для работы с ботами.
Гильдия
Гильдия # признать
guild.acknowledge ()
была полностью удалена вместе со всеми другими свойствами и методами, доступными только для учетной записи пользователя.