Создание полноценного Viberbot. Часть вторая — первый контакт или «сonversation_started»

• Tutorial

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

В первой части мы научились запускать стартер устанавливать webhook для нашего проекта botviber. В этой 2-й мы научимся отправлять первое сообщение показываемое для наших пользователей, создавать ссылки для поиска и запуска нашего бота как внутри ViberURL так и NoViberURL

Сформируем ссылки на бота

1) Oффлайн QR — его можно скачать из партнерской админки viber 2) Ссылка для месcенджера и передачи по мессенджеру ViberURL

viber://pa?chatURI=dinner&context=fromhabr

3) Ссылка редирект NoViberURL в интернете много таких сократителей URL — но все они похожи на спам, поэтому рекомендую создать свой код из трех строк PHP и положить файл себе на хостинг, вот содержимое файла foot.php

 header ("Location: viber://pa?chatURI=dinner"); exit();

Приветствия botviber или «event»: «conversation_started»

После открытия QR или перехода по ссылке на адрес нашего приложения от серверов Viber (Jetty) прилетают POST запросы с событием («event»: «conversation_started») а их полное содержимое имеет следующий вид:ВХОДЯЩИЕ ПАРАМЕТРЫ POST – или JSON из 13 полей

{   "chat_hostname": "SN-327_", # Если Viber на нескольких устройствах - будут разные "chat_hostname"   "event": "conversation_started", # Событие первого запуска или инициализации бота на строне пользователя    "context": "fromlanding", # тут можно получать UTM параметры источника ссылки     "message_token": 5406893180055821524, # токен сообщения   "subscribed": false, # пользователь еще не подписан, если тут true то уже подписан   "timestamp": 1581161565470, # UNIXTIME    "type": "open", # открытие диалога   "user": {     "api_version": 8,  # поддерживаемая версия API на устройстве пользователя.      "avatar": "https://media-direct.cdn.viber.com/avatar...", # ссылка на действующий аватар пользователя - у анонимных пусто, поля аватар отсутствует     "country": "RU", # Принадлежность телефонного номера пользователя к стране (UA-украина, BY-беларусь, IL-израиль, MD - молдова)     "id": "J2k6sasdgghaazDeoXVYww==", # ID пользователя в ВАШЕМ боте     "language": "ru", # Язык приложения пользователя или язык устройства(если они совпадают)     "name": "Denis" № #имя пользователя в Viber - то как он себя подписал - у анонимных пусто поля name не существует   } }

Но в большинстве случаев нас интересуют только эти 5 полей

{   "context": "fromlanding", # Для анализа эффекта рекламных кампаний    "subscribed": false,    "user": {     "country": "RU", # Если проект глобальный страна нам пригодиться     "id": "J2k6sasdgghaazDeoXVYww==", # ID будем сохранять в БД     "name": "Denis" № #Имя пользователя можно сохранить, если оно есть.   } }

А Иногда нам нужно всего одно поле это Главный идентификатор Viber пользователя, аналог chat_id в telegram. Обработаем их и ответим, чтобы получить один из трех ответов как на скрине выше а) type=«text» б) а тут мы видим классический случай type=«rich_media» в) на третьем скрине Type=«keyboard» Детальнее на viber REST API, а ниже рассмотрим как получить первый вариант

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

1) для обработки пользовательских сообщений в файле проекта myviberbot/views.py внесем изменения:

 #  import requests # Добавим Библиотеку для отправки запросов  import json  from django.shortcuts import HttpResponse from django.views.decorators.csrf import csrf_exempt  auth_token = '45df835d27d01f-cd2e7wetwerga18a8-9a7wert786234' #!ТОКЕН СТАВИМ СВОЙ ЭТО Фейковый неживой url = 'https://chatapi.viber.com/pa/send_message' headers = {'X-Viber-Auth-Token': auth_token}  # ДЕКОРАТОР ДЛЯ функций и отправки def sending(func):     def wrapped(*args):         return requests.post(url, json.dumps(func(*args)), headers=headers)     return wrapped  # Отправка текста @sending def send_text(agent, text, track=None):     m = dict(receiver=agent, min_api_version=2, tracking_data=track, type="text", text=text)     return m  @csrf_exempt def trx_bot(request):     if request.method == "POST":         viber = json.loads(request.body.decode('utf-8'))         if viber['event'] == 'conversation_started':             print("Приветствую пользователя")             conversation(viber) #Обработка запроса - обзор функции следующий абзац.         elif viber['event'] == 'webhook':             #print(viber)             #print("Webhook успешно установлен")             return HttpResponse(status=200)         else:             print("Это не Webhook - пробуй еще раз, или используй POSTMAN")              return HttpResponse(status=500)         return HttpResponse(status=200)   def conversation(viber):     id = viber['user']['id']     if viber['subscribed']:     send_text(id, 'ВЫ УЖЕ ПОДПИСАНЫ')     else:         send_text(id, 'Что умеет этот бот?nnЗависит от ваших идей. Отправь мне что угодно и присоединяйся...')  

Перезапустим наш проект Django. К сожалению «Rakuten Viber» никому не дает официальные страницы на PA и сообщество, исключения крупные бренды и публичные личности, поэтому для SEO продвижения и PR по соцсетям и др. рекомендую создать минилендинг — мелкая страница на которую переходят все с основного сайта или др. ресурсов вот образец: Удачного запуска botviber. Продолжение следует… В следующей статье мы разберем event[«message»], для обработки пользовательских сообщений, вы узнаете, что сделать чтоб вести диалог, как отделять следующие сообщения, вообще как botviber научить понимать, что это следующие. (Создание полноценного Viberbot на Django 2 и Viber REST API. Часть третья — Message) Материалы:Документация viber REST APIDjango версии 2.2Радиовайбер-минилендинг

 Как в вайбере отправить анимационное сообщение

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

· Зайти в мессенджер;

· Выбрать нужного собеседника;

· Нажать на появившийся в нижней части экрана значок «плюс»;

· Выбрать пункт «Анимационное сообщение»;

· Выбрать нужную анимацию;

· Записать и настроить звуковое сообщение;

· Отправить получившееся анимационное сообщение собеседнику.

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

 Что делать, если пропали анимационные сообщения

После обновления мессенджера Viber до версии 5.6.5 и, соответственно, еще более высоких версий, возможность создавать анимационные сообщения с помощью самого приложения исчезла. Это связано с большим потреблением памяти вайбером. Однако разработчики предусмотрели и вариант восстановить создание анимашек. Для этого необходимо найти и скачать приложение Zoobe. А в мессенджер вставлять анимационные сообщения, созданные в этой дополнительной программе. Кроме того, возможности Zoobe в плане создания анимаций намного выше, чем возможности самого Viber.

 Как сделать анимированного зайку в вибере?

Создать уже достаточно знаменитую анимационную зайку Zoobe в Viber можно, если на смартфоне установлено приложение Zoobe — 3D animated messages. Скачать его можно с интернета, вбив в поисковике браузера название, так как в специальных онлайн-магазинах вроде Play Market, эта программа отсутствует. После скачивания файла необходимо:

· Установить приложение на устройство;

· Открыть программу;

· Открыть раздел создания анимаций;

· Выбрать нужного персонажа (зайку Zoobe);

· Записать нужное сообщение, нажав на иконку микрофона в приложении;

· Отредактировать звук при необходимости;

· Нажать «Продолжить», дождаться окончания загрузки анимации, ввести название файла;

· Нажать «Сохранить».

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

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

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

Как отправить анимацию в Viber – этап создания

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

1. 1. Пользователю нужно открыть диалогов окно (чат собеседников) друга, которому нужно отправить анимационное сообщение.
   2. Затем в левом нижнем уголке нажать на плюсик. После этого развернется подробное меню.
   3. Далее пользователю нужно будет нажать на кнопку с изображением зайчика: «Анимационное сообщение».
   4. Откроется раздел с анимациями. Внизу расположена лента с изображениями существующих анимаций. Нажав на плюсик, можно загрузить новые анимации.

1. Далее следует записать голосовое сообщение. В голосовом сообщении возможно изменять тон собственного голоса.
2. После этого анимационное сообщение можно предварительно посмотреть.
3. Затем анимацию viber нужно вставить в диалоговое окно и отправить собеседнику.

Совет: Анимационное сообщение весит не много, но, чтобы не тратить лишние деньги, лучше всего пользоваться вай-фаем, а не мобильным интернетом!

Как отправить анимацию в Viber – как сохранить анимацию

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

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

Если приложение вайбер установлено в Iphone, то в этом случае для сохранения анимации следует воспользоваться кнопкой «Сохранить в галерею». Кнопка находится левом нижнем углу.

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

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

Как создавать анимацию в Viber

1. Все очень просто: открываете чат с собеседником, которому хотите отослать анимацию.
2. Выберете анимацию, которую хотите записать.
3. Записываете голосовое сообщение, в котором можно изменить тон голоса.
4. Просматриваете его и отправляете.

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

В настоящее время все доступные Анимашки в магазине Viber вы можете скачать БЕСПЛАТНО. Наиболее популярные их них – героиня Violet, анимация со слюнявым драконом Tyranni, симпатичный стройный брюнет Amazing Adam, а также лис и кошка.

Какой телефон может отправлять анимированные сообщения Viber

Анимированные сообщения доступны на телефонах с установленной версией ОС:

• iPhone 3GS и выше с операционной системой 6.0 и старше;
• Телефоны Android с версией ОС 2.3.3 или более поздней версией.

Самая оптимальная производительность анимации доступна на телефонах iPhone 4 с прошивкой 6.0 и старше, а для Android рекомендуется версия ОС 4.1 или выше.

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

Можно ли сохранять анимацию Viber, которую вам прислали

Вы можете легко сохранить видео анимацию. Для этого в системе Android нужно в правом верхнем углу экрана видео нажать «Сохранить в памяти устройства». А в iPhone необходимо выбрать в нижнем левом углу экрана кнопку «Сохранить в галерею».

Используемые источники:

• https://habr.com/ru/post/486858/
• https://viber-fan.ru/animatsionnye-soobshheniya-v-viber/
• http://faqviber.info/вайбер-анимации-создание-и-отправка/
• https://xn—–7kcabbec2afz1as3apmjtgqh4hrf.com/animaciya-viber.html