October 24, 2023

Настройка smsTOapi и callsTOapi на @signinssobot

Этот текст о том, как "подружить" приложения для переправки СМС и/или звонков с API демо-бота.

То, что должно получиться в настройках приложения

Для тех кто не понимает "о чём речь"

Есть два приложения для Android телефона smsTOapi и callsTOapi.

Они позволяют доставлять информацию из приходящих СМС или о приходящих звонках куда угодно по HTTPx RESTful API. В БД в телеграм, в Google-таблицу, в IFTTT… Куда угодно.

Для того, чтобы продемонстрировать их возможности, есть демо-бот.

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

Подробная статья о том, для чего все это можно использовать, здесь.

Что нужно, чтобы все получилось

  1. Желание и 5 минут свободного времени;
  2. Телефон на базе Android (для установки приложений из RuStore);
  3. Еще один смартфон с Telegram (опция, но желательная).

Подготовка

Приложения для Android в RuStore
  1. Устанавливаем на телефон для приложений эти приложения: smsTOapi и callsTOapi (первый телефон);
  2. Из Telegram (второй телефон) заходим в демо-бот и "стартуем использование". Команды:
/start

   затем
   
/newapi

Вы готовы.

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

Настройка

Меню настройка
  1. Запускаете любое из приложений (smsTOapi или callsTOapi), идете в настройки (меню в левом верхнем углу, пункт "Настройка"), не обращая внимания на жалобы приложения на версию. Приложение предложит вам "экран настройки" (на фото, выше);
  2. Нажимаете на кнопку API пересылки и заполняете поля формы (на фото, ниже), значениями, полученными демо-боте ;
  3. Нажимаете кнопку "Сохранить".
Страница добавления API endpoint

Что означает каждая строка для заполнения

RESTful API endpoint url:

URL адрес для отправки данных для их последующего отображения в боте.

Значение (более актуальное в демо-боте):

https://dle.ituse.ru

Название параметра данных:

Название заголовка или переменной в передаваемом JSON, которая содержит уникальный идентификатор (значение параметра данных). Используется в качестве ключа для доступа к API демо-бота.

Значение:

demo-access-key

Значение параметра данных:

Значение заголовка или переменной в передаваемом JSON.

Значение:

Значение, генерируется ботом

Все значения лучше взять из бот, выполнив команду:

/newapi

Как проверить

Если все настроено правильно, то после звонка или СМС на "смартфон для приложений", данные об СМС и/или звонке придут в демо-бота на "второй телефон". Данные о звонке или СМС будут отображены на зеленом фоне, на "главном экране" приложения.

Если в настройках ошибка, то сообщение или данные о звонке будут отображены на красном фоне. При нажатие на "красную запись" приложение "расскажет" об ошибке.

В правой части записи о неудачной отправки отображается кнопка повторной отправки вручную.
Повторно сконфигурируйте ваше приложение, нажмите на кнопку. Сообщение появится в демо-боте.

Приятного использования демонстрационной связки.

ММ

Ссылки списком

Android приложение smsTOapi - отправляет содержимое СМС смартфона на HTTP API

Android приложение callsTOapi - отправляет данные о звонках на HTTP API

@signinssobot - демо-бот помогает быстро протестировать возможности приложений

Статья - описывает главную идею применения приложения