Закулисье: ваш виджет, ваш путь с JavaScript API
JavaScript API позволяет создавать неограниченное количество автоматизаций и настроек для вашего виджета tawk.to. Mārtiņš, ведущий бэкэнд-разработчик tawk.to, вы узнаете о некоторых из наиболее популярных сценариев использования JS API, а также как избежать наиболее распространенных ошибок. Вы также получите предварительный обзор новых API на tawk.to и возможность получить доступ уже сейчас.
1 - Что такое API и зачем он нужен?
API означает Программный интерфейс приложения. Это средство общения двух разных программных приложений друг с другом. В этом случае, в частности, для JavaScript API, он будет использоваться на сайте, на котором в данный момент находится виджет, для влияния и управления поведением виджета и различными его аспектами.
2 - Каковы некоторые преимущества использования JavaScript API tawk.to?
С помощью API JavaScript вы можете производить действия, выполнение которых было бы затруднительным, когда вы отвечаете в чате на панели управления или отвечаете на события на своем сайте. Например, вы можете максимизировать виджет посредством JavaScript вашего сайта или минимизировать его, если необходимо.
Один из распространенных вариантов использования - это кнопка Напишите нам с полностью скрытым виджетом, пока кнопка не будет нажата. Для этого вы должны установить виджет, который будет скрыт при начальной загрузке. Затем вы могли бы просто развернуть виджет и сделать его видимым при нажатии кнопки Напишите нам.
Вы также можете по-разному реагировать на виджет. Мы можем настроить события, например, когда виджет загружен, или когда виджет развернут или свернут. Вы можете настроить контент своего сайта в зависимости от состояния виджета. На самом деле здесь вашему воображению нет предела.
3 - Можем ли мы заменить идентификатор пользователя по умолчанию на имя и адрес электронной почты посетителя?
Это определенно один из самых распространенных вариантов использования JavaScript API. Это можно сделать двумя способами.
Предположим, у вас есть CRM, и у вас уже есть необходимые данные. Что вы можете сделать, так это добавить проекты для имени и электронной почты к данным посетителя. Когда виджет будет запускаться, он автоматически получит эту информацию и отправит ее на tawk.to. Таким образом, вы можете сразу увидеть имя и адрес электронной почты вашего посетителя.
Если виджет уже работает, так как он уже загружен, то, что вы можете сделать, и это подводит нас к еще одной интересной функции, заключается в том, что вы можете установить имя посетителя и адрес электронной почты в качестве атрибутов. Более того, вы не ограничены только именем и электронной почтой. Вы можете установить множество атрибутов. Допустим, вы хотите указать, какой тарифный план использует ваш клиент в настоящее время. Это может быть настраиваемый атрибут. Эти настраиваемые атрибуты будут отображаться на боковой панели чата на вкладке Данные .
4 - Можно ли добавить номер телефона с помощью JavaScript API?
Вы должны установить атрибут под названием "телефон". В настоящее время у нас нет прямой поддержки по телефону. Но вы можете установить его как текстовый атрибут. У нас скоро появится интересная новинка - наша новая CRM, в которой вы сможете настроить функция "телефон". Вы сможете установить несколько адресов электронной почты и телефонных номеров, а также множество других интересных функций. Я пока не хочу открывать все наши карты, но это произойдет очень скоро, и мы очень рады этому, что сделает функции атрибутов еще более полезными и эффективными.
5 - Какие распространенные ошибки делают люди при использовании JavaScript API?
Одна из наиболее распространенных ошибок, которую мы видим, заключается в том, что люди пытаются заставить API делать что-то еще до того, как API будет готов принимать команды и отправлять события.
У нас есть событие, которое называется onLoad. Распространенная ошибка заключается в том, что люди пытаются немедленно отправить команды, сообщающие виджету, что нужно минимизировать или развернуть, а затем задаются вопросом, почему они не работают, в то время как сам виджет и базовый API еще не загружены.
Вторая ошибка, которую я чаще всего наблюдаю - это включение безопасного режима без понимания того, что делает безопасный режим и предварительных условий, необходимых для его работы.
6 - Доступен ли REST API на tawk.to?
У нас есть частная бета-версия Rest API, которая в настоящее время доступна нашим партнерам. Если вы являетесь партнером и заинтересованы в доступе к REST API, просто обратитесь к ближайшему представителю.
Rest API больше ориентирован на выполнение действий от имени оператора. Если API JavaScript предназначен исключительно для управления виджетом на вашем сайте, то Rest API предназначен для выполнения действий от лица оператора. У нас там сейчас много полезных функций и мы продолжаем их расширять. Но самые типичные варианты использования сейчас -это создание проектов для ваших клиентов, их автоматическое приглашение и чтение истории чатов.
Вы также можете управлять веб-перехватчиками и базой знаний через REST API. Допустим, вы создаете проект для своего клиента и хотите, чтобы с самого начала были созданы некоторые базовые записи в базе знаний. Это то, что вы можете автоматизировать с помощью REST API.
И если у вас есть действительно классная идея его использования, сообщите нам, и мы посмотрим, подходит ли вам наш Rest API.
Просмотрите нашу документацию по JavaScript API на Платформе разработчиков tawk.to.
Запросите доступ к REST API здесь: Получить бета-доступ к REST API