Особенности использования номеров в роботах и активити бизнес-процессов

Практически в каждом роботе или активити вам предстоит использовать номер телефона. Давайте разберёмся, как это делать правильно.

В карточке CRM (лид, контакт, компания) есть возможность использовать как один, так и несколько номеров телефонов, причём с разными типами (мобильный, рабочий, для рассылок, другой, и т.д.).

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

Когда вы передаёте номер (номера) телефонов в робот или активити, то они могут передаваться как массив номеров – {{Телефон}} / {=Document:PHONE} (также {{Контакт: Телефон}} и {{Компания: Телефон}}) или как текстовая строка – {{Телефон (текст)}} / {=Document:PHONE_PRINTABLE} (также {{Контакт: Телефон (текст)}} и {{Компания: Телефон (текст)}}).

Обратите внимание, что переменная {{Телефон}} / {=Document:PHONE} / {{Контакт: Телефон}} / {{Компания: Телефон}} или {{Телефон (текст)}} / {=Document:PHONE_PRINTABLE} / {{Контакт: Телефон (текст)}} / {{Компания: Телефон (текст)}} собирает и передаёт номера ВСЕХ типов.

Если в робот передан подобный массив номеров или текстовая строка с номерами и их там несколько – отправка будет осуществлена на первый номер в списке, на котором есть WhatsApp!

Для того, чтобы исключить ошибки, можно воспользоваться одним из способов, описанных ниже:

Используйте отдельный тип телефона для отправки сообщений в WhatsApp

Например, «Для рассылок». Возможные варианты, которые могут принимать переменные:

• {{Телефон для рассылок}} / Document:PHONE_MAILING}

• {{Контакт: Телефон для рассылок}}

• {{Компания: Телефон для рассылок}}

• {{Телефон для рассылок (текст)}}

• {{Контакт: Телефон для рассылок (текст)}}

• {{Компания: Телефон для рассылок (текст)}}

При настройке робота или активити используйте один из вариантов переменной, подставляя её в поле Номер телефона (кому отправляем)

Используйте функцию firstvalue для указания первого значения из массива номеров.

При использовании функции firstvalue из массива номеров {{Телефон}} / {=Document:PHONE} / {{Контакт: Телефон}} / {{Компания: Телефон}} будет выбран и подставлен в робот или активити первый по счёту номер.

При настройке робота используйте один из возможных вариантов конструкций, подставляя её в поле Номер телефона (кому отправляем):

• {{=firstvalue({{Телефон}})}}

• {{=firstvalue({{Контакт: Телефон}})}}

• {{=firstvalue({{Компания: Телефон}})}}

Для вызова окна функций в активити бизнес-процесса введите в поле для ввода номера телефона знак «равно» и в открывшемся окне выберите функцию firstvalue.

В круглых скобках функции укажите массив номеров, из которых нужно выбрать первое значение. Например, {{Контакт: Телефон}}.

Обратите внимание, что при использовании функции firstvalue переменную {{Телефон}} / {{Контакт: Телефон}} / {{Компания: Телефон}} нужно передавать без модификатора «(текст)», т.к. важно передавать именно массив номеров.

Используйте активити Итератор, чтобы перебрать номера в массиве и задать свою логику для каждого из номеров массива

Данный способ работает только в том случае, если на вашем тарифе Битрикс24 доступен дизайнер Бизнес-процессов!

Создайте переменную бизнес-процесса

Добавьте активити «Изменение переменных» и «Итератор»

Установите переменную для этих активити

Внутри итератора будут перебираться номера телефонов и вы сможете выполнять проверки и производить действия с каждым номером.

Помните, что во всех вышеописанных способах вам необходимо учитывать ещё одно обстоятельство, а именно – наличие WhatsApp на номере, на который делается отправка.

В настоящее время проверка номера на наличие WhatsApp осуществляется сразу при отправке сообщения. Если отправка осуществляется на номер, на котором не установлен WhatsApp, в дополнительных результатах выполнения активити вы получите ошибку «NW» а в описании ошибки — более развёрнутое её описание: «Ошибка при отправке: телефонный номер 7961*****57 не найден в WhatsApp»

Если вы хотите явно получить результат проверки номера на наличие WhatsApp и использовать его в ваших сценариях работы, проверку номера из массива номеров на наличие WhatsApp можно также осуществлять с помощью итератора. Подробнее в статье Проверка WhatsApp на номере