Как выбрать между ws, ws_avatar и ws_business

WA Lookup предлагает три проверки WhatsApp за одним вызовом. Выбор между ними — это вопрос о том, какие поля ваш процесс действительно будет читать, а не об уровнях возможностей.

Все три проверки WhatsApp в WA Lookup используют POST /api/v1/check и различаются только значением service_type: ws возвращает поле регистрации, ws_avatar добавляет avatar и avatar_url, а ws_business добавляет логическое значение business.

ws — когда исход определяет одно поле

Если следующий шаг вашего процесса ветвится только по тому, есть ли аккаунт WhatsApp, ws возвращает именно это — и ничего, что вы не будете читать. Выбор более насыщенного service_type в такой ситуации удорожает каждый вызов, не меняя ни одного решения, которое принимает ваш код.

ws_avatar — когда важна видимость профиля

Выбирайте ws_avatar, когда что-то на последующих этапах читает поля аватара: упорядочивание очереди лидов, обогащение записи в CRM или дополнительный контекст для проверяющего сотрудника. Ключевой вопрос — будет ли какой-либо код или человек смотреть на значение аватара. Если нет, лучше выбрать ws.

ws_business — когда тип аккаунта определяет маршрутизацию

ws_business добавляет логическое значение business, что подходит процессам, в которых бизнес-аккаунты обрабатываются иначе, чем остальные. Как и в случае с ws_avatar, критерий один: доходит ли это поле до принятия решения. Поле, которое возвращается и игнорируется, — это чистые расходы.

Выбор для каждого вызова, а не для всей интеграции

Поскольку service_type — это значение в теле того же вызова, одна интеграция может выбирать разные проверки для разных списков или разных этапов. Команды часто сначала прогоняют ws по большому списку, а затем применяют более насыщенный service_type к значимому подмножеству — так расходы остаются соразмерными ценности каждого этапа.

Часто задаваемые вопросы

Используют ли три проверки разные URL?

Нет. Все три используют POST /api/v1/check и выбираются значением service_type в теле запроса.

Можно ли в одной интеграции сочетать разные типы сервиса?

Да. service_type — это значение в теле каждого запроса, поэтому разные списки или этапы могут выбирать разные проверки через одну и ту же интеграцию.

Включает ли ws_avatar то, что возвращает ws?

Да. Он возвращает поле регистрации и дополнительно добавляет поля аватара.