# SMS API (SyBox)

Где: Настройки > Переписка > SMS API

Для чего это нужно: подключение SMS-провайдеров в качестве резервного канала. Если привязать шлюз к стране, он станет приоритетным для контактов из этой страны.

У кого есть доступ: у пользователей с правом «Управление SMS-шлюзами».

### Как добавить SMS-шлюз

1. Нажмите «Добавить SMS API».
   ![Settings, SMS APIs: a connected SMS gateway and the "Add SMS API" button](https://www.sybox.io/res/sybox/help/ru/add-an-sms-gateway-1.webp?v=bc913a16)
2. Провайдер: выберите MessageBird, SMS Misr, Texto или Twilio. В форме останутся только нужные для этого провайдера поля.
   ![The new SMS gateway window: the provider first, then the country, keys and sender](https://www.sybox.io/res/sybox/help/ru/add-an-sms-gateway-2.webp?v=1f3d2be7)
3. Отображаемое имя: любое понятное вам название.
4. Страна: двухбуквенный код, например EG. Оставьте поле пустым, чтобы шлюз применялся для всех стран.
5. Заполните данные провайдера:
   - MessageBird: Sender ID (имя отправителя или номер, который увидит получатель) и API Key.
   - SMS Misr: Sender ID, Username, Password и Sender Token. Sender Token выдается сервисом SMS Misr для вашего Sender ID.
   - Texto: только API Key.
   - Twilio: Sender ID (номер отправителя или Messaging Service), Account SID и Auth Token.
6. Активный: оставьте параметр включенным, чтобы использовать шлюз.
7. Нажмите Сохранить. Если обязательное поле пропущено, появится ошибка «Неполные данные».

### Как отправить тестовое SMS

1. Нажмите «Отправить тестовое SMS» (значок отправки) на карточке шлюза.
   ![To send a test SMS: "Send test SMS" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/ru/send-a-test-sms-1.webp?v=28400695)
2. Введите номер телефона в международном формате (например, +2126…) и при необходимости отредактируйте текст сообщения.
3. Нажмите Сохранить. Появится уведомление «Тестовое SMS отправлено.» Если провайдер отклонит запрос, отобразится текст ошибки.

Другие действия

- Редактирование: измените любые поля. Оставьте поле пароля или ключа пустым, чтобы сохранить текущее значение.
- Включение / Отключение: переключайте шлюз в активное или неактивное состояние.
- Удаление: появится запрос «Удалить этот SMS-шлюз навсегда?».
- Если на карточке написано «Отсутствует токен», значит ключ не сохранен. Отредактируйте карточку и добавьте ключ.

Source: https://www.sybox.io/ru/help/sms-apis