Ответы приходят на мобильный номер, который ваш контакт уже знает.
SMSMobileAPI / API
Получено SMS API · Ваш мобильный остаётся входящим
Преобразуйте каждое полученное на вашем мобильном SMS в данные, пригодные для приложения.
Ваш контакт отправляет обычный SMS на ваш существующий номер. Сообщение сначала поступает на подключённый телефон, после чего SMSMobileAPI безопасно синхронизирует поддерживаемые данные, чтобы ваше приложение могло получить, классифицировать и обработать ответ.
Никакой виртуальный приёмный номер не заменяет ваш телефон: ваш мобильный, SIM-карта и существующий номер остаются в центре обмена.
AКонтакт отправляет SMS
«Можешь перезвонить?»
+1 555 012 9841
Можешь перезвонить?
/getsms/200sms.received
number+15550129841
deviceМобильный отдела продаж
statusГотово
Ваше ПО использует его
Получите отправителя, текст сообщения, приёмный мобильный, метку времени, GUID и опциональную alias.
Централизуйте ответы, сохраняя информацию о том, какой подключённый телефон получил каждое SMS.
Простое объяснение
API не заменяет ваш телефон. Он делает полученные им SMS пригодными для использования.
SMSMobileAPI добавляет безопасный программный слой вокруг реального мобильного почтового ящика. Это даёт вашему CRM, платформе поддержки или внутреннему приложению доступ к допустимым данным о полученных сообщениях без изменения номера, используемого вашими контактами.
Контакт отправляет SMS
Контакт пишет на реальный номер, привязанный к вашей SIM-карте.
Ваш мобильный получает сообщение
SMS поступает через вашего мобильного оператора на подключённый телефон.
Приложение синхронизирует его
При наличии необходимых разрешений и доступа в фоновом режиме официальное приложение безопасно отправляет поддерживаемые данные о сообщениях в ваш аккаунт.
Ваше ПО использует его
Получите его через REST API, получите событие Webhook V2 или отобразите его в совместимой интеграции.
Ответ, который может использовать ваше приложение
Один запрос возвращает сообщение и контекст, необходимый для его обработки.
Используйте GET /getsms/ для перечисления синхронизированных входящих SMS. Фильтруйте по приёмному мобильному, запрашивайте только непрочитанные сообщения или получайте сообщения после Unix-метки времени.
- number
- Отправитель в международном формате, если доступно.
- message
- Текст SMS, синхронизированный с подключённого мобильного.
- sIdentifiantPhone
- Подключённый мобильный, который получил SMS.
- timestamp_unix
- Время сообщения, готовое для сортировки и инкрементальной синхронизации.
- guid
- Устойчивый идентификатор сообщения для операций со статусом прочтения и последующих действий.
- alias
- Необязательная метка контакта или приложения.
{
"result": {
"error": "",
"sms": [{
"sIdentifiantPhone": "508b004b4aadacc4",
"timestamp_unix": 1774041814,
"message": "Can you call me back?",
"number": "+15550129841",
"guid": "6BFD7DC7-3492-422D-8D02-4AF4E614F122",
"alias": "Alex Morgan"
}]
}
}Выберите подходящий способ доставки
Получайте сообщения по API — или реагируйте мгновенно с помощью Webhook V2.
Оба метода используют одни и те же данные подключённого мобильного устройства. Выбирайте в зависимости от логики вашего приложения или сочетайте их для быстрой реакции и надёжного восстановления.
Ваше приложение запрашивает сообщения, когда оно готово.
- Создайте входящий ящик или синхронизацию по расписанию
- Фильтровать по мобильному номеру, времени или статусу «непрочитано»
- Восстанавливать сообщения после прерывания
SMSMobileAPI отправляет событие sms.received в назначение HTTPS.
- Реагируйте без цикла опроса
- Используйте гарантированную доставку и автоматические повторы
- Запускайте рабочий процесс, как только событие доступно
Больше, чем просто список сообщений
Постройте полный рабочий процесс для входящих SMS.
/getsms/Список полученных SMS
Используйте фильтры по мобильному номеру, временной метке и статусу непрочитанных, чтобы извлекать только то, что нужно вашему приложению.
/getsms/set-read/Отметить как обработанное
Обновляйте состояние прочтения SMSMobileAPI API после обработки сообщения вашим приложением.
/getsms/update/Прикрепите alias
Свяжите имя контакта или метку приложения с полученным сообщением.
/conversation/sms/list/Создавайте беседы
Группируйте входящие и исходящие сообщения по номеру телефона для ленты поддержки или CRM.
Отметка сообщения как прочитанного через API не меняет его состояние прочтения в приложении сообщений на телефоне.
Что вы можете создать?
От одного ответа до полного бизнес‑процесса.
Создайте общий входящий ящик SMS
Направляйте ответы с нескольких авторизованных телефонов в единый интерфейс поддержки, сохраняя информацию о принимающем мобильном.
Дополните ленту контакта
Добавляйте входящие ответы в карточку клиента рядом с исходящими SMS и данными о звонках.
Автоматически распознавайте подтверждения
Определяйте подтверждения, отмены или запросы на перенос и обновляйте последующий шаг.
Эскалируйте важные сообщения
Уведомьте нужного человека, вызовите API или запустите автоматизацию Workflow Studio, когда условия совпадут.
От нуля до первого ответа API
Получите своё первое SMS через API в четырёх упорядоченных шагах.
- 1
Установите и сопрягите мобильное устройство
Установите последнюю официальную версию приложения SMSMobileAPI и подключите совместимый телефон к вашей учётной записи.
- 2
Включите доступ к полученным SMS
В мобильном приложении разрешите синхронизацию полученных SMS и фоновую работу, необходимую для вашего рабочего процесса.
- 3
Отправьте уникальное тестовое сообщение
Отправьте SMS с другого номера на подключённый мобильный и проверьте его в журнале дашборда полученных SMS.
- 4
Безопасно вызовите конечную точку
Храните ключ API на вашем сервере, вызывайте /getsms/ и сохраняйте GUID, чтобы ваше приложение могло избежать повторной обработки.
FAQ: получение SMS через API
Вопросы, которые разработчики и операционные команды задают в первую очередь.
Принимает ли API SMS вместо моего мобильного?
Нет. Сначала SMS получает совместимый подключённый мобильный телефон и его SIM-карта. Затем SMSMobileAPI синхронизирует поддерживаемые данные сообщения, чтобы ваше ПО могло получить их.
Могут ли несколько мобильных устройств передавать данные в одно и то же приложение?
Да. К одной учётной записи можно подключить несколько авторизованных мобильных устройств, а идентификатор принимающего устройства позволяет вашему приложению сохранять источник каждого сообщения.
Использовать ли опрос или Webhook V2?
Используйте GET /getsms/, когда ваше приложение контролирует расписание получения или требуется восстановление. Используйте событие Webhook V2 sms.received, когда нужно, чтобы назначение HTTPS отреагировало сразу после появления события. Многие продукционные системы комбинируют оба подхода.
Как избежать повторной обработки одного и того же сообщения?
Сохраняйте GUID сообщения в приложении и сделайте обработку идемпотентной. После успешной обработки вы также можете обновить состояние прочтения API у SMSMobileAPI.
Меняет ли отметка «прочитано» состояние входящих сообщений на самом телефоне?
Нет. Этот эндпоинт изменяет состояние прочтения на стороне API, используемое рабочими процессами SMSMobileAPI; он не помечает сообщение как прочитанное внутри приложения сообщений на телефоне.
Можно ли отвечать из моего приложения?
Да. Ваше приложение может вызвать эндпоинт отправки SMS, чтобы выбранное подключённое мобильное устройство отправило ответ через свою SIM-карту и номер.
Дайте вашему ПО возможность распознавать каждый полезный ответ, полученный на ваш мобильный номер.
Подключите один телефон, разрешите синхронизацию received-SMS и протестируйте полный цикл, прежде чем интегрировать это в CRM, платформу поддержки или систему автоматизации.
