Как подключить СМС через SigmaSMS

Интеграция с SigmaSMS позволяет отправлять СМС из Chat2Desk с общего имени отправителя или от имени вашей компании. В этой статье расскажем, как подготовить аккаунт SigmaSMS, подключить канал и настроить статусы доставки.

Канал поддерживает только исходящие текстовые сообщения. Получать ответы клиентов, отправлять кнопки и вложения через него нельзя.

Как оплачивается канал

Оплата состоит из двух частей:

• В SigmaSMS вы оплачиваете сообщения и собственное имя отправителя, если используете его. Условия и стоимость согласуются с менеджером SigmaSMS.
• В Chat2Desk оплачивается слот мессенджера SMS Business (Sigma) в вашем тарифном пакете.

Использование канала расходует лимит активных диалогов в Chat2Desk. Длинное СМС делится на сегменты, каждый из которых оплачивается отдельно. Ограничения по длине приведены в конце статьи.

Как выбрать имя отправителя

Имя отправителя, или альфа-имя (SenderID), отображается у получателя СМС. Вы можете использовать общее имя или зарегистрировать собственное в SigmaSMS.

При отправке с общего имени SigmaSMS автоматически подставляет одно из своих общих имен. Получатель увидит именно его. Значение chat2desk нужно указать в настройках подключения; оно не определяет имя, которое увидит получатель. Полный список общих имен SigmaSMS не предоставляет.

Бесплатное общее имя не означает бесплатную отправку СМС. Сообщения оплачиваются по условиям SigmaSMS.

Для собственного имени действуют ограничения:

• латиница, без кириллицы;
• от 4 до 11 символов, из них не более 10 цифр;
• совпадение с товарным знаком или доменным именем. Регистр может быть любым, поддерживаются спецсимволы;
• без пробелов; 
• имя не должно быть общим, например DOSTAVKA или SMS-INFO;
• имя не должно быть схоже с другими торговыми марками.

Если собственное имя не понадобится в следующем месяце, сообщите об этом в SigmaSMS до 20-го числа текущего месяца. Имя заблокируют, а списание абонентской платы приостановят.

Шаг 1. Подготовьте аккаунт SigmaSMS

1. Зарегистрируйтесь в SigmaSMS по партнерской ссылке Chat2Desk: https://user.sigmasms.ru/registration?ref=Chat2Desk.

[Скриншот: форма регистрации SigmaSMS по партнерской ссылке Chat2Desk]

2. Дождитесь, когда менеджер SigmaSMS свяжется с вами для обсуждения условий и стоимости. Если планируете использовать общее имя, сообщите, что будете отправлять СМС с бесплатного общего имени через Chat2Desk.

3. Заполните реквизиты в SigmaSMS и подпишите договор.

[Скриншот: раздел личного кабинета SigmaSMS для заполнения реквизитов]

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

[Скриншот: регистрация собственного имени отправителя в SigmaSMS]

5. Если выбрали общее имя, передайте тексты сообщений менеджеру SigmaSMS для согласования. С собственного зарегистрированного имени можно отправлять сообщения без шаблонов. Если хотите использовать шаблоны для собственного имени, обсудите условия и стоимость с менеджером. Подробнее об этом в разделе «Как использовать шаблоны» ниже.

6. Пополните баланс в SigmaSMS.

[Скриншот: пополнение баланса в личном кабинете SigmaSMS]

7. Откройте раздел Токены в личном кабинете SigmaSMS и создайте токен для подключения к Chat2Desk. При создании выберите срок действия токена. Рекомендуем указать максимальный срок — один год.

[Скриншот: создание токена в разделе «Токены» SigmaSMS; значение токена скрыто]

Шаг 2. Подключите SigmaSMS к Chat2Desk

1. После подготовки аккаунта SigmaSMS обратитесь в поддержку Chat2Desk для подключения SMS Business (Sigma).

2. Когда мессенджер добавят на ваш аккаунт, откройте Настройки > Каналы и мессенджеры.

[Скриншот: SMS Business (Sigma) в разделе «Настройки > Каналы и мессенджеры» Chat2Desk]

3. Нажмите на значок карандаша рядом с мессенджером SMS Business (Sigma).

[Скриншот: значок карандаша рядом с SMS Business (Sigma)]

4. Вставьте созданный в SigmaSMS токен в поле Токен.

[Скриншот: поле «Токен» в настройках SMS Business (Sigma); значение токена скрыто]

5. Укажите SenderID: для общего имени введите chat2desk, для собственного — имя, зарегистрированное в SigmaSMS. При значении chat2desk SigmaSMS подставит одно из своих общих имен отправителя.

[Скриншот: поле SenderID со значением chat2desk в настройках SMS Business (Sigma)]

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

Шаг 3. Настройте статусы доставки

Чтобы Chat2Desk получал статусы СМС, добавьте адрес вебхука из Chat2Desk в настройки SigmaSMS. Через этот адрес SigmaSMS передает информацию о доставке сообщений.

1. В Chat2Desk откройте Настройки > Каналы и мессенджеры и нажмите на значок карандаша рядом с SMS Business (Sigma).

[Скриншот: открытие настроек SMS Business (Sigma) в Chat2Desk]

2. Скопируйте адрес вебхука из настроек мессенджера.

[Скриншот: адрес вебхука в настройках SMS Business (Sigma)]

3. В личном кабинете SigmaSMS откройте Настройки > Webhooks.

[Скриншот: раздел «Настройки > Webhooks» в SigmaSMS]

4. Вставьте скопированный адрес вебхука.

[Скриншот: поле для адреса вебхука в SigmaSMS]

Статусы помогают проверить, что произошло с сообщением:

Статус «Отправлено» сам по себе не подтверждает доставку сообщения.

Как использовать шаблоны

Шаблон СМС — заранее согласованный текст сообщения. Правила отправки зависят от имени отправителя.

Для общего имени отправителя

Для общего имени сначала доступно только тестовое сообщение. Чтобы отправлять другие тексты, передайте их менеджеру SigmaSMS. Он проверит и добавит разрешенные тексты для отправки с общего имени. Если отправить несогласованный текст, появится ошибка Could not find matching template.

Изначально доступен только тестовый шаблон:

Это тестовое сообщение. 
Изменённый текст будет отправлен на модерацию.

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

Для собственного имени отправителя

С собственного зарегистрированного имени можно отправлять СМС без шаблонов. Если вы планируете регулярные отправки, обсудите с менеджером SigmaSMS использование шаблонов: в зависимости от условий они могут снизить стоимость сообщений.

Сколько символов можно отправить

С собственного зарегистрированного имени можно отправлять СМС без шаблонов. Если вы планируете регулярные отправки, обсудите с менеджером SigmaSMS использование шаблонов: в зависимости от условий они могут снизить стоимость сообщений.

Сколько символов можно отправить

Одно СМС вмещает до 160 символов в кодировке GSM-7 или до 70 в Unicode. Кириллица и ряд специальных символов переводят все сообщение в Unicode, даже если остальной текст написан латиницей. 

К символам, которые переводят сообщение в Unicode, относятся:

• русские и другие буквы, которые не входят в GSM-7;
• длинное тире —, короткое тире – и неразрывный дефис ‑;
• кавычки « » и типографские кавычки “ ”;
• многоточие одним знаком …;
• знаки №, ₽, → и •;
• эмодзи.

Три обычные точки ... не заменяют кодировку на Unicode.

Например, сообщение из 100 кириллических символов оплачивается как два СМС, хотя получатель увидит один текст.

Максимальная длина сообщения в интеграции — 765 символов в GSM-7 или 335 в Unicode. Отправить более длинный текст нельзя.