# Знакомство с Олчат WABA Олчат WABA – приложение для интеграции WhatsApp Business API (сервис для взаимодействия бизнеса с клиентами через бизнес-аккаунт WhatsApp) с Битрикс24. Официальным провайдером WhatsApp Business API в России является компания GupShup.
# Официальная интеграция WhatsApp Business API ### WhatsApp Business API Официальное WhatsApp Business API позволяет интегрировать WhatsApp с сайтом, CRM (системой управления взаимоотношениями с клиентами) или другими маркетинговыми инструментами. Доступ к официальному WhatsApp Business API выдаёт Meta\*. В настоящее время в мире существует ограниченный перечень крупных компаний-провайдеров, непосредственно имеющих доступ к API (к программному интерфейсу). В свою очередь, они предоставляют возможность подключения к WhatsApp Business API обычным компаниям, желающим использовать в своей работе с клиентами официальную интеграцию. Приложение **«Олчат WABA — официальный WhatsApp Business API»** позволяет выполнить интеграцию вашего WhatsApp с Битрикс24 через провайдера GupShup. ### Возможности и преимущества **Олчат WABA**: * **Делайте рассылки клиентам без ограничений.**\ Проводите согласованные рассылки, пишите первыми, отправляйте сообщения с кнопками, любые виды медиа, автоматические уведомления на новые номера. * **Подключайтесь через официального провайдера GupShup.**\ Быстрая регистрация аккаунта WhatsApp Business API. * **Отправляйте шаблоны сообщений с переменными из Битрикс24.**\ Создавайте шаблоны с параметрами. Задавайте значение параметра при отправке вручную и используйте переменные значения в роботах. * **Настраивайте сценарии автоматизации с помощью наших роботов и активити бизнес-процессов.**\ Автоматизируйте отправку обычных сообщений и интерактивных (с кнопками и списками), отправку файлов, контактов и геолокаций. ### Требования и особенности: 1. Ваша компания должна соответствовать торговой политике WhatsApp, то есть не продавать запрещенные (по политике WhatsApp) товары и услуги. Подробнее ознакомиться можно в статьях [Торговая политика WhatsApp](https://www.whatsapp.com/policies/commerce-policy/) и [Политика WhatsApp Business](https://www.whatsapp.com/policies/business-policy/) на сайте WhatsApp. 2. Необходимо получить верифицированный (подтверждённый) аккаунт WhatsApp. Для этого у вас должен быть заранее создан аккаунт в [Meta Business Manager](https://business.facebook.com/). Через него происходит последующая верификация компании. 3. Процесс подключения и верификации занимает до 14 рабочих дней, в Meta\* для проверки отправляются документы на ООО или ИП. До того, как компания прошла верификацию, интеграцией пользоваться можно, но с ограничениями (до 250 исходящих диалогов уникальным клиентам в течение 24 часов; подключение до 2-х номеров). 4. Рекомендуем подключать номер, который ранее не подключался в мобильном приложении WhatsApp или WhatsApp Business. Если вы всё же решили использовать текущий номер, необходимо предварительно удалить аккаунт в мобильном приложении WhatsApp или WhatsApp Business.\ Также рекомендуем создать резервную копию чатов, чтобы избежать потери переписок, так как после удаления аккаунта восстановить данные невозможно. 5. В официальном WhatsApp Business API отсутствуют приложения для смартфона, такие как WhatsApp или WhatsApp Business, нет web.whatsapp.com. 6. Нет возможности подключить групповые чаты и использовать звонки. 7. Начать переписку с клиентом **первым** можно только шаблонным сообщением, заранее согласованным с Meta\*. За отправку каждого сообщения по шаблону списывается стоимость по тарифам WhatsApp. Шаблонные сообщения открывают переписку категорий: Маркетинговые, Услуги, Аутентификация.\ **Переписка — это диалог с клиентом в течение 24 часов.** 8. Как только 24 часа истекли, вы можете продолжить диалог с клиентом снова отправив шаблонное сообщение, или подождать, пока клиент сам вам напишет. 9. Если клиент первым отправил вам сообщение, после вашего ответа на это сообщение открывается переписка категории «Обслуживание». С 1 ноября 2024 года все входящие переписки бесплатные. {% hint style="info" %} Подробнее о стоимости использования WhatsApp Business API в статье [Тарифы и стоимость](/tarify-prilozheniya) {% endhint %} *(\*) Meta — признана экстремистской организацией на территории РФ.* # Тарифы и стоимость ### Из чего складывается стоимость WABA? Стоимость WhatsApp Business API (программного интерфейса WhatsApp Business) складывается из следующих составляющих: 1. Оплата за приложение для интеграции с Битрикс24 (нам, в рублях). Подробнее в статье [Оплата приложения Олчат WABA](https://waba.docs.olchat.io/tarify-prilozheniya/oplata-prilozheniya-whatsabi) и в разделе [Тарифы Олчат WABA](#tarify-olchat-waba). 2. Оплата за каждое сообщение провайдеру GupShup. Стоимость за каждое сообщение \~ $0,001. 3. Оплата WhatsApp за 24-часовые переписки. Стоимость в зависимости от категории: * Маркетинговые — $0.0802. * Услуги — $0.04. * Аутентификация — $0,0429. * Обслуживание (ответ на входящий диалог) — бесплатно. {% hint style="info" %} Оплата за каждое сообщение и за 24-часовые переписки производится путём списания средств с баланса в личном кабинете GupShup. Пополнение баланса производится самостоятельно в $ с зарубежной карты через личный кабинет GupShup или в рублях, через официального представителя GupShup в РФ. Подробнее в статье [Пополнение баланса через представителя и в личном кабинете GupShup](https://waba.docs.olchat.io/tarify-prilozheniya/popolnenie-balansa-cherez-predstavitelya-i-v-lichnom-kabinete-gupshup) {% endhint %} ### **Тарифы Олчат WABA** Стоимость приложения для интеграции с Битрикс24 — **3 600 рублей** за 1 аккаунт (номер телефона) на 30 дней. Для пользователей из Казахстана стоимость составляет **25 000 тенге** за 1 аккаунт (номер телефона) на 30 дней. ### Тарифная политика WABA В WhatsApp Business API на данный момент действует следующая тарифная политика: Сообщения категории «Услуги» (Utility) бесплатны при отправке в течение 24-часового диалогового окна, открытого взаимодействием с клиентом. Вне этого окна они тарифицируются по стандартному тарифу. За каждое доставленное сообщение категорий «Маркетинг» и «Аутентификация» взимается плата. **Как это работает на практике:**\ К примеру, если вы отправляете пользователю одно сообщение с шаблоном категории «Маркетинг», а затем в рамках активного 24-часового окна — два сообщения категории «Услуги», то плата списывается только за маркетинговое сообщение. Если окно закрыто, сообщения категории «Услуги» являются платными. Оплата переписки построена за каждое доставленное шаблонное сообщение, а не за сессию в рамках 24-часового окна. {% hint style="success" %} [Подробнее о тарифах на шаблонные сообщения на сайте провайдера](https://developers.facebook.com/docs/whatsapp/pricing/updates-to-pricing/?translation\&locale) {% endhint %} ### MM Lite С 1 января 2026 года компания Meta\*\* переводит отправку маркетинговых шаблонов в WABA\* со старой технологии Cloud API на новый протокол — **MM Lite (**облегчённый режим рассылки маркетинговых сообщений через WhatsApp Business API). Полноценный запуск MM Lite ожидается ближе к концу года, а пока всем пользователям **нужно заранее принять новые условия**. До этого момента рассылки продолжают работать через Cloud API. #### Кому необходимо перейти? MM Lite становится новым стандартом **для всех** **маркетинговых рассылок** в WhatsApp\*: * Все пользователи должны поддерживать технологию **с 1 января 2026 года**. * Новые номера WABA\* будут подключаться только по MM Lite. Если вы уже пользуетесь WABA\*, достаточно принять новое соглашение в **Facebook Business Manager**\* (FBM). При этом WABA\* не будет отключена у тех, кто останется на Cloud API, однако стоимость отправки маркетинговых шаблонов временно увеличится на **7%**, пока вы не примете новые условия. {% hint style="warning" %} Подробнее о MM Lite и о том, как перейти на новую технологию, написано в [данной статье](/bystryi-start/mm-lite). {% endhint %} \*Meta — организация, деятельность и продукты которой (WhatsApp, WABA, Facebook, Facebook Business Manager) запрещены в России. # Оплата приложения Олчат WABA Оплата приложения Олчат WABA производится по счёту. Для получения счёта необходимо написать нам в чат поддержки, перейдя в него из главного окна приложения:
В сообщении пришлите следующие данные: 1. Реквизиты вашей компании. 2. Контактный телефон и адрес электронной почты. 3. Адрес портала Битрикс24. 4. Номер телефона, который подключен к WhatsApp Business API. 5. Срок, на который хотите продлить приложение. # Copy of Оплата приложения Олчат WABA Для оплаты Олчат WABA выполните следующие действия: {% stepper %} {% step %} Перейдите в приложение Олчат WABA и выберите пункт «Оплата».
{% endstep %} {% step %} В поле «Компания» нажмите «», затем «+ Добавить компанию».
{% hint style="warning" %} При повторной оплате воспользуйтесь поиском для автоматической подстановки данных компании. {% endhint %} {% hint style="info" %} В случае, если данные компании изменились, выберите «Редактировать», чтобы внести актуальные данные. В случае, если необходимо полностью удалить данные о компании, воспользуйтесь кнопкой «Удалить». {% endhint %} {% endstep %} {% step %} Укажите страну, в которой юридически зарегистрирована компания, далее укажите название компании и контактные данные ответственного за оплаты. Для автоматической подстановки данных введите название компании или ИНН в поле «Название компании».
{% hint style="info" %} Все поля являются обязательными к заполнению. {% endhint %} {% hint style="warning" %} Обязательно проверьте правильность выбранных данных для избежания ошибок в оплате. {% endhint %} {% endstep %} {% step %} В поле «Линии WABA» проставьте выбор в чекбоксе напротив тех открытых линий, оплату которых планируете продлить. При необходимости выбора всех открытых линий, проставьте только один чекбокс в начале списка. Список открытых линий можно отсортировать по названию, а также оставшемуся сроку оплаты. Для этого нажмите рядом с наименованием столбца. Для удобства срок оплаты окрашен в разные цвета. Активные линии с действующей подпиской отражены зеленым цветом, неактивные — серым, требующие оплаты — красным.
{% endstep %} {% step %} В поле «Период оплаты» выберите желаемый период оплаты. Доступна оплата на 30, 90, 180 и 360 дней.
{% endstep %} {% step %} Проверьте выбранный заказ в корзине и нажмите «Перейти к оплате».
{% endstep %} {% step %} Выберите способ оплаты: оплата картой или по счёту. В случае оплаты банковской картой онлайн, нажмите «Оплатить» и завершите оплату с помощью сервиса. В случае оплаты по счёту, выберите соответствующий пункт, а затем скачайте счёт и завершите оплату. {% hint style="warning" %} Для активации подписки в платежном поручении в назначении платежа должен быть обязательно указан номер счёта. {% endhint %}
Отправить счёт другому сотруднику можно, нажав кнопку «Поделиться». Доступно 2 способа: скопировать ссылку либо сохранить QR-код на оплату.
{% endstep %} {% step %} Оплата приложения Олчат WABA завершена. {% endstep %} {% endstepper %} # Пополнение баланса через представителя и в личном кабинете GupShup ## Пополнение баланса в рублях через официального представителя GupShup в РФ В зависимости от выбранного способа оплаты пошагово выполните предложенный порядок действий. ### Перевод официальному представителю GupShup на карту Сбербанка 1. Произведите пересчёт оплачиваемой суммы из $ в рубли по курсу ЦБ на текущую дату и добавьте к полученному значению 12%. Для удобства можно [воспользоваться конвертером валют](https://cash.rbc.ru/converter.html?from=USD\&to=RUR\&sum=10\&date=\&rate=cbrf). 2. [Напишите в телеграм](https://t.me/AlexGreenblat) официальному представителю GupShup. В сообщении пришлите ссылку на оплату, полученную методом, описанным в разделе инструкции [#poluchenie-ssylki-na-oplatu-v-lichnom-kabinete-gupshup](#poluchenie-ssylki-na-oplatu-v-lichnom-kabinete-gupshup "mention"). 3. В ответном сообщении вы получите реквизиты для перевода средств. 4. Произведите перевод по реквизитам, указанным официальным представителем GupShup. 5. Дождитесь зачисления средств на баланс GupShup. ### Оплата официальному представителю GupShup по счёту 1. Произведите пересчёт оплачиваемой суммы из $ в рубли по курсу ЦБ на текущую дату и добавьте к полученному значению 22%. Для удобства можно [воспользоваться конвертером валют](https://cash.rbc.ru/converter.html?from=USD\&to=RUR\&sum=10\&date=\&rate=cbrf). 2. [Напишите в телеграмм](https://t.me/AlexGreenblat) официальному представителю GupShup. В сообщении пришлите реквизиты вашей компании на английском и ссылку на оплату, полученную методом, описанным в разделе инструкции [#poluchenie-ssylki-na-oplatu-v-lichnom-kabinete-gupshup](#poluchenie-ssylki-na-oplatu-v-lichnom-kabinete-gupshup "mention") 3. В ответном сообщении вы получите договор и счёт для оплаты. 4. Произведите оплату счёта, присланного официальным представителем GupShup. 5. Дождитесь зачисления средств на баланс GupShup. ## Пополнение баланса с зарубежной карты Пополнение баланса в личном кабинете GupShup осуществляется с зарубежных карт платёжных систем Visa, MasterCard, American Express, UnionPay, JCB, Discover, Diners Club. {% hint style="warning" %} Баланс нельзя пополнить с карт платёжной системы «Мир» а также с карт «Visa» и «MasterCard», выпущенных в РФ. {% endhint %} Если вы владеете картой зарубежного банка, в личном кабинете GupShup перейдите в меню «Мой бумажник»:
На открывшейся странице отобразится текущий доступный баланс а также статистика использования средств. Чтобы пополнить баланс нажмите на кнопку «Добавить кредиты»:
Введите сумму от 10 до 10000 долларов на которую планируете пополнить баланс и нажмите на кнопку «Оплатить USD \_ »:
Далее укажите данные вашей карты и нажмите «Оплатить»:
## Получение ссылки на оплату в личном кабинете GupShup Если вы не владеете зарубежной картой, предлагаем воспользоваться альтернативным способом пополнения баланса GupShup – с помощью официального представителя GupShup в РФ. Он выступает в роли посредника между вами и сервисом GupShup. Вы производите оплату в рублях путём перевода посреднику на карту Сбербанка по номеру телефона, либо, если хотите оплатить как ИП или ООО – путём оплаты счёта. Для запуска процедуры пополнения баланса с помощью официального представителя GupShup, потребуется ссылка на страницу оплаты. Для этого в личном кабинете GupShup перейдите в меню «Мой бумажник»:
На открывшейся странице отобразится текущий доступный баланс. Нажмите на кнопку «Добавить кредиты»:
Введите сумму от 10 до 10000 долларов на которую планируете пополнить баланс и нажмите на кнопку «Оплатить USD \_ »:
Если реквизиты вашей компании в разделе «Информация для оплаты» не заполнены, сервис предложит это сделать во всплывающем окне. Обратите внимание, что все данные необходимо заполнять на английском. Иначе вы можете столкнуться с ошибкой при сохранении реквизитов. После заполнения нажмите на кнопку Сохранить.
На открывшейся странице оплаты скопируйте адрес данной страницы из строки адреса в браузере:
# Блокировка аккаунта Стоит помнить, что всегда существует риск блокировки. ## Рекомендации по снижению риска блокировки Чтобы минимизировать этот риск, следуйте рекомендациям ниже: 1. **Не нарушайте политику WhatsApp Business:** подробнее с ней можете ознакомиться [здесь](https://business.whatsapp.com/policy). 2. **Используйте теплую базу контактов:** рассылка по холодной базе или отправка сообщений, которые могут быть восприняты как СПАМ, значительно увеличивает риск блокировки. Убедитесь, что ваши контакты заинтересованы в получении информации от вас. 3. **Избегайте отправки спама:** не отправляйте сообщения, которые могут быть восприняты как нежелательные. Это поможет сохранить вашу репутацию и избежать блокировки. 4. **Начинайте рассылки с малого количества:** первую рассылку рекомендуется сделать небольшому количеству клиентов. Это позволит оценить их реакцию и внести необходимые корректировки. 5. **Добавьте кнопку «Отписаться»:** предоставьте клиентам возможность легко отписаться от рассылки. Это поможет избежать нажатия кнопки «СПАМ». 6. **Просьба добавить в контакты:** аключите в сообщение просьбу добавить ваш номер в контакты, чтобы клиенты не пропустили важную информацию. Это также уберет возможность пометить ваше сообщение как СПАМ. 7. **Проверка по чек-листу:** перед запуском рассылки обязательно пройдитесь по чек-листу, доступному по ссылке: [чек-лист перед запуском WABA](https://waba.docs.olchat.io/bystryi-start/chek-list-do-zapuska-waba). 8. **Достоверность данных:** убедитесь, что все данные, которые вы используете, достоверные и актуальные. ## Действия при получении блокировки Если вам пришло сообщение от GupShup, которое было помечено как СПАМ, важно **подать обращение на разблокировку** в поддержку Gupshup на почту **** и/или апелляцию в Facebook Business Manager\*. Составьте подробную апелляцию и опишите в ней случай блокировки бизнес-аккаунта вашей компании. Рекомендуемый язык апелляции — английский. Убедитесь, что апелляция содержит всю необходимую информацию. Оба действия могут быть выполнены одновременно для повышения шансов на успех. Затем как разблокировка осуществлена, приступите к выполнению следующих шагов: 1. **Измените шаблон сообщения**: если продолжать отправлять тот же шаблон на ту же базу, это может привести к блокировке. Попробуйте изменить содержание сообщения, чтобы оно стало более релевантным и полезным для получателей. 2. **Добавьте кнопку «Заблокировать» или «Пожаловаться»**: это позволит пользователям легко выразить свое недовольство, не помечая ваше сообщение как СПАМ. Обработка таких запросов поможет вам улучшить качество рассылки. 3. **Пересмотрите критерии базы**: убедитесь, что ваша база контактов актуальна и состоит из пользователей, которые заинтересованы в получении ваших сообщений. Возможно, стоит обновить или сегментировать базу. 4. **Добавьте кнопку «Отписаться»**: особенно важно для маркетинговых рассылок. Кнопка должна быть видимой и доступной без необходимости прокрутки экрана. Это поможет снизить количество жалоб на СПАМ. 5. **Обработка кнопки «Отписаться»**: убедитесь, что вы обрабатываете запросы на отписку своевременно и корректно, чтобы поддерживать положительную репутацию. ## Что делать, если не разблокировали номер? В этом случае необходимо запускать новый номер WABA или новый Facebook Business Manager\*. Если у вас остались неизрасходованные денежные средства, вы можете создать новый Facebook Business Manager (FBM) и добавить его в существующий аккаунт Gupshup. Это позволит вам использовать имеющиеся средства без необходимости их переноса. ## Действия при получении «мягкого бана» (аккаунт с ограничениями) Если ваш аккаунт получил «мягкий» бан из-за жалоб, следуйте этим рекомендациям для восстановления и предотвращения подобных ситуаций в будущем: 1. **Переименование и брендинг каналов**: * Избегайте общих названий, таких как «Поддержка Клиентов». Вместо этого используйте брендированные имена, например, «Спортмастер Поддержка Клиентов». * Верифицируйте каналы через Facebook Business Manager для повышения доверия и узнаваемости. 2. **Разделение аккаунтов**: создавайте отдельные аккаунты для каждого номера, чтобы минимизировать риски блокировки всех номеров одновременно. 3. **Обращение на разблокировку**: подайте обращение на разблокировку через Gupshup и/или апелляцию в Facebook Business Manager\*. Составьте подробную апелляцию и опишите в ней случай блокировки бизнес-аккаунта вашей компании. Рекомендуемый язык апелляции — английский. Убедитесь, что апелляция содержит всю необходимую информацию с доказательствами, что на сайте компании есть вся необходимая официальная информация. Оба действия могут быть выполнены одновременно для повышения шансов на успех. 4. **Проверка уведомлений**: проверьте бизнес-портфолио в Facebook на наличие оповещений о статусе вашего канала. 5. **Прохождение верификации**: пройдите процедуру верификации, чтобы снизить вероятность повторных блокировок. Подробности можно найти в статье: [Порядок действий для прохождения процедуры верификации](https://waba.docs.olchat.io/bystryi-start/poryadok-deistvii-dlya-prokhozhdeniya-procedury-verifikacii). 6. **Получение «Зеленой галочки»**: подайте запрос на получение «Зеленой галочки» для вашего канала. Это возможно при выполнении следующих условий: * Запущено WABA. * 50 активных пользователей в месяц. * 500 входящих сообщений в месяц. * Подробности и условия можно найти здесь: [получение зеленой галочки и названия компании вместо номера](https://waba.docs.olchat.io/bystryi-start/poluchenie-zelyonoi-galochki-i-nazvaniya-kompanii-vmesto-nomera). ## Как избежать блокировки при регистрации бизнес-аккаунта? Существует риск блокировки аккаунта при его регистрации. Перед подключением канала WhatsApp Business API убедитесь, что: * В разделе **Настройки** → **Информация о бизнес-портфолио** в Facebook Business Manager\* обязательно указаны все данные о компании: юридическое название, страна, адрес, город, почтовый индекс, номер телефона, сайт (домен второго уровня). * На сайте компании указаны такие же данные, как в разделе **Настройки** → **Информация о бизнес-портфолио** в Facebook Business Manager\*. * В качестве администраторов бизнес-портфолио добавлено два или более пользователя, которые активно пользуются страницами Facebook\*: размещают публикации, добавляют фотографии, ставят лайки. Для добавления администратора перейдите в раздел **Настройки** → **Центр безопасности** в Facebook Business Manager\* и нажмите **Добавить**. * Для всех администраторов бизнес-портфолио включена двухфакторная аутентификация в разделе **Настройки** → **Центр безопасности** → **Двухфакторная аутентификация** в Facebook Business Manager\*. Подробнее [в документации Meta](https://www.meta.com/en-gb/help/quest/articles/accounts/account-settings-and-management/two-factor-meta-account/)\*. * Администраторы бизнес-портфолио прошли верификацию. Подробнее [в документации Meta](https://www.facebook.com/help/contact/515009838910929)\*. * На сайте компании нет упоминания деятельности, запрещенной в WhatsApp. Подробнее [в документации Meta](https://business.whatsapp.com/policy#overview)\*. *(\*) Meta, Facebook — признана экстремистской организацией на территории РФ.* # Правила эффективного взаимодействия со службой поддержки Мы ценим каждого клиента и стремимся решать возникающие вопросы быстро и качественно. Команда Олчат — это живые люди, специалисты, которые осознают важность своей работой и готовы приложить все усилия, чтобы помочь вам. Чтобы общение было максимально продуктивным и комфортным для обеих сторон, просим придерживаться нескольких простых правил. ### Основные принципы конструктивного диалога Успех решения любого запроса зависит от совместных усилий. Вот ключевые принципы, которые помогут нам помочь вам: * **Взаимное уважение.** Мы уважаем вас и ваше время. В ответ ожидаем такого же отношения к нашим сотрудникам. Грубость, оскорбления и переход на личности мешают концентрации и работе. * **Конкретика и ясность.** Чем более подробно и чётко вы опишете возникшую проблему, тем быстрее мы сможем найти решение. * **Взаимопонимание.** Технические неполадки могут вызывать раздражение, но мы просим помнить, что сотрудник поддержки не виноват в сложившейся ситуации. Его задача — стать вашим союзником в её решении. ### Права и обязанности клиента Вы имеете право на: * **Квалифицированную помощь.** Получение полной и экспертной консультации по вопросам, связанным с сервисом Олчат. * **Вежливое обслуживание.** Общение в уважительном и корректном тоне. * **Конфиденциальность.** Защита ваших персональных данных. Для этого мы просим вас: * **Предоставлять точную информацию.** Указывайте данные аккаунта, присылайте описание ошибки, скриншоты или видео, которые помогут понять суть проблемы. * **Соблюдать деловой тон.** Обращайтесь к сотрудникам по имени (которое указано в подписи) и избегайте фамильярности. * **Сохранять терпение.** Сложные вопросы требуют времени на тщательный анализ. Мы не всегда можем дать мгновенный ответ, но обязательно ответим, как только проработаем все варианты. ### Что недопустимо? Поведение, которое приведёт к прекращению поддержки Команда Олчат имеет право ограничить или приостановить предоставление поддержки, если клиент: * **Использует ненормативную лексику, оскорбления, угрозы** в адрес сотрудника или компании. * **Проявляет вербальную агрессию,** переходит на личности, унижает достоинство специалиста. * **Провоцирует конфликт,** игнорирует вопросы специалиста, отказывается от диалога и предложенных решений. * **Ведет себя деструктивно:** спамит, многократно повторяет одно и то же сообщение, препятствуя работе специалистов, либо предъявляет претензии, не относящиеся к работе сервиса Олчат. ### Почему это важно? Последствия нарушения правил Мы верим, что любую проблему можно решить. Однако чтобы защитить наших сотрудников и сохранить здоровую атмосферу в работе, мы можем применять санкции к клиентам, которые систематически нарушают правила эффективного взаимодействия. **В случае деструктивного поведения или грубого нарушения правил общения сотрудник поддержки может:** 1. **Предупредить** клиента о недопустимости общения в деструктивных тонах. 2. **Приостановить диалог** до нормализации тона общения. 3. В крайних случаях — **полностью прекратить поддержку** по обращению и передать информацию руководству для принятия дальнейших решений. Обращаем ваше внимание, что целью перечисленных мер является возобновление конструктивного диалога. ### Вместо заключения Помните: по другую сторону экрана находится человек, который хочет вам помочь. Уважительное и конструктивное общение — это самый короткий путь к решению возникшей проблемы. Мы всегда на вашей стороне, когда дело касается любых трудностей, и просим вас быть на нашей стороне, когда дело касается человеческого общения. С уважением, команда Олчат ❣️ # Последовательность подключения 1. Перед подключением к WABA предварительно необходимо удалить аккаунт в мобильном приложении WhatsApp или WhatsApp Business, **если он был**. Также рекомендуем создать резервную копию чатов, чтобы избежать потери переписок, так как после удаления аккаунта восстановить данные невозможно. 2. Создайте бизнес-портфолио в Meta\* Business Suite и Business Manager. Подробнее в статье [Добавление компании в Business Manager](/bystryi-start/podtverzhdenie-kompanii-v-facebook-business-manager#process-sozdaniya-biznes-portfolio). 3. Зарегистрируйтесь и создайте личный кабинет на сайте gupshup.io. Подробнее в статье [Регистрация в GupShup](/bystryi-start/copy-of-registraciya-v-gupshup). 4. Добавьте приложение WhatsApp в кабинете GupShup. Подробнее в статье [Создание и настройка приложения WhatsApp в GupShup](/bystryi-start/sozdanie-i-nastroika-prilozheniya-whatsapp-v-gupshup#dobavlenie-prilozheniya-whatsapp-v-kabinete-gupshup). 5. Подключите приложение WhatsApp к аккаунту Meta\*. Подробнее в статье [Создание и настройка приложения WhatsApp в GupShup](/bystryi-start/sozdanie-i-nastroika-prilozheniya-whatsapp-v-gupshup#podklyuchenie-prilozheniya-k-akkauntu-meta). 6. Выполните привязку приложения к партнёру. Подробнее в статье [Создание и настройка приложения WhatsApp в GupShup](/bystryi-start/sozdanie-i-nastroika-prilozheniya-whatsapp-v-gupshup#dobavlenie-partnyora). 7. Получите ключ API приложения. Подробнее в статье [Создание и настройка приложения WhatsApp в GupShup](/bystryi-start/sozdanie-i-nastroika-prilozheniya-whatsapp-v-gupshup#poluchenie-klyucha-api-prilozheniya). 8. Установите приложение «Олчат WABA» на ваш портал Битрикс24. Подробнее в статье [Установка приложения](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/ustanovka-prilozheniya). 9. Подключите и настройте открытую линию в нашем приложении «Олчат WABA». Подробнее в статье [Подключение открытой линии и коннектора](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/podklyuchenie-konnektora#podklyuchenie-otkrytoi-linii). 10. Введите полученный ключ API приложения в нашем приложении «Олчат WABA». Подробнее в статье [Подключение открытой линии и коннектора](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/podklyuchenie-konnektora#podklyuchenie-konnektora). 11. Пополните баланс в личном кабинете GupShup. Средства с баланса будут расходоваться на шаблонные 24-часовые переписки и за каждое сообщение. Подробнее в статье [Пополнение баланса через представителя и в личном кабинете GupShup](/tarify-prilozheniya/popolnenie-balansa-cherez-predstavitelya-i-v-lichnom-kabinete-gupshup). 12. Оплатите приложение «Олчат WABA». Подробнее в статье [Оплата приложения Олчат WABA](/tarify-prilozheniya/oplata-prilozheniya-whatsabi). 13. Сейчас верификация компании по правилам Meta необязательна. Если качество вашей рассылки хорошее, то лимиты на количество рассылаемых сообщений увеличатся без прохождения верификации. Если у Meta возникают вопросы к качеству рассылки, то для увеличения объёма рассылаемых сообщений, Meta попросит вас пройти верификацию. Подробнее [в этой статье](https://waba.docs.olchat.io/bystryi-start/poryadok-deistvii-dlya-prokhozhdeniya-procedury-verifikacii). *(\*) Meta — признана экстремистской организацией на территории РФ.* # Чек-лист до запуска WABA ## Это необходимо проверить до запуска WABA: 1. Создан Facebook Business Manager/Meta Portfolio. Есть доступ администратора к Facebook. 2. Полностью корректно заполнены данные бизнеса и админа в FBM. 3. Сайт 2-го уровня и внешний имидж Бизнеса соответствует требованиям META\* и данным WABA. Сайт НЕ на домене Хостера (), НЕ домен 3-4 уровня\* 4. Сайт с прямо указанным юр лицом, его реквизитами в контактах/о компании/подвале сайта, точным юр. Адресом (как в выписке из ЕГРЮЛ). 5. FBM-администраторы — 2 или более пользователей Facebook с активными страницами (посты / репосты / лайки / переписки / френды / личное инфо / селфи и т.п.). Без аутсорса. 6. 2FA включен для всех (минимум 2х) админов в FBM и личных аккаунтах. 7. Доменная запись с данными владельца именно этого юр лица и контактными данными админа (email, телефон, форма обрсвязи). 8. Верификация Админов – пользователей Facebook. 9. Верификация домена (опционально). 10. Верификация бизнеса в Facebook/FBM (опционально). \*Meta (Facebook) – считается экстремистской организацией в РФ # Copy of Чек-лист до запуска WABA Команда Олчат подготовила список пунктов, которые необходимо проверить и выполнить до запуска Олчат WABA. {% hint style="info" %} Настоятельно рекомендуем ознакомиться со всей информацией, представленной на этой странице. Это необходимо, чтобы запуск и настройка WABA прошли легко и без ошибок, допущенных на подготовительном этапе к запуску. {% endhint %} {% stepper %} {% step %} **Создайте Facebook Business Manager / Meta Portfolio.** Для подключения WABA необходимо, чтобы был создан личный кабинет [Facebook Business Manager](https://business.facebook.com/) (далее — FBM) / Meta Portfolio, а также налажен доступ к Facebook (использование VPN (виртуальной частной сети) для пользователей из России). Инструкция по созданию FBM: 1. **Перейдите по** [**ссылке**](https://business.facebook.com/) **и нажмите «Создать бизнес-портфолио» в левом верхнем углу под эмблемой Meta**. 2. **Заполните основную информацию.** В открывшемся окне формы укажите обязательные реквизиты: * Название вашей компании или бизнеса. * Имя и фамилию лица, которое будет администратором аккаунта. * Адрес электронной почты этого администратора. 3. **Перейдите к следующему шагу.** После заполнения данных нажмите кнопку «Далее», чтобы продолжить. 4. **Введите контактные и бизнес-данные.** В новой форме потребуется указать: * Физический адрес вашей компании. * Контактный телефон. * Адрес вашего сайта. В качестве альтернативы сайту можно предоставить ссылку на страницу вашего бизнеса в Facebook. 5. **Определите цель использования.** Четко укажите, для чего вы создаете этот аккаунт: для управления вашим собственным бизнесом или для оказания рекламных услуг другим компаниям. 6. **Завершите регистрацию.** После проверки всех введенных данных нажмите кнопку «Отправить», чтобы завершить создание Business Manager. {% endstep %} {% step %} **Проверьте, что корректно и в полном объёме заполнены данные бизнеса и администраторов в FBM, выполнена верификация бизнеса.** Воспользуйтесь инструкцией ниже, чтобы пройти процедуру верификации бизнеса. **Перед началом подготовьте:** * **Официальные документы компании:** для юрлиц — свидетельство о регистрации (ОГРН) или выписка из ЕГРЮЛ/ЕГРИП (не старше 12 месяцев). Для ИП — свидетельство о регистрации (ОГРНИП) или выписка из ЕГРИП. * **Подтверждение адреса компании:** это может быть официальный документ с тем же адресом, что и в документах (например, банковская выписка, счет за коммунальные услуги, налоговое уведомление). *Совет: часто выписка из госреестра уже содержит адрес, и ее бывает достаточно.* * **Доступ к официальному сайту или адресу электронной почты компании** (вида `info@вашакомпания.ru`). **Шаг 1: Начало процесса верификации** 1. Перейдите в ваш **Business Manager**. 2. В левом меню нажмите на **«Настройки»** (Settings). 3. В разделе **«Безопасность»** (Security) найдите и выберите пункт **«Верификация бизнеса»** (Business Verification). 4. Нажмите кнопку **«Начать»** (Start Verification). **Шаг 2: Ввод юридических данных** 1. Система предложит вам ввести официальные данные вашей компании. Убедитесь, что они **точно совпадают** с данными в подготовленных документах. * **Юридическое название** (полное наименование организации или ФИО ИП). * **Юридический адрес** (адрес регистрации). * **Почтовый адрес** (может совпадать с юридическим). * **Страна** и **ИНН** (или его аналог для вашей страны). 2. Внимательно проверьте все введенные данные и нажмите **«Далее»**. **Шаг 3: Выбор метода подтверждения** Facebook предложит один или несколько способов подтвердить вашу связь с бизнесом. Доступные варианты зависят от данных вашей страницы. * **A. Подтверждение через домен сайта (рекомендуется)** * **Вариант 1: Добавление мета-тега в HTML-код.** * Скопируйте уникальный мета-тег, который предоставит Facebook. * Добавьте этот тег в раздел `` главной страницы вашего сайта. * Сохраните изменения и вернитесь в Business Manager. * Нажмите **«Подтвердить»**. Робот Facebook проверит наличие тега. * **Вариант 2: Загрузка HTML-файла.** * Скачайте специальный файл, который предложит Facebook. * Загрузите его в корневую директорию вашего веб-сайта через FTP-менеджер или панель управления хостингом. * Убедитесь, что файл доступен по прямой ссылке (например, `yourdomain.com/facebook-file.html`). * Вернитесь в Business Manager и нажмите **«Подтвердить»**. * **B. Подтверждение через официальный email-адрес** * Система предложит отправить письмо с подтверждением на адрес, вида `admin@вашакомпания.ru`, `info@вашакомпания.ru` и т.д. * Убедитесь, что у вас есть доступ к этому почтовому ящику. * Нажмите **«Отправить письмо»**, перейдите в свой почтовый клиент, найдите письмо от Facebook и перейдите по ссылке для подтверждения. **Шаг 4: Загрузка документов** 1. После успешного подтверждения домена или email система запросит загрузку официальных документов. 2. Вам будет предложено загрузить **минимум два документа**: * **Документ, подтверждающий регистрацию бизнеса** (свидетельство ОГРН/ОГРНИП, выписка из ЕГРЮЛ/ЕГРИП). * **Документ, подтверждающий юридический адрес** (если он не указан в первом документе). 3. Загрузите четкие цветные сканы или фотографии документов. Все данные должны быть хорошо читаемы. **Шаг 5: Ожидание решения** 1. После отправки всех данных нажмите **«Отправить на проверку»**. 2. Проверка обычно занимает от **нескольких дней до нескольких недель**. Вы можете продолжить работу в Business Manager в это время. 3. Статус заявки можно отслеживать в том же разделе **«Верификация бизнеса»**. Результат будет отправлен вам также по email и в уведомлениях. **Чтобы увеличить шансы компании на верификацию Meta, важно, чтобы:** * Веб-сайт компании активен, имеет SSL и является полным, содержит название компании, адрес, в том числе юридический, и номер телефона, который соответствует тому, который был предоставлен бизнес-менеджером. Данные о бизнесе на сайте должны совпадать с данными из выписки ЕГРЮЛ. Сайт не может быть размещён на домене 3 или 4 порядка, а также на домене хостинга (например infocom.tilda.cc). Доменная запись должна содержать такую же информацию о владельце, что и данные о владельце юридического лица. * Электронная почта учетной записи находится в том же домене, что и веб-сайт компании, указанный в документации. Пример: Электронная почта: , сайт: [infocom.io](https://infocom.io)) * Если проверка будет производиться по номеру телефона, убедитесь, что вы можете принять звонок. Если в телефоне есть IVR, временно отключите его. IVR (интерактивное голосовое меню) — это автоматизированная функция телефонной станции, которая принимает звонки и распределяет их. * Торговое название компании в документации такое же, как на сайте и на странице Facebook. Если они разные, имена должны быть каким-то образом связаны на веб-сайте. Например, в нижнем колонтитуле введите «Компания ABC при поддержке компании D». {% endstep %} {% step %} **Добавьте администраторов в FBM.** Необходимо, чтобы у FBM было два или более пользователей, имеющих права администратора. Личные страницы администраторов FBM должны пройти верификацию и быть активными на Facebook: профили должны иметь заполненный раздел с информацией «О себе», страница содержит «друзей», фотографии, активные чаты с другими пользователями, на странице размещаются публикации. **Как пройти верификацию личной страницы:** **Шаг 1: Откройте настройки** 1. Нажмите на свою **аватарку** в правом верхнем углу. 2. Выберите **«Настройки и конфиденциальность»** → **«Настройки»**. **Шаг 2: Запустите процесс подтверждения** 1. В левом меню выберите раздел **«Профиль»** (или «Информация в профиле»). 2. Найдите и нажмите на пункт **«Подтверждение личности»** (Identity Confirmation). **Шаг 3: Следуйте инструкциям и загрузите документ** 1. Нажмите **«Начать»**. 2. Вам будет предложено **загрузить фото удостоверения личности**. 3. Выберите тип документа (например, **паспорт, водительские права, ID-карта**). 4. **Загрузите четкие фото 2-х разворотов** документа (главная страница и страница с регистрацией). Убедитесь, что все данные хорошо видны. **Шаг 4: Отправьте на проверку** 1. Нажмите **«Отправить»**. 2. Проверка обычно занимает **до 48 часов**. Результат придет в уведомления Facebook. {% hint style="info" %} В настройках личных аккаунтов всех пользователей, имеющих права администратора в FBM, должна быть обязательно включена двухфакторная аутентификация (2FA). {% endhint %} {% hint style="info" %} Двухфакторная аутентификация (2FA) также в обязательном порядке должна быть включена и для входа в FBM. {% endhint %} **Инструкция по включению 2FA на личном аккаунте:** 1. **Откройте Настройки** * Нажмите на свою **аватарку** в правом верхнем углу. * Выберите **«Настройки и конфиденциальность»** → **«Настройки»**. 2. **Найдите раздел безопасности** * В левом меню перейдите в раздел **«Безопасность и вход»**. 3. **Включите 2FA** * Найдите пункт **«Использовать двухфакторную аутентификацию»** и нажмите **«Редактировать»**. * Нажмите **«Начать»** и выберите способ: * **Приложение-аутентификатор** (рекомендуется): Отсканируйте QR-код из приложения (Google Authenticator и т.п.). * **SMS-сообщения**: Укажите номер телефона для получения кодов. * Следуйте инструкциям на экране и введите проверочный код. 4. **Сохраните резервные коды** * После настройки **обязательно скачайте или сохраните резервные коды**. Они понадобятся, если у вас не будет доступа к телефону. **Инструкция по включению 2FA для входа в FBM:** 1. **Откройте настройки Business Manager.** В левом меню нажмите **«Безопасность бизнеса»** (Business Security). 2. **Найдите раздел двухфакторной аутентификации** * В разделе **«Дополнительные параметры безопасности»** найдите пункт **«Двухфакторная аутентификация»**. * Нажмите кнопку **«Настроить»** или **«Управлять»**. 3. **Включите и настройте 2FA** * Нажмите **«Включить»**. * **Выберите метод** (рекомендуется приложение-аутентификатор, например, Google Authenticator). * Отсканируйте **QR-код** своим приложением-аутентификатором. * Введите **6-значный код** из приложения для подтверждения. 4. **Сохраните резервные коды.** Они понадобятся для входа, если у вас не будет доступа к телефону. {% endstep %} {% endstepper %} \*Meta (Facebook) – считается экстремистской организацией в РФ # Регистрация в GupShup Для подачи заявки на регистрацию аккаунта WhatsApp Business API необходимо [перейти по ссылке и](https://www.gupshup.io/)[ зарегистрироваться на сайте gupshup.io](https://www.gupshup.io/)
Нажмите на кнопку Sign up here (зарегистрироваться здесь).
{% hint style="warning" %} В кабинете Gupshup доступ к работе есть только у владельца изначально зарегистрированного аккаунта. Рекомендуем использовать аккаунт с общим доступом, чтобы у всех сотрудников был к нему доступ. {% endhint %} Заполните регистрационную форму, задайте пароль, разгадайте капчу, согласитесь с условиями и политикой конфиденциальности и нажмите на кнопку Signup (регистрация).
После отправки формы на указанную почту придёт письмо с ссылкой для подтверждения регистрации. Перейдите по ссылке из письма и подтвердите активацию аккаунта. На этом регистрация и создание личного кабинета в GupShup завершено. На странице дашборд в кабинете отображаются Клиент ID (идентификатор клиента), список приложений и кнопки для создания новых приложений.
После регистрации и создания аккаунта в GupShup можно переходить к добавлению приложения. # Создание и настройка приложения WhatsApp в GupShup ### Добавление приложения WhatsApp в кабинете GupShup Чтобы добавить новое приложение WhatsApp, в личном кабинете GupShup перейдите на страницу рабочей панели (дашборд). Далее нажмите на кнопку «+ Создать приложение»:
Выберите тип приложения «API доступа»:
Укажите имя приложения и нажмите на кнопку «Отправить»:
После создания приложения оно отобразится в списке приложений:
### Добавление партнёра Для добавления партнёра к приложению WhatsApp, в личном кабинете GupShup перейдите на рабочую панель. Выберите нужное приложение и перейдите к его настройкам. Для этого нажмите на иконку рядом с названием приложения:
Далее, перейдите на вкладку «Настройки» и нажмите на кнопку «Добавить партнёра»:
В поле ввода партнёрского ID (идентификатора) введите значение `88` и нажмите на кнопку для подтверждения добавления. Это ID нашей компании, его необходимо вводить чтобы вы смогли подключиться к нашему приложению для интеграции.
Убедитесь в том, что привязка к партнёру произошла успешно и в имени партнёра прописано значение `Infocom`:
### Подключение приложения к аккаунту Meta\* Для подключения приложения WhatsApp к аккаунту Meta\*, в личном кабинете GupShup перейдите на страницу Дашборд. Напротив нужного приложения нажмите на кнопку «В прямом эфире»:
В появившемся окне выберите «Новый номер телефона» и нажмите на кнопку «Продолжить»:
Далее следуйте пошаговой инструкции на экране:
На странице 1 необходимо выбрать регион хранения данных — Индию. Также можно выбрать страну для ознакомления со стоимостью сообщений:
Внизу страницы нажмите на кнопку чтобы перейти к следующей странице настроек:
На странице 2 введите ваши контактные данные, для связи с вами по вопросам, касающимся бизнес-аккаунта WhatsApp:
На странице 3 проверьте контактные данные и нажмите на кнопку «Подтвердить»:
На странице 4 потребуется войти в аккаунт Facebook\* и выполнить создание бизнес-аккаунта Whatsapp:
Нажмите продолжить как ...
Свяжите свой аккаунт Facebook\* с Gupshup:
Выберите верифицированный бизнес-аккаунт Meta:
В списке аккаунтов выберите вариант с созданием нового аккаунта и профиля WhatsApp Business:
Укажите имя пользователя для аккаунта WhatsApp Business, заполните отображаемое имя профиля, укажите категорию услуг. При необходимости заполните описание компании и адрес сайта. Нажмите на кнопку «Далее»:
На следующем шаге укажите номер телефона WhatsApp, для которого будет создан профиль WhatsApp Business и выберите удобный способ подтверждения номера. Нажмите на кнопку «Далее»:
Выберите номер телефона, который будет связан с приложением и нажмите на кнопку «Подтвердить»:
Перейдите к рабочей панели. В списке приложений вы увидите подключенный аккаунт:
Следующий этап — [установка приложения Whatsabi](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/ustanovka-prilozheniya) на портал Битрикс24. *(\*) Meta — признана экстремистской организацией на территории РФ.* # Добавление компании в Business Manager Для того чтобы использовать WhatsApp Business API, необходимо произвести создание бизнес-портфолио в Meta\* Business Suite и Business Manager. {% hint style="danger" %} При создании бизнес-портфолио особое внимание обратите на то, чтобы наименование юридического лица, описание бизнеса, адреса и контакты совпадали и в Business Manager, и на вашем сайте, и в созданном аккаунте и профиле WhatsApp Business. В противном случае, вы можете столкнуться с блокировкой аккаунта WhatsApp Business API со стороны Meta\* без предупреждений! {% endhint %} ## Процесс создания бизнес-портфолио Для создания бизнес-портфолио у вас должен быть зарегистрирован личный аккаунт Facebook\*. С его помощью вы будете входить в аккаунт Meta\* Business Suite или Business Manager, в котором создадите бизнес-портфолио. Всего можно создать не более 2 бизнес-портфолио. Это ограничение не касается числа портфолио, с которыми вы можете быть связаны. ### Чтобы создать бизнес-портфолио: 1. Откройте ссылку [business.facebook.com](https://business.facebook.com/) в браузере на компьютере. В будущем используйте этот адрес для входа в аккаунт Meta\* Business Suite или Business Manager. Если у вас уже есть доступ к Meta\* Business Suite или Business Manager, раскройте меню в верхней части панели навигации слева. Перейдите к шагу 4.
2. Нажмите Создать аккаунт. 3. Войдите в личный аккаунт Facebook. Если у вас его нет, нажмите Создать аккаунт и создайте его. 4. Нажмите Создать компанию.
5. Введите сведения о вашей компании: * Название бизнес-портфолио. Оно должно совпадать с официальным названием вашей компании или организации, поскольку будет доступно на платформах Meta\*. Название не должно содержать специальные символы. * Ваше имя. * Электронный адрес компании. С его помощью Meta\* будет связываться с вашей компанией. Электронный адрес не смогут видеть клиенты.
6. Нажмите Отправить или Создать, чтобы создать портфолио. Вы получите электронное письмо с просьбой подтвердить электронный адрес компании. ## Редактирование информации о компании в Meta\* Business Manager Создав бизнес-портфолио, вы сможете добавить в него объекты компании, например Страницы, рекламные аккаунты, производить редактирование информации о вашей компании. ### Обновление информации Чтобы отредактировать информацию в Business Manager: 1. Откройте страницу [настройки компании](https://business.facebook.com/settings). 2. Если в кабинете добавлено несколько компаний, выберите нужную:
3. Нажмите Информация о бизнес-портфолио. 4. Нажмите Редактировать в разделе Сведения о компании:
5. Обновите необходимые данные:
6. Нажмите на кнопку Сохранить. 7. Meta\* отправит вам электронное письмо, чтобы подтвердить изменения. {% hint style="warning" %} Если вы уже подтвердили свою компанию, то при внесении изменений вам потребуется снова пройти процесс подтверждения. Процесс редактирования не повлияет на ваш текущий статус подтверждения компании. Однако вам может потребоваться предоставить документы, подтверждающие обновленные сведения о компании, такие как юридическое название, физический адрес и номер телефона. Вам также будет необходимо подтвердить свою связь с компанией, получив код подтверждения на электронный адрес, по телефону или с помощью подтверждения домена. {% endhint %} *(\*) Meta, Facebook — признана экстремистской организацией на территории РФ.* # Перенос номера с провайдером GupShup Если вы ранее использовали номер WABA через провайдера GupShup и были клиентом другой компании-интегратора, вы можете осуществить перенос номера в Олчат WABA. Для этого понадобится доступ к номеру WABA и аккаунту Facebook\*, к которому привязан бизнес-аккаунт Meta\* с нужным номером WABA. {% hint style="warning" %} При смене компании-интегратора на Олчат, созданные шаблоны в GupShup, автоматически загрузятся в Олчат WABA. {% endhint %} ### Отключение 2FA До начала процесса переноса подключенного к GupShup номера в Олчат, необходимо выполнить отключение двухфакторной аутентификации (2FA, two-factor authentication). Для этого выполните следующие действия: {% stepper %} {% step %} Перейдите в [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/overview/), затем выберите необходимый для переноса номер телефона.
{% endstep %} {% step %} Выберите вкладку «Двухшаговая проверка», затем нажмите «Отключить двухшаговую проверку».
{% endstep %} {% step %} На привязанный адрес электронной почты придёт письмо с ссылкой для отключения 2FA. Перейдите по ней и подтвердите отключение.
{% endstep %} {% step %} Отключение 2FA завершено. {% endstep %} {% endstepper %} ### Перенос номера Чтобы перенести номер от другой компании-интегратора, выполните следующие действия: {% stepper %} {% step %} Необходимо обратиться в чат технической поддержки компании-интегратора, услугами которой вы пользовались ранее. Текст сообщения приведён ниже, он является примером: > Добрый день! Нам необходимо освободить номер WABA (*ваш номер телефона*). Отправьте, пожалуйста, тикет в поддержку GupShup на удаление приложения (app). > {% endstep %} {% step %} Удалите приложение, привязанное к переносимому номеру, в личном кабинете компании-интегратора, услугами которой вы пользовались ранее. {% endstep %} {% step %} Воспользуйтесь [инструкцией ](https://waba.docs.olchat.io/bystryi-start/sozdanie-i-nastroika-prilozheniya-whatsapp-v-gupshup#dobavlenie-prilozheniya-whatsapp-v-kabinete-gupshup)по созданию и настройке приложения WhatsApp в GupShup. {% endstep %} {% step %} На этапе подключения приложения WhatsApp к аккаунту Meta\*, выберите «Действующий номер» и завершите подключение, следуя инструкции. {% endstep %} {% step %} Воспользуйтесь [инструкцией ](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/ustanovka-prilozheniya)по установке приложения Олчат WABA. {% endstep %} {% step %} Подключите открытую линию и коннектор, воспользовавшись данной [инструкцией](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/podklyuchenie-konnektora). {% endstep %} {% step %} Настройте открытую линию согласно данной [инструкции](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/nastroika-otkrytoi-linii). Перенос номера завершён, можно приступать к работе! {% endstep %} {% endstepper %} *(\*) Meta, Facebook — признана экстремистской организацией на территории РФ.* # Перенос номера от другого провайдера Если вы ранее использовали номер WABA через другого провайдера, вы можете осуществить перенос номера. Для этого понадобится доступ к номеру WABA и аккаунту Facebook\*, к которому привязан бизнес-аккаунт Meta\* с нужным номером WABA. {% hint style="warning" %} При переносе номера шаблоны, которые были привязаны к WABA, мигрируют вместе с номером в приложение. {% endhint %} ### Отключение 2FA Для начала процесса переноса номера к другому провайдеру, необходимо выполнить отключение двухфакторной аутентификации (2FA, two-factor authentication). Для этого выполните следующие действия: {% stepper %} {% step %} Перейдите в [WhatsApp Manager](https://business.facebook.com/latest/whatsapp_manager/overview/), затем выберите необходимый для переноса номер телефона.
{% endstep %} {% step %} Выберите вкладку «Двухшаговая проверка», затем нажмите «Отключить двухшаговую проверку».
{% endstep %} {% step %} На привязанный адрес электронной почты придёт письмо с ссылкой для отключения 2FA. Перейдите по ней и подтвердите отключение.
{% endstep %} {% endstepper %} {% hint style="info" %} Создайте личный кабинет в GupShup, если еще не зарегистрированы, затем создайте новое приложение. Подробная инструкция по регистрации в Gupshup доступна по [ссылке](broken://pages/iBDZWmFnH7h73tsX3Rck). {% endhint %} ### Перенос номера Чтобы перенести номер от другого провайдера, выполните следующие действия: {% stepper %} {% step %} При создании приложения в GupShup, на этапе «Let\`s get started» («Начать») выберите «Migrate a live phone number» («Перенести номер телефона»), затем нажмите «Continue». Перейти к данному этапу получится после нажатия кнопки «Go Live».
{% endstep %} {% step %} Следуйте дальнейшей инструкции, выбрав или создав аккаунт. Далее создайте профиль под номер.
{% hint style="warning" %} Необходимо указывать тот же WhatsApp Display Name, какой использовался у предыдущего оператора в личном кабинете. {% endhint %} {% endstep %} {% step %} Добавьте номер, который переносится.
{% endstep %} {% step %} При успешном переносе, в GupShup станет доступен следующий шаг. Здесь необходмо также выбрать номер, который переносится, далее нажать «Confirm» («Подтвердить»).
{% endstep %} {% step %} Перенос номера завершен. {% endstep %} {% endstepper %} ### Подключение партнёра и получение ключа API Следуйте инструкции: {% embed url="" %} После этого переходите к установке приложения: {% embed url="" %} *(\*) Meta, Facebook — признана экстремистской организацией на территории РФ.* # MM Lite **MM Lite API (Marketing Messaging Lite)** — это упрощённый режим отправки маркетинговых сообщений через WhatsApp Business API, созданный компанией Meta\*.\ Он начнёт работу с 1 января 2026 года и будет обеспечивать более высокую доставляемость, а также снижать риск блокировок, особенно при интенсивных рассылках. Такой формат идеально подходит для массовых кампаний (рассылок): уведомлений об акциях и новинках, баннеров, а также повторных коммуникаций с клиентами. При этом используется та же структура шаблонов, что и в стандартном WhatsApp Business API — создавать новые не потребуется. Решение **MM Lite** разработано Meta\* для повышения качества пользовательского опыта и снижения количества спама в экосистеме WhatsApp Business API. ### Для кого создан MM Lite? **MM Lite API** — это оптимальное решение для бизнеса, которому важно: * масштабировать маркетинговые рассылки; * повысить процент доставленных сообщений; * снизить риск блокировок; * использовать привычные шаблоны и действующие тарифы. MM Lite является дополнением к **WhatsApp Business API**, упрощающим маркетинговые процессы и делая коммуникацию с клиентами более прозрачной и безопасной. ### Преимущества MM Lite По данным Meta\*\*, новая технология повысит доставляемость сообщений в среднем **до 9%** по отношению к текущим показателям. Кроме того, в ней предусмотрены дополнительные возможности, которые будут постепенно добавляться в работу: * Срок жизни сообщений увеличится с 12 часов до 30 дней. Просроченные сообщения не тарифицируются. * Поддержка **анимированных заголовков**, чтобы привлекать больше внимания пользователей. * **Активные ссылки в приложение или на сайт**, ведущие клиента прямо в нужный раздел или карточку товара. ### Стоимость MM Lite Использование **MM Lite API** обходится по тем же тарифам, что и **WhatsApp Business API**.\ Никаких дополнительных платежей, комиссий или подписок не потребуется. ### Сравнение MM Lite и Business API: | **Критерий** | **WhatsApp Business API** | **MM Lite API** | | -------------------------- | --------------------------------------------------------------- | ---------------------------------------------------------- | | **Для чего используется?** | Универсальный: маркетинг, поддержка, аутентификация, транзакции | MM Lite (маркетинг), поддержка, аутентификация, транзакции | | **Оптимизация доставки** | Без дополнительной логики | Использует AI и динамическую маршрутизацию | | **Ценовая политика** | Стандартная | Остается неизменной | | **TTL шаблонов** | Только для служебных шаблонов | Поддержка TTL для маркетинговых сообщений | {% hint style="success" %} TTL — срок действия сообщения. Вы можете задать собственный период действия, в течение которого маркетинговое сообщение должно быть доставлено получателю. Если сообщение не будет доставлено до окончания этого срока, оно не тарифицируется (за него не взимается плата), а клиент его не получит. {% endhint %} ### Как подключить? Подключение MM Lite возможно двумя способами: в личном кабинете GupShup, а также в Facebook Business Manager. Инструкция по подключению с помощью личного кабинета GupShup: {% stepper %} {% step %} На главной странице личного кабинета GupShup выберите подключенный аккаунт. {% endstep %} {% step %} Нажмите «Дашборд», затем выберите «Счёт».
{% endstep %} {% step %} Нажмите «Приступайте к работе», чтобы перейти на MM Lite. В открывшемся окне нажмите «Включить оптимизированный маркетинг».
{% endstep %} {% endstepper %} #### Инструкция по подключению с помощью Facebook Business Manager: {% stepper %} {% step %} Перейдите в Facebook Business Manager. Воспользуйтесь [активной ссылкой](https://business.facebook.com/) для перехода. {% endstep %} {% step %} Выберите свою компанию (портфолио). {% endstep %} {% step %} Перейдите в настройки компании (портфолио). В меню слева выберите раздел «Запросы». {% endstep %} {% step %} Примите запрос от GupShup, нажав кнопку «Ответить», а затем подтвердив переход на MM Lite.
{% endstep %} {% endstepper %} Если запроса нет, выполните следующие действия в Facebook Business Manager: {% stepper %} {% step %} Перейдите в **Информация о компании** → **Data Sharing (**Обмен данными). {% endstep %} {% step %} Активируйте «Optimize marketing messages delivery in Marketing Messages Lite API and Ads Manager» («Оптимизируйте доставку маркетинговых сообщений в Marketing Messages Lite API и Ads Manager»). {% endstep %} {% step %} Проверьте нужный WABA-аккаунт. FBM → WhatsApp Accounts → используемый аккаунт → Privacy and Data Sharing (Приватность и Обмен данными) → активируйте «Optimize marketing messages by sharing event activity with Meta» («Оптимизируйте маркетинговые сообщения, делясь информацией о мероприятиях с Meta»). {% endstep %} {% endstepper %} ### Особенности работы MM Lite API в России Marketing Messages Lite API доступен для российских WABA-аккаунтов, однако функционирует в упрощённом режиме. Из-за требований к обработке данных, некоторые функции Meta\* недоступны: * автоматическая оптимизация времени доставки отключена — сообщения отправляются сразу, без подбора «лучшего момента»; * недоступна отложенная отправка в течение 24 часов; * статистика по кликам и конверсиям не отображается. Несмотря на эти ограничения, MM Lite всё равно помогает экономить: рассылка не уходит неактивным пользователям, поэтому списания происходят только за доставку заинтересованным контактам. {% hint style="info" %} Если пользователь превысил лимиты на получение маркетинговых сообщений или пожаловался на спам, система просто не доставит ему сообщение — и оплата за него не взимается. Так алгоритм защищает ваш аккаунт: платформа автоматически исключает контакты, которые не хотят получать рассылки, снижая количество жалоб и риск ограничений со стороны WhatsApp. {% endhint %} \*Meta - организация, деятельность и продукты которой (WhatsApp, WABA, Facebook, Facebook Business Manager) запрещены в России. # Установка приложения Для установки приложения [напишите нам в поддержку](https://auth2.bitrix24.net/oauth/select/?preset=im\&IM_DIALOG=networkLines7c380c91ab28dacab02d3af93fecdbf9) адрес вашего портала, в ответ мы пришлём ссылку на установку приложения. После перехода по ссылке откроется окно с установкой приложения. Установите галочки напротив ознакомления с Лицензионным соглашением и Политикой конфиденциальности и нажмите на кнопку «УСТАНОВИТЬ».
После установки приложение «Олчат WABA» появится в левом меню портала:
# Подключение открытой линии и коннектора Для того чтобы подключить открытую линию в приложении Олчат WABA, необходимо выполнить следующие действия: {% stepper %} {% step %} **Откройте приложение Олчат WABA.** Для этого выберите приложение в левом меню портала Битрикс24:
{% endstep %} {% step %} **В открывшемся окне выберите «Подключить WhatsApp Business API».**
{% endstep %} {% step %} **Создайте новую открытую линию путём нажатия на соответствующую кнопку, либо выберите линию из существующих и нажмите кнопку «Подключить».**
{% endstep %} {% endstepper %} ### Подключение коннектора Для того, чтобы подключить коннектор, необходимо выполнить следующие действия: {% stepper %} {% step %} В подключаемом коннекторе перейдите на вкладку «Соединение».
{% endstep %} {% step %} В поле «**Токен**» укажите API (программный интерфейс) ключа приложения WhatsApp, полученный в личном кабинете GupShup. Для получения ключа API нажмите на «Мой профиль» в правом верхнем углу, далее необходимо нажать кнопку «Показать», либо сразу воспользоваться кнопкой копирования ключа API «Копировать в буфер обмена».
{% endstep %} {% step %} В поле «**Приложение**» укажите название приложения из личного кабинета. Название приложения можно скопировать в личном кабинете GupShup на вкладке Dashboard (рабочая панель)/ WhatsApp в строках, содержащих информацию о подключенных приложениях.
{% endstep %} {% step %} Сохраните настройки. После успешного подключения цвет иконки статуса подключения сменится на зелёный, а также отобразится дополнительная информация о номере телефона, названии приложения и оставшаяся на балансе сумма.
{% endstep %} {% endstepper %} # Настройка открытой линии Настроим основные параметры открытой линии к которой подключен коннектор. Для этого прейдите в приложение «Олчат WABA» в левом меню портала и в карточке нужного коннектора нажмите на иконку «⚙️» настройка напротив названия открытой линии:
Также в настройки Открытой линии можно перейти следующим образом: «CRM» — «Клиенты» — «Контакт-центр» — «Олчат WABA». Затем нажмите на подключенную Открытую линию:
### Раздел Очередь Сначала нужно добавить сотрудников в очередь и выбрать тип распределения диалогов. Рекомендуем ставить «Одновременно всем», если у вас нет специфического сценария работы.
Дальше настраивается информация об операторах и правила автоматического создания сущностей при создании диалогов. Снимите галочку с настройки «Включить чат трекер». Остальные настройки рекомендуем установить как показано на скриншоте ниже:
{% hint style="info" %} Если вы используете сценарий создания сделки, обратите внимание на настройку «Использовать активную сделку, не создавая новую». Если она не активна, будет создаваться новая сделка даже если вы пишете клиенту из действующей сделки. Рекомендуем активировать данную настройку, чтобы не создавались дубликаты сделок! {% endhint %}
После этого нужно настроить автоматические действия. ### Раздел Автоматические действия и Оценка качества {% hint style="warning" %} Обратите внимание! Изначально установлено автоматическое приветствие. Оно срабатывает всегда, когда вам клиент пишет в первый раз. Есть особенность. Открытые линии не разрешают писать первыми. Для того чтобы писать первыми мы применяем маленькую хитрость и пишем как бы от имени клиента. Битрикс24 думает, что написал клиент и создаёт чат. Но вместе с созданием чата срабатывает автоответ. В этом случае мы рекомендуем отключать автоматический ответ. {% endhint %} Для корректной работы Открытой линии, в разделе Автоматические действия настоятельно рекомендуем устанавливать настройки, как показано на скриншоте ниже:
В разделе Оценка качества снять галочку «Отправлять запрос...»:
{% hint style="info" %} Открытые линии: общие настройки {% endhint %} # Настройка прав Настройка прав для работы с Олчат WABA выполняется на портале в нескольких разделах. Чтобы приложение функционировало корректно, сотрудникам, которые будут его использовать и настраивать, необходимо предоставить права на следующие элементы: само приложение Олчат WABA, настройку открытой линии, карточку CRM (системы управления взаимоотношениями с клиентами), коннектор линии. ### Права на коннектор По умолчанию все сотрудники с правами на приложение могут выбирать любой коннектор для отправки сообщений или шаблонов. Однако вы можете ограничить этот доступ, назначив конкретным сотрудникам или отделам только тот коннектор, который предназначен для их работы. Для того, чтобы установить права на коннектор , выполните следующие действия: {% stepper %} {% step %} Откройте приложение Олчат WABA. Сделать это можно, выбрав приложение в левом меню портала Битрикс24, либо воспользоваться списком установленных приложений через Маркетплейс.
{% endstep %} {% step %} Выберите коннектор и нажмите «Права доступа к коннектору».
{% endstep %} {% step %} Нажмите кнопку «Добавить».
{% endstep %} {% step %} Выберите категории или отдельных пользователей - сотрудников, подключенных к порталу Битрикс24. Воспользуйтесь поиском, чтобы быстро найти сотрудника или отдел, либо отметьте желаемые категории и отделы в структурированном списке.
{% endstep %} {% step %} Проверьте список сотрудников и отделов, которым будет доступен данный коннектор, в окне справа и нажмите кнопку «Выбрать». Настройка прав доступа к коннектору завершена. Выбранные сотрудники и/или отделы теперь отображаются в соответствующем поле в настройках коннектора.
{% endstep %} {% endstepper %} ### Права на работу приложения По умолчанию приложение работает под правами администратора портала Битрикс24, который установил данное приложение на портал. Для того, чтобы изменить права на приложение или просмотреть, под правами какого пользователя Олчат WABA работает в данный момент, выполните следующие действия: {% stepper %} {% step %} Откройте приложение Олчат WABA. Сделать это можно, выбрав приложение в левом меню портала Битрикс24, либо воспользоваться списком установленных приложений через Маркетплейс.
{% endstep %} {% step %} Выберите «Настройки» на главной странице приложения.
{% endstep %} {% step %} В разделе «Общие» настроек приложения можно просмотреть, под правами какого пользователя приложение работает в данный момент.
{% endstep %} {% step %} Нажмите кнопку «Сменить права на текущего пользователя», чтобы приложение стало работать под правами, установленными для вас. Обновите страницу приложения, чтобы увидеть изменения. Настройка прав на использование приложения завершена. {% endstep %} {% endstepper %} ### Права на использование приложения Для того, чтобы приложение было доступно на портале только определенным отделам или сотрудникам, его отображение и доступ к нему можно настроить следующим образом: {% stepper %} {% step %} Перейдите в магазин приложений Битрикс24, выбрав его в меню слева на портале. {% endstep %} {% step %} В левом верхнем углу нажмите «Ещё», далее выберите «Установленные приложения».
{% endstep %} {% step %} Нажмите на «», затем выберите «Доступ».
{% endstep %} {% step %} Добавьте сотрудников и/или отделы, которым будет доступно приложение. {% hint style="info" %} Для корректной работы приложения рекомендуем оставлять поле пустым. {% endhint %} {% endstep %} {% endstepper %} ### Права на открытые линии Права на использование открытой линии можно настроить двумя способами: из приложения Олчат WABA и через контакт-центр. Чтобы выдать права на настройку открытой линии через приложение Олчат WABA, выполните следующие действия: {% stepper %} {% step %} Откройте приложение Олчат WABA.
{% endstep %} {% step %} Нажмите на иконку шестерни после названия открытой линии и перейдите в настройки.
{% endstep %} {% step %} В разделе «Очередь ответственных сотрудников» нажмите «+ Добавить».
{% endstep %} {% step %} Укажите сотрудников и/или отделы, которые будут использовать данную открытую линию.
{% endstep %} {% endstepper %} Чтобы выдать права на настройку открытой линии через Контакт-центр, выполните следующие действия: {% stepper %} {% step %} Перейдите к карточке приложения. Перейдите в CRM, далее нажмите «Клиенты» в верхнем меню портала Битрикс24, а затем выберите «Контакт-центр». {% endstep %} {% step %} Левой кнопкой мыши выберите карточку Олчат WABA, чтобы открыть список линий, подключённых к приложению.
{% endstep %} {% step %} Выберите открытую линию из списка. {% endstep %} {% step %} В открывшемся окне настрое открытой линии и прав доступа выберите «Настроить» в разделе «Права доступа».
{% endstep %} {% step %} Настройте список ролей, установив права доступа. Добавьте новые, отредактируйте или удалите существующие роли в списке.
Установите роли права на выполнение списка действий (для каждого действия право устанавливается индивидуально) и нажмите «Сохранить».
Если необходимо, чтобы сотрудники видели только свои переписки, настройте для этих сотрудников права таким образом, как показано на скриншоте ниже:
Также имеется возможность немного расширить права сотрудников и выдать им доступ на просмотр истории разговоров, установив в пункте «История разговора» значение «Любые». При этом сотрудники также не смогут подключаться и писать в чат, который за ними не закреплён, если остальные настройки установлены так, как показано на скриншоте ниже:
{% hint style="info" %} Доступ к истории разговора зависит от прав пользователя в CRM, и права CRM важнее прав в открытых линиях. Если у сотрудника есть доступ к сделке, он сможет открыть и прочитать диалог из карточки CRM. Например, руководитель сможет ознакомиться с историей чата и проверить, как сотрудник работает со сделкой. {% endhint %} Возможность подключения к разговору также зависит от прав пользователя в CRM. Если у сотрудника есть доступ к лиду или сделке, он сможет подключиться к диалогу. Например, ответственный менеджер в отпуске, а клиент задал в чате вопрос по заказу. Коллега сотрудника с доступом к карточке CRM сможет в любой момент прочитать диалог и продолжить общение с клиентом.
{% endstep %} {% step %} Присвойте каждой группе сотрудников или отделам роли, настроенные на предыдущем этапе. Добавьте новые, отредактируйте или удалите существующие группы в списке.
Нажмите кнопку «Сохранить». {% endstep %} {% step %} Настройка прав доступа к открытой линии завершена. {% endstep %} {% endstepper %} ### Права на карточку CRM Чтобы сотрудник имел возможность пользоваться приложением из карточки лида или сделки, необходимо настроить права на карточку CRM. Для этого необходимо выполнить следующие действия: {% stepper %} {% step %} Перейдите в CRM. Из верхнего меню выберите «Настройки», затем «Права доступа к CRM».
{% endstep %} {% step %} В меню справа выберите «Лид» или «Сделка», затем отредактируйте существующие или добавьте новые роли. Для использования приложения сотруднику необходимо установить права на **Изменение** лида или сделки. Установите соответствующие права для выбранных ролей.
При необходимости можно удалить имеющиеся настройки прав и добавить новые. Чтобы добавить новые права, нажмите «+» в конце списка ролей**,** выберите из структуры компании нужный отдел или сотрудника и присвойте ему необходимую роль. Нажмите на кнопку «Сохранить». {% endstep %} {% step %} Настройка прав на карточку CRM завершена. {% endstep %} {% endstepper %} # Интерфейсы приложения # Описание панели приложения Панель приложения Олчат WABA является главным интерфейсом, содержащим набор инструментов для управления настройками приложения, получения актуальной информации о подключенных линиях и статусах подключения.
## Меню приложения
* Пункт меню **«Статус рассылок».** Открывает страницу просмотра статусов рассылок CRM-маркетинга. Подробнее [в статье](https://waba.docs.olchat.io/vozmozhnosti/rassylka-shablonov-s-pomoshyu-marketinga#status-rassylok-marketinga). * Пункт меню **«Настройки».** Подробнее в статье [Описание настроек приложения](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/interfeisy-prilozheniya/opisanie-nastroek-prilozheniya) * Пункт меню **«Помощь».** Ссылка на данную документацию * Пункт меню **«Чат поддержки».** Открывает чат поддержки пользователей приложения Олчат WABA в вашем Битрикс24 ## Список коннекторов Содержит список подключенных коннекторов с информацией о подключении и возможностью перейти к настройкам коннектора, открытой линии, а также кнопку для подключения новых коннекторов. Подробнее о настройках коннектора в статье [Описание настроек коннектора](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/interfeisy-prilozheniya/opisanie-nastroek-konnektora). Подробнее о подключении коннектора в статье [Подключение открытой линии и коннектора](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/podklyuchenie-konnektora). Подробнее о настройке открытой линии в статье [Настройка открытой линии](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/nastroika-otkrytoi-linii). # Описание настроек коннектора Окно настроек коннектора содержит в себе несколько вложенных пунктов настроек для управления сценариями работы подключенного аккаунта WhatsApp (коннектора).
## **Наименование коннектора** Вы можете переименовать коннектор так, как вам удобно, нажав для этого на значок «✏️» карандаш напротив названия коннектора. ## **Статусы подключения** Включают в себя статусы подключения линии и провайдера. При условии подключении и линии и провайдера, статусы отображаются зелёным цветом ## Открытая линия Отображается название открытой линии подключенной к коннектору и значок «⚙️» настройка, при клике на которую произойдёт переход в настройки подключенной Открытой линии. Подробнее в статье [Настройка открытой линии](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/nastroika-otkrytoi-linii). ## Соединение
На вкладке «Соединение» производится настройка и подключение коннектора. Подробнее в статье [Подключение открытой линии и коннектора](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/podklyuchenie-konnektora#podklyuchenie-konnektora). Если подключение коннектора выполнено, цвет иконки статуса подключения отображается зелёным цветом, а также отображается дополнительная информация о дате, до которой оплачен коннектор, номер телефона, название приложения и оставшаяся на балансе сумма.
## Отключить интеграцию Кнопка позволяет разорвать соединение с провайдером и отключить интеграцию ## Настройки чата Раздел отвечает за настройку логики работы приложения при отправке сообщений из чатов Битрикс24. Вы можете отметить или деактивировать нужные пункты в зависимости от потребностей и сценариев вашей работы
* **«Включить SMS провайдера»** – управляет возможностью использовать приложение Олчат WABA в качестве провайдера СМС в стандартном функционале отправки СМС от Битрикс24. * **«Публиковать в чат исходящие сообщения: через СМС, из приложения, роботов и бизнес-процессов».** При включении данной функции все сообщения отправляемые различными способами – с телефона, через СМС, из приложения, с помощью роботов и бизнес-процессов будут опубликованы в чат открытой линии. Это глобальная настройка. Если она отключена, то сообщения от приложения не будут попадать в чат открытой линии даже если в роботах стоит «Да» в настройке «Создавать сообщение в чате открытой линии?». * **«Создавать чат при отправке через СМС-провайдера»** – управляет возможностью создавать или не создавать чат открытой линии с клиентом при использовании стандартного функционала отправки СМС от Битрикс24 и приложения Олчат WABA в качестве провайдера. * **«Создавать чат при отправке через SMS-рассылки»** – управляет возможностью создавать или не создавать чат открытой линии с клиентом при проведении рассылок и использовании приложения Олчат WABA в качестве провайдера в разделе Маркетинг. ## Настройка виджета на сайт Подробнее в статье [Виджет на сайт](/vozmozhnosti/dobavlenie-vidzheta-na-sait).
## Права доступа к коннектору Подробнее в статье [Настройка прав](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/nastroika-prav).
# Описание настроек приложения Страница «Настройки приложения» содержит несколько вкладок с вложенными настройками. ### Общие
В разделе «Общие» содержится информация о том, под правами какого пользователя работает приложение и возможность их сменить. Подробнее в статье [Настройка прав](/ustanovka-i-nastroika-prilozheniya-v-bitriks24/nastroika-prav). ### Уведомления
В разделе «Уведомления» содержится ссылка на переход в чат уведомлений и возможность добавить в этот чат сотрудников. ### Роботы и бизнес-процессы
Раздел «РОБОТЫ» содержит список всех роботов и активити бизнес-процессов приложения Олчат и кнопку для их переустановки. Подробнее в статье [Роботы и активити бизнес-процессов](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov). ### Виджеты
В разделе «Виджеты» можно произвести включение/выключение виджетов «Статусов и отправки CRM» и «Отправки шаблонов для ОЛ». Подробнее в статье [Виджеты](/ispolzovanie/vidzhety) # Дополнительные настройки для коробочной версии Битрикс24 Если вы используете наше приложение в коробочной версии Битрикс24, для его корректной работы вам необходимо открыть доступы к нашему серверу и серверам Битрикс24.Ниже представлен минимальный список адресов и портов, которые необходимо открыть: **Наш сервер:** > 178.250.156.140 > > waba.olchat.infocom.io **Сервера Битрикс24:** > cloud-messaging.bitrix24.com – Сервис пуш-уведомлений > > im.bitrix.info – Сервер коннекторов > > marta.bitrix.info – Сервис ботов, в том числе канал по network > > imsqs.bitrix.info, imsqs-ru.bitrix.info – Серверы очередей для ботов и открытых линий > > oauth.bitrix.info – Сервер REST авторизацииmarketplace.1c-bitrix.ru – Marketplace **Порты. Какие входящие сетевые соединения ожидает сервер:** > 80, 443 – стандартные HTTP/HTTPS порты > > 8893, 8894 – если используется push-сервер. > > Подробнее в статье Битрикс24 [Настроить сервис Push/RTC](https://dev.1c-bitrix.ru/learning/course/?COURSE_ID=37\&CHAPTER_ID=09377\&LESSON_PATH=3908.8809.9377)​ {% hint style="info" %} Актуальность и полноту списка адресов Битрикс24 лучше уточнить в техподдержке Битрикс24 на момент подключения. {% endhint %} # Интерфейс GupShup [Страница входа](https://login.gupshup.io/u/login) на сервис и [личный кабинет](https://www.gupshup.io/whatsapp/dashboard) GupShup доступны по ссылкам. {% hint style="info" %} По умолчанию пользователям открывается англоязычная версия сайта GupShup. После прохождения процесса регистрации или авторизации, на вкладке «Dashboard» (рабочая панель) появится возможность смены языка сайта путем нажатия на кнопку «English» (английский) в правом верхнем углу. {% endhint %} ### Дашборд (рабочая панель)/ WhatsApp
1. Вкладка **«дашборд / WhatsApp»**. Основная вкладка, выполняющая роль личного кабинета. 2. Вкладка **«**[**Мой бумажник**](#moi-bumazhnik)**»**. Рядом с данной вкладкой отображается актуальный баланс аккаунта. При нажатии на вкладку будет осуществлен переход к детальной информации по использованию средств. 3. Вкладка **«**[**Мой профиль**](#moi-profil)**»**. При нажатии позволяет узнать ключ API (программного интерфейса), необходимый для отправки сообщений через WhatsApp. 4. Информация **«Клиент ID»** необходима для интеграции с другими платформами и сервисами. 5. Кнопка **«**[**+ Создать приложение**](#sozdanie-prilozheniya)**»** позволяет перейти к процессу создания приложения во вкладке «дашборд / Создание приложения». 6. В нижней части вкладки «дашборд / WhatsApp» доступна **информация о созданных ранее приложениях**. ### Мой бумажник Вкладка также может называться «Мой кошелёк и его использование».
1. Окно **«Доступный баланс»**. В данном окне отображается баланс аккаунта в кредитах, имеется возможность пополнения баланса аккаунта, а также настройка уведомлений о низком балансе. Курс кредитов: 1$ = 1 кредит. 2. Окно **«Использование»**. Здесь доступна статистика использования WhatsApp с помощью сервиса GupShup. 3. Окно **«История оплат»** позволяет получить информацию об истории операций, пополнивших баланс аккаунта. 4. В окне **«Баланс кошелька»** можно запросить выписку финансовых операций по аккаунту на электронную почту. При этом имеется возможность выбора диапазона дат для установления конкретного интересующего вас периода. 5. Окно **«Подробная информация о клиенте»** содержит в себе информацию об ID (об идентификаторе) пользователя. Данная информация дублируется из вкладки «дашборд / WhatsApp». 6. В окне **«Часовой пояс по умолчанию»** рекомендуется выбрать из выпадающего списка свой часовой пояс, чтобы даты и время в выписках финансовых операций соответствовали реальному времени совершения платежа в вашем часовом поясе. 7. В окне **«Информация для оплаты»** необходимо заполнить все поля, указав данные владельца аккаунта. ### Мой профиль При нажатии позволяет узнать ключ API, необходимый для отправки сообщений через WhatsApp.
1. Нажмите на иконку профиля. 2. Воспользуйтесь кнопкой для копирования ключа API, либо используйте кнопку «Показать», чтобы скопировать ключ API в ручном режиме, выделив его. ### Создание приложения Создание приложения начинается с ввода наименования приложения. Далее воспользуйтесь [инструкцией](https://waba.docs.olchat.io/bystryi-start/sozdanie-i-nastroika-prilozheniya-whatsapp-v-gupshup#poluchenie-klyucha-api-prilozheniya) по созданию и настройке приложения WhatsApp в GupShup.
# Создание и управление шаблонами сообщений ### Создание нового шаблона Для создания шаблона сообщения, в личном кабинете GupShup перейдите на страницу Дашборд (рабочей панели). Нажмите на название приложения, для которого нужно добавить шаблон:
На открывшейся странице нажмите на кнопку «+ Создать шаблон»:
Откроется специальная форма создания и предпросмотра шаблона, который затем можно отправить на согласование. Задайте имя шаблону сообщения. Имя шаблона должно быть указано на латинице:
Выберите категорию и тип шаблона сообщения. Например, «Маркетинг» и «Пользовательское сообщение»:
Заполните по-порядку все предложенные поля, Язык, Ярлык шаблона, Заголовок, Тело сообщения:
### Создание шаблона с переменными Если вы хотите создать шаблон, в котором присутствует возможность при отправке через приложение в карточке или с помощью роботов подставлять в текст шаблона переменные значения, вам необходимо создать и согласовать такой шаблон, заранее указав в тексте шаблона места вставки переменных. На этапе заполнения тела шаблона, нажмите на кнопку «+ Добавить переменную»:
Переменная вставляется в текст шаблона в виде порядкового номера переменной в двойных фигурных скобках: {{1}}, {{2}} и т.д. Напротив каждой указанной переменной в поле «Значение выбора» укажите любой текст, характеризующий данную переменную. Подробнее об использовании шаблона с переменными в статье [Отправка шаблонов и сообщений из приложения в карточке](/ispolzovanie/otpravka-i-poluchenie-soobshenii/otpravka-shablonov-i-soobshenii-iz-prilozheniya-v-kartochke#shablony). ### Создание шаблона с Кнопками При необходимости вы можете добавить к тексту сообщения несколько кнопок:
В разделе «Призыв к действию» можно, например, выбрать тип «Номер телефона» и «URL», чтобы добавить кнопки двух разных типов. Для типа призыва к действию «Номер телефона» значение кнопки задаётся статическим образом, без возможности подстановки переменных. Для типа призыва к действию «URL» можно указать статическую часть адреса а также добавить переменную, если выбрать в поле «Тип URL» значение «Динамический». Таким образом, часть ссылки может быть изменяемой и вести на разные адреса. {% hint style="warning" %} Обратите внимание, что прямые ссылки на WhatsApp для кнопок запрещены! Вы получите ошибку: «Direct links to WhatsApp aren't allowed for buttons» а ваш шаблон не будет согласован. {% endhint %} Кроме кнопок типа призыва к действию «CTA», вы можете добавить кнопки с быстрыми ответами:
Задать значение конечных переменных при использовании подобного шаблона можно при отправке его из приложения в карточке или в роботах. Подробнее об использовании шаблона с переменными в статье [Отправка шаблонов и сообщений из приложения в карточке](/ispolzovanie/otpravka-i-poluchenie-soobshenii/otpravka-shablonov-i-soobshenii-iz-prilozheniya-v-kartochke#shablony). ### Создание шаблона с изображениями Если вы хотите создать шаблон, в котором присутствует возможность при отправке через приложение в карточке или с помощью роботов подставлять в него изображения, вам необходимо создать и согласовать такой шаблон, заранее указав в заголовке шаблона возможность подстановки изображений. Для этого выберите «Медиа» и установите чекбокс на иконке «Изображение». Загрузите образец изображения с соблюдением требований:
### Отправка шаблона на согласование После ввода всей необходимой информации, справа в Preview (в поле предпросмотра) отобразится готовый сформированный шаблон и пример, как он будет выглядеть.
Для отправки созданного шаблона сообщения на согласование, нажмите на кнопку «Предварительный просмотр и отправка». В открывшемся окне предпросмотра шаблона нажмите на кнопку «Отправить».
После отправки шаблон появится в списке шаблонов в статусе «Отправлено»:
{% hint style="info" %} Обычно новый шаблон рассматривается и согласовывается в течение 24 часов. {% endhint %} Все согласованные шаблоны находятся в разделе «Утверждено» и доступны для отправки через приложение и роботов.
# Описание категорий шаблонов {% hint style="info" %} Данные о категориях шаблонов и примерах использования получены [из официальной документации Meta\*](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines) в целях сохранения достоверности информации. {% endhint %} ## Категория «Маркетинг» Шаблоны категории «Маркетинг» бывают очень разными. Они позволяют компаниям достичь самых разных целей: от повышения узнаваемости до увеличения продаж и др. {% hint style="info" %} Примеры приведены только для иллюстрации. Шаблоны, содержащие аналогичный контент или такой же текст, могут категоризироваться по-разному в зависимости от их содержания. {% endhint %}
ЦельБизнес-цельПримеры шаблонов
УзнаваемостьПовышение узнаваемости компании, товаров или услуг среди клиентов, которые подписались на сообщения от ваше компании в WhatsApp.
  • «А вы знаете, что мы установили в вашем районе новую вышку, чтобы улучшить подключение к сети? Все подробности на нашем сайте: {{1}}».
  • «Думаете, куда поехать этим летом? У нас только что открылся новый курорт {{1}}: идеальное место, чтобы расслабиться и отдохнуть. Подробная информация: {{2}}»
ПродажиОтправка клиентам промо-предложений общего характера, связанных с мероприятиями, купонами и другого контента, направленного на увеличение продаж.
  • «В знак благодарности за ваш последний заказ мы предлагаем вам скидку 15 % на следующий. Введите код ___ при оформлении заказа. Наш сайт: {{1}}».
  • «Рекомендуйте и экономьте! По коду FRIEND вы и ваш друг получите скидку 10 долларов на следующий заказ».
  • «Не забудьте! Только сегодня вы получите удвоенные баллы за свои покупки. Зайдите в ближайший магазин и назовите свой номер телефона на кассе».
РетаргетингПродвижение актуальных предложений и другие призывы к действию для клиентов, которые, возможно, посещали ваш сайт, пользовались вашим приложением или интересовались вашими товарами и услугами.
  • «Не пропустите свои любимые сериалы! Продлите подписку сейчас: {{1}}»
  • «У вас в корзине остались товары! Не беспокойтесь, мы сохранили их. Купите их сейчас: {{1}}».
  • «Спасибо за посещение нашего сайта. Мы оформим вашу медицинскую страховку в несколько простых действий. Продолжите здесь: {{1}}».
Продвижение приложенияПредложение установить ваше приложения или выполнить в нем какое-либо действие
  • «А вы знаете, что заказ можно оформить в нашем приложении? Скачайте его здесь {{1}}, чтобы быстро оформить заказ».
  • «Благодарим за использование нашего приложения. Мы заметили, что вы не пользуетесь нашей новой функцией, {{1}}. Нажмите здесь {{2}}, чтобы узнать, чем она может быть вам полезной!»
  • «Здравствуйте, {{1}}! Ваш друг или подруга {{2}} недавно присоединился к нашему сообществу. Отправьте ему или ей приветственное сообщение: {{1}}»
Построение отношений с клиентамиУкрепление отношений с клиентами посредством персонализированных сообщений
  • «{{1}}, вы думаете, мы забыли? Вот уж нет! С днем рождения! Желаем всего наилучшего».
  • «Год заканчивается, и мы думаем о том, ради кого работаем: о вас. Спасибо, что вы наш клиент. Мы ценим это. Надеемся, что вы и далее будете пользоваться нашими услугами».
Также шаблонами категории «Маркетинг» считаются: * шаблоны со смешанным контентом (например, относящимся к категориям «Услуги» и «Маркетинг», в том числе обновление информации о промоакцией или предложением); * шаблоны с контентом, категорию которого трудно определить (например, сообщение содержит только текст “{{1}}” или “Поздравляем!”). ## Категория «Услуги» Шаблоны категории «Услуги» обычно запускаются в результате действия и запроса пользователя. Они должны содержать конкретные сведения об активной или текущей транзакции, счете, подписке или взаимодействии, к которым они относятся. Например, в подтверждении заказа должен содержаться номер этого заказа. {% hint style="info" %} Примеры приведены только для иллюстрации. Шаблоны, содержащие аналогичный контент или такой же текст, могут категоризироваться по-разному в зависимости от их содержания. {% endhint %} | Цель | Бизнес-цель | Примеры шаблонов | | --------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Управление согласием | Подтверждение согласия на получение сообщений в WhatsApp после получения согласия по другим каналам (например, через сайт или электронное письмо). Также относится к подтверждению отказа. |
  • «Спасибо за подтверждение согласия! Вы в списке. Теперь вы будете получать сообщения в WhatsApp».
  • «Благодарим за подтверждение отказа. Вы больше не будете получать от нас сообщения в WhatsApp».
| | Управление заказами | Подтверждение, обновление и отмена заказов или транзакций для клиента с указанием конкретных сведений о заказе или транзакции в тексте сообщения. |
  • «Благодарим! Ваш заказ {{1}} подтвержден. Мы сообщим вам, как только отправим пакет». «Ура! Ваш пакет с заказом {{1}} уже в пути. Вот номер для отслеживания: {{2}}. Ожидаемая дата доставки: {{3}}».
  • «К сожалению, один из товаров в вашем заказе {{1}} распродан. Мы сообщим вам ожидаемую дату поставки. Если вы хотите отменить заказ или получить возврат средств, нажмите здесь: {{2}}»
| | Оповещения и обновления по счетам |

Отправка важных обновлений по счетам, в том числе своевременных предупреждений, информации о безопасности, напоминаний о платежах и другой информации, относящейся к уже приобретенным товарам или услугам, на которые подписался пользователь.

Эти сообщения не должны подразумевать продажу более дорогих товаров и услуг или перекрестные продажи.

|
  • «Ежедневное обновление для счета, который заканчивается на {{1}}: Ваш баланс: {{2}}».
  • «Напоминаем: ваш ежемесячный платеж за подписку {{1}} будет списан с сохраненной карты {{2}}».
  • «Чтобы закончить настройку профиля, загрузите фото здесь: {{1}}».
  • «Заказанный вами {{2}} товар {{1}} отозван. Подробная информация: {{3}}».
| | Опросы |

Сбор отзывов о сделанных заказах, взаимодействии или текущих отношениях с клиентами.

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

|
  • «Мы получили ваш заказ {{1}}! Пожалуйста, расскажите, легко ли было с нами работать: {{2}}».
  • «Выши отзывы помогают нам постоянно совершенствоваться. Пожалуйста, поделитесь своим мнением о недавнем посещении нашего {{2}} здесь: {{1}}. Заранее спасибо!»
  • «Недавно вы разговаривали с нами онлайн о вашем заказе {{1}}. Как всё прошло? Пожалуйста, пройдите короткий опрос: {{2}}».
| | Продолжение переписки |

Отправка сообщений для переноса взаимодействия, начавшегося в другом канале, в WhatsApp.

Эти сообщения нельзя начинать, если клиент не запросил перенос переписки в WhatsApp.

|
  • Здравствуйте {{1}}! Мы продолжаем обработку вашего запроса, отправленного через онлайн-чат. Пожалуйста, дайте знать, если вопрос еще актуален.
  • {{1}}, добрый день! Мы получили ваше обращение в онлайн-чате и продолжаем работу над ним в WhatsApp.
  • «Здравствуйте, {{1}}! Вы звонили в нашу службу поддержки {{2}}. Ваш вопрос перешел на следующий этап. Чтобы продолжить, войдите в своей аккаунт: {{3}}».
| ## Категория «Аутентификация» {% hint style="info" %} Для отправки одноразового пароля для подтверждения личности можно использовать только шаблоны категории «Аутентификация». Шаблоны категорий «Маркетинг» и «Услуги» для этого не используются. {% endhint %} С помощью шаблонов категории «Аутентификация» вы помогаете пользователям проходить аутентификацию, используя одноразовые коды (обычно 4–8-значные буквенно-цифровые коды), например в процессе многошагового входа (подтверждение аккаунта, восстановление аккаунта, проблемы с целостностью аккаунта). Шаблоны категории «Аутентификация» имеют наибольшие ограничения. Для создания шаблона в категории «Аутентификация» компания должна: * Использовать для аутентификации предустановленные шаблоны сообщений WhatsApp, которые содержат такие необязательные дополнения, как отказ от ответственности и предупреждения об истечении срока действия. * Настроить кнопку одноразового пароля (для копирования кода или подтверждения одним нажатием). * Соблюдать ограничения в отношении контента (контент и параметры шаблонов категории «Аутентификация» не должны содержать URL, медиафайлы и смайлики). Кроме того, максимальная длина параметров — 15 символов. | Определение | Примеры | | ------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Код аутентификации |
  • «Ваш код подтверждения: {{1}}». «Ваш код подтверждения: {{1}}. Из соображений безопасности никому не сообщайте этот код».
  • «Ваш код подтверждения: {{1}}. Срок действия этого кода истекает через 15 минут».
| *(\*) Meta — признана экстремистской организацией на территории РФ.* # Причины отклонения шаблонов и рекомендации по их исправлению ### Неправильное форматирование шаблона WhatsApp может отклонить шаблон из-за неправильного форматирования. Возможные причины: 1. Длина текста в шаблоне более 550 символов. 2. Орфографические или грамматические ошибки. 3. Несоответствие языка шаблона и текста. 4. Использование сервисов сокращения URL (уникального адрес ресурса), например, bit.ly, tinyurl, goo.gl. 5. Домен в URL не связан с вашей компанией. 6. Наличие более 10 эмодзи в тексте шаблона. 7. Использование эмодзи в кнопках. 8. Содержание шаблона не соответствует выбранной категории. Рекомендации: * Составляйте шаблон из текста, длина которого не превышает 550 символов. Вместе с переменными можно использовать до 1024 символов. В таком случае, например, при длинном адресе клиента, и при условии, что адрес заполнен как переменная, данный текст не идёт в счёт ограничения в 550 символов. * Проверять соответствие шаблона категории перед отправкой. * Проверять соответствие языка шаблона и текста, наличие орфографические и грамматические ошибок, наличие сокращенных ссылок, корректность ссылок. * Избегайте использование эмодзи в кнопках и минимально используйте в тексте при необходитмости. ### Ошибки в переменных параметрах 1. Отсутствие или неправильное форматирование фигурных скобок. 2. Использование специальных символов. 3. Несоответствие последовательности переменных. Рекомендации: * Убедитесь, что переменные параметры оформлены правильно, например, {{1}}. * Избегайте использования символов #, $, % и других специальных символов в переменных параметрах. * Убедитесь, что переменные последовательные. Например, если определены {{1}}, {{2}}, {{4}}, {{5}}, то {{3}} также должна существовать. ### Дублирование шаблонов Если текст в теле и нижнем колонтитуле шаблона совпадает с уже существующим шаблоном, такой дубликат будет отклонен. Рекомендации: * Проверяйте шаблоны на совпадения перед отправкой на согласование. ### В содержании шаблона есть оскорбление, угроза, подозрение на мошенничество или обман Meta\* может отклонить шаблон, если считает его оскорбительным, содержащим угрозы или вводящим в заблуждение. Рекомендации: * Исключите двусмысленные слова и фразы, подберите синонимы. * Избавьтесь от недосказанности. * Пересмотрите структуру и порядок предложений. * Убедитесь, что смысл шаблона ясен даже нейросети Meta\*. ### Слишком рекламный шаблон Meta\* может отклонить шаблон, если он слишком рекламный, даже в категории «Маркетинг». Чтобы снизить риск жалоб пользователей и возможной блокировки шаблонов или аккаунта, рекомендуется добавлять в маркетинговые рассылки кнопку **«Отписаться»**. Эта кнопка даёт получателю простой и понятный способ отказаться от дальнейших маркетинговых сообщений, не прибегая к жалобе. #### Когда стоит добавлять кнопку «Отписаться» Рекомендуется использовать кнопку в следующих случаях: * В шаблонах категории **«Маркетинг»**. * В первом маркетинговом сообщении, которое получает клиент. * В первом сообщении после длительного перерыва в рассылках. * В сообщениях для клиентов, которые давно не совершали покупок. **Не рекомендуется** добавлять кнопку во все шаблоны подряд — это может спровоцировать излишнюю отписку активных клиентов. #### Как добавить кнопку в шаблон в GupShup. Как создать шаблон с кнопками, подробно описано [здесь.](https://waba.docs.olchat.io/lichnyi-kabinet-gupshup/sozdanie-i-upravlenie-shablonami-soobshenii#sozdanie-shablona-s-knopkami) #### Обработка нажатия на кнопку Когда клиент нажимает кнопку «Отписаться», в ОЛ приходит входящее сообщение с текстом кнопки. Рекомендуемый порядок действий: * Автоматически исключите номер из списков маркетинговых рассылок. * Отправьте подтверждение: «Вы успешно отписались от маркетинговых рассылок». Подробнее можно ознакомиться [здесь](https://waba.docs.olchat.io/keisy/otpravka-shablona-soobsheniya-s-knopkami-i-obrabotka-otvetov-robotom-ozhidanie-soobsheniya). #### Важные рекомендации * Кнопка «Отписаться» не отменяет возможность писать клиенту по сервисным и другим шаблонам (уведомления о заказах, доставке, оплате и т. д.). * Всегда тестируйте шаблон с кнопкой перед массовой отправкой. Добавление удобной кнопки отписки — один из самых эффективных способов сохранить высокий рейтинг аккаунта и избежать блокировок шаблонов. ### Нарушение политики WhatsApp Business и торговой политики WhatsApp Шаблон может быть отклонен, если нарушает торговую политику, например, предлагает запрещенные товары. Также шаблон может быть отклонен, если запрашивает конфиденциальные данные, такие как полные номера банковских карт. С политикой вы можете ознакомиться [здесь](https://business.whatsapp.com/policy). *(\*) Meta — признана экстремистской организацией на территории РФ.* # Почему шаблоны могут долго находиться на модерации? Обычно новый шаблон согласовывается в течение 24 часов. Чаще всего шаблоны могут находиться долго на модерации, если аккаунт не верифицирован. ### Какие можно предпринять действия? 1. При зависании шаблона более, чем на 5-10 минут создайте новый с измененным текстом. Прошлый шаблон необходимо удалить. 2. Пройти [верификацию](https://waba.docs.olchat.io/bystryi-start/podtverzhdenie-kompanii-v-facebook-business-manager#poryadok-deistvii-dlya-prokhozhdeniya-procedury-verifikacii). # Порядок действий для прохождения процедуры верификации Для того, чтобы использовать WhatsApp Business API, необходимо произвести создание бизнес-портфолио в Meta\* Business Suite и Business Manager, затем пройти процедуру подтверждения вашей компании. {% hint style="danger" %} При создании бизнес-портфолио особое внимание обратите на то, чтобы наименование юридического лица, описание бизнеса, адреса и контакты совпадали и в Business Manager, и на вашем сайте, и в созданном аккаунте и профиле WhatsApp Business! В противном случае, вы можете столкнуться с блокировкой аккаунта WhatsApp Business API со стороны Meta\* без предупреждений! {% endhint %} ## Процедура подтверждения компании 1. Откройте страницу [настройки компании](https://business.facebook.com/settings). Если в кабинете добавлено несколько компаний, выберите нужную:
2. Нажмите Информация о бизнес-портфолио. Проверьте, что вся информация заполнена верно и полно. Чтобы компанию подтвердили с первого раза и вам не пришлось отправлять документы повторно, проверьте, что информация в документах один в один совпадает с тем, что написано в разделе Информация о бизнес-портфолио. Даже пробелы, кавычки и другие символы должны быть одинаковыми. Если информация отличается – исправьте ее в разделе или в документах.
3. Подготовьте документы. Для верификации компании вам потребуется загрузить документы, подтверждающие: * Название компании и факт ее существования. Для этого используйте ИНН. * Адрес компании. Его можно подтвердить справкой из банка или счетом за коммунальные услуги. Важно, чтобы название компании на справке было написано так же, как в ИНН. * Номер телефона. Его можно подтвердить счётом за услуги связи или справкой из банка, для этого попросите сотрудника банка прописать в справке номер телефона. 4. Перейдите в [Центр безопасности](https://business.facebook.com/settings/security) в Business Manager. Нажмите Начать подтверждение. 5. По завершении нажмите Готово. Meta\* может принять решение по вашей заявке за время от 10 минут до 14 рабочих дней после ее отправки. По завершении проверки вы получите уведомление. Если вы получили уведомление о том, что ваша компания подтверждена, больше ничего делать не нужно. {% hint style="info" %} При возникновении проблем с подтверждением компании ознакомьтесь с рекомендациями: {% endhint %} {% embed url="" %} *(\*) Meta — признана экстремистской организацией на территории РФ.* # Синяя галочка WhatsApp - что это и как получить? Голубая галочка WhatsApp - это новейший значок проверки, заменивший старый. Верификация, обозначающий предприятие, которое прошло проверку подлинности и известности на сайте Meta\*. Ознакомиться с порядком действия для прохождения верификации можно [здесь](https://waba.docs.olchat.io/verifikaciya/poryadok-deistvii-dlya-prokhozhdeniya-procedury-verifikacii). {% hint style="info" %} Подробнее о процедуре получения зелёной галочки и названия компании вместо номера в инструкции по ссылке: {% endhint %} ## Какие критерии для получения синей галочки? Для получения синей галочки WhatsApp компании должны соответствовать определенным критериям, которые подтверждают их легитимность и укрепляют доверие к платформе. Эти требования включают: 1. **Использование бизнес-аккаунта WhatsApp:** Ваш бизнес должен активно использовать приложение WhatsApp Business API и соблюдать политику WhatsApp для бизнеса. Это подтверждает законность и эффективность использования платформы. 2. **Подтвержденная учетная запись**: Для верификации требуется подтвержденная учетная запись **Facebook Business Manager\***. 3. **Включение двухэтапной верификации:** Активация этой функции повышает безопасность вашей учетной записи, защищая ее от несанкционированного доступа. 4. **Проверка через Meta\* / Facebook Business Manager\*:** Компании должны подтвердить свои аккаунты, предоставив действительные документы, что важно для подтверждения легитимности бренда. 5. **Демонстрация заметности:** Meta\* оценивает известность на основе частоты поиска компании. Предоставление 3-5 достоверных ссылок на СМИ из надежных источников может усилить вашу заявку. ## Зачем бизнесу нужна синяя галочка в WhatsApp? 1. **Укрепление доверия и авторитета:** подтвержденный значок делает ваш бизнес более легитимным и надежным, снижая сомнения у потенциальных клиентов. 2. **Повышение доверия клиентов:** верифицированные аккаунты имеют более высокие показатели вовлеченности, что способствует уменьшению спама и улучшению качества взаимодействия. 3. **Повышение эффективности рекламы:** верифицированные компании достигают лучших результатов в рекламе на платформах Meta\*, что усиливает маркетинговые усилия в WhatsApp. Синяя галочка служит сигналом доверия, побуждая пользователей взаимодействовать с рекламными объявлениями. 4. **Единый брендинг на платформах Meta\*:** система верификации позволяет компаниям поддерживать последовательный брендинг на WhatsApp, Instagram и Facebook, что улучшает узнаваемость и вовлеченность. ## Что произойдет, если ваш бизнес уже проходил ранее верификацию? Для компаний, которые уже имеют верификацию, переход на синюю галочку осуществляется автоматически. Нет необходимости повторно проходить верификацию. Проверенные компании могут продолжать свою деятельность без каких-либо препятствий. *(\*) Meta, Facebook — признана экстремистской организацией на территории РФ.* # Лимиты на отправку сообщений через WhatsApp Business API После подключения к WhatsApp Business API для вашего бизнеса устанавливается суточный лимит на количество уникальных пользователей, с которыми вы можете начать диалог. Это часть системы защиты Meta\* от спама. Лимиты рассчитываются на уровне бизнес-портфолио (все ваши номера делят общий лимит), а не на отдельный номер. {% hint style="info" %} Ограничения касаются только исходящих диалогов, в то время как на входящие сообщения лимитов нет на любом уровне. Это означает, что клиенты всегда могут связаться с вами через номер или с помощью кнопки на сайте. {% endhint %} Всего существует 5 уровней номера WABA. Лимиты на исходящие сообщения на каждом уровне следующие: **Tier-0**: вы можете инициировать 250 уникальных диалогов за 24 часа. **Tier-1**: вы можете инициировать 2 000 уникальных диалогов за 24 часа. **Tier-2**: вы можете инициировать 10 000 уникальных диалогов за 24 часа. **Tier-3**: вы можете инициировать 100 000 уникальных диалогов за 24 часа. **Tier-4**: вы можете инициировать неограниченное количество уникальных диалогов за 24 часа. Сразу после регистрации номера вам будет присвоен либо Tier-0, либо Tier-1. Начальный уровень определяется наличием подтверждённого юридического лица в вашем кабинете Business Manager.
## Повышение Tier-уровня Если у вас сейчас Tier-0 и вы хотите увеличить количество отправляемых сообщений, [необходимо пройти процедуру подтверждения компании](/verifikaciya/poryadok-deistvii-dlya-prokhozhdeniya-procedury-verifikacii). Для этого заполните форму и загрузите необходимые документы в вашем кабинете Meta\*. После успешной модерации вы автоматически перейдете на Tier-1. Начиная с Tier-1 повышение уровня для всех последующих осуществляется одинаково: в течение календарной недели необходимо отправить как минимум вдвое больше текущего дневного лимита. Например, если вы хотите перейти на Tier-2, вам нужно отправить около 3000 сообщений. Учитываются только те сообщения, которые были доставлены клиентам. Ещё один важный параметр – показатели качества. Если вы будете отправлять сообщения на неподготовленную аудиторию, антиспам протоколы WhatsApp быстро это обнаружат и не повысят ваш уровень. Одной из основных причин снижения качества являются жалобы пользователей на ваши сообщения и их пометка как «спам». Чтобы улучшить показатели, отправляйте триггерные сообщения только тем клиентам, которые их ожидают. Промо-акции или массовые рассылки лучше отложить или добавить в них возможность отписки. *(\*) Meta — признана экстремистской организацией на территории РФ.* # Лимиты на отправку шаблонных сообщений Существуют лимиты на отправку шаблонных сообщений из категории «Маркетинговых»: 1. 2 подряд любых маркетинговых шаблона с одного аккаунта WABA клиенту доставятся. 3-й (любой), если не было ответа клиента вызовет ошибку при отправке и не отправится 2. Если в течение 24ч клиент получил 4 маркетинговых шаблона от любых бизнесов/WABA, 5-й (любой) также вызовет ошибку при отправке и не отправится. 3. Если в течение 7 дней клиент получил 10 маркетинговых шаблонов от любых бизнесов/WABA, 11-й (любой) также вызовет ошибку при отправке и не отправится. При превышении лимитов в момент отправки сообщения вы получите следующую ошибку: «Маркетинговое ограничение на рассылку сообщений» код ошибки #131049.
Если вы достигли лимита делая рассылку, то при наведении на статус «Не отправлено» вы увидите аналогичную ошибку:
# Отправка и получение сообщений # Отправка шаблонов и сообщений из приложения в карточке Для отправки стандартных сообщений или шаблонных из карточки лида, сделки, контакта или компании перейдите в карточку и выберите приложение «Олчат WABA»:
### Канал При отправке можно выбрать канал, через который вы планируете отправлять сообщение. ### Телефон В списке указаны все номера, которые привязаны к карточке контакта и на которых есть аккаунт WhatsApp. ### Создание чата Если вы хотите создать чат открытой линии и пригласить туда сотрудников портала для общения с клиентом, нажмите на кнопку «СОЗДАТЬ ЧАТ». Чтобы начать новый диалог с клиентом, отправьте ему [шаблонное сообщение из открытой линии. ](/ispolzovanie/otpravka-i-poluchenie-soobshenii/shablony) {% hint style="info" %} При нажатии на кнопку «СОЗДАТЬ ЧАТ», создающийся чат распределяется не в общую очередь Открытой линии или на ответственного сотрудника, а сразу на его создателя. {% endhint %} ### Шаблоны Если вы хотите начать новый диалог с клиентом, отправьте ему шаблонное сообщение. Шаблонные сообщения – это сообщения добавленные в кабинете GupShup и заранее согласованные с Meta\* . Подробнее про создание и управление шаблонами сообщений в статье [Создание и управление шаблонами сообщений](/lichnyi-kabinet-gupshup/sozdanie-i-upravlenie-shablonami-soobshenii) После выбора нужного шаблона он отобразится в окне предпросмотра:
Если выбранный шаблон содержит переменные, вы можете внести их в соответствующие поля. После заполнения в окне предпросмотра сообщения вы увидите итоговый текст отправляемого шаблонного сообщения:
Если выбранный шаблон предполагает использование изображений, в качестве изображения в параметр «Ссылка на изображение» может быть подставлена прямая ссылка на изображение:
{% hint style="info" %} Данный пример рассматривает отправку шаблонного сообщения с изображением, но принцип работы подходит также и под отправку шаблона с документом, аудио- или видеофайлом. {% endhint %} Изображение также может храниться на диске портала Битрикс24. Чтобы использовать в шаблоне сохранённое на Битрикс.Диске изображение, в поле «Ссылка на изображение» подставьте параметр: > DISK\_ID В данном параметре ID (идентификатор) — это ID файла на Битрикс.Диске. Узнать ID файла можно тут:
Пример использования шаблона с изображением, хранящимся на Битрикс.Диске:
При использовании шаблона данного типа, клиент получит следующее сообщение в WhatsApp:
В Открытой линии текст шаблона и изображение будут не видны. Вместо этого в чате будет информация о том, что был отправлен шаблон, и детали о нём — наименование шаблона и наличие изображения.
{% hint style="warning" %} Размер изображения, отправляемого клиенту, должен быть 800×800 пикселей. В таком случае изображение в WhatsApp, при прочтении сообщения, обрезаться не будет. {% endhint %} {% hint style="info" %} Подробнее о создании шаблонных сообщений с изображениями в статье [Создание и управление шаблонами сообщений](/lichnyi-kabinet-gupshup/sozdanie-i-upravlenie-shablonami-soobshenii#sozdanie-shablona-s-izobrazheniyami). {% endhint %} ### Стандартные сообщения
{% hint style="info" %} Выбрать для отправки Стандартные сообщения вы можете в том случае, если у вас отрыто 24-х часовое окно переписки с клиентом. Возможность отправки Стандартного сообщения определяется с помощью таймера, который показывает оставшееся время до закрытия 24-х часового окна. {% endhint %} **Сообщение** — тут можете писать сообщение длиной около 1000 символов. Если нужны эмодзи, воспользуйтесь меню в правом верхнем углу. **Файл** — для прикрепления файла выберите файл на компьютере. **Публиковать в чате** — если значение активно, то отправленное сообщение будет опубликовано и в чате открытой линии, и в таймлайне карточки сущности. Если чат открытой линии не был создан до этого, то он будет создан после публикации сообщения. Если данная настройка отключена, отправленное сообщение будет видно только в таймлайне карточки. *(\*) Meta — признана экстремистской организацией на территории РФ.* # Как отправить шаблон из чата Открытой линии Олчат WABA позволяет удобно работать с шаблонными сообщениями WhatsApp Business API прямо внутри интерфейса Битрикс24. Один из самых удобных способов — в поле ввода сообщения чата Открытой линии.
Это решение особенно полезно для менеджеров, которые часто отправляют однотипные сообщения: приветствия, уведомления, коммерческие предложения и т.д. ## Создание шаблонов Для создания шаблонов необходимо перейти в личный кабинет провайдера GupShup. Подробнее можно ознакомиться [здесь](/lichnyi-kabinet-gupshup/sozdanie-i-upravlenie-shablonami-soobshenii). ## Включение встроенной панели шаблонов в чатах Функция **Шаблоны в чате** должна быть активна: 1. Перейдите в настройки приложения.
2. Откройте вкладку **Виджеты**.
3. Найдите пункт **Виджет отправки шаблонов для ОЛ** и включите его. ## Отправка шаблонов из чата Открытой линии 1. Откройте нужный чат. 2. В поле ввода сообщения нажмите на иконку выбора шаблонов (сетка / 4 квадратика).
3. Выберите раздел **Олчат WABA — отправка сообщений**.
4. Выберите шаблон и заполните параметры. 5. При необходимости отредактируйте сообщение и отправьте. ## Отправка шаблонов из [карточки сущности](/ispolzovanie/otpravka-i-poluchenie-soobshenii/otpravka-shablonov-i-soobshenii-iz-prilozheniya-v-kartochke) 1. Откройте карточку лида, сделки, контакта или компании. 2. Запустите приложение **Олчат WABA**. 3. Перейдите на вкладку **ШАБЛОНЫ**. 4. Выберите шаблон, заполните переменные при необходимости. 5. Отправьте сообщение.
# Отправка сообщений через функционал СМС Для отправки шаблонных и стандартных сообщений из карточки Лида, Сделки, Контакта, Компании, рассылок через Маркетинг или для отправки ссылок на оплату в Центре продаж можно воспользоваться функционалом отправки СМС. {% hint style="warning" %} Наш сервис не отправляет СМС-сообщения! Он позволяет отправить сообщение в WhatsApp через функционал СМС. Для отправки именно СМС-сообщений, на вашем портале Битрикс24 должен быть подключён провайдер СМС. {% endhint %} Для отправки сообщений через функционал СМС, в таймлайне карточки сущности перейдите на вкладку «СМС»:
Нажмите на «Подробнее» чтобы выбрать нужный сервис:
В качестве сервиса для отправки выберите коннектор Олчат WABA:
{% hint style="info" %} Вы можете столкнуться с ситуацией, когда провайдер Олчат WABA не появляется в выборе сервисов отправки. При возникновении такой ситуации, перейдите в приложение Олчат WABA. На вкладке «СОЕДИНЕНИЕ» проверьте, что линия оплачена а статус соединения с провайдером активен. На вкладке «НАСТРОЙКИ» проверьте, что в настройках чата активирован чекбокс в пункте «Включить СМС провайдера». {% endhint %}
### Отправка шаблонного сообщения Если вы хотите начать новый диалог с клиентом и у вас не отрыто 24-х часовое окно переписки с клиентом, отправьте ему шаблонное сообщение. Шаблонные сообщения – это сообщения добавленные в кабинете GupShup и заранее согласованные с Meta\* . Подробнее про создание и управление шаблонами сообщений в статье [Создание и управление шаблонами сообщений](/lichnyi-kabinet-gupshup/sozdanie-i-upravlenie-shablonami-soobshenii). Для отправки шаблонного сообщения, его необходимо заранее сформировать. Подробнее о том, как сформировать шаблон в статье [Получение параметров шаблонов](/vozmozhnosti/poluchenie-parametrov-shablonov). В текст СМС-сообщения необходимо подставить готовую, сформированную ранее конструкцию шаблона и нажать на кнопку «ОТПРАВИТЬ»:
После отправки данной конструкции, клиент получит шаблонное сообщение в WhatsApp в следующем преобразованном виде:
В таймлане карточки факт отправки также зафиксируется и создастся дело «Отправлено СМС-сообщение»:
Для отправки шаблонного сообщения с изображением, скопируйте необходимый шаблон, заранее подставив ссылку на изображение. Ссылка может быть прямой, либо в виде параметра DISK\_ID, позволяющего использовать в шаблонах изображения, которые хранятся на Битрикс.Диске портала. Воспользуйтесь [данной инструкцией](/roboty-i-aktiviti/nastroika-otpravki-faila-v-zavisimosti-ot-istochnika) для работы с типом источников файла. {% hint style="info" %} Данный пример рассматривает отправку шаблонного сообщения с изображением, но принцип работы подходит также и под отправку шаблона с документом, аудио- или видеофайлом. {% endhint %} На примере отправка сообщения с изображением через функционал СМС с использованием шаблонов будет выглядеть так: Откройте приложение Олчат WABA, выберите шаблон и подставьте ссылку на изображение.
Нажмите кнопку «Скопировать шаблон». В буфер обмена будет скопировано следующее: > \[template=ru]kartinka\[/template]\[header=image]DISK\_3283\[/header] В данном случае kartinka — название шаблона, а DISK\_3283 — ссылка на изображение, хранящееся на Битрикс.Диске, которое будет отправлено вместе с сообщением. Вставьте текст скопированного шаблона в чат с клиентом и отправьте его через функционал СМС, выбрав коннектор Олчат WABA.
В таймлане карточки факт отправки также зафиксируется и создастся дело «Отправлено СМС-сообщение»:
### Отправка Стандартного сообщения Если у вас отрыто 24-х часовое окно переписки с клиентом, вы можете отправить обычное сообщение в свободной форме. Напишите текст сообщения и нажмите «Отправить»:
Факт отправки сообщения зафиксируется в таймлайне:
Определить, открыто ли 24-часовое окно для отправки стандартных сообщений, вы можете с помощью таймера обратного отсчёта в приложении Олчат WABA. Подробнее в статье [Отправка шаблонов и сообщений из приложения в карточке](/ispolzovanie/otpravka-i-poluchenie-soobshenii/otpravka-shablonov-i-soobshenii-iz-prilozheniya-v-kartochke#liniya-1) *(\*) Meta — признана экстремистской организацией на территории РФ.* # Отправка сообщений из мобильного приложения Битрикс24 Для того, чтобы отправить сообщение клиенту из мобильного приложения Битрикс24 через Олчат WABA, необходимо проделать следующие действия: {% stepper %} {% step %} Если с клиентом не открыто 24-часовое окно диалога, то есть за последние сутки вы не использовали WABA для общения с клиентом, диалог необходимо начать с отправки шаблона. {% hint style="info" %} Чтобы создать шаблон, воспользуйтесь [данной ](/lichnyi-kabinet-gupshup/sozdanie-i-upravlenie-shablonami-soobshenii)инструкцией. {% endhint %} Чтобы скопировать шаблон, выполните следующее: 1. Зайдите с веб-версии Битрикс24 в карточку лида, выберите «Олчат WABA». 2. Укажите коннектор, к которому привязан шаблон, затем перейдите во вкладку «Шаблоны». 3. Выберите желаемый шаблон из выпадающего списка, далее нажмите «Скопировать шаблон».
Сохраните шаблон на мобильном устройстве в удобном месте, например, в личных заметках на портале Битрикс24, либо попросите коллег выслать вам необходимый шаблон. {% endstep %} {% step %} Откройте CRM (систему управления взаимоотношениями с клиентами) своего портала Битрикс24 в мобильном приложении и воспользуйтесь поиском по лидам, сделкам или контактам, чтобы найти необходимого клиента. Например, найти клиента можно по сохраненному имени в карточке лида, названию сделки или по номеру телефона (вводите номер в любом формате — начиная с 7, +7 или 8).
{% hint style="info" %} Если у вас отсутствует кнопка CRM в нижнем меню мобильной версии Битрикс24, измените настройки отображения пунктов: выберите «Ещё» в нижнем меню — «Нижнее меню» — «Своё меню». {% endhint %} {% endstep %} {% step %} В карточке клиента перейдите в «Таймлайн», затем нажмите кнопку и выберите «Отправить СМС».
{% endstep %} {% step %} В открывшемся окне нажмите на , чтобы указать коннектор, к которому привязан шаблон, и с помощью которого будет отправлено сообщение клиенту, а также выберите СМС-сервис.
{% endstep %} {% step %} В текстовое поле вставьте скопированный шаблон и нажмите «Отправить». {% hint style="info" %} Если шаблон содержит переменные, не забудьте указать их. {% endhint %}
{% endstep %} {% step %} Клиент получит сообщение на WhatsApp следующего вида:
{% endstep %} {% step %} В таймлайне (в хронологии) будет зафиксирована успешная отправка сообщения.
В случае возникновения ошибки при отправке сообщения, вы увидите информацию об этом в таймлайне:
В причинах возникновения ошибки можно разобраться, попытавшись отправить сообщение с помощью Олчат WABA через веб-версию Битрикс24. {% endstep %} {% endstepper %} # Виджеты Статья документации находится в разработке, скоро здесь появится информация. # Виджет статусов и отправки в карточке CRM Статья документации находится в разработке, скоро здесь появится информация. # Виджет отправки шаблонов для Открытой Линии Статья документации находится в разработке, скоро здесь появится информация. # REST API для рассылок и отчётности Клиентское REST API позволяет запускать рассылки по шаблонам WhatsApp Business API и забирать статистику доставки из своих систем: CRM, BI-панели, скрипты автоматизации. API работает по модели «запрос — ответ»: вы сами обращаетесь к сервису тогда, когда вам нужны данные. Исходящих вебхуков на вашу сторону сервис не отправляет. {% hint style="info" %} По умолчанию в ответах приходят метаданные сообщения, значения параметров шаблона и статусы доставки — без содержимого переписки. Тексты сообщений передаются, если вы явно запросите их параметром `include_text`; это сделано для того, чтобы уже написанная интеграция не начала получать переписку без вашего ведома. {% endhint %} ## Список методов | Метод | Назначение | | --------------------------- | --------------------------------------------------------------------- | | `messages.send.template` | Отправить одно сообщение по шаблону | | `messages.status.get` | Статусы доставки по идентификаторам сообщений или по номеру | | `messages.history.list` | История сообщений линии за период с фильтрами и пагинацией | | `messages.stats.get` | Счётчики за период: отправлено, доставлено, прочитано, ошибки, ответы | | `templates.list` | Шаблоны линии, одобренные провайдером | | `templates.analytics.get` | Аналитика провайдера по шаблонам рядом с нашими счётчиками | | `campaigns.create` | Создать черновик рассылки | | `campaigns.recipients.add` | Загрузить получателей в черновик | | `campaigns.start` | Запустить рассылку | | `campaigns.cancel` | Остановить выполняющуюся рассылку | | `campaigns.list` | Список рассылок портала | | `campaigns.stats.get` | Воронка по рассылке | | `campaigns.recipients.list` | Построчный отчёт по получателям рассылки | | `line.status.get` | Состояние одной линии | | `portal.status.get` | Состояние всех линий портала | Пустой метод (обращение к базовому адресу) отдаёт этот же список в машинном виде — с обязательными и необязательными параметрами каждого метода и действующими лимитами. ## Получение токена Токен выдаётся в приложении Олчат в Битрикс24: «Настройки приложения» — вкладка «REST API» — кнопка «Выдать / перевыпустить токен». Рядом показывается базовый адрес API. Выдать, посмотреть или отозвать токен может только администратор портала Битрикс24: право проверяется в самом Битрикс24 в момент запроса. У остальных сотрудников вкладка показывает надпись «Токен доступен администратору портала». Токен принадлежит порталу целиком, а не отдельной линии: одним токеном вы работаете со всеми подключёнными номерами портала, указывая нужный в параметре `line_number`. Повторное нажатие «Выдать / перевыпустить токен» выдаёт новое значение и одновременно обесценивает прежнее — все интеграции на старом токене сразу начнут получать ошибку `401`. Кнопка «Отозвать» отключает доступ полностью. ## Формат запросов Базовый адрес: ``` https://waba.olchat.io/rest/client/v2/<метод>/ ``` Токен передаётся заголовком `OLChat-Api-Token`. В адресе и в query-строке токен не принимается. Поддерживаются `GET` и `POST`. Простые параметры можно передавать query-строкой или формой, составные (списки получателей, параметры шаблона) — только JSON-телом с `Content-Type: application/json`. Пример: ```bash curl -X POST 'https://waba.olchat.io/rest/client/v2/messages.stats.get/' \ -H 'OLChat-Api-Token: ВАШ_ТОКЕН' \ -H 'Content-Type: application/json' \ -d '{"line_number": 12, "date_from": "2026-07-01", "date_to": "2026-07-31"}' ``` Даты принимаются в формате ISO-8601 (`2026-07-01` или `2026-07-01T10:00:00+03:00`) либо числом секунд epoch. Все даты в ответах — ISO-8601. Список доступных методов и действующие лимиты отдаёт сам сервис по базовому адресу без указания метода. ## Ограничения | Ограничение | Значение | | ----------------------------------- | ----------------------------------------------- | | Частота запросов | 5 запросов за 3 секунды на пару «токен + метод» | | Глубина статистики | 92 дня | | Размер страницы | до 500 записей, по умолчанию 100 | | Получателей в одном запросе | до 1000 | | Аналитика провайдера | до 90 дней, обновляется раз в сутки | | Одновременно выполняющихся рассылок | до 5 на портал | | Окно ожидания ответа | от 1 до 720 часов | Лимит частоты считается отдельно для каждого метода: обращение к `messages.stats.get` не расходует лимит `campaigns.start`. Ответ `429` означает, что запрос не выполнен — его нужно повторить, а не считать неудачей операции. ## Отправка сообщений ### Одно сообщение по шаблону `messages.send.template` отправляет одно сообщение по одобренному шаблону. Заводить ради одного получателя рассылку не нужно. | Параметр | Тип | Описание | | ------------------ | ---- | ------------------------------------------------------------ | | line\_number\* | int | Номер линии | | phone\* | str | Номер абонента в любой записи | | template\_name\* | str | Имя шаблона | | template\_language | str | Язык шаблона, если одно имя используется в нескольких языках | | template\_params | list | Значения подстановок в порядке их следования в шаблоне | В ответе — блок `message` в том же виде, что и в истории: идентификатор сообщения, номер, время создания, имя и язык шаблона, значения подстановок и блок статусов. Идентификатор из ответа используйте дальше в `messages.status.get`. Число переданных подстановок должно совпадать с числом подстановок в шаблоне, иначе метод ответит ошибкой `template_params_mismatch` и сообщение отправлено не будет. Отправка на линию с просроченной оплатой или без подключения отклоняется с `line_not_active`. ## Отчётность ### История сообщений `messages.history.list` — сообщения линии за период с пагинацией и фильтрами. | Параметр | Тип | Описание | | --------------------- | ---- | -------------------------------------------- | | line\_number\* | int | Номер линии | | date\_from\* | date | Начало периода | | date\_to\* | date | Конец периода | | direction | str | `incoming`, `outgoing` или `all` | | phone | str | Номер абонента | | template\_name | str | Имя шаблона | | sent, delivered, read | bool | Фильтр по статусу | | errors\_only | bool | Только сообщения с ошибкой | | page, page\_size | int | Страница и её размер | | include\_text | bool | Добавить текст сообщения и описание вложения | Параметр `include_text: true` добавляет к каждому сообщению его текст. Работает и для входящих, и для исходящих. У сообщения с вложением приходит блок `attachment` с типом вложения и именем файла; само содержимое файла и ссылка на скачивание через API не передаются. Без этого параметра поля `text` и `attachment` в ответе отсутствуют. В ответе — `total`, `page`, `page_size` и массив `messages`. Каждое сообщение содержит `message_id`, `line_number`, `direction`, `phone`, `created_at`, имя, язык и значения параметров шаблона, блок `status` со значениями `sent`/`delivered`/`read` и временем каждого, `status_source`, текст ошибки, признак тарификации и модель тарификации. ### Статус конкретных сообщений `messages.status.get` — состояние доставки по идентификаторам либо по паре «номер абонента + период». | Параметр | Тип | Описание | | -------------------- | ---- | ----------------------------------------------- | | line\_number\* | int | Номер линии | | message\_ids | str | Идентификаторы через запятую | | phone | str | Номер абонента, если идентификаторы не известны | | date\_from, date\_to | date | Период, обязателен при запросе по номеру | | include\_text | bool | Добавить текст сообщения и описание вложения | Идентификатор, не принадлежащий линиям вашего портала, просто отсутствует в ответе — запрос при этом успешен. За один раз принимается не более 500 идентификаторов: на большем количестве метод отвечает ошибкой `too_many_message_ids`, а не отдаёт часть молча. ### Агрегированная статистика `messages.stats.get` — счётчики за период: отправлено, доставлено, прочитано, ошибок, ответов. Обратите внимание на базы счётчиков: `sent`, `delivered`, `read`, `errors` и `total` считаются по всем исходящим сообщениям линии — операторским, роботным и рассылочным. `replied` считается только по получателям рассылок: ответы отслеживаются в окне ответа кампании. Чтобы доля ответов была осмысленной, рядом отдаётся `campaign_sent` — база именно для `replied`. Оба поля есть при `group_by=total`. | Параметр | Тип | Описание | | ------------------------ | ---- | -------------------------------------------- | | line\_number\* | int | Номер линии | | date\_from\*, date\_to\* | date | Период, не длиннее 92 дней | | group\_by | str | `total` (по умолчанию), `day` или `template` | Счётчик `replied` считается по получателям рассылок: сообщения вне рассылок в него не попадают. ### Состояние линий `line.status.get` (параметр `line_number`) и `portal.status.get` (без параметров) отдают номер телефона, статус подключения, признак активности, признак демонстрационного режима и дату оплаты. Ключи доступа к провайдеру в ответах не передаются. ### Список шаблонов `templates.list` (параметр `line_number`) — доступные шаблоны линии: имя, идентификатор, язык, статус согласования, категория и число параметров. Список берётся из того же источника, против которого проверяется отправка, поэтому шаблон из этого метода гарантированно пригоден для рассылки. Если линия не подключена к провайдеру, метод отвечает `line_not_connected`. ## Рассылки Рассылка проходит четыре шага: создание черновика, загрузка получателей, запуск, наблюдение за воронкой. ### Создание рассылки `campaigns.create` | Параметр | Тип | Описание | | -------------------- | ---- | ------------------------------------------ | | line\_number\* | int | Номер линии | | template\_name\* | str | Имя шаблона | | name | str | Название рассылки | | template\_language | str | Язык шаблона, по умолчанию `ru` | | template\_params | list | Значения параметров шаблона по умолчанию | | reply\_window\_hours | int | Окно ожидания ответа, по умолчанию 72 часа | Число значений в `template_params` проверяется по составу шаблона: несовпадение отклоняется с ошибкой `template_params_mismatch`. ### Загрузка получателей `campaigns.recipients.add` — до 1000 получателей за запрос, черновик можно наполнять несколькими запросами. | Параметр | Тип | Описание | | -------------- | ---- | ---------------------- | | campaign\_id\* | int | Идентификатор рассылки | | recipients\* | list | Список получателей | Персональные параметры получателя передаются списком в том же порядке, что и подстановки шаблона. Значение другого типа (например объект `{"1": "Иван"}`) отклоняется с причиной `invalid_params`: раньше такой получатель принимался и получал текст с параметрами кампании вместо своих. Получатель — либо номер строкой, либо объект: ```json { "campaign_id": 17, "recipients": [ "79001234567", {"phone": "79007654321", "external_id": "CRM-4821", "params": ["Иван", "12 августа"]} ] } ``` Персональные значения `params` замещают значения рассылки по умолчанию. Поле `external_id` возвращается обратно в отчётах — по нему удобно сопоставлять получателей со своими записями. Ответ содержит число принятых и список отклонённых с причиной: `invalid_phone` (номер не похож на телефон) или `duplicate` (номер уже есть в этой рассылке). Повторная загрузка того же номера дубля не создаёт, поэтому запрос можно безопасно повторить после обрыва связи. ### Запуск и отмена `campaigns.start` (параметр `campaign_id`) переводит рассылку в работу. Перед запуском проверяются подключение и оплата линии; повторный запуск отвечает `409`. Отправка идёт порциями в фоне, поэтому метод возвращает управление сразу, не дожидаясь конца рассылки. `campaigns.cancel` (параметры `campaign_id`, `reason`) останавливает рассылку: неотправленные получатели переводятся в `skipped`, следующая порция не запускается. Уже отправленные сообщения отменить нельзя — они у абонентов. В ответе кроме `skipped` приходит `in_flight` — число получателей, по которым обращение к провайдеру было разрешено до того, как отмена дошла. Только по ним сообщение ещё может уйти: отозвать отправленный по сети запрос нельзя. Получатели, просто взятые обработчиком в работу, но не дошедшие до отправки, в это число не входят — они переводятся в `skipped` без обращения к провайдеру. Если `in_flight` больше нуля, окончательные статусы этих получателей смотрите в `campaigns.recipients.list` через минуту-другую. ### Наблюдение `campaigns.stats.get` (параметр `campaign_id`) отдаёт воронку: `total`, `pending`, `sent`, `delivered`, `read`, `replied`, `errors`, `skipped`, `no_whatsapp`, `unknown`, а также статус рассылки и время запуска и завершения. `campaigns.recipients.list` (параметры `campaign_id`, `status`, `page`, `page_size`) — построчный отчёт: номер, `external_id`, статус, ошибка, идентификатор сообщения, время отправки, доставки, прочтения и ответа. `campaigns.list` (параметры `line_number`, `status`, `page`, `page_size`) — список рассылок портала. Статусы рассылки: `draft`, `running`, `completed`, `cancelled`. Статусы получателя: `pending` (ожидает), `processing` (в обработке), `success` (отправлено), `error` (ошибка), `skipped` (пропущен при отмене), `no_whatsapp` (на номере нет WhatsApp), `unknown` (результат неизвестен). Статус `unknown` появляется, если обработчик прервался между отправкой и получением ответа провайдера. Автоматически такой номер повторно не отправляется: сообщение могло уйти и уже быть оплачено, а повтор означал бы второе сообщение абоненту и второй счёт. Решение по таким номерам принимаете вы. ## Аналитика шаблонов `templates.analytics.get` показывает значения провайдера рядом с нашими за один и тот же период. | Параметр | Тип | Описание | | ------------------------ | ---- | ----------------------- | | line\_number\* | int | Номер линии | | date\_from\*, date\_to\* | date | Период | | template\_name | str | Один шаблон вместо всех | Данные провайдера выгружаются фоновой задачей раз в сутки, поэтому за сегодняшний день их может ещё не быть. Признак `has_provider_data` и поле `fetched_at` показывают, есть ли выгрузка и насколько она свежая; наши счётчики отдаются в любом случае. Фоновая выгрузка забирает у провайдера последние 30 дней, а запросить можно период до 92 дней. Чтобы частичное покрытие не выглядело полным, в ответе есть блок `provider_coverage` с фактическими границами дат, за которые выгрузка у нас есть. Наши счётчики покрывают весь запрошенный период. Небольшое расхождение между колонками — норма: провайдер считает по своим суткам и включает переходы по кнопкам, которых в нашей статистике нет. ## Коды ошибок Ошибка возвращается телом `{"error": "<код>"}` с соответствующим HTTP-статусом. | Код | Статус | Причина | | --------------------------------- | ------ | ----------------------------------------------------------------- | | unauthorized | 401 | Токен отсутствует, неизвестен или отозван | | rate\_limit\_exceeded | 429 | Превышена частота запросов | | unknown\_method | 404 | Метод не существует | | line\_not\_found | 404 | Линия не найдена или принадлежит другому порталу | | campaign\_not\_found | 404 | Рассылка не найдена или принадлежит другому порталу | | line\_number\_required | 400 | Не передан номер линии | | period\_required | 400 | Не передан период | | invalid\_period | 400 | Начало периода позже его конца | | period\_too\_long | 400 | Период длиннее 92 дней | | invalid\_datetime | 400 | Дата не разобрана | | invalid\_direction | 400 | Недопустимое значение `direction` | | invalid\_group\_by | 400 | Недопустимое значение `group_by` | | invalid\_pagination | 400 | Недопустимые `page` или `page_size` | | message\_ids\_or\_phone\_required | 400 | Не передан ни идентификатор, ни номер | | line\_not\_connected | 400 | Линия не подключена к провайдеру | | template\_not\_found | 400 | Шаблон не найден среди доступных линии | | template\_params\_mismatch | 400 | Число значений не совпадает с числом параметров шаблона | | recipients\_required | 400 | Не передан список получателей | | batch\_too\_large | 400 | Больше 1000 получателей в одном запросе | | no\_recipients | 400 | Запуск рассылки без получателей | | line\_not\_paid | 400 | Линия не оплачена | | campaign\_not\_draft | 409 | Получателей можно добавлять только в черновик | | campaign\_already\_started | 409 | Рассылка уже запущена | | campaign\_not\_running | 409 | Отменить можно только запущенную рассылку | | too\_many\_running\_campaigns | 409 | Больше пяти одновременно выполняющихся рассылок на портал | | invalid\_reply\_window | 400 | Окно ожидания ответа вне диапазона 1–720 часов | | invalid\_params | 400 | Параметры шаблона переданы не списком | | phone\_required | 400 | Не передан номер абонента | | template\_name\_required | 400 | Не передано имя шаблона | | invalid\_phone | 400 | Номер не распознан | | template\_params\_mismatch | 400 | Число подстановок не совпадает с шаблоном | | template\_not\_found | 404 | Шаблон не найден среди одобренных на линии | | line\_not\_active | 403 | Линия не подключена или оплата просрочена | | templates\_unavailable | 503 | Список шаблонов у провайдера временно недоступен, повторите позже | | provider\_error | 502 | Провайдер отклонил отправку | | send\_failed | 502 | Сбой связи с провайдером | | too\_many\_message\_ids | 400 | Больше 500 идентификаторов в одном запросе статусов | | invalid\_datetime | 400 | Дата не разобрана: нужен ISO‑8601 или epoch в секундах | | internal\_error | 500 | Внутренняя ошибка сервиса | Линия или рассылка другого портала неотличима от несуществующей — это сделано намеренно, чтобы по ответам API нельзя было выяснить чужие настройки. ## О чём стоит знать заранее **Время статусов.** С 3 августа 2026 года время доставки и прочтения записывается таким, каким его сообщил провайдер, а не временем обработки события на нашей стороне. У каждого сообщения есть поле `status_source`: `provider` — время провайдера, `internal` — время обработки. Сообщения, отправленные до этой даты, остались со значением `internal`; при сравнении периодов «до» и «после» это стоит учитывать. **Сопоставление ответа с рассылкой.** Ответ абонента засчитывается получателю рассылки, если он пришёл после отправки и внутри окна ожидания (по умолчанию 72 часа). Если один и тот же номер участвует в нескольких рассылках с пересекающимися окнами, ответ засчитывается ближайшей по времени отправке — разделить, на какую именно рассылку ответил абонент, по одному входящему сообщению невозможно. **Приостановка рассылки.** Отдельного метода паузы нет. Останавливает рассылку только `campaigns.cancel`, и возобновить отменённую нельзя — оставшихся получателей переносят в новую рассылку. **Фильтр по имени шаблона и старая переписка.** Отбор истории и группировка статистики по `template_name` опираются на структурированные данные сообщения. Сообщения старше 10 июля 2024 года хранятся в прежнем формате и под такой отбор не попадают: за периоды до этой даты запрашивайте историю без фильтра по шаблону. **Срок хранения истории.** Сообщения хранятся год. Данные старше года удаляются, поэтому история и статистика доступны за последние 12 месяцев. Если вам нужна более длинная история, выгружайте её к себе регулярно. **Формат номера и дат.** Номер в фильтрах принимается в любой записи — `+7 999 123-45-67` и `79991234567` дают один результат. Даты принимаются в ISO‑8601 (`2026-08-01`, `2026-08-01T10:00:00Z`), в сжатом виде (`20260801`) и как epoch в секундах. # Виджет на сайт Для добавления виджета WhatsApp на ваш сайт в левом меню портала войдите в приложение **Олчат WABA.** Выберите нужный коннектор и разверните раздел меню **Настройка виджета на сайт:**
Укажите текст приветствия в соответствующем поле. Нажмите на кнопку «УСТАНОВИТЬ». Также вы можете скопировать ссылку на чат в WhatsApp, нажав на иконку «Скопировать ссылку» в разделе «Ссылка на чат в WhatsApp»/
Далее перейдите в **Контакт-центр — Виджет на сайт**.
Включите канал в настройках виджета:
Если у вас уже существует и настроена линия с каким-то набором подключенным каналов, вы можете подключить к ней канал из другой линии. Это может пригодиться в случае, если для приложения Олчат WABA вы использовали отдельную открытую линию со своим сценарием обработки и распределения входящих сообщений от клиентов. Для добавления канала WhatsApp из открытой линии подключенной к приложению Олчат WABA, в настройках виджета нажмите ссылку «добавить открытую линию».
{% hint style="info" %} После установки виджет может появиться на сайте не сразу, т.к. он кэшируется на стороне Битрикс24. Чаще всего такое случается на коробочных версиях Битрикс24. Обновляться виджет может в течение 15-60 минут. Для ускорения обновления данных в виджете рекомендуем выключать и включать виджет. Тогда кэш виджета обновляется быстрее и применяются новые настройки. {% endhint %} # Получение параметров шаблонов ### Получение текста шаблона сообщения Для получения текста шаблона сообщения, зайдите в любую карточку лида, сделки, контакта или компании и нажмите на приложение «Олчат WABA».
В открывшемся окне приложения перейдите на вкладку «ШАБЛОНЫ». Из выпадающего списка шаблонов выберите нужный шаблон и нажмите на кнопку «СКОПИРОВАТЬ ШАБЛОН».
Текст шаблона будет скопирован в буфер и может быть использован для вставки в текст рассылки на следующем этапе. Если ваш шаблон содержит переменные, значения этих переменных можно прописать в соответствующие поля и в окне предварительного просмотра увидеть результат подстановки переменных в шаблон:
Скопируйте шаблон с переменными и используйте его в [Рассылка шаблонов с помощью Маркетинга](/vozmozhnosti/rassylka-shablonov-s-pomoshyu-marketinga), при [Отправка сообщений через функционал СМС](/ispolzovanie/otpravka-i-poluchenie-soobshenii/otpravka-soobshenii-cherez-funkcional-sms) а также в роботах и действиях бизнес-процессов, например, чтобы [Отправить сообщение или шаблон](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/otpravit-soobshenie-ili-shablon). {% hint style="info" %} После копирования шаблон сообщения может выглядеть следующим образом: > \[template=ru]test\_text\_cta\_dyn\[/template]\[body]**Это переменная с любым текстом**\[/body]\[buttons=url]***ustanovka-i-nastroika-prilozheniya-v-bitriks24/ustanovka-prilozheniya***\[/buttons] > {% endhint %} # Рассылка шаблонов с помощью Маркетинга Для автоматизированной рассылки сообщений в WhatsApp вы можете использовать функционал Маркетинга в Битрикс24. ### Создание сегмента Перед началом рассылки создайте сегмент. Для этого перейдите на страницу **Маркетинг — Сегменты** и нажмите кнопку **Создать сегмент**:
В форме создания сегмента выберите получателей рассылки с помощью фильтра. После применения система покажет сколько контактов подходит под это условие.
Сохраните сегмент. ### Создание рассылки {% hint style="info" %} Обратите внимание, для отправки сообщений в WhatsApp используется тип рассылки «СМС рассылка» а не «Мессенджеры». Через «Мессенджеры» можно написать только в уже созданные Открытые линии. Клиентам, с которыми ещё нет Открытой линии, написать нельзя. С помощью типа рассылки «СМС-рассылка» и при условии выбора нашего канала «\[Олчат WABA]», производится отправка в WhatsApp по номеру телефона. {% endhint %} Создайте новую СМС рассылку.
#### Создание рассылки без переменных в шаблоне
1. Выберите сегмент клиентов, по котором планируете сделать рассылку. 2. В качестве сервиса для отправки выберите сервис «\[Олчат WABA]» с нужным коннектором линии. 3. В текст сообщения вставьте текст шаблона, который планируете отправить. Подробнее о получения текста шаблона в статье [Получение параметров шаблонов](/vozmozhnosti/poluchenie-parametrov-shablonov#poluchenie-teksta-shablona-soobsheniya). 4. Рассылка готова. Нажмите на кнопку «СОХРАНИТЬ». #### Создание рассылки с переменными в шаблоне Если вы планируете создать рассылку с шаблоном, в котором присутствуют переменные, пропишите на месте для подстановки переменных нужный текст. Вы также можете использовать параметры, которые могут быть подставлены в текст из меню вызова вставки дополнительных значений:
При отправке рассылки система заменит переменные из указанных полей на значения, которые в этих полях указаны. Таким образом, вы можете разнообразить и персонифицировать ваши рассылки.
Рассылку можно отправить сразу или запланировать отправку на нужное время. ### Статус рассылок Маркетинга Отчет о рассылке можно посмотреть на главной странице приложения.
{% hint style="info" %} В Статусах рассылок будет отображаться один из статусов: * Одна серая галочка – сообщение отправлено, но не доставлено. * Две серые галочки – сообщение доставлено, но не прочитано. * Две синие галочки – сообщение прочитано. {% endhint %} # Роботы и активити бизнес-процессов {% hint style="warning" %} Функционал роботов в лидах и сделках доступен в Битрикс24 на тарифах **«Базовый»**, **«Стандартный»**, **«Профессиональный»** и **«Энтерпрайз»**. Функционал **активити (действий) в бизнес-процессах** доступен в Битрикс24 на тарифах **«Профессиональный»** и **«Энтерпрайз»**. {% endhint %} {% hint style="info" %} Общая информация по работе с роботами в Битрикс24: [Роботы Битрикс24](https://helpdesk.bitrix24.ru/open/6908975/) Общая информация по работе с бизнес-процессами в Битрикс24: [Видео-курс о бизнес-процессах](https://helpdesk.bitrix24.ru/open/3092117/) {% endhint %} {% hint style="warning" %} Сообщения роботами не будут отправляться, если будете отправлять на свой же номер. {% endhint %} ### Установка роботов и активити Включить роботов и активити можно в настройках приложения: **Олчат WABA — Настройки — Роботы и Бизнес-процессы.**
Для установки роботов и активити нажмите на кнопку **«ОБНОВИТЬ РОБОТОВ»**. После нажатия на кнопку, появится уведомление об успешной установке роботов, а статус возле названия робота поменяет значение с ❌ на ✅. ### Описание роботов и активити [Отправить сообщение или шаблон](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/otpravit-soobshenie-ili-shablon) — робот для отправки шаблонных и стандартных сообщений. [Отправить файл](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/otpravit-fail) — робот для отправки изображений и других файлов. [Broken mention](broken://pages/Ef7mnTbT3eJaKrg96hv4). [Broken mention](broken://pages/UT0bBCctg5OMgN1EUxj3). [Отправить контакт](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/otpravit-kontakt)— отправляет карточку контакта. [Отправить геолокацию](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/otpravit-geolokaciyu)— отправляет местоположение заданное координатами широты и долготы. [Проверить наличие WhatsApp на номере](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/proverit-nalichie-whatsapp-na-nomere) — проверяет телефон на наличие WhatsApp. [Ожидать сообщение](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/ozhidat-soobshenie). [Узнать возможность отправки сообщения](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/uznat-vozmozhnost-otpravki-soobsheniya). # Отправить сообщение или шаблон {% hint style="info" %} В качестве текста сообщения возможно использовать шаблонные сообщения, если планируете начать новый диалог с клиентом, либо сообщения, написанные в свободной форме, если у вас отрыто 24-х часовое окно диалога с клиентом. Подробнее о шаблонных сообщениях в статьях [Создание и управление шаблонами сообщений](/lichnyi-kabinet-gupshup/sozdanie-i-upravlenie-shablonami-soobshenii) и [Получение параметров шаблонов](/vozmozhnosti/poluchenie-parametrov-shablonov) {% endhint %} Для автоматизированной отправки сообщений используется робот «\[Олчат WABA] Отправить сообщение». ## Настройка робота Для добавления робота необходимо: {% stepper %} {% step %} Перейти в раздел «Роботы» из списка лидов либо карточки лида в CRM (в системе управления взаимоотношениями с клиентами).
{% endstep %} {% step %} Добавьте робота. 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Из списка меню выберите «Другие роботы». 4. Нажмите «Добавить» напротив «\[Олчат WABA] Отправить сообщение».
{% endstep %} {% step %} Настройте робота. 1. Укажите линию, через которую будет осуществляться отправка сообщений роботом. 2. Введите параметры поля **Телефон.** * ***Важно:*** убедитесь, что в роботе выбрано корректное поле с номером телефона. Если в карточке клиента заполнено поле «Мобильный телефон», а в настройке робота указано {{Рабочий телефон}}, робот не найдёт номер и сообщение не будет отправлено. Чтобы робот корректно подставлял номер из всех заполненных телефонных полей, рекомендуем в строке «Номер телефона» выбрать переменную {{Телефон (текст)}}. Указать её можно через меню «…» (три точки) напротив строки «Номер телефона». 3. Введите **Текст сообщения.** 4. При необходимости имеется возможность прикрепить изображение к сообщению. Для этого в текст необходимо загрузить файл на Диск в Битрикс24. ID (идентификатор) файла необходимо вставить в текст сообщения, как показано на скриншоте ниже. {% hint style="info" %} Данный способ работает с файлами формата «jpg» и «png». {% endhint %}
5. Нажмите кнопку «Сохранить». {% endstep %} {% step %} **Настройка робота завершена.** {% endstep %} {% endstepper %} ## Настройка активити (действия) бизнес-процесса Для отправки сообщения из бизнес-процесса добавьте действие «\[Олчат WABA] Отправить сообщение». Выполните настройку параметров действия:
1. Укажите **Линию,** через которую планируете сделать отправку/ 2. Введите **Телефона**, на который необходимо отправить сообщение/ {% hint style="info" %} ***Важно:*** убедитесь, что в роботе выбрано корректное поле с номером телефона. Если в карточке клиента заполнено поле «Мобильный телефон», а в настройке робота указано {{Рабочий телефон}}, робот не найдёт номер и сообщение не будет отправлено. Чтобы робот корректно подставлял номер из всех заполненных телефонных полей, рекомендуем в строке «Номер телефона» выбрать переменную {{Телефон (текст)}}. Указать её можно через меню «…» (три точки) напротив строки «Номер телефона». {% endhint %} 3. Введите **Текст сообщения/**
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «Сохранить». # Отправить шаблонное сообщение с файлом {% hint style="info" %} Данная статья в качестве примера рассматривает отправку роботом шаблонного сообщения с изображением, но принцип работы робота подходит также и под отправку шаблона с документом, аудио- или видеофайлом. {% endhint %} Для того, чтобы отправлять сообщения с файлом с помощью робота, выполните следующие действия: {% stepper %} {% step %} Скопируйте шаблон с изображением из приложения Олчат WABA. Вставьте ссылку на изображение: прямую или с помощью параметра DISK\_ID, где ID (идентификатор) — это ID файла на Битрикс.Диске, а затем нажмите кнопку «Скопировать шаблон». {% hint style="success" %} Воспользуйтесь [данной инструкцией](/roboty-i-aktiviti/nastroika-otpravki-faila-v-zavisimosti-ot-istochnika#ukazanie-id-otpravlyaemogo-faila), чтобы узнать, где взять ID файла на Битрикс.Диске. {% endhint %}
В буфер обмена будет скопировано следующее: > \[template=ru]kartinka\[/template]\[header=image]DISK\_3283\[/header] В данном случае kartinka — название шаблона, а DISK\_3283 — ссылка на изображение, хранящееся на Битрикс.Диске, которое будет отправлено вместе с сообщением. {% endstep %} {% step %} В карточке лида перейдите на вкладку «Роботы».
{% endstep %} {% step %} Нажмите «+ Создать», затем выберите стадию, на которую необходимо добавить робота, далее в меню выберите «Другие роботы» → \[Олчат WABA] Отправить сообщение.
{% endstep %} {% step %} В настройках робота укажите линию (1), через которую будут отправляться сообщения с изображением, вставьте переменную контакта (2), затем вставьте скопированный ранее шаблон в поле «Текст сообщения» (3). При необходимости измените остальные настройки, выставленные по умолчанию, и нажмите кнопку «Сохранить».
{% endstep %} {% step %} Сообщение, полученное клиентом в WhatsApp, имеет следующий вид:
{% endstep %} {% step %} Настройка робота завершена. {% endstep %} {% endstepper %} # Отправить файл ### Настройка робота {% hint style="warning" %} Для того чтобы робот успешно сработал, должно быть открыто 24-часовое окно диалога с клиентом. {% endhint %} Робот «\[Олчат WABA] Отправить файл» позволяет на определённой стадии в автоматизированном режиме отправлять в чат с клиентом файлы различного типа: документы и изображения, аудио- и видеофайлы. Для добавления робота необходимо: {% stepper %} {% step %} Перейти в раздел «Роботы» из списка лидов либо карточки лида в CRM (в системе управления взаимоотношениями с клиентами).
{% endstep %} {% step %} Добавьте робота. 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Из списка меню выберите «Другие роботы». 4. Нажмите «Добавить» напротив «\[Олчат WABA] Отправить файл».
{% endstep %} {% step %} **Настройте робота.** 1. Укажите линию, через которую будет осуществляться отправка сообщений роботом. 2. Заполните поле «Телефон». 3. В поле «Отправить файл как...» выберите тип отправляемого роботом файла. В выпадающем списке можно выбрать: Изображение, Аудио, Видео, Документ. Данный пример рассматривает отправку роботом изображения. 4. Укажите тип источника файла. В выпадающем списке можно выбрать: Прямая ссылка на файл, ID файла на Битрикс.Диске, Файл из поля CRM. Данный пример рассматривает отправку файла, расположенного на Битрикс.Диске. 5. Укажите прямую ссылку на файл/ID файла на Битрикс.Диске/ID поля CRM в формате UF\_CRM\_0000000. Воспользуйтесь [данной инструкцией](/roboty-i-aktiviti/nastroika-otpravki-faila-v-zavisimosti-ot-istochnika#ukazanie-id-otpravlyaemogo-faila), чтобы найти ID файла на Битрикс.Диске, и [данной инструкцией](/roboty-i-aktiviti/nastroika-otpravki-faila-v-zavisimosti-ot-istochnika#ukazanie-id-polya-v-kotorom-nakhoditsya-otpravlyaemyi-fail), чтобы узнать ID поля CRM. 6. Сохраните настройки.
{% endstep %} {% step %} Настройка робота завершена. Сообщение клиенту в WhatsApp будет выглядеть следующим образом:
{% endstep %} {% endstepper %} # Отправить контакт ### Настройка робота {% hint style="warning" %} Для того, чтобы робот успешно сработал, должно быть открыто 24-часовое окно диалога с клиентом. {% endhint %} Робот «\[Whatsabi] Отправить контакт» позволяет на определённой стадии в автоматизированном режиме отправлять в чат с клиентом данные контакта, записанного в CRM-системе. Для добавления робота необходимо: {% stepper %} {% step %} **Перейти в раздел «Роботы» из списка лидов, либо карточки лида в CRM.**
{% endstep %} {% step %} **Добавьте робота.** 1. Нажмите «+ Создать»; 2. Укажите стадию, на которой должен срабатывать робот; 3. Из списка меню выберите «Другие роботы»; 4. Нажмите «Добавить» напротив «\[Whatsabi] Отправить контакт».
{% endstep %} {% step %} **Настройте робота.** 1. Укажите линию, через которую будет осуществляться отправка контакта роботом. 2. Заполните поле «Телефон». 3. Укажите ID контакта, данные которого будут отправляться роботом.
{% endstep %} {% step %} **Настройка робота завершена.** {% endstep %} {% endstepper %} # Отправить геолокацию ### Настройка робота {% hint style="warning" %} Для того, чтобы робот успешно сработал, должно быть открыто 24-часовое окно диалога с клиентом. {% endhint %} Робот «\[Олчат WABA] Отправить геолокацию» позволяет на определённой стадии в автоматизированном режиме отправлять в чат с клиентом геометку. Для добавления робота необходимо: {% stepper %} {% step %} Перейти в раздел «Роботы» из списка лидов либо карточки лида в CRM (в системе управления взаимоотношениями с клиентами).
{% endstep %} {% step %} **Добавьте робота.** 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Из списка меню выберите «Другие роботы». 4. Нажмите «Добавить» напротив «\[Олчат WABA] Отправить геолокацию».
{% endstep %} {% step %} **Настройте робота.** 1. Укажите линию, через которую будет осуществляться отправка геолокации роботом. 2. Заполните поле «Телефон». 3. Введите координаты точки на карте. В поле «Адрес» можно указать название места или улицу, дом. Во второй строке адреса, например, можно указать город. 4. Сохраните настройки.
{% endstep %} {% step %} Настройка робота завершена. {% endstep %} {% endstepper %} # Проверить наличие WhatsApp на номере ### Настройка робота Робот «\[Олчат WABA] Проверить наличие WhatsApp» позволяет на определённой стадии в автоматизированном режиме осуществить проверку телефона клиента на предмет регистрации в WhatsApp. Для добавления робота необходимо: {% stepper %} {% step %} * Перейти в раздел «Роботы» из списка лидов либо карточки лида в CRM (в системе управления взаимоотношениями с клиентами).
{% endstep %} {% step %} Добавьте робота. 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Из списка меню выберите «Другие роботы». 4. Нажмите «Добавить» напротив «\[Олчат WABA] Проверить наличие WhatsApp».
{% endstep %} {% step %} Настройте робота, заполнив параметры поля «Телефон».
{% endstep %} {% step %} Настройте триггер «Добавить комментарий элемента», чтобы на таймлайне в карточке сущности отобразился результат проверки робота «\[Олчат WABA] Проверить наличие WhatsApp». 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Воспользуйтесь строкой поиска, введя «Добавить комментарий в элемент». 4. Нажмите «Добавить» напротив «Добавить комментарий в элемент».
5. Укажите очередь срабатывания триггера: После предыдущего робота. 6. Укажите причину срабатывания триггера: нажмите «», далее выберите «Роботы» — «\[Олчат WABA] Проверить наличие WhatsApp» — «Номер существует?»
7. Сохраните настройки. {% endstep %} {% step %} Настройка робота завершена. Результат проверки будет отображён на таймлайне в карточке сущности в виде поля с буквой Y (yes, номер зарегистрирован в WhatsApp) или N (no, не зарегистрирован). {% endstep %} {% endstepper %} # Ожидать сообщение ## Настройка робота Робот «\[Олчат WABA] Ожидать сообщение» позволяет дождаться ответа пользователя на ваше сообщение. Ответ пользователя содержится в дополнительных результатах робота. Доступны следующие ответы пользователя: Тип сообщения, Текст, Файл, Имя файла:
{% hint style="info" %} Ответ пользователя вы можете использовать в дальнейших сценариях автоматизации и настроить реакцию, что должно происходить при получении того или иного ответа от клиента. {% endhint %} Для добавления робота необходимо: {% stepper %} {% step %} Перейти в раздел «Роботы» из списка лидов, либо карточки лида в CRM (в системе управления взаимоотношениями с клиентами).
{% endstep %} {% step %} Добавьте робота. 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Из списка меню выберите «Другие роботы». 4. Нажмите «Добавить» напротив «\[Олчат WABA] Узнать возможность отправки сообщения».
{% endstep %} {% step %} **Выполните настройку робота.** 1. Укажите **Линию WhatsApp,** на которой ожидаем сообщение. 2. Введите **Номер телефона**, на котором ожидаем сообщение. 3. В поле **Период ожидания (в минутах)** укажите количество минут, в течение которых робот будет ожидать сообщение. 4. Нажмите «Сохранить».
{% hint style="info" %} Чтобы дождаться ответа пользователя и использовать отправленный им ответ в дальнейших сценариях автоматизации, статус или стадия сущности, в которой запущен робо,т не должна изменятся! При перемещении на другую стадию робот завершит свою работу и не среагирует на ответ пользователя. Если планируете получать ответ пользователя вне зависимости от статусов или стадий – используйте функционал бизнес-процессов. {% endhint %} {% endstep %} {% step %} Настройка робота завершена. {% endstep %} {% endstepper %} ## Настройка активити (действия) бизнес-процесса
Выполните настройку параметров действия: 1. Укажите **Линию WhatsApp,** на которой ожидаем сообщение. 2. Введите **Номер телефона**, на котором ожидаем сообщение. 3. В поле **Период ожидания (в минутах)** укажите количество минут, в течение которых робот будет ожидать сообщение.
Остальные настройки можно оставить по умолчанию. Ответ пользователя содержится в дополнительных результатах активити. Доступны следующие ответы пользователя: Тип сообщения, Текст, Файл, Имя файла:
{% hint style="info" %} При использовании бизнес-процессов следует помнить о том, что для одной сущности вы можете запустить не более 2-х бизнес-процессов одновременно. Подробнее в статье от Битрикс24 [Ограничение на запуск процессов](https://helpdesk.bitrix24.ru/open/5671433/). {% endhint %} # Узнать возможность отправки сообщения ### Настройка робота Робот «\[Олчат WABA] Узнать возможность отправки сообщения» позволяет на определённой стадии в автоматизированном режиме проверить, возможно ли клиенту отправить сообщение с помощью выбранной открытой линии (активен ли диалог), а также узнать время закрытия диалога. Для добавления робота необходимо: {% stepper %} {% step %} Перейти в раздел «Роботы» из списка лидов, либо карточки лида в CRM (в системе управления взаимоотношениями с клиентами).
{% endstep %} {% step %} Добавьте робота. 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Из списка меню выберите «Другие роботы». 4. Нажмите «Добавить» напротив «\[Олчат WABA] Узнать возможность отправки сообщения».
{% endstep %} {% step %} Настройте робота. 1. Выберите линию, с которой планируется производить проверку. 2. Заполните параметры поля «Телефон». 3. Нажмите «Сохранить».
{% endstep %} {% step %} Настройте триггер «Добавить комментарий элемента», чтобы на таймлайне в карточке сущности отобразился результат проверки робота «\[Олчат WABA] Узнать возможность отправки сообщения». 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Воспользуйтесь строкой поиска, введя «Добавить комментарий в элемент». 4. Нажмите «Добавить» напротив «Добавить комментарий в элемент».
5. Укажите очередь срабатывания триггера: После предыдущего робота. 6. Укажите причину срабатывания триггера: нажмите «», далее выберите «Роботы» — «\[Олчат WABA] Узнать возможность отправки сообщения», затем выберите необходимый параметр проверки.
7. Сохраните настройки. {% endstep %} {% step %} Настройка робота завершена. Результат проверки будет отображён на таймлайне в карточке сущности в виде поля с буквой Y (yes, открыто 24-часовое окно диалога) или N (no, диалог закрыт). В случае выбора параметра проверки «Время закрытия диалога», в поле на таймлайне (хронологии) будет отражено соответствующее время. {% endstep %} {% endstepper %} # Завершить диалог ### Настройка робота Робот «\[Олчат WABA] Закрыть все диалоги в сущности» позволяет в автоматизированном режиме на выбранной стадии закрывать все активные диалоги в сущности. Для добавления робота необходимо: {% stepper %} {% step %} Перейти в раздел «Роботы» из списка лидов, либо карточки лида в CRM (в системе управления взаимоотношениями с клиентами).
{% endstep %} {% step %} Добавьте робота. 1. Нажмите «+ Создать». 2. Укажите стадию, на которой должен срабатывать робот. 3. Из списка меню выберите «Другие роботы». 4. Нажмите «Добавить» напротив «\[Олчат WABA] Закрыть все диалоги в сущности».
{% endstep %} {% step %} **Выполните настройку робота.** Укажите: 1. Очередь срабатывания робота. 2. Время запуска (при необходимости). 3. Условие запуска (при необходимости). Сохраните настройки.
{% endstep %} {% step %} Настройка робота завершена. {% endstep %} {% endstepper %} ### Настройка активити (действия) бизнес-процесса Для отправки сообщения из бизнес-процесса добавьте действие «\[Олчат WABA] Закрыть все диалоги в сущности». Для этого: 1. В карточке лида выберите «Бизнес-процессы». 2. Нажмите кнопку «Создать». 3. Укажите основные настройки и параметры запуска бизнес-процесса. 4. Нажмите кнопку «Сохранить». 5. В схеме между «Начало» и «Конец» нажмите на треугольник. 6. Из меню выберите «Действия приложений». 7. Добавьте «\[Олчат WABA] Закрыть все диалоги в сущности» из списка. 8. Нажмите на шестерню над наименованием бизнес-процесса, чтобы выполнить настройку параметров действия. Сохраните данные настройки. 9. Сохраните шаблон бизнес-процесса.
# Настройка отправки файла в зависимости от источника При отправке файла с помощью активити или робота «\[Олчат WABA] Отправка файла» и выборе типа источника файла доступны варианты «Прямая ссылка на файл», «Битрикс24.Диск (ID (идентификатор) файла)», «Файл из поля CRM» и «Короткая ссылка Битрикс24». В зависимости от выбранного типа источника необходимо указывать прямую ссылку на файл, ID отправляемого файла или ID поля, в котором находится отправляемый файл. ### Создание прямой ссылки на файл Прямая ссылка имеет вид . При переходе по такой ссылке сразу начинается скачивание файла. Для создания прямой ссылки файл можно разместить на вашем хостинге (сайте) или использовать один из сервисов хранения файлов, которые предоставляют такую возможность. {% hint style="info" %} Битрикс24, Dropbox, Google Drive, Яндекс.Диск и другие облачные сервисы, по умолчанию не создают прямые ссылки на скачивание, а создают публичные ссылки с промежуточной страницей, где нужно для загрузки нажать кнопку «Скачать», поэтому данные сервисы не подходят для формирования прямой ссылки на файл. {% endhint %} ### Указание ID отправляемого файла ID файла можно посмотреть в Битрикс.Диске. ID файла указан в соответствующем столбце строки необходимого файла на Битрикс.Диске.
### Указание ID поля, в котором находится отправляемый файл Чтобы узнать ID поля, в котором находится отправляемый файл, на вашем портале необходимо перейти по адресу: **CRM — Настройки — Настройки форм и отчётов — Пользовательские поля — Сущность CRM: Лид|Сделка|Контакт|Компания — Список полей.** Выберите необходимо поле и откройте его в режиме редактирования. В браузере в строке ссылки будет указан ID этого поля.
### Использование короткой ссылки Битрикс.Диска Если файл находится на Диске Битрикс24, для использования его в роботе «Отправка файла» проделайте следующие действия: 1. На Диске выберите необходимый файл и нажмите на него правой кнопкой мыши. 2. Выберите «Поделиться». 3. Нажмите «Получить публичную ссылку».
В окне получения короткой ссылки нажмите , чтобы скопировать её. Нажав на , вы также можете задать срок действия данной ссылки и защитить её паролем. Нажмите «Сохранить».
{% hint style="info" %} Для корректной работы робота «Отправка файла» нельзя устанавливать пароль на файл. {% endhint %} При настройке робота «Отправка файла», в поле «Тип источника файла» выберите «Короткая ссылка Битрикс24», а в поле «Прямая ссылка на файл, ID файла на Диске, ID поля» вставьте полученную ранее короткую ссылку. # Умные сценарии Умные сценарии в Битрикс24 позволяют автоматизировать работу с лидами, сделками, контактами и компаниями. С помощью умных сценариев вы можете настроить последовательность роботов, которые совершат нужные действия для выбранных сущностей. В умных сценариях доступны все роботы приложения Олчат. Рассмотрим один из возможных вариантов использования и выполним настройку умного сценария. Создадим умный сценарий, который будет отправлять сообщения клиентам в WhatsApp по выбранным сделкам. Для этого в вашем Битрикс24 необходимо перейти в раздел **CRM ‒ Сделки ‒ Список сценариев ‒ Умные сценарии ‒ Создать сценарий.**
В открывшемся окне укажите название и описание сценария.
Добавим робота, который будет выполнять отправку сообщения. Для этого необходимо нажать кнопку **+добавить ‒ Другие роботы ‒ \[**Олчат WABA**] Отправить сообщение.**
Выполните настройку робота: 1. Укажите **Линию,** через которую планируете сделать отправку. 2. Введите **Номер телефона**, на который необходимо отправить сообщение. 3. Введите текст **Сообщения.** Здесь вы можете ввести текст отправляемого сообщения либо с помощью диалогового окна выбора параметров нажав на значок **▪▪▪** создать ещё более гибкие условия запуска умного сценария. Предоставляется несколько вариантов: * **Настроить администратором перед запуском** – в этом случае администратору нужно будет указать параметры робота в разделе **Настройка сценария** перед сохранением сценария. * **Спрашивать при запуске** – во время запуска сценария нужно будет внести данные в появившемся окне. * **Выбрать сейчас** – укажите нужные параметры, чтобы установить их сейчас.
Остальные настройки можно оставить по умолчанию. Нажмите на кнопку «СОХРАНИТЬ» Если на предыдущем шаге при настройке роботов вы выбирали параметры **Настроить администратором перед запуском** или **Спрашивать при запуске,** в разделе Настройка сценария укажите дополнительные настройки. Нажмите на кнопку «СОХРАНИТЬ». Умный сценарий готов и можно переходить к его запуску. Чтобы запустить умный сценарий, отметьте необходимые сущности, перейдите в **Список сценариев ‒ Умные сценарии ‒ Отправка сообщения.** Сценарий запустится и выполнит указанные в нём действия.
Если при настройке сценария вы выбирали дополнительные параметры запуска, перед выполнением вам будет показано диалоговое окно с возможностью указать эти параметры. В нашем примере – укажем текст отправляемого сообщения.
Чтобы отредактировать созданный сценарий, необходимо перейти в список сценариев.
В открывшемся окне вы увидите список всех доступных сценариев. Чтобы удалить или настроить сценарий, используйте соответствующие действия.
# Вопросы и ответы # Решение ошибки «Соответствие компании правилам: проблема с платежом» Если при отправке шаблона с помощью Олчат WABA возникает ошибка «ШАБЛОН: Соответствие компании правилам: проблема с платежом», необходимо проверить настройки аккаунтов WhatsApp в личном кабинете Facebook\* Business Manager, а именно настройки оплаты.
Ошибка может появляться по нескольким причинам: * с аккаунтом WhatsApp не связан платежный аккаунт; * превышено ограничение по кредитной линии; * кредитная линия (платежный аккаунт) не задана или неактивна; * аккаунт WhatsApp Business удален; * не указан часовой пояс; * не указана валюта; * запрос MessagingFor (от имени) ожидает подтверждения или отклонен; * превышен предел бесплатных сообщений и отсутствует допустимый способ оплаты. Для устранения ошибки рекомендуем проделать следующие действия: 1. Откройте Настройки бизнес-портфолио Facebook\* Business Manager. 2. В меню слева выберите «Аккаунты», далее «Аккаунты WhatsApp» и выберите аккаунт. 3. В графе «Способ оплаты» должно стоять следующее значение: **Gupshup Technology India Pvt Ltd.**
В случае если в графе «Способ оплаты» указан другой провайдер, воспользуйтесь [данной инструкцией](/bystryi-start/perenos-nomera), чтобы перенести свои данные. \*\* Деятельность компании Meta Platforms Inc. (Facebook) на территории РФ запрещена. # Сравнение неофициальной интеграции WhatsApp и официальной WhatsApp Business API с Битрикс24 Интеграция WhatsApp с Битрикс24 может быть реализована двумя основными способами: официальным («белым») и неофициальным («серым»). В данной статье рассмотрим ключевые различия между этими методами, их возможности и преимущества, требования и особенности. ## Неофициальная интеграция Это решение не задействует WhatsApp Business API и является независимым от Meta\*. Принцип его работы основан на эмуляции веб-версии WhatsApp на нашем сервере. Мы создаем его виртуальный экземпляр, который выполняет роль моста для двусторонней синхронизации переписки с Битрикс24. #### **Возможности и преимущества** * **Быстрый старт:** подключение за несколько минут через сканирование QR-кода. * **Расширенные коммуникации:** возможность отправлять первыми любые сообщения, включая файлы, без ограничений. * **Свобода выбора номера:** можно подключить любой телефонный номер. * **Работа с групповыми чатами:** интеграция групповых переписок в Битрикс24. * **Мультиплатформенность:** поддержка до 4 дополнительных устройств одновременно, помимо основного телефона. Это позволяет вести переписку через: * Открытые линии в Битрикс24. * Приложение WhatsApp на смартфоне. * Веб-версию и десктопное приложение WhatsApp. * **Сохранение истории:** вся переписка автоматически сохраняется в Открытых линиях Битрикс24. * **Прозрачная стоимость:** фиксированный платеж в размере **3600 рублей в месяц (за 30 дней)** за одну подключенную Открытую линию (WhatsApp-приложение). #### **Требования и важные особенности** * **Автономная работа:** для стабильной работы интеграции больше не требуется, чтобы телефон был постоянно включен в сеть и подключен к интернету. * **Единственное условие:** для поддержания активности подключения необходимо пользоваться приложением WhatsApp на основном телефоне **хотя бы раз в 14 дней**. * **Риск блокировки:** существует высокий риск блокировки номера при проведении массовых рассылок и нарушении правил использования WhatsApp. Во избежание этого строго следуйте нашим рекомендациям. ## Официальная интеграция WhatsApp Business API Официальный WhatsApp Business API позволяет интегрировать мессенджер с CRM-системой, сайтом и другими инструментами. Прямой доступ к API (программному интерфейсу) предоставляет компания Meta (Facebook), и им обладают лишь несколько крупных провайдеров в мире. Наше приложение **Олчат WABA** выполняет роль связующего звена, позволяя подключить ваш WhatsApp к Битрикс24 через одного из таких провайдеров — компанию **GupShup**. ### **Ключевые преимущества** * **Стабильное соединение:** работает без необходимости использования постоянно включенного смартфона или эмуляторов. * **Безопасные рассылки:** возможность проводить согласованные с Meta рассылки без риска блокировки номера. #### **Требования и особенности подключения** * **Верифицированный аккаунт:** для работы необходим подтвержденный бизнес-аккаунт WhatsApp. * **Сроки и процесс:** процесс подключения и верификации может занимать **до 14 рабочих дней**, так как требует проверки документов вашего бизнеса в Facebook. * **Лимиты на период верификации:** до завершения проверки действуют ограничения: * Не более **250 исходящих диалогов** с уникальными клиентами в сутки. * Можно подключить до **2-х телефонных номеров**. #### **Особенности работы с клиентами** **Начало диалога (исходящие сообщения)** * Первый контакт с клиентом возможен **только через шаблонное сообщение**, заранее согласованное с Meta. * Срок согласования шаблона — до 24 часов. * За каждое отправленное шаблонное сообщение взимается плата по тарифам WhatsApp. * Шаблоны используются для запуска диалогов трёх категорий: **Маркетинговые, Уведомления об услугах, Аутентификация.** **Продолжение диалога (входящие сообщения)** * Если клиент написал первым, в ответ открывается окно **«Обслуживание»**. * В течение **24 часов** с момента последнего сообщения от клиента вы можете общаться с ним в свободной форме, без шаблонов. * Все входящие сообщения от клиентов бесплатны. **Возобновление диалога** * По истечении 24-часового окна для продолжения беседы необходимо отправить новое шаблонное сообщение или дождаться, пока клиент напишет снова. ### **Важные ограничения** * **Нет поддержки групповых чатов и голосовых звонков.** * **Нельзя использовать стандартные приложения:** официальный API (программный интерфейс) несовместим с приложениями WhatsApp, WhatsApp Business и веб-версией ([web.whatsapp.com](https://web.whatsapp.com/)). * Перед подключением к WABA номер необходимо полностью удалить из всех личных аккаунтов WhatsApp. Как вернуть номер для WhatsApp, можно узнать [здесь](/voprosy-i-otvety/untitled/kak-otklyuchit-nomer-ot-whatsapp-business-api-chtoby-podklyuchitsya-k-seromu-whatsapp). {% hint style="warning" %} Также рекомендуем создать резервную копию чатов, чтобы избежать потери переписок, так как после удаления аккаунта восстановить данные невозможно. {% endhint %} ### Из чего складывается стоимость WABA? Стоимость WhatsApp Business API складывается из следующих составляющих: 1. Оплата за приложение для интеграции с Битрикс24 (нам, в рублях). Подробнее в статье [Оплата приложения Олчат WABA](https://waba.docs.olchat.io/tarify-prilozheniya/oplata-prilozheniya-whatsabi) и в разделе [Тарифы Олчат WABA](#tarify-olchat-waba). 2. Оплата за каждое сообщение провайдеру GupShup. Стоимость за каждое сообщение \~ $0,001. 3. Оплата WhatsApp за 24-часовые переписки. Стоимость в зависимости от категории: * Маркетинговые — $0.0802. * Услуги — $0.04. * Аутентификация — $0,0429. * Обслуживание (ответ на входящий диалог) — бесплатно. ### **Тарифы Олчат WABA** Подробнее о тарифах и стоимости написано в [данной ](https://waba.docs.olchat.io/tarify-prilozheniya)статье. #### Хотите подключить Олчат WABA? Есть вопросы по официальной интеграции? Напишите нам в [чат поддержки](https://auth2.bitrix24.net/oauth/select/?preset=im\&IM_DIALOG=networkLines7c380c91ab28dacab02d3af93fecdbf9). *\*Деятельность Meta запрещена на территории Российской Федерации.* # Отличие WhatsApp, WhatsApp Business и WhatsApp Business API {% hint style="info" %} Если у вас есть приложение WhatsApp на телефоне, то у вас WhatsApp или WhatsApp Business. WhatsApp Business API не всегда удобен для привычного общения, но в нём можно рассылать много сообщений. Но за деньги. И приложения для телефона нет. {% endhint %} ## WhatsApp WhatsApp — популярная бесплатная система мгновенного обмена текстовыми сообщениями, изображениями, видео, аудио, электронными документами через Интернет. Работает на распространённых платформах, таких как Android, iOS, а также Windows, macOS и в виде веб-приложения. Предполагает использование для личного общения людей. Не предоставляет доступ к API и недоступно для официальных («белых») интеграций с CRM-системами и другими маркетинговыми инструментами. {% hint style="info" %} Возможно использование в неофициальной («серой») интеграции с Битрикс24, однако, предпочтительнее для этой цели версия WhatsApp Business {% endhint %} ## WhatsApp Business Это бесплатное приложение на Android и iOS, разработанное специально для владельцев малого бизнеса. Оно не дает доступ к API (к программному интерфейсу) и недоступно для официальных («белых») интеграций. Для неофициальной («серой») интеграции с Битрикс24, рекомендуется использовать именно эту версию. Так же как и обычная версия WhatsApp, WhatsApp Business имеет веб-версию и кроме того, содержит набор дополнительных инструментов для взаимодействия с клиентами. Рассмотрим их подробнее. 1. **Профиль компании.** Здесь размещают описание услуг компании, контактную информацию — адрес, часы работы, веб-сайт, адрес электронной почты. 2. **Каталоги.** Предназначены для демонстрации своих товаров и услуг клиентам. Имеется возможность отправлять ссылки на каталоги в личные сообщения или в группы. 3. **Быстрые ответы.** Часто используемые сообщения можно сохранять и затем использовать их для ответов на стандартные вопросы клиентов. 4. **Автоматические ответы.** Если вы не можете ответить клиенту сразу, можно настроить автоматическую отправку заранее подготовленного сообщения. Также можно создать приветственное сообщение, которое будет отправляться клиенту при первом обращении. 5. **Ярлыки.** Контакты или чаты можно помечать с помощью ярлыков, объединяя их таким образом в тематические группы. ## WhatsApp Business API WhatsApp Business API — это API, которое позволяет интегрировать WhatsApp с сайтом, CRM (системой управления взаимоотношениями с клиентами) или другими маркетинговыми инструментами. Доступ к официальному WhatsApp Business API выдаёт Facebook. В настоящее время в мире существует ограниченный перечень крупных компаний-провайдеров, непосредственно имеющих доступ к API. В свою очередь, они предоставляют возможность подключения к WhatsApp Business API обычным компаниям, желающим использовать в своей работе с клиентами официальную интеграцию. В официальном WhatsApp Business API отсутствуют приложения для смартфона, такие как WhatsApp или WhatsApp Business, нет и веб-версии приложения. Общение с клиентом производится непосредственного из CRM-системы или того канала, с которым произведена интеграция. # Как отключить номер от WhatsApp Business API, чтобы подключиться к «серому» WhatsApp? Необходимо написать в поддержку GupShup с просьбой удалить приложение и отключить номер. Написать можно на русском языке на данную почту: Как быстро его можно включить в приложении Whatsapp зависит от того, были ли на номере платные сессии: * Если нет, то номер станет доступен через 5 минут после отключения от WABA. * Если да, то 1-го числа следующего месяца (в худшем случае через 30 дней после отключения). # Существует ли защита от спама и списания средств за входящие сообщения? Если клиент первым отправил вам сообщение, после вашего ответа на это сообщение открывается переписка категории «Обслуживание». В течение 24 часов вы можете переписываться с клиентом в свободной форме, без использования шаблонов. Каждый месяц первая 1000 переписок в этой категории бесплатна. У компаний может вызывать беспокойство тот факт, что номер может попасть спамерам или недобросовестным клиентам, которые захотят нанести вред компании путём отправки большого количества входящих сообщений и таким образом израсходовать ваш бюджет на номере. Это невозможно, поскольку переписка категории «Обслуживание» запускается только ответом от Бизнеса! Если вы не отвечаете, то за переписку вы не платите! Кроме того, вы может заблокировать такого пользователя чтобы больше не получать от него сообщения. # Как добавить второго администратора? Для добавления второго администратора в вашем бизнес-аккаунте Facebook\*: 1. Перейдите в настройки бизнес-аккаунта. 2. Перейдите в раздел Пользователи **→** Люди **→** «Пригласить людей». 3. При добавлении второго администратора убедитесь, что не включаете определенную галочку, которая может вызвать запрос на добавление дополнительных объектов.
*(\*) Meta — признана экстремистской организацией на территории РФ.* # Как добавить сотрудника в личный кабинет Gupshup, чтобы он мог работать с шаблонами? В стандартном кабинете Gupshup нельзя добавить других сотрудников для работы с шаблонами — доступ есть только у владельца изначально зарегистрированного аккаунта. Таким образом, нужно использовать аккаунт с общим доступом и указывать отдельную рабочую почту, так как у всех сотрудников должен быть к ней доступ. # Коды ошибок и их значения 1 ### Gupshup WhatsApp API — Полная таблица ошибок
КодОшибкаЗначение / действие
500Внутренняя ошибка сервераОбратиться в команду Gupshup.
1001Ошибка последнего привязанного ботаНесоответствие данных привязанного бота и отправителя. ​
1002Номер не существует в WhatsAppНомер получателя не зарегистрирован в WhatsApp. ​
1003Низкий баланс кошелькаНевозможно отправить сообщение — проверьте баланс кошелька. ​
1004Ошибка отключённого шаблонаОтправка не удалась: пользователь неактивен для сессионных сообщений, шаблонные сообщения отключены. ​
1005Ошибка соответствия шаблонаОтправка не удалась: пользователь неактивен, шаблон не соответствует. ​
1006Ошибка opt-in шаблонаОтправка не удалась: пользователь неактивен и не дал согласия на шаблонные сообщения. ​
1007Ошибка соответствия opt-in шаблонаОтправка не удалась: пользователь неактивен, нет opt-in и шаблон не соответствует. ​
1008Ни прокси, ни opt-inПользователь не дал согласия и неактивен. ​
1010Неверный URL медиаНеверный URL медиафайла. ​
1011Неверный размер медиаНеверный размер медиафайла. ​
1012Номер отписанОтправка не удалась: номер отписан от сообщений. ​
4001Ограничение скорости APIЧто-то пошло не так. Прекратите отправку и обратитесь в Gupshup с кодом ошибки. ​
4002Неверный ответ от WhatsAppПолучен неверный ответ от серверов WhatsApp. ​
4003Нет соответствия шаблонаОтправка не удалась: шаблон не соответствует. ​
4004Только для CAPIТип сообщения поддерживается только в Meta Cloud API. ​
4005Приостановленный шаблонОтправка не удалась: шаблон приостановлен. ​
# Отправка шаблона сообщения с кнопками и обработка ответов роботом Ожидание сообщения В процессе взаимодействия с клиентом на любом этапе сделки может происходить отправка клиенту сообщений в WhatsApp и получение от него ответов. Если вопросы задаваемые клиенту всегда одинаковые, а ответы получаемые от клиента однотипные, этот процесс можно автоматизировать с помощью роботов [Отправить сообщение или шаблон](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/otpravit-soobshenie-ili-shablon) и [Ожидать сообщение](/roboty-i-aktiviti/roboty-i-aktiviti-biznes-processov/ozhidat-soobshenie). Рассмотрим следующий сценарий: 1. Отправляем клиенту в WhatsApp сообщение. В тексте сообщения используем заранее согласованный шаблон с добавлением кнопок. Ожидаем ответ клиента. 2. Обрабатываем ответ клиента и реагируем соответствующим образом: либо отправляем клиенту ещё несколько сообщений, либо ставим на ответственного по сделке Дело позвонить клиенту. Выполним пошаговую настройку описанного выше сценария. На стадию **«Отправлено приглашение»** добавим робота **«\[Олчат WABA] Отправить сообщение»,** в котором с помощью заранее утверждённого шаблонного сообщения с кнопками уведомим клиента о предстоящей акции и предоставим на выбор возможность записаться на процедуру или узнать подробнее об акции.
Выполните настройку робота. Для этого на добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота.
1. Укажите **Линию WhatsApp,** через которую планируете сделать отправку. 2. Введите **Номер телефона**, на который необходимо отправить сообщение. 3. В поле **«Сообщение»** напишите текст. В рассматриваемом примере – это текст шаблона сообщения. Как его получить подробнее рассмотрено в статье [Получение параметров шаблонов](/vozmozhnosti/poluchenie-parametrov-shablonov). Нажмите на кнопку «СОХРАНИТЬ». Шаблонное сообщение, полученное клиентом в WhatsApp имеет следующий вид:
Далее для ожидания вариантов ответа клиента на текущую стадию добавим робота **«\[Олчат WABA] Ожидать сообщение».**
Выполним настройку робота. Для этого на добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота. Робот **«Ожидать сообщения»** позволяет дождаться ответа пользователя на ваше сообщение. Ответ пользователя содержится в дополнительных результатах робота. Мы отправили клиенту шаблон сообщения с кнопками и ожидаем получить варианты: «Записаться на процедуру» и «Узнать подробнее об акции». Настроим добавленного робота 1. Обязательно укажите, что робот должен сработать **после предыдущего.** 2. Выберите **Линию WhatsApp,** для которой ожидаем сообщение. 3. Введите **Номер телефона** клиента, на который было отправлено сообщение и с которого мы ожидаем получить ответ. 4. Укажите **Период ожидания (в минутах),** в течение которого робот будет ожидать сообщение от клиента.
Нажмите на кнопку «СОХРАНИТЬ». Далее необходимо обработать ответ клиента. Если клиент выбрал кнопку «Узнать подробнее об акции» – переведём сделку в стадию «Отправлена форма для записи». В данной стадии вы можете добавить ещё одного робота, который, например, отправит клиенту сообщение с ссылкой на форму записи на процедуру. Добавим робота **«Сменить стадию»** и выполним его настройку.
1. Обязательно укажите, что робот должен сработать **после предыдущего.** 2. Настроим условие срабатывания робота. Для этого необходимо обработать ответ пользователя, содержащийся в дополнительных результатах робота «Ожидание сообщения».
3\. Укажите стадию, на которую нужно изменить сделку.
Нажмите на кнопку «СОХРАНИТЬ». Последним шагом, добавим робота **«Запланировать дело»** и настроим его таким образом, чтобы он поставил на ответственного по сделке дело «Позвонить клиенту» в случае, если клиент выбрал кнопку «Узнать подробнее об акции» или не ответил в указанный промежуток времени.
Выполним настройку робота. Для этого на добавленном роботе нажмите на кнопку «изменить», чтобы открыть интерфейс редактирования робота. 1. Обязательно укажите, что робот должен сработать **после предыдущего.** 2. Настроим условие срабатывания робота. Для этого необходимо обработать ответ пользователя, содержащийся в дополнительных результатах робота «Ожидание сообщения». Здесь мы можем обработать ответ «Нет» и тот случай, если клиент не ответил в указанный промежуток времени.
Нажмите на кнопку «СОХРАНИТЬ».