Добавление интеграции

Интеграции — это внешние службы, подключаемые к Gizmo для расширения функционала, например, службы отправки SMS, боты в Telegram и др.

Интеграции живут в разделе «Настройки» → «Сервер» → «Плагины», во втором блоке экрана — Интеграции. Первый блок, Плагины, отвечает за другое: там перечислены файлы расширений, установленные на сервере.

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

Как добавить

  1. Откройте «Настройки» → «Сервер» → «Плагины».

  2. В блоке Интеграции нажмите

    .

  3. В окне «Выберите тип интеграции» выберите нужную службу.

  4. Заполните её параметры — состав полей зависит от выбранного типа.

  5. Сохраните и перезапустите сервер.

Доступные типы

  • Telegram-бот — интеграция мессенджера Telegram для подтверждения пользователей и уведомлений.

  • Пользовательский — отправляет SMS на любой SMS-шлюз с помощью настраиваемого HTTP-запроса. Подходит, когда нужного оператора нет в списке готовых.

  • Red SMS — SMS-сообщения и флэш-звонки через сервис RedSMS.ru.

  • SMS Aero RU — SMS-сообщения через сервис SMS Aero.

  • SMSC RU — SMS-сообщения и флэш-звонки через сервис SMSC.ru.

  • Twilio — SMS-сообщения через сервис Twilio.

  • Системный SMTP — электронная почта через системную конфигурацию SMTP. Сам почтовый сервер настраивается отдельно, в разделе «Настройки SMTP».

Таблица интеграций

Добавленные интеграции показываются списком:

  • Название — название интеграции.

  • Тип — служба, к которой она подключена.

  • Включен — работает интеграция или отключена.

Настройка SMS-провайдеров

Провайдер

Что нужно для настройки

Возможности

Red SMS

Логин учётной записи и API-ключ (есть на странице настроек в кабинете RedSMS). Длина флэш-звонка — сколько цифр (4 или 6) гость вводит при подтверждении

SMS и флэш-звонки

SMS Aero RU

Email учётной записи, API-ключ и подпись (подпись отправителя оформляется по запросу у провайдера)

Только SMS

SMSC RU

Логин и пароль учётной записи

SMS и флэш-звонки

Twilio

SID аккаунта, токен и номер отправителя

Только SMS

Пользовательский провайдер

Если нужного SMS-провайдера нет в списке, выберите Пользовательский и укажите URL HTTP-запроса провайдера. Требования:

  • поддерживаются методы GET и POST;

  • все параметры передаются в строке URL — параметры в теле запроса не поддерживаются;

  • в URL используются подстановки: {FROM} — отправитель, {TO} — номер получателя, {MESSAGE} — текст сообщения.

Примеры URL для популярных провайдеров (замените заглавные значения на свои):

Провайдер

URL

https://rest.nexmo.com/sms/json?api_key=APIKEY&api_secret=APISECRET&from={FROM}&to={TO}&text={MESSAGE}

https://TWILIO_ACCOUNT_SID:TWILIO_AUTH_TOKEN@api.twilio.com/2010-04-01/Accounts/TWILIO_ACCOUNT_SID/Messages.json?From={FROM}&To=+{TO}&Body={MESSAGE}

https://api.smstraffic.ru/multi.php?login=ACCOUNTNAME&password=ACCOUNTPASSWORD&originator={FROM}&phones={TO}&message={MESSAGE}

http://billing.smstraf.ru/sys/send.php?login=ACCOUNTNAME&psw=ACCOUNTPASSWORD&sender={FROM}&phones={TO}&mes={MESSAGE}

http://sms.etc.uz:8083/http2sms?login=LOGIN&pwd=PASSWORD&CgPN=SENDER&CdPN={TO}&text={MESSAGE}

Телефон Android как SMS-шлюз

Вместо SMS-провайдера можно отправлять сообщения через обычный телефон на Android:

  1. Установите на телефон приложение GSM - modem (SMS).

  2. В приложении нажмите Users и создайте пользователя с паролем.

  3. Нажмите ВКЛ. и проверьте, что статус службы — started.

  4. В Gizmo добавьте интеграцию Пользовательский с URL:

http://PHONEIP:8090/SendSMS?username=USER&password=PASSWORD&phone={TO}&message={MESSAGE}

где PHONEIP — IP-адрес телефона, который показывает приложение, а USER и PASSWORD — пользователь и пароль, созданные в приложении. Телефон должен быть в одной сети с сервером.