Відповіді надходять на мобільний номер, який ваш контакт уже знає.
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, щоб ваш додаток міг уникнути подвійної обробки.
Часті запитання про Received SMS API
Питання, які найчастіше ставлять розробники та операційні команди.
Чи отримує API SMS замість мого мобільного?
Ні. Сумісний підключений мобільний пристрій та SIM спочатку отримують SMS. Після цього SMSMobileAPI синхронізує підтримувані дані повідомлення, щоб ваше програмне забезпечення могло їх отримати.
Чи можуть кілька мобільних пристроїв підключатися до одного додатка?
Так. До одного акаунта можна підключити кілька авторизованих мобільних пристроїв, а ідентифікатор приймаючого пристрою дозволяє вашому додатку зберігати інформацію про джерело кожного повідомлення.
Чи слід використовувати опитування чи Webhook V2?
Використовуйте GET /getsms/, коли ваш додаток контролює графік отримання або потребує відновлення. Використовуйте подію sms.received Webhook V2, якщо ви хочете, щоб HTTPS-призначення реагувало щойно подія стала доступною. Багато виробничих систем поєднують обидва підходи.
Як уникнути обробки одного й того ж повідомлення двічі?
Зберігайте GUID повідомлення у вашому додатку та забезпечте ідемпотентність обробки. Після успішної обробки ви також можете оновити стан прочитання SMSMobileAPI API.
Чи змінює позначення повідомлення як прочитаного стан папки «Вхідні» на телефоні?
Ні. Ендпоінт змінює стан прочитання на боці API, який використовують робочі процеси SMSMobileAPI; він не позначає повідомлення як прочитане в додатку для повідомлень на телефоні.
Чи можу я відповісти з додатка?
Так. Ваш додаток може викликати ендпоінт відправки SMS, щоб вибраний підключений мобільний пристрій відправив відповідь через свою SIM-карту та номер телефону.
Надайте вашому програмному забезпеченню можливість обробляти кожну корисну відповідь, отриману на ваш мобільний.
Підключіть один телефон, авторизуйте синхронізацію received-SMS і протестуйте повний сценарій, перш ніж розширювати інтеграцію до вашої CRM, платформи підтримки або автоматизації.
