Раньше интеграция API для отправки сообщений означала, что нужно отправить себе сорок SMS и заплатить за каждое. В каждом аккаунте SMSMeteor рядом с рабочими ключами есть тестовый ключ с префиксом sk_test_, и им можно пользоваться ещё до первого пополнения.
Что делает тестовый запрос
Всё, кроме последнего шага. Номер приводится к формату E.164, определяется направление, применяется правило отправителя, текст кодируется и разбивается на сегменты, стоимость рассчитывается по действующей таблице тарифов. Ответ — настоящий, со значением "status": "test". Оператору связи ничего не передаётся, с баланса ничего не списывается.
Поскольку проверка настоящая, тестовый ключ выявляет ошибки, важные при интеграции: номера без кода страны, необслуживаемые направления, тексты длиннее, чем вы думали, и отправителей, которых на некоторых маршрутах заменят. Поля segments и price показывают, сколько стоила бы реальная отправка.
Вебхуки тоже
Тестовые сообщения отправляют на ваши конечные точки вебхуки, подписанные точно так же, как рабочие. Обработчик можно собрать и проверить от начала до конца: проверка подписи, устранение дубликатов, обновление статусов в базе данных. Быстрый старт проводит через весь цикл за пять минут.
Чего он не покажет
Тестовый ключ не покажет, будет ли реальное сообщение доставлено, как быстро и под каким отправителем оно появится на телефоне: это может показать только оператор связи. Он также не проверяет вашу логику работы с балансом, поскольку ничего не списывается.
Переход в рабочий режим
- Создайте рабочий ключ с минимально необходимыми правами:
sendдля сервиса, который отправляет сообщения,readдля дашбордов. - По возможности ограничьте ключ IP-адресами ваших серверов: запросы с других адресов отклоняются.
- Пополните баланс на небольшую сумму.
- Отправьте одно реальное сообщение на свой телефон и проверьте три вещи: доставку, отображаемого отправителя и вебхук
message.deliveredв вашей базе данных. - Переключите конфигурацию рабочей среды на рабочий ключ.
Правила обращения с ключами
- Используйте отдельные ключи для каждой среды и каждого сервиса, чтобы отзыв одного ключа не останавливал всё.
- Храните ключи в переменных окружения или в менеджере секретов и никогда — во фронтенд-коде или в репозитории.
- Немедленно перевыпускайте ключ, если он попал в лог, обращение в поддержку или на скриншот.
- Передавайте Idempotency-Key при каждой отправке, тестовой или рабочей, чтобы повторные запросы никогда не приводили к двойной отправке.


