Віддати вхідні у свою систему
Екрани: Прийняті SMS, адреса /incoming/received, — там ви перевіряєте результат;
Налаштування → API, адреса /settings?tab=api, — та частина всього цього, у якої є поле
в кабінеті.
Решту з цієї сторінки налаштовує підтримка, на вашому ключовому слові. Сторінка потрібна для того, щоб ви знали, що взагалі буває і що просити на імʼя.
Простий випадок: автоматична відповідь
До ключового слова можна прикріпити один сталий текст, який іде кожному, хто на нього написав. Усім іде той самий текст, що б вони не написали, і жодної вашої системи для цього не потрібно — це відповідь на просте «повідомте, що ми отримали». Він заводиться разом із ключовим словом, а результат ви бачите у звіті, у рядку Відповідь.
Справжній випадок: у вашої системи питають, що відповісти
Замість сталого тексту SMS-Docs звертається на вашу адресу з вхідним повідомленням і надсилає абоненту те, що поверне ваш обробник.
Правила, під які його варто проєктувати:
- Відповідайте швидко. Абонент чекає з телефоном у руках.
- Відповідайте текстом повідомлення і нічим іншим. Простим текстом, саме таким, яким він має дійти до телефона, — не сторінкою і не JSON із текстом усередині.
- Тримайтеся довжини звичайної SMS. Відповідь такої довжини йде абоненту одразу, а колонка Відповідь у звіті показує, що саме пішло.
Точний таймаут і точну довжину для вашого ключового слова називає підтримка.
Адресу, яка приймає вхідні, і її формат налаштовує підтримка. Поле URL для сповіщень у розділі Налаштування → API — інший механізм: воно повідомляє про долю тих повідомлень, які надсилаєте ви, і його формат описаний у розділі API цієї документації.
Сповіщення людині
Коли про надходження достатньо повідомити людину, SMS-Docs надсилає сповіщення поштою або SMS на вказаний номер.
Воно надсилається з вашого рахунку і тарифікується як будь-яка ваша SMS: на завантаженому ключовому слові це одне сповіщення на кожне вхідне, і звіт вхідних показує ці списання у своїй колонці. Сповіщення на пошту несе ту саму новину.
Видача по SMPP
Якщо ви вже працюєте по SMPP, вхідні можна віддавати у вашу підключену сесію замість надсилання на адресу. Сам звʼязок вмикається в розділі Налаштування → API, і йому потрібна IP-адреса, з якої ви підключаєтеся. Маршрут вхідних у цю сесію налаштовує підтримка.
Два готових ключових слова
Два ключових слова належать самому SMS-Docs і в усіх працюють однаково:
- одне поповнює рахунок по SMS;
- інше запускає підготовлену розсилку по SMS.
Знати про них варто з однієї практичної причини: вони вже зайняті, тож обирайте собі ключове слово, відмінне від них. Якщо котресь із них вам потрібне, підтримка вмикає його для вашого акаунта.