Отдать входящие в свою систему
Экраны: Принятые 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.
Знать о них стоит по одной практической причине: они уже заняты, поэтому выбирайте себе ключевое слово, отличное от них. Если какое-то из них вам нужно, поддержка включает его для вашего аккаунта.