Как подключить 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 %}
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://help.myfreshcloud.com/integration/social-networks/whatsapp.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.