Bytehand: агент для SMS-уведомлений клиентам

Bytehand — SMS-шлюз с REST API: рассылки клиентам, отложенная отправка, статусы доставки. Агент помогает поддержке: шлёт уведомления по заявкам, следит за статусами и сводит отчёты.

Агент — программа, которой ставят дело, а не вопрос. Он сам обращается к сервису, забирает данные, сверяет по правилам и возвращается с результатом: отправленными сообщениями, списком недоставленных, сводкой. Признаков три: работает в ваших сервисах, доводит дело до результата, работает без вас.

Чат-бот отвечает текстом, агент приходит с готовым журналом отправок.

Коннектор — подключение к Bytehand по выданному доступу: идентификатор пользователя и ключ передаются в запросе. Ключ берётся в личном кабинете, его можно пересоздать. Пароль от кабинета агент не хранит.

Связь проверяется запросом баланса. Дальше агенту видны сообщения, их статусы и подписи отправителя. Это не плагин и не доработка сервиса.

Bytehand — SMS-шлюз с REST API версии v1. Запросы идут по HTTPS на адрес api.bytehand.com/v1, данные — JSON в UTF-8 с типом application/json;charset=UTF-8. Авторизация — два параметра: id и key из 16 символов.

Методы: баланс, отправка одного сообщения и нескольких, детали и статус, подписи отправителя. Текст — до 800 символов, часть это 160 знаков латиницы или 70 кириллицы. Номер приводится к международному формату, есть отложенная отправка.

Статусы: NEW, PAUSED, ACCEPTED, DELIVERED, EXPIRED, DELETED, UNDELIVERABLE, REJECTED, UNKNOWN. Их можно получать извещениями: адрес обработчика задаётся в настройках, вызов идёт методом GET, ответ 200 нужен за десять секунд.

### Входящая корреспонденция: регистрация и резолюция

Агент берёт статусы сообщений и детали по каждому идентификатору, сверяет с журналом обращений: кому ушло, дошло ли. Новое обращение регистрирует, ставит резолюцию по правилам — кому и в какой срок — и отправляет клиенту подтверждение с номером. На выходе журнал со списком недошедших.

### Заявки из почты, форм и мессенджеров

Агент собирает заявки из каналов, приводит к одному виду и заводит в очередь поддержки. По каждой шлёт SMS: подтверждение приёма, сообщение о смене статуса, напоминание, если клиент молчит. Подпись берётся из зарегистрированных в кабинете, текст — из согласованных шаблонов. На выходе очередь с отметкой, какое уведомление ушло.

### Сводки по обращениям: день и месяц

Агент сводит обращения и отправленные сообщения: сколько заявок пришло, по каким каналам, сколько сообщений ушло и в каком статусе, какая стоимость. Он отмечает всплески и складывает сводку за день и за месяц. На выходе таблица и короткий текст для руководителя поддержки.

Утверждение текстов и подписи отправителя, решение по спорному обращению, ответ клиенту в конфликте. Новая подпись проходит модерацию — это шаг человека.

В личном кабинете Bytehand откройте Настройки → Безопасность → Управление ключами доступа, версия API v1, и заберите id и ключ. Ключ показывается один раз; если он утёк, рядом кнопка пересоздания.

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

Не рассылает без утверждённого текста и подписи. Не обходит модерацию подписи и ограничения операторов. Не хранит пароль от кабинета — работает только с ключом API.

Что такое агент? Программа, которая получает дело и возвращается с результатом: уведомлениями, журналом обращений, сводкой.

Что такое коннектор к Bytehand? Подключение по идентификатору и ключу API, через которое агент шлёт SMS, читает статусы и баланс.

Где взять ключ? В кабинете: Настройки → Безопасность → Управление ключами доступа, версия API v1.