Как делать платные и бесплатные рассылки в Viber Navika.Pro

Дата публикации: 17 января 2019 г.

Из популярного мессенджера для личного общения Viber превратился в эффективный канал коммуникации бизнеса с клиентами. Мессенджер предлагает гораздо больше форматов сообщений, чем стандартные СМС-рассылки, и демонстрирует более высокий уровень просмотра (Open Rate при правильном подходе к базе подписчиков и рассылкам достигает 90%), чем традиционный e-mail.

О популярности Viber говорят цифры:

Рассылки в Viber безопасны (бизнес-сообщения защищаются механизмом сквозного шифрования), интерактивны (сообщения содержат кнопки, ссылки, кликабельные изображения), эффективны (рассылки от компаний получают официальную метку — галочку зеленого цвета, благодаря этому уровень доверия к рассылкам повышается).

Рассылки официальных аккаунтов отмечаются зелеными метками

Viber предлагает два типа рассылок: бесплатные и платные.

Бесплатные рассылки также позволяют отправлять изображения (отдельными сообщениями), ссылки, однако придать этому интересный интерактивный вид не получится. Добавить UTM-метку нельзя. Не поддерживаются и кнопки призыва к действию.

Отчетность по такой рассылке также не формируется. То есть отследить отправку, открытие сообщений возможно исключительно вручную, проверяя каждый отдельный чат с контактами из списка рассылки. Клики по ссылкам в бесплатном варианте отследить не получится. Сообщения отправятся только тем, у кого номер добавлен в контакты.

Такой вариант рассылки подойдет лишь небольшому местному бизнесу, который только наращивает потенциал, нарабатывает базу, а клиенты прекрасно знают, кому принадлежит номер. К таким бизнесам относятся местные компании — небольшие салоны красоты, мини-пекарни, кафе, мастера, предоставляющие частные услуги (бьюти, ремонт и т.д.).

Платные рассылки через Viber позволяют создавать и рассылать брендированный контент, содержащий изображения, ссылки, СТА-кнопки, добавлять к сообщениям UTM-метки для отслеживания активности пользователей, получать отчеты.

Преимущества платных рассылок очевидны:

• сообщения получают все адресаты вне зависимости от того, добавлен ли номер в контакты или нет;
• отсутствуют ограничения по количеству адресатов в списке рассылки;
• поддерживаются все форматы сообщений: текст, изображения, ссылки, СТА-кнопки, UTM-метки.

Платные рассылки осуществляются через сторонние сервисы, аккредитованные в Viber. Список доступен по ссылке.

Платные рассылки Viber подойдут крупному бизнесу с большой базой клиентов,

Рассылки в Viber, платные или бесплатные, работают эффективнее стандартных коротких СМС-сообщений.

Сообщение из рассылки Viber вмещает до 1000 символов в сравнении со 140 символами стандартного СМС.

Даже в бесплатной версии рассылки пользователям можно отправить рекламное изображение. СМС не поддерживает медийный контент. Любые изображения отправляются через MMS, а это дороже.

Платные рассылки Viber обходятся дешевле, чем СМС. Стоимость одного сообщения зависит от региона рассылки и количества отправок в месяц. В отличие от СМС, оплачиваются только доставленные сообщения.

Сервисы Viber-рассылок предлагают подробную аналитику по каждой кампании: сколько сообщений доставлено, сколько открыто, сколько пользователей перешло по ссылке.

Некоторые сервисы предлагают дополнительные функции доотправки сообщений по СМС, если номер в списке рассылки не зарегистрирован в Viber.

Рассылка в Viber, платная или бесплатная, должна руководствоваться теми же правилами, что и любая email-кампания.

Нельзя просто взять номера и разослать по ним рекламные сообщения. Во-первых, непрошеные сообщения в Viber пользователи также успешно отправляют в спам. Во-вторых, эффективность любой рассылки зависит от интереса целевой аудитории и актуальности предложения. Вот так выглядит сообщение у пользователя, который не давал согласия на рассылку. Если пользователь не поймет, кто ему пишет и зачем, может отправить сообщение сразу в бан:

Viber дает возможность сразу отказаться от прочтения неофициальной рассылки

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

После открытия сообщения бесплатной рассылки часть текста скрыта системными настройками

Медиафайлы при этом не отображаются, а ссылки остаются некликабельными.

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

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

Пользователи могут отключать слишком назойливые рассылки

Не существует однозначных рекомендаций по оптимальной частоте рассылок. Она определяется спецификой вашего бизнеса. В этом вопросе стоит придерживаться простого правила:

Не рассылайте сообщения ни о чем — пишите только тогда, когда вам есть что сказать.

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

Любые ошибки могут стоить вам клиента.

Не все рассылки в Viber одинаково полезны. Чтобы сообщение, что называется, зашло пользователям, оно должно быть:

• уместным — уведомление о скидках, об истечении срока действия услуги, приглашение на событие должны приходить заранее;
• коротким и четким — из короткого сообщения пользователь должен четко понять, что ему предлагают и как это получить;
• с понятным призывом к действию — СТА-кнопка должна указывать, что пользователь получит по клику. Призывы «узнать больше / детали» работают хуже, чем указание результата «получить скидку, купить со скидкой», «продлить льготный период», «получить бесплатно» и т.д.

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

Devino Telecom: сервис Viber-рассылка

Официальный сервис доставки сообщений, одобренный компанией Viber. Зарегистрируйте Ваш официальный канал уже сейчас и отправляйте рекламные рассылки через Вайбер, транзакционные сообщения и общайтесь со своей аудиторией прямо в мессенджере.

Подключения

Devino.Online Devino.Gate Devino.API

Devino.Online

Новый online-сервис мультиканальных коммуникаций, сочетающий простоту интерфейса, многозадачность и детализированную статистику

SMS сервисы

Распространяйте персонифицированные SMS-сообщений информационного или рекламного характера от имени вашей компании. Взаимодействуйте со всеми операторами связи в рамках одного договора.

Viber рассылка

Email рассылка

Создавайте красочные и информативные электронные письма, используя различные варианты легко настраиваемых блоков. Отслеживайте статистику по результатам отправки, времени доставки, проценту открытия и перехода по активным ссылкам.

Мультиканальные цепочки

Выстраивайте персонализированные цепочки коммуникации с клиентом, используя разные точки входа. Реализуйте оперативное взаимодействие с клиентами по средствам SMS-, Viber-, или E-mail-рассылок, проводите исследования поведенческих факторов и анализируйте эффективность.

Системное интеграционное решение для крупного бизнеса на любом уровне

Проектирование

Подбираем комплексное решение под конкретную бизнес задачу с учетом отраслевой специфики и целеполаганий клиента. Технический штат компании более 100 человек позволяет взять на себя полную настройку системы: управление проектами, аналитику, разработку, тестирование, внедрение, сопровождение, мониторинг и клиентский сервис. Обеспечиваем качественное и быстрое решение любых задач.

Эффективность

Расширим ваши возможности! Проведем консалтинговые и маркетинговые исследования. Настроим интеграцию с вашей CRM и CMS: с SAP CRM, Siebel CRM, Microsoft Dynamics CRM, Oracle или 1С Битрикс. Автоматизируем и объединим бизнес процессы с персоналом в единую экосистему. Окажем юридическую поддержку и разработаем коммуникационную стратегию для достижения конкретных целей.

Результат

Заказчик получает комплексное решение, разработанное для реализации конкретных бизнес-задач с учетом отраслевой специфики. Коммуникации с клиентами осуществляются на надежной и качественной инфраструктуре Devino Telecom. Специалисты и эксперты компании оказывают оперативную бизнес и техническую поддержку в круглосуточном режиме.

Devino.API

Используйте удобный API-сервис Devino Telecom
и выстраивайте общение с клиентами по всем каналам
привлечения трафика

Отправить SMS сообщение

Отправка Viber сообщений

Создать email сообщение

# Send SMS
POST /messages
Authorization: Key QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Accept: application/json
{
    "messages": [
        {
            "from": "MyCompany",
            "to": "79034567890",
            "text": "Code: 1234"
        }
    ]
}
# Response
{
    "result": [
        {
            "code": "OK",
            "messageId": "3482512350952730368"
        }
    ]
}

# Request
POST /messages
Authorization: Key QWxhZGRpbjpvcGVuIHNlc2FtZQ==
Content-Type: application/json
Accept: application/json
{
    "messages":[
            {
                "from": "MyCompany",
                "to": "79034567890",
                "text": "Code: 1234",
                "image": "https://cdn.mycompany.com/viber.png",
                "action": "https://mycompany.com/promo",
                "caption": "Activate!"
            }
        ]
}
# Response
{
    "result": [
        {
            "code": "OK",
            "messageId": "3482512350952730368"
        }
    ]
}

# Request
curl "https://integrationapi.net/email/v2/Messages" \
		--user sammy:fAj$xna)vm \
		-H "Content-type: application/json" \
        -d '{
              "Sender":{
                "Address":"[email protected]",
                "Name":"Sammy"
              },
              "Recipients":[
                {
                  "MergeFields":{
                    "Name":"Иван"
                  },
                  "Address":"[email protected]",
                  "Name":"Ivan"
                }
              ],
              "Subject":"Уважаемый [Name]!",
              "Body":{
                "Html":"Уважаемый [Name]! Ждем вас завтра! [Unsubscribe]",
                "PlainText":"Уважаемый [Name]! Ждем вас! [Unsubscribe]"
              }
            }'

# Response
{
  "Result":[
    {
      "Index":0,
      "Address":"[email protected]",
      "MessageId":"MSWIr1YYD2P",
      "Code":"ok"
    }
  ],
  "Code":"ok",
  "Description":"ok"
}

Плюсы и минусы рассылки через Вайбер

Сейчас клиентам доступно множество каналов общения со своей аудиторией через мобильные мессенджеры, однако рассылка Viber имеет ряд отличительных плюсов:

• Выгодность рассылки – стоимость одного доставленного до клиента сообщения обходится компании значительно дешевле, чем оплата альтернативных текстовых форматов рекламы.
• Информативность сообщений – нет необходимости ограничиваться сухим текстом. Дополняйте его яркими фотографиями и активными ссылками на ваш сайт.
• Доступность – приложение можно бесплатно скачать и установить практически на любой смартфон, и его дальнейшая эксплуатация не потребует никаких материальных затрат со стороны пользователя.
• Постоянно растущая аудитория – сейчас почти у каждого человека в наши дни есть смартфон с уже предустановленными мессенджер-приложениями, среди которых Viber является одним из самых популярных. Если обратиться к статистическим данным, практически 60% жителей России открывали данный мессенджер за последний год, а порядка 40% используют его как один из основных коммуникационных каналов постоянно. Это значит, что отправленная Вайбер рассылка наверняка дойдет до адресата.
• Простота взаимодействия – клиенту нет необходимости отключаться от общения или деловой переписки и выходить из приложения. Переключение на канал интуитивно понятно и не требует специальных навыков.

Несмотря на большое количество плюсов, стоит упомянуть и о минусах. Основной из них – невозможность сервисной рассылки через Вайбер, если приложение не установлено на смартфоне клиента. Однако данный минус легко покрывается возможностями нашей платформы и личного кабинета: там, где Вайбер оказался бессилен, конечной цели достигнут СМС-сообщения, для этого достаточно лишь настроить мультиканальную связь при создании новой рассылки.

Как показывают статистические данные, выбор комплексного подхода в каскадной рассылке сообщений приносит большую результативность и существенно экономит рекламный бюджет. Не стоит забывать и о том, что ваши клиенты используют разные каналы. Соответственно, задействование большего количества инструментов существенно увеличивает шансы на то, что человек получит и прочитает адресованное ему сообщение.

Секреты успешной рассылки

На что стоит обратить внимание, планируя коммуникацию с клиентами через Вайбер рассылку?

1. Отправляйте своей аудитории только те сообщения, которые будут потенциально ей интересны. Покупатели интернет-магазина оценят новости о новой коллекции, в то время как читатели тематического портала не пропустят дайджест самых популярных публикаций недели. Следование этому правилу повысит лояльность клиентов к компании.
2. Рассылайте Viber-рекламу через сервис исключительно тем, кто официально дал согласие на получение рассылки. В противном случае программа заблокирует вас без возможности восстановления аккаунта. Нарушение регламента чревато попаданием в спам и пристальным вниманием со стороны организаций, контролирующих соблюдение закона о рекламе.
3. Стимулируйте клиента совершить действие, которое вы от него ждете. Обязательно добавьте в сообщение кнопку действия или гиперссылку, перейдя по которой, адресат воспользуется вашим предложением.

Стоимость Viber рассылки | Stream Telecom

Инвестируйте в удобство и комфорт ваших клиентов, выбирая Viber рассылки в Stream Telecom.

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

От чего зависит цена при запуске рассылки в Viber

▶ Выбор имени отправителя для рассылки.
Рассылка в Viber может производиться как от имени компании, так и от общего имени (Info/Inform/Info Navigator и др.).

• Рассылка от брендового имени предполагает фиксированную абонентскую плату, в которую входит и имя отправителя и пакет сообщений. От брендового имени отправителя можно запускать как рассылку рекламных сообщений в Viber, так и рассылку сообщений, направленных на информирование клиентов (так называемых сервисных сообщений).
• Рассылка от общего имени не предполагает абонентской платы и стоимость одного сообщения будет зависеть исключительно от суммы пополнения счёта. От общего имени можно рассылать только рекламные сообщения.

▶ Сумма пополнения.
Помимо имени отправителя, на стоимость отправки сообщений в Viber также влияет сумма пополнения баланса. Чем больше сумма, тем дешевле сообщение. При этом разница в стоимости одного сообщения при пополнении на минимальную и максимальную сумму составляет до 30%.

О чём ещё стоит помнить при оценке стоимости рассылки в Viber:

• Оплата производится только за доставленные сообщения. В отличие от СМС рассылок, в Viber списывается оплата только за те сообщения, которые получены адресатом.
• В цену одного Viber сообщения входит до 1000 символов текста с изображением или видео и кликабельной кнопкой. Таким образом при больших объёмах рассылаемого текста, или выборе между СМС и MMS сообщением — Viber рассылка может стать отличной альтернативой.
• Рассылки можно запускать поочерёдно в нескольких каналах (т. н. каскадные рассылки). Например, рассылка сначала запускается в Viber, потом, в случае недоставки, по абонентам не получившим сообщения запускается СМС рассылка.

что лучше для массовых рассылок — Маркетинг на vc.ru

Объясняет за 5 минут Виктория Грибенко из UniSender.

2315 просмотров

Viber, SMS или всё вместе? UniSender

— SMS надежнее. Любой человек получит SMS!

— Viber быстрее и красивее!

— А если нет смартфона?

— А если нет сети?

Разбираемся, что эффективнее: рассылки в Viber или SMS.

Особенности SMS-рассылок

Как отправляются. Для отправления SMS используется мобильная связь. То есть доступ в интернет не нужен.

Кому отправлять. Охват огромен. Почти у каждого человека есть мобильный телефон. Даже если это не смартфон, функцию SMS он точно поддерживает. Но! Пересмотрите базу. Если большая часть клиентов находится за границей, придется переплатить.

Как выглядят. Здесь функционал не очень-то шикарен. Только текст. 1 SMS = 70 знаков кириллицей. Не густо. Хочешь больше знаков? Плати за 2 SMS.

Дополнительные возможности. Мобильные операторы предлагают таргетированную рекламу. Базу можно сегментировать по разным признакам, даже по операционной системе телефона.

• таргетинг;

• охват;

• SMS придет всем, не важно, какой телефон.

Особенности Viber-рассылок

Как отправляются. Через интернет. Если соединение нестабильно, сообщение придет тогда, когда оно восстановится. Но только в течение 1440 минут. Это срок жизни отправленного сообщения. После 1440 минут, если интернета все еще нет, сообщение не доставится.

Кому отправлять. Очевидно, что Viber используют меньше людей, чем SMS. Но приложение очень популярно в России и странах СНГ.

Как выглядят. Дизайн сообщений в Viber — его основной плюс:

• 1000 символов в сообщении;
• можно добавить яркий баннер;
• кнопка с прямой ссылкой и UTM-метками.

Дополнительные возможности. Оплата только за доставленные сообщения. Это безусловно выгодно, дешевле, чем SMS. Но выгоднее только, если вы отправляете не меньше 16 000 сообщений в месяц. Потому что есть минимальный ежемесячный платеж, рассчитанный на определенное количество отправлений.

Еще один плюс — наличие подробной статистики. Вы всегда знаете, сколько человек прочли сообщение и сколько перешли по ссылкам.

• дизайн сообщений;
• оплата только за доставленные сообщения;
• подробные отчеты после отправки.

• охват;
• дополнительные условия подключения (минимальный платеж).

Сравним каналы

Итак, хотелось бы создать для вас таблицу с подробным сравнением этих каналов по определенным критериям. Но это невозможно. Сравнить рассылки в SMS и Viber это так же, как сравнить велосипед и арбуз.

Если вы посмотрите на все плюсы и минусы двух каналов, то поймете: чего нет в SMS — есть в Viber. И наоборот. Тогда зачем их сравнивать, если они прекрасно дополняют друг друга и могут работать, как единый механизм?

Некоторые компании практикуют цепочку сообщений через несколько инструментов. Например, отправляем уведомление в Viber (напомню, оно дешевле, чем SMS). Ждем отчет. Если не доставлено — отправляем SMS.

Мы спросили экспертов, какому каналу они отдают предпочтение. Мнения разные, но идея одна.

Ринат Сибгатуллин, руководитель направления CRM и email-маркетинга i-Media советует прогонять базу через Viber, и добивать SMSками.

Использовать надо и Viber и SMS. SMS лучше использовать для критичного информирования, всем придет ваше сообщение. Viber больше подойдет для массовых рассылок. Но самые бережливые давно поняли, что массовую рассылку надо делать каскадно, сначала прогонять базу через Viber, а потом добивать SMS.

Ринат Сибгатуллин

Руководитель направления crm и email-маркетинга i-Media

Иван Овощников, email-маркетолог DreamTeam, также рекомендует делать рассылку в Viber и дополнять ее SMS. Например, так:

Отправляем сообщение в Viber. Если не доставлено, то шлём SMS. Если доставлено, то смотрим, было ли открыто. Если нет, то шлём SMS. Если открыли и прочитали, то SMS не шлём.

В случае, когда сообщение должно быть доставлено моментально, лучше отправлять SMS. Например, напоминание о том, что вебинар, на который записался человек, начинается через 5 минут.

Или, опять же, отправить сообщение в Viber, если оно не было доставлено моментально, то отменять дальнейшую попытку отправки и отправить SMS.

Иван Овощников

Email-маркетолог DreamTeam

Вывод

Выбирая только один инструмент для рассылки, вы снижаете ее эффективность. База не может быть однородной: кто-то не использует смартфон, а кто-то не читает SMS, используя только мессенджеры. А некоторые любят рассматривать фото товаров на большом экране, поэтому воспринимают информацию только из email. Люди разные.

Нужно рассылать по нескольким каналам. А лучше, минимум по трем: Viber, SMS и email. Такая схема во много раз увеличивает шансы на более эффективную коммуникацию с клиентом.

белая, серая и бесплатная — Блог SigmaSMS

Бесплатная Viber рассылка

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

1. Максимальный объем — 50 контактов. 
2. Сообщения доставляются пользователям, сохранившим ваш номер телефона. 
3. Картинка отправляется отдельным сообщением.  

Бизнес-функции не доступны. В сообщение нельзя вставить кнопку. Доступа к статистике нет. Бесплатные рассылки не подходят для бизнеса, а скорее для личного общения. 

Платная рассылка в Viber. 

Не имеет ограничений бесплатного варианта. Отправка сообщений не зависит от количеста получателей. В сообщение прикрепляются картинки и кнопка звонка или перехода на сайт. Функционал платных рассылок отлично подходит для бизнеса.  

Отметим, что в Viber вы платите за доставленные сообщения, что экономит бюджет на рассылки. Стоимость рассылки в мессенджере на 20% ниже, чем СМС. Подробности смотрите в разделе тарифы.

Сравнение «серого» и «белого» Viber 

Официальный канал рассылки считается «белым». «Серый» Viber — неофициальные программные врезки. Из этого вытекает преимущество — они дешевые, правда без гарантий. Поэтому в 50% случаев неофициальные сообщения не приходят пользователям.

Сравним другие параметры:

Внимательный читатель обратит внимание на строку предупреждение о  спаме. В случае неофициального вайбера получатель сообщения не сможет его прочитать. Сначала появится всплывающее окно, которое сообщит что сообщение похоже на спам. И предложит его удалить, пожаловаться на спам или прочитать на свой страх и риск. Логично, что большинство людей верят мессенджеру, а конверсия рассылки снижается. Скриншоты сравнение двух каналов вайбер:

Какая рассылка лучше подходит для бизнеса?

Лучшим решением для бизнеса будет использование официальных рассылок в Viber. Бесплатный вайбер подходит только для личного общения из-за своих ограничений. «Серые» рассылки – не показывают высокой конверсии и блокируются мессенджером.  

Рассылка Viber, программы-рассыльщики сообщений по Виберу

Рассылка в Viber — это разнообразные действия, предпринимаемые для отправки одного или нескольких сообщений (с картинками, вложениями или без них) нескольким пользователям сразу. Популярность данного вида донесения до адресатов информации возрастает, поэтому рассматриваемая тема будет интересна большому кругу интернет-пользователей.

Самый логичный способ рассылки

Рассылка сообщений при помощи и с использованием средств Вайбера может осуществляться интересным, 100%-м способом. Создание чатов для общения по интересам групп людей — это самый логичный способ создания массовой рассылки, так как его не могут заблокировать в отличие от других способов осуществления массовых оповещений людей о чем-то (не исключая рекламы).

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

1. Открыть программу Вибер.
2. Перейти в раздел чатов (он может выглядеть как значок сообщения).
3. Нажать на кнопку создания нового чата, которая обычно выглядит как плюсик.
4. Внести название (оно должно быть оригинальным, но в то же время — отражать сущность вопросов, на которые хотят получить ответы все участники такого чата).
5. Когда с созданием чата (группы) все будет закончено, добавьте участников путем нажатия на значок с изображением нескольких людей и значка плюса.
6. Выберите всех участников, тапнув по специально предназначенному месту перед каждым именем так, чтобы появилась зеленая галочка.
7. Нажмите на кнопочку «Готово!» (в некоторых версиях «Сохранить»).

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

Как еще можно найти программу — рассыльщик?

Чтобы отыскать программу, которая будет отправлять быстро и качественно ваши сообщения многим людям, попробуйте найти специальное приложение в интернете. Для этого:

1.Зайдите в любимый интернет-браузер.

2.В любом поисковике напишите словосочетание: «Программа для рассылки в Viber». Можно также добавить: «скачать бесплатно».

3.Среди найденных программ будет очень много вариантов:

• Mass Advert Viber Pro 2.3.4 (применяется «ВайберТехнолоджи 3» для предотвращения проблем с блокированием, также есть встроенный генератор текстов).
• Viber рассыльщик (может рассылать сообщение сразу с нескольких учетных записей, предварительно проверяя, есть ли у абонента Вайбер, также поддерживается рассылка картинок).
• Программы Viber Bulk Sender и Viber Checker (прекрасно справляются с быстрой проверкой большого диапазона телефонных номеров на наличие установленного клиента Вайбера, чтобы после этого пользователь мог выслать на них сообщения).
• ViberAd (позволяет быстро разослать ваши рекламные и другие оповещения).

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

Итак, сделать массовую рассылку с помощью средств Вайбера (через Viber) нетрудно. Можно создать группу пользователей и делиться с ними полезной информацией, а можно найти и установить специальную программу, которая сделает рассылку, предварительно отыскав возможные номера получателей.

Viber рассылка сообщений в Беларуси, официальный канал

Как сделать рассылку в вайбере?

Создать рассылку через вайбер с помощью сервиса Devino Telecom легко и просто:

1. Свяжитесь с нашими менеджерами, подпишите единый договор на осуществление рассылок смс по всем операторам Республики Беларусь и сервисного провайдера Viber.
2. Зарегистрируйте и подтвердите имя вашего вайбер-канала.
3. Выберите канал коммуникации с уже имеющимися подписчиками по базе мобильных номеров или настройте сценарий таргетированной рекламной кампании.

Секреты успешных вайбер коммуникаций

За многолетний опыт работы в сфере онлайн-коммуникаций наши специалисты помогли осуществить и провели аналитику более миллиона вайбер сообщений. Сейчас мы готовы поделится основными секретами успеха по работе с этим мессенджером:

• Коммуницируйте исключительно с теми, кто дал свое согласие на получение рассылок.

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

Когда рост в рамках собственной базы уже невозможен, воспользуйтесь официальной сервисной рассылкой по вайберу. Многие пользователи приложения в Беларуси используют данный тип подписки исключительно для получения товарных предложений с реальной выгодой. Правильно созданная вайбер рассылка не просто приводит к росту прямых продаж, а существенно влияет на общий уровень лояльности к бренду.

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

• Создавайте потенциально интересные рассылки для каждого сегмента своей клиентской базы.

Внутренняя проработка и сегментация базы очень важна. Представьте, что обычная женщина, домохозяйка, получает сообщение о поступлении новой коллекции брендовых кроссовок для тинейджеров. Скорее всего, это сообщение вызовет её покупательский интерес, только если у нее есть дети подросткового возраста. В противном случае —  сообщение будет прочитано и удалено за ненадобностью. В ситуации, когда эта же женщина получает информацию о скидке в магазине косметики в честь предстоящего праздника 8 марта, эффективность рассылки вырастает в разы.

• Используйте максимум возможностей вайбер сообщений

Создавая сообщение, добавьте привлекательную картинку товара, продумайте текст и снабдите его кнопкой действия.  Клик позволит клиенту сразу перейти на страницу с указанным предложением. Стимулируйте его к совершению нужного вам целевого действия.

Как отправить кампанию Viber

Создавать и отправлять сообщения Viber очень просто — вы можете сделать это всего за два шага.

1. Активируйте новое имя отправителя

В своей учетной записи SendPulse откройте вкладку «EMAIL» и нажмите кнопку «Отправить Viber» .

Нажмите «Добавить новое имя отправителя для Viber».

Заполните поля на странице «Добавить новое имя отправителя для Viber» своей информацией и нажмите «Отправить на регистрацию».”

Активация занимает от 7 до 30 дней. Как только имя отправителя станет активным, вы можете переходить к следующему шагу.

2. Создайте кампанию в Viber

На вкладке «EMAIL» нажмите кнопку «Отправить Viber» . Имя отправителя будет заполнено автоматически.

Выберите тип сообщения — промо или услуга — и добавьте номера телефонов получателей в международном формате вручную или выберите список подписчиков из раскрывающегося списка «Получатели» .

Добавьте содержимое сообщения. Сервис позволяет отправлять текст или изображение. Кроме того, вы можете включать в текстовое сообщение переменные.

Установите кнопку действия в сообщении. Укажите текст, который будет отображаться на кнопке, и ссылку на страницу веб-сайта, на которую пользователи будут перенаправлены при нажатии на нее.

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

Установить время жизни сообщения — период, в течение которого служба будет пытаться доставить ваше сообщение подписчикам, недоступным на момент его отправки.Минимальное значение — одна минута, а максимальное — 24 часа.

Укажите время отправки. Кампания будет отправлена ​​сразу после ее создания или запланирована на определенную дату и время.

Сервис также предлагает возможность повторной отправки кампаний через SMS, если они не были доставлены через Viber.

Когда ваше сообщение будет готово, просмотрите его, чтобы понять, как оно будет выглядеть для ваших подписчиков. Для этого нажмите на значок телефона.

Если сообщение отображается правильно, щелкните «Отправить».

Примечание: 220 евро в месяц — это требование официального канала Viber.

Начните создавать свою кампанию в Viber прямо сейчас!

Последнее обновление: 19.01.2021

Viber REST API | Центр разработчиков Viber

Начало работы

Для реализации API вам потребуется:

1. Активная учетная запись Viber на платформе, которая поддерживает ботов (iOS / Android).Эта учетная запись будет автоматически назначена администратором учетной записи в процессе создания учетной записи.
2. Активный бот — Создайте бота здесь.
3. Токен аутентификации учетной записи — уникальный идентификатор учетной записи, используемый для проверки вашей учетной записи во всех запросах API. Как только ваша учетная запись будет создана, ваш токен аутентификации появится на экране «Изменить информацию» учетной записи (только для администраторов). Каждый запрос, отправленный в Viber учетной записью, должен содержать токен.
4. Настройка веб-перехватчика учетной записи — это необходимо сделать один раз в процессе настройки учетной записи, чтобы определить веб-перехватчик и тип ответов, которые вы хотите получать. Для реализации API вам потребуется:

Поддерживаемые платформы

Боты в настоящее время поддерживаются на устройствах iOS и Android с Viber версии 6.5 и выше, а также на настольных компьютерах с версии 6.5.3.

Важные примечания для разработчиков ботов:

1. Бот-платформа Viber открыта, и разработчики могут бесплатно создавать ботов в нашей экосистеме.После того, как вы создали своего бота, вы можете поделиться им со своими контактами в Viber или продвигать его за пределами Viber на своем веб-сайте или в социальных сетях с помощью deeplink. Обратите внимание, что Viber не несет ответственности за продвижение вашего бота, и что по умолчанию у вашего бота не будет активной целевой страницы под viber.com после создания. Включение этого URL-адреса является частью платных услуг, которые мы предлагаем официальным партнерам. Точно так же после создания вашего бота он не будет отображаться в результатах поиска в Viber, и включение этого также является частью платных услуг, которые мы предлагаем официальным партнерам.Если вы хотите обсудить соглашение о партнерстве или узнать больше о платных каналах для продвижения вашего бота в Viber, напишите по адресу [email protected] и укажите данные своей компании, включая страну вашей компании.
2. Мы рекомендуем вам записывать идентификатор подписчика для каждого подписчика, поскольку у вашего бота нет API для получения всех идентификаторов подписчиков. Вы можете найти идентификатор подписчика в свойстве sender.id обратного вызова Message или в свойстве user.id обратного вызова с подпиской.Вы можете увидеть, подписан ли пользователь, в параметре subscribed callback-функции talk_started. Обратите внимание, что первое сообщение пользователей боту заставит их подписаться, но не приведет к обратному вызову с подпиской.
3. Если вы хотите отправлять сообщения пользователям по их номерам телефонов и с помощью 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.

Обратите внимание, что как только вы установите веб-перехватчик, общение один на один с вашей учетной записью станет доступным. Чтобы отключить беседу один на один с вашим аккаунтом, вам нужно удалить веб-перехватчик — см. Раздел об удалении веб-перехватчика ниже.

Viber позволяет получать имена пользователей и фотографии. Он был обновлен, чтобы соответствовать законам о конфиденциальности и позволить разработчикам, которые не используют имена пользователей и фотографии в рамках своих услуг, отказаться от участия.Если вы не используете фотографии с именами пользователей, откажитесь от значений по умолчанию.

Чтобы установить запрос, передайте флаги send_name и send_photo с запросом set_webhook .

Примечание: Эта функция будет работать, если пользователь разрешил «Персонализацию содержимого» (Подробнее → Конфиденциальность → личные данные). Если пользователь запретил персонализацию контента, вы получите значения заполнителей.

Настройка веб-перехватчика

URL ресурса

  https: // chatapi.viber.com/pa/set_webhook  

Данные публикации

  {
   "url": "https://my.host.com",
   "event_types": [
      "доставлен",
      "видимый",
      "не смогли",
      "подписан",
      "отписался",
      "беседа началась"
   ],
   "send_name": правда,
   "send_photo": правда
}  

Параметры поста

Установить ответ веб-перехватчика

  {
   «статус»: 0,
   "status_message": "хорошо",
   "event_types": [
      "доставлен",
      "видимый",
      "не смогли",
      "подписан",
      "отписался",
      "беседа началась"
   ]
}  

Параметры ответа

Фильтрация типов событий

Параметр event_types позволяет учетным записям выбирать, для каких событий они будут получать обратный вызов.
Следующие события являются обязательными и не могут быть отфильтрованы: сообщение , подписан и отписан .
Следующие события могут быть отфильтрованы во время запроса set_webhook : доставлено , просмотрено , не удалось и talk_started .
Отправка запроса set_webhook без параметра event_types означает получение всех событий.
Отправка запроса set_webhook с пустым списком event_types ("event_types": []) означает получение только обязательных событий. См. Раздел обратных вызовов для получения полной информации о событиях обратных вызовов.

Установить обратный вызов webhook

Для каждого запроса set_webhook Viber отправит обратный вызов на URL-адрес веб-перехватчика, чтобы подтвердить его доступность. Ожидаемый HTTP-ответ на обратный вызов — 200 OK — любой другой ответ будет означать, что веб-перехватчик недоступен. Если веб-перехватчик недоступен, ответ set_webhook , отправленный пользователю, будет иметь статус 1: invalidUrl.

Данные обратного вызова

  {
   "событие": "перехватчик",
   "отметка времени": 1457764197627,
   «message_token»: 241256543215
}  

Параметры обратного вызова

Удаление веб-крючка

После того, как вы установите веб-перехватчик для своего бота, появится кнопка беседы один на один, и пользователи смогут получить к ней доступ.
В настоящее время нет возможности отключить беседу один на один в настройках бота, поэтому, чтобы отключить эту опцию, вам нужно удалить веб-перехватчик, который вы установили для учетной записи. Удаление веб-перехватчика выполняется путем отправки запроса set_webhook с пустой строкой веб-перехватчика.

URL ресурса

  https://chatapi.viber.com/pa/set_webhook  

Данные публикации

  {
   "url": ""
}  

Параметры поста

Отправить сообщение

API send_message позволяет учетным записям отправлять сообщения пользователям Viber, которые подписаны на учетную запись. Отправка сообщения пользователю будет возможна только после того, как пользователь подписался на бота. (см. обратный вызов с подпиской для получения дополнительной информации). Вы можете поделиться своим ботом с пользователями через deeplink.

API поддерживает различные типы сообщений: текст , изображение , видео , файл , местоположение , наклейка , контакт , контент карусели и URL . Ниже приведены конкретные примеры данных сообщений и необходимые параметры для каждого типа сообщений.

Проверка

Максимальный общий размер запроса в формате JSON — 30 КБ.

Может отправлять до 100 сообщений пользователю в час (XX: 00-XX: 00) без ответа, счетчик сообщений сбрасывается, когда пользователь отвечает на сообщение.Как только предел будет достигнут, вы получите обратный вызов об ошибке:

  {"status": 12, "status_message": "превышено максимальное количество сообщений от общедоступного аккаунта пользователю Viber без ответа.", "Message_token": XXXXXXXXXXXXXXXXXXX, "chat_hostname": "SN-CHAT-0x_"}  

Resource URL

  https://chatapi.viber.com/pa/send_message  

Общие параметры отправки сообщения

Для всех типов сообщений доступны следующие параметры:

Типы сообщений

Ниже приведен список всех поддерживаемых типов сообщений с примерами данных сообщений.

Текстовое сообщение

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "текст",
   "text": "Привет, мир!"
}  

Параметры поста

Графическое сообщение

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "картинка",
   "text": "Описание фото",
   "media": "http: // www.images.com/img.jpg ",
   "thumbnail": "http://www.images.com/thumb.jpg"
}  

Параметры поста

Видео сообщение

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "видео",
   "media": "http://www.images.com/video.mp4",
   "thumbnail": "http://www.images.com/thumb.jpg",
   «размер»: 10000,
   «продолжительность»: 10
}  

Параметры поста

Файловое сообщение

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "файл",
   "media": "http: // www.images.com/file.doc ",
   «размер»: 10000,
   "имя_файла": "имя_файла.doc"
}  

Параметры поста

Контактное сообщение

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "контакт",
   "контакт":{
      "name": "Итамар",
      "phone_number": "+ 972511123123"
   }
}  

Параметры поста

Сообщение о местоположении

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com "
   },
   "tracking_data": "данные отслеживания",
   "тип": "местоположение",
   "место расположения":{
      "lat": "37,7898",
      "лон": "- 122.3942"
   }
}  

Параметры поста

URL-сообщение

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "URL",
   "media": "http://www.website.com/go_here"
}  

Параметры поста

Наклейка с сообщением

Данные публикации

  {
   "получатель": "01234567890A =",
   «min_api_version»: 1,
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com"
   },
   "tracking_data": "данные отслеживания",
   "тип": "наклейка",
   "sticker_id": 46105
}  

Параметры поста

Сообщение Rich Media / сообщение с содержанием карусели

Тип сообщения Rich Media позволяет отправлять сообщения с заранее заданным макетом, включая высоту (количество строк), ширину (количество столбцов), текст, изображения и кнопки.

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

Каждый элемент списка, отображаемый пользователю, представляет собой кнопку в массиве «Buttons» сообщения Rich Media. Также разрешена отправка одной кнопки.

Параметры сообщения Rich Media и его кнопки также используются для клавиатуры. Вы можете найти дополнительную информацию о них в следующей статье.

Примечания:

1. Сообщение с содержимым карусели поддерживается на устройствах под управлением Viber версии 6.7 и выше.
2. Максимальная длина каждой кнопки — 7 рядов.
3. Пересылка не поддерживается для сообщений Rich Media.

Почтовые данные

  {
   "приемник": "nsId6t9MWy3mq09RAeXiug ==",
   "тип": "rich_media",
   «min_api_version»: 7,
   "мультимедиа":{
      «Тип»: «rich_media»,
      «ButtonsGroupColumns»: 6,
      «ButtonsGroupRows»: 7,
      "BgColor": "# FFFFFF",
      «Кнопки»: [
         {
            «Колонны»: 6,
            «Рядов»: 3,
            "ActionType": "открытый URL",
            "ActionBody": "https://www.google.com ",
            "Изображение": "http: // html-test: 8080 / myweb / guy / assets / imageRMsmall2.png"
         },
         {
            «Колонны»: 6,
            «Рядов»: 2,
            "Text": "  Наушники с микрофоном, накладные проводные наушники    
 Sound Intone   17,99 долл. США  ",
            "ActionType": "открытый URL",
            "ActionBody": "https://www.google.com",
            "TextSize": "средний",
            "TextVAlign": "средний",
            "TextHAlign": "слева"
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https: // www.google.com ",
            "Text": " Купить ",
            "TextSize": "большой",
            "TextVAlign": "средний",
            "TextHAlign": "средний",
            «Изображение»: «https://s14.postimg.org/4mmt4rw1t/Button.png»
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https://www.google.com",
            "Text": " ПОДРОБНЕЕ ",
            "TextSize": "маленький",
            "TextVAlign": "средний",
            «TextHAlign»: «средний»
         },
         {
            «Колонны»: 6,
            «Рядов»: 3,
            "ActionType": "открытый URL",
            "ActionBody": "https: // www.google.com ",
            «Изображение»: «https://s16.postimg.org/wi8jx20wl/image_RMsmall2.png»
         },
         {
            «Колонны»: 6,
            «Рядов»: 2,
            "Text": "  Мужская футболка с изображением юмора Hanes    
 Hanes   10,99 долл. США  ",
            "ActionType": "открытый URL",
            "ActionBody": "https://www.google.com",
            "TextSize": "средний",
            "TextVAlign": "средний",
            "TextHAlign": "слева"
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https: // www.google.com ",
            "Text": " Купить ",
            "TextSize": "большой",
            "TextVAlign": "средний",
            "TextHAlign": "средний",
            «Изображение»: «https://s14.postimg.org/4mmt4rw1t/Button.png»
         },
         {
            «Колонны»: 6,
            «Рядов»: 1,
            "ActionType": "ответить",
            "ActionBody": "https://www.google.com",
            "Text": " ПОДРОБНЕЕ ",
            "TextSize": "маленький",
            "TextVAlign": "средний",
            «TextHAlign»: «средний»
         }
      ]
   }
}  

Параметры поста

Кнопочный элемент

Клавиатуры

API Viber позволяет отправлять настраиваемую клавиатуру с помощью API send_message , чтобы предоставить пользователю набор предопределенных ответов или действий. Клавиатуру можно прикрепить к любому типу сообщения или отправить с ней. После получения клавиатура будет отображаться для пользователя вместо встроенной клавиатуры устройства.Клавиатуры полностью настраиваются и могут быть созданы и разработаны специально для нужд учетной записи. Клиент всегда будет отображать последнюю отправленную ему клавиатуру.

Прочтите следующую статью, чтобы узнать больше о клавиатурах.

Проверка

Максимальный общий размер запроса в формате JSON — 30 КБ.

URL ресурса

  https://chatapi.viber.com/pa/send_message  

Данные публикации

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

  {
   "получатель": "01234567890A =",
   «min_api_version»: 7,
   "тип": "текст",
   "текст": "Привет, мир",
   "keyboard": {
      "Тип": "клавиатура",
      "DefaultHeight": true,
      «Кнопки»: [
         {
            "ActionType": "ответить",
            "ActionBody": "ответь мне",
            «Текст»: «Ключевой текст»,
            "TextSize": "обычный"
         }
      ]
   }
}  

Широковещательное сообщение

API broadcast_message позволяет учетным записям отправлять сообщения нескольким пользователям Viber, которые подписаны на учетную запись.Отправка сообщения пользователю будет возможна только после того, как пользователь подписался на бота, отправив сообщение боту.

API поддерживает различные типы сообщений: текст , изображение , видео , файл , местоположение , наклейка , контакт , контент карусели и URL .

Проверка

Максимальный общий размер запроса в формате JSON — 30 КБ. Максимальная длина списка — 300 получателей.Широковещательный API используется для отправки сообщений нескольким получателям с ограничением скорости 500 запросов в 10-секундном окне.

URL ресурса

  https://chatapi.viber.com/pa/broadcast_message  

Параметры сообщения

Этот метод API использует те же параметры, что и метод send REST API с несколькими вариантами, описанными ниже.

broadcast_list

Этот обязательный параметр определяет получателей сообщения.Каждый пользователь должен быть подписан и иметь действующий идентификатор пользователя. Максимальная длина списка — 300 получателей. Например (это должно быть частью полного тела JSON):

  {
   "Список вещания":[
      "ABB102akPCRKFaqxWnafEIA ==",
      "ABB102akPCRKFaqxWna111 ==",
      "ABB102akPCRKFaqxWnaf222 =="
   ]
}  

Места

Широковещательное сообщение может содержать заполнители, которые будут заменены информацией о получателе (каждый получатель получит свою информацию).Заполнители могут появляться в любом месте сообщения, даже в данных отслеживания. Список обладателей:

• replace_me_with_receiver_id — будет заменен на идентификатор получателя
• replace_me_with_url_encoded_receiver_id — будет заменен идентификатором получателя в кодировке URL
• replace_me_with_user_name — будет заменено именем пользователя получателя

Пример сообщения

В следующем примере демонстрируется отправка содержимого карусели с заполнителями ( replace_me_with_receiver_id , replace_me_with_url_encoded_receiver_id , replace_me_with_user_name ) 4 получателям:

  {
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com "
   },
   «min_api_version»: 2,
   "тип": "rich_media",
   "Список вещания":[
      "pttm25kSGUo1919sBORWyA ==",
      "2yBSIsbzs7sSrh5oLm2hdQ ==",
      "EGAZ3SZRi6zW1D0uNYhQHg ==",
      "kBQYX9LrGyF5mm8JTxdmpw =="
   ],
   "мультимедиа":{
      «Тип»: «rich_media»,
      "BgColor": "# FFFFFF",
      «Кнопки»: [
         {
            "ActionBody": "https://www.google.com",
            "ActionType": "открытый URL",
            "Text": "Должен вернуть мой ID вместо replace_me_with_receiver_id"
         },
         {
            "ActionBody": "https: // www.google.com ",
            "ActionType": "открытый URL",
            "Text": "Должен получить обратно мой URL-кодированный идентификатор вместо replace_me_with_url_encoded_receiver_id"
         },
         {
            "ActionBody": "https://www.google.com",
            "ActionType": "открытый URL",
            "Текст": "Должен вернуть мое имя вместо replace_me_with_user_name"
         }
      ]
   }
}  

Ответ

Параметры ответа

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

  {
   "message_token": 408088712,
   «статус»: 0,
   "status_message": "хорошо",
   "failed_list": [
      {
         "приемник": "pttm25kSGUo1919sBORWyA ==",
         «статус»: 6,
         "status_message": "Не подписан"
      },
      {
         "приемник": "EGAZ3SZRi6zW1D0uNYhQHg ==",
         «статус»: 5,
         "status_message": "Не найдено"
      }
   ]
}  

Получить информацию об аккаунте

Запрос get_account_info получит данные учетной записи, зарегистрированные в Viber.Администратор аккаунта сможет редактировать большую часть этих данных в своем клиенте Viber.

URL ресурса

  https://chatapi.viber.com/pa/get_account_info  

Данные публикации

  {
}  

Ответ

  {
   «статус»: 0,
   "status_message": "хорошо",
   "id": "pa: 753465468546724",
   "name": "имя учетной записи",
   "uri": "accountUri",
   "icon": "http://example.com",
   "фон": "http://example.com",
   "категория": "категория",
   «подкатегория»: «подкатегория»,
   "место расположения":{
      «лон»: 0.1,
      «шир»: 0,2
   },
   "страна": "Великобритания",
   "webhook": "https://my.site.com",
   "event_types": [
      "доставлен",
      "видимый"
   ],
   "subscribers_count": 35,
   "members": [
      {
         "id": "01234567890A =",
         "name": "мое имя",
         "аватар": "http://example.com",
         "роль": "администратор"
      }
   ]
}  

Параметры ответа

Получить сведения о пользователе

Запрос get_user_details будет извлекать сведения о конкретном пользователе Viber на основе его уникального идентификатора пользователя. Идентификатор пользователя может быть получен из обратных вызовов, отправленных в учетную запись относительно действий пользователя. Этот запрос может быть отправлен дважды в течение 12 часов для каждого идентификатора пользователя.

URL ресурса

  https://chatapi.viber.com/pa/get_user_details  

Данные публикации

  {
   "id": "01234567890A ="
}  

Параметры поста

Ответ

  {
   «статус»: 0,
   "status_message": "хорошо",
   message_token: 41846655238145,
   "Пользователь":{
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http://avatar.example.com",
      "страна": "Великобритания",
      "language": "en",
      "primary_device_os": "android 7.1",
      "api_version": 1,
      "viber_version": "6.5.0",
      «mcc»: ​​1,
      «mnc»: 1,
      "device_type": "iPhone9,4"
   }
}  

Параметры ответа

Подключиться к Интернету

Запрос get_online извлекает онлайн-статус заданных подписанных участников учетной записи. API поддерживает до 100 идентификаторов пользователей на запрос, и эти пользователи должны быть подписаны на учетную запись.

URL ресурса

  https://chatapi.viber.com/pa/get_online  

Данные публикации

  {
   "идентификаторы": [
      "01234567890 =",
      "01234567891 =",
      "01234567893 ="
   ]
}  

Параметры поста

Ответ

  {
   «статус»: 0,
   "status_message": "хорошо",
   "пользователи": [
      {
         "id": "01234567890 =",
         "online_status": 0,
         "online_status_message": "онлайн"
      },
      {
         "id": "01234567891 =",
         "online_status": 1,
         "online_status_message": "офлайн",
         "last_online": 1457764197627
      },
      {
         "id": "01234567893 =",
         "online_status": 3,
         "online_status_message": "tryLater"
      }
   ]
}  

Параметры ответа

Обратный звонок

Каждый обратный вызов будет содержать подпись JSON, переданного обратному вызову. Подпись - это HMAC с SHA256, который будет использовать токен аутентификации в качестве ключа и JSON в качестве значения. Результат будет передан как HTTP Header X-Viber-Content-Signature , чтобы получатель мог определить источник сообщения.

Логика повторной попытки

Если веб-перехватчик отключен, Viber будет повторно пытаться доставить обратный вызов, пока не будет получен код состояния HTTP 200 .Будет повторная попытка через 5 секунд, а затем еще одна через 1 минуту 5 секунд.

Ввод

Ключ (токен аутентификации вашего бота):

  4453b6ac12345678-e02c5f12174805f9-daec9cbb5448c51f  

Значение:

  {
   "событие": "доставлено",
   "отметка времени": 1457764197627,
   message_token: 4184665523145,
   "user_id": "01234567890A ="
}  

Выход

HTTP-заголовок

  X-Viber-Content-Signature: 9d3941b33d45c165400d84dba9328ee0b687a5a18b347617091be0a56d  

Подписан

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

Вы получите событие с подпиской, когда отписавшиеся пользователи сделают следующее:

1. Открытый разговор с ботом.
2. Нажмите на кнопку с тремя точками в правом верхнем углу, а затем на «Информация о чате».
3. Нажмите на «Получать сообщения».

Примечание: Событие подписки удалит любую информацию контекста или tracking_data , связанную с диалогом. Это означает, что если пользователь разговаривал с сервисом, а затем решил отказаться от подписки и подписаться снова, новый разговор будет начат без какой-либо информации, относящейся к старому разговору.

Данные обратного вызова

  {
   "событие": "подписан",
   "отметка времени": 1457764197627,
   "Пользователь":{
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com ",
      "страна": "Великобритания",
      "language": "en",
      «api_version»: 1
   },
   message_token: 41846655238145
}  

Параметры обратного вызова

Отписался

У пользователя будет возможность отказаться от подписки на PA. Это вызовет обратный вызов для отказа от подписки.

Данные обратного вызова

  {
   "событие": "отписался",
   "отметка времени": 1457764197627,
   "user_id": "01234567890A =",
   message_token: 41846655238145
}  

Параметры обратного вызова

Разговор начат

Событие начала беседы возникает, когда пользователь открывает беседу с ботом, используя кнопку «сообщение» (находится на экране информации учетной записи) или используя глубокую ссылку.

Это событие , а не , считается событием подписки и не позволяет учетной записи отправлять сообщения пользователю; однако это позволит отправить пользователю одно «приветственное сообщение». См. Отправку приветственного сообщения ниже для получения дополнительной информации.

После получения обратного вызова talk_started служба сможет ответить JSON, содержащим те же параметры, что и запрос send_message . Параметр приемника равен , а не в этом случае.

Примечание. Обратный вызов talk_started по умолчанию не содержит параметра контекста .

Чтобы добавить этот параметр и определить его значение, вы можете использовать deeplink следующим образом: viber: // pa? ChatURI = your_bot_URI & context = your_context

Данные обратного вызова

  {
   "событие": "начало_ беседы",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "тип": "открытый",
   "context": "контекстная информация",
   "Пользователь":{
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com ",
      "страна": "Великобритания",
      "language": "en",
      «api_version»: 1
   },
   "подписан": ложь
}  

Параметры обратного вызова

Отправка приветственного сообщения

API Viber позволяет отправлять сообщения пользователям только после того, как они подпишутся на аккаунт.Однако Viber позволит учетной записи отправлять пользователю одно «приветственное сообщение», когда пользователь открывает беседу, прежде чем пользователь подпишется.

Приветственное сообщение будет отправлено как ответ на обратный вызов talk_started , который будет получен от Viber, как только пользователь откроет беседу с учетной записью. Чтобы узнать больше об этом событии и когда оно запускается, см. Разговор начался в разделе обратных вызовов.

Поток приветственного сообщения

Отправка приветственного сообщения будет происходить в следующем порядке:

1. Пользователь открывает беседу один на один с учетной записью.
Сервер
2. Viber отправляет обратный вызов talk_started веб-перехватчику бота.
3. Учетная запись получает обратный вызов talk_started и отвечает HTTP-ответом, который включает приветственное сообщение в качестве тела ответа.

Приветственное сообщение будет в формате JSON, созданном в соответствии со структурой запросов send_message , но без параметра Receiver . Пример приветственного сообщения будет выглядеть так:

  {
   "отправитель": {
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com "
   },
   "tracking_data": "данные отслеживания",
   "тип": "картинка",
   "text": "Добро пожаловать в наш бот!",
   "media": "http://www.images.com/img.jpg",
   "thumbnail": "http://www.images.com/thumb.jpg"
}  

Примечание: Приветственное сообщение должно быть отправлено как тело HTTP-ответа на обратный вызов talk_started , а не на конечную точку send_message .

Получение сообщений, обратные вызовы

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

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

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

Если Viber не может доставить сообщение клиенту, он попытается доставить его в течение 14 дней.Если сообщение не было доставлено в течение 14 дней, оно не будет доставлено, и для него не будет получено никаких обратных вызовов «доставлено» или «просмотрено».

Данные обратного вызова

Доставлено

  {
   "событие": "доставлено",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "user_id": "01234567890A ="
}  

Просмотрели

  {
   "событие": "видел",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "user_id": "01234567890A ="
}  

Параметры обратного вызова

Неудачный обратный вызов

«Неудачный» обратный вызов будет запущен, если сообщение достигло клиента, но не удалось выполнить какую-либо из проверок клиента.

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

1. Сообщение отправлено.
2. Получен ответ со статусом 0, указывающий на успешный запрос.
3. Сообщение достигает клиента и не проходит проверку клиента.
4. Обратный вызов «Failed» отправляется на веб-перехватчик, содержащий уникальный токен сообщения и строку, объясняющую сбой.

Такое сообщение не будет отображаться получателю, и для него не будут возвращены обратные вызовы «доставлено» или «видно».

Данные обратного вызова

  {
   "событие": "не удалось",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "user_id": "01234567890A =",
   "desc": "описание ошибки"
}  

Параметры обратного вызова

Получить сообщение от пользователя

API чата позволяет пользователю отправлять сообщения в PA.За исключением файла типа , поддерживаются все типы сообщений для отправки от бота к пользователю и от пользователя к боту. К ним относятся: текст , изображение , видео , контакт , URL и местоположение . Следующие данные обратного вызова описывают структуру сообщений, отправляемых пользователем в PA.

Данные обратного вызова

  {
   "событие": "сообщение",
   "отметка времени": 1457764197627,
   message_token: 41846655238145,
   "отправитель": {
      "id": "01234567890A =",
      "name": "Джон МакКлейн",
      "аватар": "http: // аватар.example.com ",
      "страна": "Великобритания",
      "language": "en",
      «api_version»: 1
   },
   "сообщение":{
      "тип": "текст",
      "текст": "сообщение в службу",
      "media": "http://example.com",
      "место расположения":{
         «шир»: 50,76891,
         "lon": 6.11499
      },
      "tracking_data": "данные отслеживания"
   }
}  

Общие параметры обратного вызова

Параметры сообщения обратного вызова

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

Статус сообщения

После получения ответа 200 OK от PA статус сообщения изменится на доставлено на стороне пользователя.Статус «Просмотрено» в настоящее время не поддерживается для сообщений, отправленных от пользователя к PA.

  {
"keyboard": {
"DefaultHeight": true,
"BgColor": "#FFFFFF",
«Кнопки»: [{
«Колонны»: 6,
«Рядов»: 1,
"BgColor": "# 2db9b9",
"BgMediaType": "gif",
"BgMedia": "http://www.url.by/test.gif",
"BgLoop": правда,
"ActionType": "открытый URL",
"ActionBody": "www.tut.by ",
«Изображение»: «www.tut.by/img.jpg»,
«Текст»: «Ключевой текст»,
"TextVAlign": "средний",
"TextHAlign": "центр",
«TextOpacity»: 60,
"TextSize": "обычный"
}]
}
}