seven.io SMS и связь

Адаптер ioBroker для seven.io

Этот адаптер подключает ioBroker к API для SMS и коммуникаций seven.io . Отправляйте SMS-сообщения и запускайте голосовые вызовы с преобразованием текста в речь непосредственно из ваших автоматизаций, скриптов Blockly или JavaScript — с управлением контактами, отслеживанием доставки, опросом входящих SMS и мониторингом баланса счета.

Функции

• Отправка SMS — запуск через точку данных, блок Blockly илиsendTo()
• Flash SMS — сообщение отображается непосредственно на экране получателя.
• Голосовые вызовы (TTS) — чтение любого текста вслух во время автоматического звонка.
• Статус доставки — автоматическая проверка примерно через 60 секунд после отправки, записывается в специальное состояние.
• Управление контактами — синхронизация контактов из seven.io как отдельных точек данных; создание новых контактов непосредственно из ioBroker.
• Получатель по имени — введите имя контакта вместо номера телефона; адаптер автоматически определит его.
• Опрос баланса счета — настраиваемый интервал, результат доступен в виде читаемого состояния.
• Опрос входящих SMS — прием входящих SMS (требуется арендованный виртуальный номер, см. ниже)
• Блок Blockly — готовый к использованию блок в категории «Отправить кому» с флажками для отправки SMS и/или голосовых вызовов.
• sendTo()API — полная поддержка скриптов для адаптера JavaScript.

Требования

• Аккаунт на seven.io
• Действительный ключ API (его можно найти в вашей панели управления seven.io в разделе «Разработчик» → «Ключи API» ).

Модель затрат:

• Отправка SMS-сообщений и голосовые звонки оплачиваются по факту использования — вы платите только за сообщение или звонок, без ежемесячной платы.
• Для получения входящих SMS-сообщений требуется виртуальный номер телефона, арендованный у seven.io (примерно 20 евро в месяц). Без арендованного номера опрос входящих сообщений недоступен.

Частные пользователи: seven.io — это в первую очередь бизнес-сервис. При регистрации необходимо указать название компании. Частные пользователи могут просто ввести свое имя или слово «Privat» в это поле — seven.io подтвердил, что это допустимо.

Конфигурация

Точки данных

info

account

contacts

sms

sms.inbound

voice

pricing

stats (30-дневный цикл)

Статистические данные всегда охватывают скользящее окно «сегодня – 30 дней → сегодня» . Они загружаются один раз при запуске адаптера и по ручному запуску — автоматического таймера обновления нет.

Входящие SMS

Для получения ответов на SMS-сообщения необходим цифровой отправитель — буквенно-цифровые имена (например,MyCompany ) не может напрямую получать ответы. У вас есть два варианта:

Вариант 1 — Общий бассейн (бесплатно, для тестирования и неинтенсивного использования)

ПроходитьgetReplies: true за сообщение (флажок Blockly илиsendTo() параметр). seven.io автоматически назначает временный номер общего пула в качестве отправителя, поэтому ответы работают даже с буквенно-цифровым идентификатором отправителя.

Вариант 2 — Собственный входящий номер (~20 евро в месяц)

Арендуйте виртуальный номер для входящих звонков прямо в панели управления seven.io. Ответы будут поступать надежно и постоянно.

Настройте интервал опроса в параметрах адаптера. Установите значение0 чтобы отключить входящий опрос (например, если вы используете вебхуки).

Несколько сообщений за цикл: если между двумя опросами поступает несколько SMS-сообщений, адаптер обрабатывает их все — начиная с самых старых. Каждое сообщение вызывает отдельное изменение состояния.sms.inbound.text Таким образом, каждое правило Blockly или автоматизация JavaScript, отслеживающая это состояние, срабатывает один раз для каждого сообщения. Точки данных всегда отражают самое последнее сообщение после цикла.

Блокли

После установки адаптера в категории sendTo редактора Blockly в ioBroker появляется готовый к использованию блок.

┌─ seven.io  |  SMS ☑  Voice call ☐ ─────────────┐
│  sender (optional)  [ ""                  ]      │
│  recipient          [ "+491234567890"     ]      │
│  message            [ "Alarm!"            ]      │
│  flash SMS ☐  replies (shared pool) ☐           │
│  ring time (s)  30                               │
│  instance  sevenio.0 ▼                           │
└──────────────────────────────────────────────────┘

• Проверьте SMS , чтобы отправить текстовое сообщение.
• Проверьте голосовой вызов , чтобы запустить автоматический вызов с преобразованием текста в речь.
• Выберите оба варианта , чтобы одновременно отправить SMS и совершить звонок (параллельно, без дополнительной задержки).
• Ответы (общий пул) — если этот параметр включен, seven.io использует номер из общего пула в качестве отправителя, чтобы получатель мог ответить (см. Входящие SMS ).
• В поле ввода получателя принимается номер телефона или имя контакта из вашего списка контактов seven.io.

скрипт sendTo()

Все функции доступны черезsendTo() в JavaScript-адаптере.

Отправить SMS:

sendTo('sevenio.0', 'send', {
    to: '+491234567890',   // or a contact name: 'Max Mustermann'
    text: 'Door opened!',
    flash: false,          // optional
    getReplies: true,      // optional — enable shared pool so recipient can reply
}, result => {
    console.log(result.statusText); // e.g. 'Success'
});

Инициировать голосовой вызов:

sendTo('sevenio.0', 'voice', {
    to: '+491234567890',
    text: 'Attention! Motion detected in the garage.',
    ringtime: 30,          // optional, 5–60 s
});

Узнать баланс счета:

sendTo('sevenio.0', 'get_balance', {}, result => {
    console.log(result.amount, result.currency);
});

Получить список контактов:

sendTo('sevenio.0', 'get_contacts', {}, contacts => {
    console.log(JSON.stringify(contacts));
});

Создать контакт:

sendTo('sevenio.0', 'create_contact', {
    name: 'Max Mustermann',
    number: '491234567890',   // without +
});

Тестовое SMS (отправьте тестовое сообщение для подтверждения ключа API):

sendTo('sevenio.0', 'test_sms', { to: '+491234567890' }, result => {
    console.log(result.statusText);
});

Тестовый голосовой вызов:

sendTo('sevenio.0', 'test_voice', { to: '+491234567890' }, result => {
    console.log(result);
});

Немедленно обновите статистику:

sendTo('sevenio.0', 'get_stats', {}, result => {
    console.log(result); // raw analytics data
});

В качестве альтернативы, установитеsevenio.0.stats.refresh данные указывают наtrue — Адаптер получает новые статистические данные и сбрасывает состояние.false автоматически.

Отложенное SMS (запланированная доставка):

sendTo('sevenio.0', 'send', {
    to: '+491234567890',
    text: 'Good morning!',
    delay: '2026-12-24 08:00:00', // ISO datetime or Unix timestamp (seconds)
}, result => {
    console.log(result.statusText);
});

Онdelay Параметр передается напрямую в API seven.io. Используйте строку даты и времени в формате ISO (YYYY-MM-DD HH:MM:SS ) или метку времени Unix в секундах. Сообщение ставится в очередь seven.io и доставляется в указанное время.

коды состояния SMS

Онsms.lastStatus В состоянии содержится удобочитаемый перевод кода состояния seven.io:

Changelog

0.1.2 (2026-07-22)

• (ipod86) Maintenance: fix io-package.json structure, improve CI and dependabot configuration

0.1.1 (2026-07-22)

• (ipod86) Fix: multiple inbound SMS per poll cycle now each trigger automations (processed oldest-first)

0.1.0 (2026-07-22)

• (ipod86) SMS sending via state, Blockly, and sendTo()
• (ipod86) Voice calls (TTS) via state, Blockly, and sendTo()
• (ipod86) Contact management — sync, create, send by name
• (ipod86) Inbound SMS polling with shared pool and own number support
• (ipod86) Delivery status check ~60 s after sending
• (ipod86) Account balance polling
• (ipod86) SMS pricing data with per-country price state
• (ipod86) Usage statistics (rolling 30-day window)

License

MIT License

Copyright (c) 2026 ipod86 david@graef.email

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.