Wazzup База знаний по сервису

wz-help-logo-part

База знаний

Схемы интеграций

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

  1. Публичные интеграции — интеграции, которые выполненные по нашим заготовленным “схемам” и опубликованные в маркетплейсе интеграций Wazzup. Создателю интеграции, дошедшему до этапа публикации, может быть присвоен статус “технического партнера”, что дает возможность получать процент с продаж этой интеграции.
  2. Непубличные интеграции — интеграции, которые не опубликованы в маркетплейсе интеграций. Часто сделаны для индивидуального пользования.

Если хотите создать публичную интеграцию, то вот два важных условия:

  • Нужно сделать интеграцию в соответствии с нашими схемами интеграций.
  • Нужно пройти ревью.

А вот и схемы

Схема интеграции — подготовленная концепция интеграции, которая выполняет две основные функции:

  • Максимизирует ценность для пользователя от будущей интеграции.
  • Упрощает процесс разработки интеграции, за счет верхнеуровной пошаговой инструкции.

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

Интеграция с Wazzup может быть реализована разными подходами:

  • С использованием интерфейсов для чатов Wazzup: встроенных чатов Wazzup (iFrame) или «личного кабинете менеджера»
  • С использованием ваших интерфейсов для обработки чатов. Wazzup в этом случае выполняет роль поставщика каналов или, как принято говорить, роль “транспорта”.

Мы рекомендуем использовать  для интеграций наши интерфейсы для чатов, потому что:

  • Вам не нужно разрабатывать/дорабатывать/поддерживать свои интерфейсы для обработки диалогов.
  • Мы непрерывно занимаемся улучшением наших интерфейсов, повышая их удобство и ценность для пользователя,  потому что это наш основной продукт.
  • Технические партнеры, которые  используют вариант интеграций с помощью наших интерфейсов могут получить до 50% комиссии, в то время интегрируя Wazzup только через API можно претендовать только до 25%.

Схема интеграции с ведением клиента

Данная схема интеграции подходит для CRM, ЦА которых ведет продолжительное время клиентов, в том числе передавая его от менеджера по продажам к аккаунт-менеджеру.

Данная схема является “классической” и наиболее полной. Рекомендуем брать ее в основу любой интеграции с нами.

Реализация с помощью iFrame
Что зачем
Настройте синхронизацию аккаунтов пользователей вашей CRM и Wazzup Это поможет Wazzup иметь актуальный список ваших пользователей,  которые будут работать с чатами Wazzup, обрабатывая входящие диалоги.
Научитесь открывать окно чатов 1. “Глобальное окно чатов” (“scope”: “global”)  — окно со всеми чатами, доступными для пользователя.
> Глобальное окно чатов — место, куда будут поступать все чаты,  на которые увидят все пользователи, имеющие доступ к чатам Wazzup. Значок, по клику на который, будет открываться глобальное окно чатов рекомендуем разместить на видном месте.2. “Окно чатов в карточке контакта”  (“scope”: “card”) — окно чатов с конкретным списком контактов, например, из релевантной карточки контакта.
> “Окно чатов в карточке контакта” — способ быстро открыть чат с конкретным пользователем. Рекомендуем размещать значок, который будет открывать
Настройте синхронизацию контактов вашей CRM и Wazzup Это нужно чтобы:

1. Показывать диалоги менеджерам, которые указаны как ответственные за контакт

2. Была возможность быстро попадать на карточку контакта в CRM

3. Была возможность инициировать чат из карточки контакта с контактами, которые были созданы в CRM до подключения к Wazzup

Настройте синхронизацию сделок из вашей CRM и Wazzup Это нужно чтобы:

1. Показывать диалоги менеджерам, которые указаны как ответственные за сделку

2. Менеджер мог видеть список открытых и закрытых сделок у этого контакта и была возможность быстро попадать на карточку сделки в CRM

Настройте счетчик неотвеченных. Дает понять, что остались неотвеченные сообщения. Рекомендуем его размещать на значке, по клику на который открывается глобальный чат
Научитесь получать и обрабатывать вебхуки 1.Вебхук о Создании нового контата и сделки

2. Получение новых сообщений —> для использования в вашей системе нотификаций

3. Обновление состояния каналов (optional)

Загрузите воронки с этапами Это позволит нам отправлять вебхук  о Создании нового контата и сделки, когда напишет новый клиент
Отладьте работу с инструментом “чемодан 1. Проверьте корректность передачи ссылок в PATCH /v3/contacts для отображения кнопки-ссылки на страницу контакта в CRM

2. Проверьте корректность передачи ссылок в  PATCH /v3/deals для отображения ссылок на существующие сделки с данным контактом

3. Научитесь обрабатывать вебхук  Создании новой сделки, при клике пользователем на “+” из инструмента чемодан

Настроить WAuth
  1. Научитесь доставать state из  authRedirectUri
  2. Научитесь отправлять POST /connect
Подать заявку на размещение в маркетплейсе интеграций Wazzup

Схема интеграции без ведения клиента

Данная схема интеграции подходит для:

  • CRM, целевая аудитория которых не ведет продолжительное время клиентов, а совершает быстрые продажи, консультирует пользователей о статусе заказа или наличии товара на складе
  • CRM или платформ для коммуникаций, пользователи которых небольшие контакт-центры до четырех человек

Особенность схемы реализации:

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

Реализация с помощью iFrame
Что зачем
Настройте синхронизацию аккаунтов пользователей вашей CRM и Wazzup Это поможет Wazzup иметь актуальный список ваших пользователей,  которые будут работать с чатами Wazzup, обрабатывая входящие диалоги.
Научитесь открывать окно чатов 1. “Глобальное окно чатов” (“scope”: “global”)  — окно со всеми чатами, доступными для пользователя.
> Глобальное окно чатов — место, куда будут поступать все чаты,  на которые увидят все пользователи, имеющие доступ к чатам Wazzup. Значок, по клику на который, будет открываться глобальное окно чатов рекомендуем разместить на видном месте.2. “Окно чатов в карточке контакта”  (“scope”: “card”) — окно чатов с конкретным списком контактов, например, из релевантной карточки контакта.
> “Окно чатов в карточке контакта” — способ быстро открыть чат с конкретным пользователем. Рекомендуем размещать значок, который будет открывать
Настройте синхронизацию контактов вашей CRM и Wazzup Это нужно чтобы:

1. Была возможность быстро попадать на карточку контакта в CRM

2. Была возможность инициировать чат из карточки контакта с контактами, которые были созданы в CRM до подключения к Wazzup

Настройте счетчик неотвеченных. Дает понять, что остались неотвеченные сообщения. Рекомендуем его размещать на значке, по клику на который открывается глобальный чат
Научитесь получать и обрабатывать вебхуки 1.Вебхук о Создании нового контата

2. Получение новых сообщений —> для использования в вашей системе нотификаций

3. Обновление состояния каналов (optional)

Отладьте работу с инструментом “чемодан С помощью чемодана менеджер может быстро переключаться между интерфейсами чатов Wazzup и CRM.
1. Проверьте корректность передачи ссылок в PATCH /v3/contacts для отображения кнопки-ссылки на страницу контакта в CRM
Настроить WAuth
  1. Научитесь доставать state из  authRedirectUri
  2. Научитесь отправлять POST /connect
Подать заявку на размещение в маркетплейсе интеграций Wazzup