API: что это такое, зачем он нужен бизнесу и какие возможности предоставляет пользователям Jivo

API стал неотъемлемой частью современного бизнеса. По статистике shiftmag, 83% интернет-трафика в 2023 году проходило через программные интерфейсы.

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

В этой статье расскажем, что такое API, как работает интерфейс программирования, какие задачи бизнеса решает и как использовать API в Jivo.

Что такое API простыми словами#

Представьте ситуацию: вы оформляете заказ в интернет-магазине и нажимаете кнопку «Оплатить». В этот момент сайт магазина моментально связывается с вашим банком, проверяет баланс, списывает деньги и подтверждает покупку.

Вся эта «магия» происходит благодаря API — программному интерфейсу приложений.

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

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

Как работает API#

Любой программный интерфейс включает три основных компонента:

1. Операция — действие, которое может выполнить система (например, получить данные о клиенте, отправить сообщение, провести платеж).
2. Входящие данные — информация, которую нужно передать для выполнения операции (номер карты, текст сообщения, ID пользователя).
3. Исходящие данные — результат операции, который система возвращает обратно (подтверждение оплаты, информация о доставке или сообщение об ошибке).

Процесс взаимодействия выглядит так:

• Ваше приложение отправляет запрос через API.
• Система-получатель обрабатывает этот запрос.
• Вы получаете ответ с нужной информацией или подтверждением действия.
• Данные отображаются в удобном для пользователя виде.

Как интернет-пользователи применяют API#

API — это не какое-то редкое и уникальное явление. На самом деле, каждый интернет-пользователь ежедневно взаимодействует с программным интерфейсом:

• Онлайн-платежи: каждая транзакция на сайте проходит через API платежной системы.

• Авторизация через соцсети: вход на сайт через аккаунт Google, Яндекс или VK.
• Карты и геолокация: отображение адресов и маршрутов доставки на сайте.
• Виджеты социальных сетей: кнопки «Поделиться» и встроенные посты.

• Погодные данные: прогноз погоды на главной странице портала.
• Курсы валют: актуальные котировки на финансовых, новостных сайтах и в поисковиках.

• Системы аналитики: сбор статистики посещений через Google Analytics или Яндекс.Метрику.

Зачем бизнесу нужен API: 5 ключевых задач#

1. Экономия времени и денег на разработке#

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

Пример: интернет-магазину не нужно создавать систему авторизации пользователей — можно подключить вход через Google, VK или Яндекс.

2. Автоматизация бизнес-процессов#

API позволяет объединить разные системы в единую экосистему. Данные автоматически передаются между CRM, складским учетом, сервисами рассылок и аналитикой без ручного ввода информации.

Пример: диалог клиента и менеджера из чате на сайте от Jivo можно передать в amoCRM, Битрикс24 и любые другие CRM-системы.

3. Повышение безопасности данных#

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

Пример: при оплате на сайте магазина данные карты не попадают на сервер продавца — они напрямую передаются в платежную систему через защищенный API.

4. Быстрое масштабирование и добавление новых функций#

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

Пример: компания решила добавить в чат от Jivo своего бота. Можно легко интегрировать это решение через API.

5. Интеграция с партнерскими системами#

API открывает возможности для B2B-партнерств и создания экосистем. Компании могут обмениваться данными с партнерами, агрегаторами и маркетплейсами.

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

Что такое API в Jivo и как его использовать#

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

1. Узнать о наступлении события#

Callback — это функции, которые вызываются автоматически, когда в виджете Jivo происходит определенное событие. Такие функции позволяют реагировать на действия пользователя в реальном времени и собирать нужные данные. Вы можете получать уведомление при:

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

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

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

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

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

Тогда стоит провести беседу с сотрудниками и объяснить, почему важно ответить клиенту в течение нескольких секунд после получения обращения. Например, можно сразу поздороваться с клиентом и написать ему, что оператор начал заниматься его вопросом:

2. Кастомизировать виджет чата от Jivo#

Вы можете настраивать различные параметры чата на сайте от Jivo под свои нужды:

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

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

2. Поменять цвет виджета. Например, если на разных страницах сайта вы используете разный дизайн, то можно менять цвет самого чата в зависимости от страницы. Доступен любой цвет из стандартных в HTML.

3. Применить кастомный ярлык виджета. С помощью API можно кастомизировать ярлык приложения Jivo.

Подробнее об этой функции можно узнать в статье.

4. Изменить форму обратного звонка. Вы можете использовать готовые настройки обратного звонка в Jivo или создать свою самописную форму:

5. Узнать, на какой странице сейчас находится клиент. По умолчанию в Jivo отображается страница начала диалога: откуда клиент написал вам в чат на сайте.

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

6. Собирать любые данные клиента и отображать их в диалоге. Кастомная форма помогает собрать любые данные клиента, которые не предусмотрены в стандартной форме, и погрузить их в приложение Jivo. Например, вы можете добавить поле для сбора госномера машины клиента:

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

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

8. Сделать эксклюзивные настройки для активного приглашения. Активное приглашение в Jivo — это автоматическое всплывающее окно чата, которое появляется перед посетителями сайта, чтобы инициировать диалог.

Можно задать настройки активного приглашения в самом приложении Jivo:

Но если вас интересуют дополнительные настройки, которых нет в стандартном перечне Jivo, вы можете задать их дополнительно через API.

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

Важно, что если логика активных приглашений задана и в приложении Jivo, и через API, то настройки API — важнее и именно они будут реализованы на вашем сайте.

3. Синхронизировать переписку в чате клиента, если он заходит с разных устройств#

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

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

Читайте подробнее о том, как настроить JWT-авторизацию.

3. Отправлять данные из Jivo в CRM-систему или на ваш сервер#

Благодаря Webhooks API вы сможете отправлять всю информацию о клиенте собранную в Jivo на сервер или в вашу CRM-систему: amoCRM, Битрикс24, EnvyCRM, YCLIENTS и другие.

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

Чтобы система работала, в настройках Jivo нужно написать адрес, куда отправлять данные:

Можно пересылать информацию после:

• начала и окончания звонка;
• приема диалога оператором
• обновлении данных о клиенте;
• завершении чата;
• отправке офлайн-сообщения и контакты клиента.

Подробнее об интеграции Jivo с CRM-системами вы можете узнать в базе знаний.

4. Интегрировать любой канал переписки в приложение Jivo#

Jivo — это омниканальное приложение, объединяющее все популярные способы общения с клиентами в одном окне:

• чат на сайте;
• в мобильном приложении;
• ВКонтакте;
• WhatsApp*;
• Telegram;
• Viber;
• Одноклассники;
• электронную почту;
• Авито;
• Дром;
• 2gis;
• Apple Business Chat;
• AliExpress.

Сообщения со всех этих каналов коммуникации будут приходить в единую систему Jivo.

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

Если ваш способ коммуникации с клиентами не попал в список выше, Chat API позволяет подключить такой канал общения к Jivo.

Тогда ваш оператор сможет общаться с клиентами, используя весь потенциал Jivo:

1. Сохранять контактные данные пользователя.
2. Применять AI-ассистента.
3. Наблюдать за тем, что печатает клиент.
4. Добавлять комментарии о клиенте.
5. Приглашать в чат других операторов, если нужна помощь.
6. Обмениваться картинками, видео, стикерами, голосовыми сообщениями.
7. Использовать шаблоны и быстрые ответы.

Подробнее о том, как интегрировать любой чат с Jivo, читайте в документации для разработчиков.

5. Интегрировать любого чат-бота с любым каналом Jivo#

Bot API позволяет интегрировать любого чат-бота с чатом на сайте, мобильным приложением, ВКонтакте, Telegram, WhatsApp* и любыми другими письменными каналами Jivo.

При этом оператор будет видеть переписку бота с клиентом в приложении Jivo и сможет подключиться к ней при необходимости.

Подробнее о том, как интегрировать вашего чат-бота с любым каналом в Jivo, вы можете узнать в документации.

Что важно запомнить про API#

1. API — это инструмент, который соединяет разные программы и сервисы, позволяя им обмениваться данными и договариваться между собой. Интерфейс программирования делает возможным совместную работу систем, даже если они созданы разными компаниями и на разных языках программирования.
2. Интернет-пользователи сталкиваются с API ежедневно: когда совершают покупки в интернет-магазине, авторизуются через соцсети, проверяют курсы валют, смотрят погоду.
3. API помогает бизнесу: сэкономить время и деньги на разработке, автоматизировать бизнес-процессы, повысить безопасность данных, быстрее масштабировать решения, интегрировать свою систему с партнерскими.
4. С помощью API в Jivo вы можете: узнать о наступлении определенного события в виджете на сайте, кастомизировать виджет сайта, сохранять переписку клиента, который заходит с разных устройств, отправлять данные из Jivo в CRM-систему или на сервер, интегрировать сторонний чат или вашего бота в Jivo. Подробнее о том, как применять API, вы можете узнать в нашей документации.

*WhatsApp принадлежит компании Meta (признана экстремистской и запрещена на территории РФ)