Comment on page
Особенности использования номеров в роботах и активити бизнес-процессов
Практически в каждом роботе или активити вам предстоит использовать номер телефона. Давайте разберёмся, как это делать правильно.
В карточке CRM (лид, контакт, компания) есть возможность использовать как один, так и несколько номеров телефонов, причём с разными типами (мобильный, рабочий, для рассылок, другой, и т.д.).
Если номер один, то вопросов обычно не возникает. Проблемы появляются, когда номеров несколько. В этом случае важно учитывать на какой и на сколько номеров вы отправляете сообщение.
Когда вы передаёте номер (номера) телефонов в робот или активити, то они могут передаваться как массив номеров – {{Телефон}} / {=Document:PHONE} (также {{Контакт: Телефон}} и {{Компания: Телефон}}) или как текстовая строка – {{Телефон (текст)}} / {=Document:PHONE_PRINTABLE} (также {{Контакт: Телефон (текст)}} и {{Компания: Телефон (текст)}}).
Обратите внимание, что переменная {{Телефон}} / {=Document:PHONE} / {{Контакт: Телефон}} / {{Компания: Телефон}} или {{Телефон (текст)}} / {=Document:PHONE_PRINTABLE} / {{Контакт: Телефон (текст)}} / {{Компания: Телефон (текст)}} собирает и передаёт номера ВСЕХ типов.
Если в робот передан подобный массив номеров или текстовая строка с номерами и их там несколько – отправка будет осуществлена на первый номер в списке, на котором есть WhatsApp!
Для того, чтобы исключить ошибки, можно воспользоваться одним из способов, описанных ниже:
Например, «Для рассылок». Возможные варианты, которые могут принимать переменные:
- {{Телефон для рассылок}} / Document:PHONE_MAILING}
- {{Контакт: Телефон для рассылок}}
- {{Компания: Телефон для рассылок}}
- {{Телефон для рассылок (текст)}}
- {{Контакт: Телефон для рассылок (текст)}}
- {{Компания: Телефон для рассылок (текст)}}
При настройке робота или активити используйте один из вариантов переменной, подставляя её в поле Номер телефона (кому отправляем)
При использовании функции firstvalue из массива номеров {{Телефон}} / {=Document:PHONE} / {{Контакт: Телефон}} / {{Компания: Телефон}} будет выбран и подставлен в робот или активити первый по счёту номер.
При настройке робота используйте один из возможных вариантов конструкций, подставляя её в поле Номер телефона (кому отправляем):
- {{=firstvalue({{Телефон}})}}
- {{=firstvalue({{Контакт: Телефон}})}}
- {{=firstvalue({{Компания: Телефон}})}}
Для вызова окна функций в активити бизнес-процесса введите в поле для ввода номера телефона знак «равно» и в открывшемся окне выберите функцию firstvalue.
В круглых скобках функции ук ажите массив номеров, из которых нужно выбрать первое значение. Например, {{Контакт: Телефон}}.
Обратите внимание, что при использовании функции firstvalue переменную {{Телефон}} / {{Контакт: Телефон}} / {{Компания: Телефон}} нужно передавать без модификатора «(текст)», т.к. важно передавать именно массив номеров.
Используйте активити Итератор, чтобы перебрать номера в массиве и задать свою логику для каждого из номеров массива
Данный способ работает только в том случае, если на вашем тарифе Битрикс24 доступен дизайнер Бизнес-процессов!
Создайте переменную бизнес-процесса
Добавьте активити «Изменение переменных» и «Итератор»
Установите переменную для этих активити
Внутри итератора будут перебираться номера телефонов и вы сможете выполнять проверки и производить действия с каждым номером.
Помните, что во всех вышеописанных способах вам необходимо учитывать ещё одно обстоятельство, а именно – наличие WhatsApp на номере, на который делается отправка.
В настоящее время проверка номера на наличие WhatsApp осуществляется сразу при отправке сообщения. Если отправка осуществляется на номер, на котором не установлен WhatsApp, в дополнительных результатах выполнения активити вы получите ошибку «NW» а в описании ошибки — более развёрнутое её описание: «Ошибка при отправке: телефонный номер 7961*****57 не найден в WhatsApp»
Если вы хотите явно получить результат проверки номера на наличие WhatsApp и использовать его в ваших сценариях работы, проверку номера из массива номеров на наличие WhatsApp можно также осуществлять с помощью итератора. Подробнее в статье Проверка WhatsApp на номере