# Hostme

## Описание интеграции

[Hostme](https://www.hostmeapp.ru/) - умный сервис бронирования и управления рестораном. Интеграция сервиса с \
I-digital direct позволяет отправлять гостям Whatsapp-сообщения со статусами бронирований, информации о событиях или заказах.

## Инструкция по подключению

Чтобы начать использовать сервис I-digital direct в Hostme, необходимо выполнить несколько простых шагов по подключению.

**1. Аккаунт в сервисе i-digital direct** \
[Зарегистрируйтесь ](https://direct.i-dgtl.ru/register/)в сервисе i-digital direct. А если у вас уже есть аккаунт, можно сразу переходить к подключению каналов и настройке интеграции.

**2. Создайте аккаунт WhatsApp Business.** 

* Ссылки для скачивания с разных платформ: [iOS](https://apps.apple.com/app/whatsapp-business/id1386412985), [Android](https://play.google.com/store/apps/details?id=com.whatsapp.w4b\&hl=en_US\&gl=US\&pli=1).
* Определитесь, какой номер телефона будет использоваться для вашего аккаунта. Лучше, если это будет номер на котором ранее был аккаунт WhatsApp и велись переписки. Но если такого нет, то подойдёт и новый.
* Зарегистрируйте WhatsApp аккаунт на этот номер.
* Установите подходящий аватар пользователя и сделайте описание профиля, так пользователям будет понятно от кого они получают сообщения.
* Сообщите менеджеру номер телефона для регистрации аккаунта и выбранный пакет сообщений на месяц (активация аккаунта осуществляется после пополнения баланса). Если у вас нет персонального менеджера, то пришлите эту информацию на account@i-dgtl.ru.
* После регистрации вы получите ссылку перейдя по которой сможете сгенерировать QR для привязки вашего аккаунта к i-digital direct.
* Отсканируйте QR через приложение WhatsApp на смартфоне:

::::{tab-set}

:::{tab-item} Android

**Шаг 1. Откройте приложение WhatsApp на смартфоне**

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

<figure><img src="../.gitbook/assets/image (99).png" alt=""><figcaption></figcaption></figure>

**Шаг 2. Выбрать пункт меню Связанные устройства**

В появившемся меню выберите пункт "Связанные устройства".

<figure><img src="../.gitbook/assets/2.jpg" alt=""><figcaption></figcaption></figure>

**Шаг 3. Нажмите "Привязка устройства" и отсканируйте смартфоном QR, ссылку на который вам прислал менеджер**

<figure><img src="../.gitbook/assets/3 (1).jpg" alt=""><figcaption></figcaption></figure>
:::


:::{tab-item} iOS

**Шаг 1. Откройте приложение WhatsApp на смартфоне**

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

<figure><img src="../.gitbook/assets/1-1 (1).jpg" alt=""><figcaption></figcaption></figure>

**Шаг 2. Выбрать пункт меню Связанные устройства**

В появившемся меню выберите пункт "Связанные устройства".

<figure><img src="../.gitbook/assets/2-1 (1) (1).jpg" alt=""><figcaption></figcaption></figure>

**Шаг 3. Нажмите "Привязка устройства" и отсканируйте смартфоном QR, ссылку на который вам прислал менеджер**

<figure><img src="../.gitbook/assets/3-1 (1).jpg" alt=""><figcaption></figcaption></figure>
:::

::::




**3. Подключение SMS**

Мы рекомендуем подключать SMS, чтобы отправлять сообщения клиентам, у которых не установлено мобильное приложение WhatsApp. Подробнее о подключении SMS https://faq.docs.direct.i-dgtl.ru/kanaly-otpravki/sms

**4.  Настройте интеграцию с Hostme в I-Digital Direct.**

* Добавьте возможность получать входящие сообщения в Hostme. \
  Для этого в ЛК I-Digital Direct перейдите Настройки -> Входящий трафик.

<figure><img src="../.gitbook/assets/inbound (1).png" alt=""><figcaption></figcaption></figure>

<figure><img src="../.gitbook/assets/добавить.png" alt=""><figcaption></figcaption></figure>

* Нажмите зелёную кнопку “Добавить”.
* Выберите в поле “Канал” -> “Weasy”.
* В поле “Callback URL” скопируйте следующий адрес: [https://hostme-services-qa.azurewebsites.net/api/wm/admin/integration/idirect](https://hostme-services-qa.azurewebsites.net/api/wm/admin/integration/idirect).
* В типах событий установите галочку для "Входящее сообщение".
* Подтвердите, нажав кнопку “Добавить”.

<figure><img src="../.gitbook/assets/настройки.png" alt=""><figcaption></figcaption></figure>

* Теперь необходимо создать API-ключ для Hostme. В ЛК I-Digital Direct перейдите Настройки -> API-ключи.

<figure><img src="../.gitbook/assets/api.png" alt=""><figcaption></figcaption></figure>

<figure><img src="../.gitbook/assets/create.png" alt=""><figcaption></figcaption></figure>

* Нажмите на кнопку “Создать ключ".
* Укажите название вашей интеграции, может быть любым.
* В методах выберите "Отправка сообщений и рассылок, получение статистики".
* Укажите тип интеграции - выберите из списка Hostme.
* Укажите центр разделения трафика - выберите тот который у вас есть в списке или необходимый вам, если вы используете этот параметр. Создать новый центр разделения трафика можно в разделе Настройки -> Центры разделения трафика.&#x20;
* Нажмите на кнопку "Создать".
* В появившемся окне скопируйте созданный API-ключ.

<figure><img src="../.gitbook/assets/настройки ключа.png" alt=""><figcaption></figcaption></figure>

<figure><img src="../.gitbook/assets/ключ.png" alt=""><figcaption></figcaption></figure>

**5. Настройте интеграцию с I-Digital Direct в Hostme**

* Перейдите в ЛК Hostme.&#x20;
* В панели администратора Hostme перейти в раздел Маркетплейс.
* Найдите WhatsApp, нажмите “Подключить”.

<figure><img src="../.gitbook/assets/хостми1.png" alt=""><figcaption></figcaption></figure>

* Подключение переместится наверх списка в раздел “Установленные приложения”.
* Перейдите в “Настройки”.

<figure><img src="../.gitbook/assets/хостми2.png" alt=""><figcaption></figcaption></figure>

* Установите настройки подключения:&#x20;

1. API key - это API-ключ для интеграции, который вы получили в ЛК I-Digital Direct, вставьте его в это поле;
2. Sender name for WhatsApp - введите номер телефона, на который был создан аккаунт WhatsApp for Business.
3. Sender name for SMS - имя отправителя для SMS если этот канал используется в качестве резерва для отправки сообщений тем, у кого нет WhatsApp. Не меняйте это поле. Как подключить своё имя для SMS вам сообщит менеджер I-Digital Direct.

**6. Заключительный шаг - активация аккаунта**

Для того чтобы активировать ваш аккаунт WhatsApp Business и задать дополнительные вопросы по подключению SMS, напишите письмо на [account@i-dgtl.ru](mailto:account@i-dgtl.ru) о том, что вы подключаете интеграцию Hostme. В письме сообщите следующие данные:

* планируете ли использовать своё имя отправителя для смс;
* номер, на который был создан аккаунт WhatsApp Business;
* email, который вы указали при регистрации ЛК i-digital direct.

Менеджер поможет активировать WhatsApp, ответить на вопросы связанные с SMS и на этом настройка будет завершена.<br>