> For the complete documentation index, see [llms.txt](https://help.myfreshcloud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.myfreshcloud.com/integration/social-networks/whatsapp.md).
# WhatsApp\*
Как подключить WhatsApp* Business для приема входящих сообщений в чат и отправлки шаблонов из приложения FreshOffice
⚠️ ***Внимание**: на странице и в видео упоминаются сервисы компании Meta Platforms Inc.* ⚠️ Деятельность Meta Platforms Inc. (Facebook\*, Instagram\*) признана экстремистской в РФ (решение Тверского районного суда г. Москвы от 21.03.2022 № 02-215/2022).
Инструкция **не призывает** к использованию запрещённых сервисов. Пользователи обязаны соблюдать законодательство РФ. ООО "Свежие решения" не несёт ответственности за нарушения, допущенные пользователями.\
\
Данная инструкция **техническая**, касается только интеграции *WhatsApp\* Business* с легальной CRM
{% embed url="" %}
{% hint style="info" %}
Интеграция выполняется через API компании Meta. Управление аккаунтом WhatsApp\* происходит в панели управления бизнес‑портфолио Facebook\* **Как оформить ваше бизнес‑портфолио** рассказано в официальной инструкции [facebook](https://www.facebook.com/business/help/1710077379203657) **\***
{% endhint %}
### Требования перед стартом
Убедитесь, что у вас есть базовый набор для начала работы:
* **Аккаунт** Facebook\*— учётная запись на платформе.
* **Бизнес‑сайт** — официальный ресурс компании.
* **Бизнес‑портфолио** — профиль компании в системе Facebook\* для управления инструментами.
### Требования к номеру телефона
* **Новый аккаунт.** Используйте номер, никогда не регистрировавшийся в WhatsApp\* Business. Это гарантирует корректное создание аккаунта с привязкой к вашему бизнес‑портфолио.
* **Существующий аккаунт.** Если вы хотите использовать уже действующий аккаунт WhatsApp\* Business, его необходимо **предварительно отвязать** от предыдущего бизнес‑портфолио. Это предотвратит ошибки синхронизации и конфликты данных.
* **Номер должен принимать SMS или звонки для получения кода авторизации**. В зависимости от типа номера (мобильный, виртуальный, городской) выбирается способ получения кода — через SMS или входящий звонок.
### Настройка WhatsApp\* Business в Facebook\*
1. Перейдите в панель управления бизнес‑портфолио Facebook\*
2. Создайте **новый аккаунт WhatsApp\***
3. Введите номер телефона, который вы хотите привязать к аккаунту, и подтвердите его.
4. Укажите имя, (например, название компании) которое будут видеть клиенты. Дождитесь, проверки и подтверждения Facebook\***.**
Аккаунт готов к подключению в FreshOffice.
### FreshOffice & WatsApp\* Business
1. Перейдите в раздел: **Настройки → Внешний чат → WhatsApp\***
2. Добавьте WhatsApp\* и авторизуйтесь в Facebook\* под администратором **бизнес‑портфолио** Facebook**\***
3. В выпадающем списке выберите:
* нужную организацию;
* номер телефона WhatsApp\*, который ранее был привязан к вашему бизнес‑портфолио
4. При необходимости укажите PIN‑код, если у вас подключена 2-х факторная авторизация используемая для входа.
5. На финальном этапе настройте параметры генерации лидов (используйте стандартные настройки или задайте свои).
6. Нажмите Добавить - и аккаунт появится в списоке.
### Отправка исходящих шаблонных сообщений
Согласно правилам WhatsApp\*, вы можете отправлять **первые** **сообщения** **только утверждёнными шаблонами**. Они делятся на несколько категорий (например, *Marketing* и служебные уведомления).
Управление шаблонами осуществляется в интерфейсе Facebook\* — в разделе **Business WhatsApp\* Manager**. Вы можете создать неограниченное количество шаблонов в разных категориях.
#### Как отправить сообщение
Есть два способа отправки.
**Способ 1. Через карточку контрагента**
* Перейдите в карточку контрагента → раздел «Контакты».
* Найдите иконку WhatsApp\* рядом с телефоном или контактным лицом.
* В открывшейся форме:
1. выберите аккаунт, с которого будет отправлено сообщение;
2. выберите нужный шаблон;
3. нажмите «Отправить».
**Способ 2. Через форму софтфона** (где совершаются звонки и отправляются SMS)
* Откройте форму софтфона.
* В открывшейся форме:
1. выберите аккаунт, с которого будет отправлено сообщение;
2. укажите получателя (кому отправляется сообщение);
3. выберите нужный шаблон;
4. нажмите «Отправить».
{% hint style="info" %}
**Статус сообщения** (отправка, получение, прочтение) можно посмотреть в журнале событий по конкретной компании/сделке либо в общем журнале всех событий.
{% endhint %}
### Получение входящих сообщений
Все сообщения, поступающие в WhatsApp\* Business, дублируются в [чате FreshOffice](/attachment/chat/external.md). Это позволяет вести общение в единой среде — так же, как с обращениями из любых других источников. \
\
Дополнительно вы можете предоставить клиентам удобный способ связи, разместив на своём сайте ссылку на номер WhatsApp\* или QR‑код (аналогично примеру на нашей странице) [контакты](https://www.freshoffice.ru/contacts) ****
{% hint style="warning" %}
Если пользователь сам написал вам или ответил на ваше сообщение, в течение **24 часов** можно отправлять любые текстовые и шаблонные сообщения без ограничений (отсчёт начинается заново после каждого сообщения от пользователя).
{% endhint %}
{% hint style="danger" %}
Деятельность Meta Platforms Inc. (Facebook\*, Instagram\*) признана экстремистской в РФ (решение Тверского районного суда г. Москвы от 21.03.2022 № 02-215/2022). \
Инструкция техническая, касается только интеграции с легальной CRM.\
ООО "Свежие решения" не несёт ответственности за нарушения, допущенные пользователями при использовании инструкции.
{% endhint %}