Программа, которая падает, раздражает. Программа, которая показывает сообщение об ошибке, неприятна. Программа, которая молчит и ничего не находит, опасна — потому что никто не замечает, что что-то сломано.
При распознавании звонящего это выглядит так: телефон звонит, плитка спрашивает CRM, CRM отвечает пустым списком, плитка показывает «Неизвестно». Всё работает. Всё зелено. И всё равно ничего не верно.
Три пути, на которых подключение становится тихо неверным
Первое: искали не в том месте
Одна программа для юридических контор предлагает полнотекстовый поиск по контактам. В её справке сказано, что он особенно полезен, когда звонит клиент и есть только номер телефона. В описании же интерфейса сказано лишь, что поисковое слово «применяется к разным полям контакта».
Каким именно полям — не сказано нигде. Если бы телефонных номеров среди них не было, сообщения об ошибке не пришло бы. Пришёл бы пустой список — при каждом звонке, неделями, и никто бы не заподозрил поиск.
Поэтому мы там спрашиваем, а не пробуем. Попытка не смогла бы отличить «искали не там» от «этого нет».
Второе: поле поиска было проигнорировано
Самый неприятный случай — и именно он вызвал у нас появление защиты.
Одна скандинавская CRM принимает поисковые запросы через общий вызов, в котором играет роль имя поискового поля. Будь это имя неверным, мыслимы два ответа: сообщение об ошибке — или простое игнорирование неизвестного поля.
Во втором случае вернулся бы весь массив, со статусом 200. Плитка показала бы тогда первую попавшуюся запись как звонящего.
С тех пор есть сторож: после ответа проверяется, действительно ли номер найденного совпадает с искомым. Что не подходит, отпадает, и в журнале записано, что отпало. Ошибка заявляет о себе сама, вместо того чтобы молча приветствовать не того.
Третье: ошибка стоит в теле ответа
Одна немецкая программа для маклеров отвечает на неверный вход нормальной HTTP-ошибкой. Ошибку же при обработке — например, отсутствие права на адресный модуль — она сообщает в теле ответа, при статусе 200.
Без предосторожности недостающее право выглядело бы поэтому точно так же, как «номера тут нет»: пустой список, никакого сообщения.
Портал теперь проверяет этот код намеренно. При настройке различие между «нет прав» и «ничего не найдено» — половина поиска причины, а без него подозрение падает на CRM клиента, где ему не место.
Почему мы предпочитаем спросить, а не гадать
Поэтому в каждом запросе к производителю ПО стоит абзац, объясняющий, почему мы вообще пишем, а не просто начинаем:
Это не недоверие к производителю. Это понимание того, что подключение, которое молча ничего не находит, хуже, чем никакого — про «никакого» хотя бы все знают.
По чему это заметить в собственной компании
Кто использует распознавание звонящих и подозревает, что оно узнаёт слишком мало, пусть проверит в таком порядке:
- Просматриваются ли все телефонные поля или только первое?
- Сравнивается ли посимвольно или по цифрам?
- Приходит ли при намеренно неверном запросе ошибка или пустой список?
- Стоит ли что-нибудь в журнале, когда ничего не найдено, — или вообще ничего?
Последний вопрос — самый важный. Система, которая не записывает собственную неудачу, проверке не поддаётся.
Частые вопросы
Почему вы просто не попробуете интерфейс?
Потому что неудачная попытка здесь не бросается в глаза как ошибка. Поиск, который не просматривает телефонные номера, отвечает не ошибкой — он отвечает пустым списком. Это выглядит как «звонящего тут нет».
Что такое сторож?
Проверка после ответа: попадание показывается лишь тогда, когда его номер действительно совпадает с искомым. Если чужая система обходит наше поле поиска и выдаёт весь массив, отпадает всё, что не подходит, — и в журнале записано, что это произошло.
Разве HTTP 200 не означает, что всё хорошо?
Нет. Некоторые интерфейсы всегда отвечают 200 и помещают результат в тело ответа. Недостающее право выглядит тогда точно так же, как «ничего не найдено», — пока не заглянешь в тело намеренно.
Что это значит для настройки?
Что различие между «нет прав» и «ничего не найдено» — половина поиска причины. Без него кто-то ищет полдня, а подозрение падает на CRM клиента.