# I-Digital SMS

## Установка и настройка

I-Digital SMS- приложение для отправки SMS из Bitrix24 через сервис I-Digital Direct.

После подключения I-Digital становится доступен как SMS-провайдер внутри Bitrix24. Пользователи могут использовать SMS в CRM-сценариях, отправлять сообщения клиентам и видеть базовые статусы доставки в карточках CRM.

### Для чего подходит

* подтверждение заявок и заказов;
* напоминания о встречах, оплатах и доставке;
* сервисные уведомления;
* короткие персональные сообщения клиентам;
* автоматические SMS из CRM-роботов и бизнес-процессов;
* массовые SMS через сценарии Bitrix24.

### Что понадобится перед установкой

Для работы нужен аккаунт [I-Digital Direct](https://direct.i-dgtl.ru/channels-management) и API-ключ.

API-ключ можно получить в личном кабинете I-Digital Direct: [https://direct.i-dgtl.ru/dev-api](https://direct.i-dgtl.ru/dev-api).

Если аккаунта еще нет, зарегистрируйтесь [на сайте I-Digital](https://i-dgtl.ru/) или обратитесь в поддержку I-Digital support@i-dgtl.ru.

### Установка приложения

1. Откройте ваш портал Bitrix24.
2. Перейдите в раздел **Маркетплейс** или **Приложения**.
3. Найдите приложение **I-Digital SMS**.
4. Нажмите **Установить**.
5. Подтвердите установку приложения.
6. После установки откройте приложение или его настройки.

### Настройка подключения

1. Вставьте API-ключ I-Digital Direct.
2. Если ключа еще нет, получите его в личном кабинете: [https://direct.i-dgtl.ru](https://direct.i-dgtl.ru/).
3. Укажите имя отправителя, если оно уже зарегистрировано в I-Digital.
4. Если используется общий отправитель, укажите название компании, которое будет добавляться в текст SMS.
5. Нажмите **Проверить и сохранить**.

После сохранения приложение проверит связь с I-Digital Direct и добавит I-Digital как SMS-провайдера в Bitrix24.

### Проверка подключения

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

* приложение установлено в Bitrix24;
* ключ I-Digital сохранен;
* связь с I-Digital работает;
* отправитель выбран;
* название компании добавлено, если используется общий отправитель;
* I-Digital добавлен в Bitrix24;
* баланс пополнен в личном кабинете I-Digital.

Если баланс еще не пополнен, откройте личный кабинет I-Digital Direct и пополните счет.

### Тестовая отправка SMS

1. Откройте карточку сделки, контакта или клиента в Bitrix24.
2. Найдите действие отправки SMS.
3. Выберите I-Digital как SMS-провайдера, если Bitrix24 предлагает выбор провайдера.
4. Выберите получателя.
5. Проверьте имя отправителя.
6. Напишите короткое тестовое сообщение.
7. Отправьте SMS.
8. Проверьте, что сообщение появилось в истории карточки или в ленте событий.
9. Дождитесь обновления статуса доставки.

### Использование в CRM-роботах

После подключения I-Digital можно использовать в автоматических сценариях Bitrix24.

Например:

* отправлять SMS при создании сделки;
* отправлять SMS при переходе сделки на нужный этап;
* отправлять напоминания клиенту;
* отправлять уведомления ответственному менеджеру;
* использовать данные из CRM в тексте сообщения.

Для настройки откройте автоматизацию Bitrix24, выберите действие отправки SMS и используйте подключенный провайдер I-Digital.

### Где смотреть историю и статусы

После отправки SMS информация отображается в Bitrix24 в зависимости от сценария отправки.

Обычно можно увидеть:

* дату и время отправки;
* получателя;
* отправителя;
* текст сообщения;
* статус доставки.

Статус может обновиться не сразу. Это нормально: доставка зависит от оператора и может занять некоторое время.

### Частые ситуации

#### API-ключ не принимается

Проверьте, что ключ скопирован полностью и без лишних пробелов. Если ошибка остается, получите новый ключ в личном кабинете I-Digital Direct или обратитесь в поддержку.

#### I-Digital не появился как SMS-провайдер

Откройте настройки приложения и нажмите `Проверить и сохранить` еще раз. Если проблема остается, обратитесь в поддержку I-Digital.

#### SMS не отправляется

Проверьте:

* сохранен ли API-ключ;
* есть ли баланс в I-Digital Direct;
* выбран ли отправитель;
* корректно ли указан номер телефона клиента;
* доступен ли I-Digital в настройках SMS-провайдера Bitrix24.

#### Статус доставки не обновился

Подождите несколько минут и обновите карточку. Если статус не изменился, проверьте отправку в личном кабинете I-Digital Direct или обратитесь в поддержку.

#### Нужно зарегистрировать имя отправителя

Имя отправителя регистрируется на стороне I-Digital. Если хотите, чтобы клиент видел название вашей компании вместо общего отправителя, обратитесь в поддержку I-Digital.

### Баланс и оплата SMS

Баланс SMS пополняется в личном кабинете I-Digital Direct: [https://direct.i-dgtl.ru](https://direct.i-dgtl.ru/).

Если баланс закончился, SMS не будут отправляться до пополнения.

### Поддержка

Если возникнут вопросы по API-ключу, имени отправителя, балансу или доставке SMS, обратитесь в поддержку I-Digital.

Для обращения подготовьте:

* адрес портала Bitrix24;
* пример карточки или сценария, из которого отправляли SMS;
* номер получателя;
* примерное время отправки;
* текст ошибки, если она отображается.

### Короткая версия для пользователя

1. Установите `SMSforCRM I-Digital` из Битрикс24.Маркет.
2. Откройте настройки приложения.
3. Вставьте API-ключ из [I-Digital Direct](https://direct.i-dgtl.ru/).
4. Укажите имя отправителя.
5. Если нужно, укажите название компании для SMS.
6. Нажмите `Проверить и сохранить`.
7. Пополните баланс в личном кабинете I-Digital.
8. Отправьте тестовое SMS из карточки CRM или через SMS-действие Bitrix24.
9. Проверьте историю и статус доставки.