# Руководство по настройке проекта

В этом руководстве описаны шаги по настройке вашего проекта Pushwoosh и каналов обмена сообщениями, таких как push-уведомления, входящие сообщения, in-app сообщения, email, WhatsApp, LINE, Kakao, SMS, а также карты Apple и Google Wallet. В зависимости от канала, вам потребуется настроить параметры платформы, интегрировать SDK (если требуется) и зарегистрировать данные пользователей.

Как только канал будет настроен, вы сможете отправлять сообщения через Панель управления Pushwoosh или через API.

## Предварительные условия

Прежде чем начать работу с любым каналом коммуникации, выполните следующие шаги:

*   **Создайте аккаунт Pushwoosh**

*   **Используйте ваш проект по умолчанию или создайте новый**
    Проект по умолчанию (**My project**) создается при регистрации. Используйте его для одного приложения на нескольких платформах или создавайте отдельные проекты для разных приложений.
    <LinkCard title="Узнайте, как создать проект" href="/product/first-steps/start-with-your-project/create-your-project/" />

## Настройка каналов обмена сообщениями

<TitleIcon icon="push">
### Push-уведомления
</TitleIcon>

Отправляйте своевременные и персонализированные оповещения пользователям на мобильных и веб-платформах.

Чтобы включить push-уведомления:

<Steps>
1. **Настройте вашу платформу**

   Настройте учетные данные для iOS, Android, Huawei и Web. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/configure-project/)

2. **Интегрируйте SDK**

   Добавьте Pushwoosh SDK в ваше приложение или на сайт. [Узнать больше](/ru/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **Протестируйте интеграцию и опубликуйте ваше приложение или сайт**

   Убедитесь, что функциональность push-уведомлений работает, как ожидалось.
   *   Для приложений выпустите версию с интегрированным SDK в магазины приложений.
   Для сайтов просто обновите ваш действующий сайт. [Узнать больше](/ru/developer/first-steps/test-your-integration/test-devices/)

4. **Зарегистрируйте пользователей**

   Подпишите устройства и синхронизируйте данные пользователей, чтобы обеспечить доставку push-уведомлений. [Узнать больше](/ru/developer/first-steps/subscribe-users/)

5. **Установите кастомные User ID**

   Присвойте кастомный User ID, чтобы объединить устройства/контакты пользователя в один профиль. [Узнать больше](/ru/developer/first-steps/collecting-user-ids/)
</Steps>

После завершения настройки вы можете начать [отправлять push-уведомления через Панель управления](/ru/product/messaging-channels/push-notifications/#start-sending-different-types-of-push-notifications) или использовать метод API [`Notify`](/ru/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="download">
### Входящие сообщения
</TitleIcon>

Храните важные сообщения в специальном разделе внутри приложения, чтобы достучаться до пользователей, даже если они отказались от push-уведомлений.

Чтобы включить Входящие сообщения:

<Steps>
1. **Настройте платформы**

   Настройте ваше приложение для обмена push-сообщениями на поддерживаемых платформах. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/configure-project/)

2. **Интегрируйте SDK**

   Добавьте Pushwoosh SDK в ваше приложение, чтобы включить функциональность входящих сообщений. [Узнать больше](/ru/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **Зарегистрируйте пользователей**

   Синхронизируйте данные пользователей, чтобы разрешить доставку сообщений во входящие. [Узнать больше](/ru/developer/first-steps/subscribe-users/)

4. **Установите кастомные User ID**

   Присвойте кастомный User ID, чтобы объединить устройства/контакты пользователя в один профиль. [Узнать больше](/ru/developer/first-steps/collecting-user-ids/)

5. **Реализуйте Входящие сообщения**

   Следуйте руководствам для конкретных платформ, чтобы реализовать пользовательский интерфейс входящих сообщений. [Узнать больше](/ru/developer/guides/message-inbox/)

6. **Настройте пользовательский интерфейс (опционально)**

   При необходимости настройте внешний вид входящих сообщений. [Узнать больше](/ru/developer/guides/message-inbox/)
</Steps>

После завершения интеграции вы можете доставлять сообщения во входящие с помощью [Pushwoosh Customer Journey](/ru/product/customer-journey/journey-elements/#save-to-inbox) или метода API [`Notify`](/ru/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="inapp">
### In-App сообщения
</TitleIcon>

Отображайте контекстные сообщения прямо внутри вашего приложения.

Чтобы включить in-app сообщения:

<Steps>
1. **Настройте вашу платформу**

   Убедитесь, что ваше приложение поддерживает in-app сообщения. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/configure-project/)

2. **Интегрируйте SDK**

   Требуется для доставки in-app сообщений. [Узнать больше](/ru/developer/pushwoosh-sdk/pushwoosh-sdk-overview/)

3. **Протестируйте интеграцию и опубликуйте ваше приложение**

   Убедитесь, что функциональность in-app работает, как ожидалось, и выпустите версию с интегрированным SDK в магазины приложений. [Узнать больше](/ru/developer/first-steps/test-your-integration/)

4. **Зарегистрируйте пользователей**

   Убедитесь, что устройства подписаны и данные пользователей синхронизированы. [Узнать больше](/ru/developer/first-steps/subscribe-users/)

5. **Установите кастомные User ID**

   Присвойте кастомный User ID, чтобы объединить устройства/контакты пользователя в один профиль. [Узнать больше](/ru/developer/first-steps/collecting-user-ids/)
</Steps>

После настройки вы можете отправлять in-app сообщения через [Customer Journey](/ru/product/messaging-channels/in-apps/sending-in-apps/#send-in-apps-via-customer-journey) или использовать функциональность [мгновенных in-app сообщений](/ru/product/messaging-channels/in-apps/sending-in-apps/#send-instant-in-apps).

<TitleIcon icon="email">
### Email-сообщения
</TitleIcon>

Обращайтесь к вашим пользователям с персонализированными email-кампаниями или транзакционными сообщениями.

Чтобы начать отправлять email-сообщения:

<Steps>
1. **Настройте email-платформу**

   Аутентифицируйте ваш домен и адрес отправителя. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/email-verification/)

2. **Зарегистрируйте пользователей**

   Импортируйте и синхронизируйте адреса электронной почты пользователей. [Узнать больше](/ru/developer/first-steps/subscribe-users/)

3. **Установите кастомные User ID**

   Присвойте кастомный User ID, чтобы объединить устройства/контакты пользователя в один профиль. [Узнать больше](/ru/developer/first-steps/collecting-user-ids/)
</Steps>

После завершения настройки вы можете начать отправлять email-сообщения с помощью Панели управления Pushwoosh или метода [`Notify`](/ru/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="whatsapp">
### WhatsApp
</TitleIcon>

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

Чтобы включить обмен сообщениями в WhatsApp:

<Steps>
1. **Подключите ваш аккаунт WhatsApp Business**

   [Узнать больше](/ru/product/first-steps/start-with-your-project/configure-platforms/whatsapp-configuration/)

2. **Одобрите шаблоны**

   Отправьте свои собственные шаблоны в Meta или используйте предварительно одобренные. [Узнать больше](/ru/product/messaging-channels/whatsapp-messages/#create-whatsapp-templates)

3. **Зарегистрируйте контакты WhatsApp**

   [Узнать больше](/ru/developer/first-steps/subscribe-users/)

4. **Установите кастомные User ID**

   Присвойте кастомный User ID, чтобы объединить устройства/контакты пользователя в один профиль. [Узнать больше](/ru/developer/first-steps/collecting-user-ids/)
</Steps>

Как только интеграция будет готова, вы можете отправлять сообщения WhatsApp [с помощью Панели управления](/ru/product/messaging-channels/whatsapp-messages/send-whatsapp-messages/) или метода API [`Notify`](/ru/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="sms">
### SMS
</TitleIcon>

Отправляйте текстовые сообщения непосредственно на мобильные номера пользователей.

Чтобы включить SMS:

<Steps>
1. **Подключите вашего SMS-провайдера**

   [Узнать больше](/ru/developer/first-steps/connect-messaging-services/sms-configuration/)

   Для URL-адресов обратного вызова провайдера см. [вебхуки SMS-провайдера](/ru/developer/first-steps/connect-messaging-services/sms-configuration/sms-provider-webhooks/).

2. **Зарегистрируйте номера телефонов**

   Собирайте и форматируйте номера правильно (E.164) с согласия пользователя. [Узнать больше](/ru/developer/first-steps/subscribe-users/)

3. **Установите кастомные User ID**

   Присвойте кастомный User ID, чтобы объединить устройства/контакты пользователя в один профиль. [Узнать больше](/ru/developer/first-steps/collecting-user-ids/)
</Steps>

После настройки вы можете отправлять SMS-сообщения с помощью [Customer Journey](/ru/product/customer-journey/journey-elements/#sms) или через метод API [`Notify`](/ru/developer/api-reference/messaging-api-v2/notify/).

<TitleIcon icon="line">
### LINE
</TitleIcon>

Используйте LINE для связи с пользователями через Customer Journeys, API или чат 1:1, используя шаблоны или обычные текстовые сообщения.
Чтобы начать использовать обмен сообщениями в LINE:

<Steps>

1. **Настройте ваши аккаунты LINE**
   Создайте [LINE Official Business Account](https://www.linebiz.com/jp-en/) и [LINE Developers Account](https://developers.line.biz/en/docs/line-developers-console/login-account/).

2. **Подключите LINE к Pushwoosh**
   Настройте платформу LINE в вашем аккаунте Pushwoosh. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/line-configuration/)

3. **Убедитесь, что LINE Messaging настроен и биллинг включен.**
   > **Важно:** Цены на LINE Messaging API управляются непосредственно LINE. Тарифы зависят от региона и объема использования. [Посмотреть детали ценообразования](https://developers.line.biz/en/docs/messaging-api/pricing/)

</Steps>

##### Следующие шаги

*   **Отправляйте сообщения через API**

    Используйте Pushwoosh API для отправки сообщений LINE с шаблонным или обычным текстовым содержанием.

    <LinkCard title="Notify" href="/developer/api-reference/messaging-api-v2/notify/" />

<TitleIcon icon="comment">
### Kakao
</TitleIcon>

Отправляйте сообщения Kakao через Customer Journeys или API, используя одобренные шаблоны, чтобы достучаться до пользователей в KakaoTalk.

Чтобы начать использовать обмен сообщениями в Kakao:

<Steps>

1. **Подключите Kakao к Pushwoosh**

   Настройте платформу Kakao в вашем аккаунте Pushwoosh. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/kakao-configuration/)

2. **Создайте и одобрите шаблоны сообщений**

   Используйте одобренные шаблоны Kakao; кастомные шаблоны требуют одобрения в Kakao Business Center. [Узнать больше](/ru/product/content/kakao-presets/)

</Steps>

##### Следующие шаги

*   **Отправляйте сообщения через API**

    Используйте Pushwoosh API для отправки сообщений Kakao с одобренными шаблонами.

    <LinkCard title="Notify" href="/developer/api-reference/messaging-api-v2/notify/" />

### Карты Apple Wallet

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

Чтобы начать использовать карты Apple Wallet:

<Steps>

1. **Настройте сертификат подписи**

   Добавьте ваш сертификат Apple Pass Type ID в ваше приложение, чтобы Pushwoosh мог подписывать карты. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/ios-configuration/ios-wallet-pass-configuration/)

2. **Создайте и выпустите карту**

   Создайте карту в конструкторе карт, затем поделитесь ею в виде ссылки для установки или QR-кода. [Узнать больше](/ru/product/messaging-channels/apple-wallet-passes/pass-builder/)

</Steps>

##### Следующие шаги

*   **Узнайте больше о картах Apple Wallet**

    Создавайте, распространяйте и обновляйте карты в Панели управления.

    <LinkCard title="Узнать больше" href="/product/messaging-channels/apple-wallet-passes/" />

*   **Управляйте картами через API**

    Используйте PassKit API для программного создания, обновления и управления картами.

    <LinkCard title="Узнать больше" href="/developer/api-reference/apple-wallet-passkit-api/" />

### Карты Google Wallet

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

Чтобы начать использовать карты Google Wallet:

<Steps>

1. **Настройте Google Wallet в Pushwoosh**

   Добавьте ваш Issuer ID и ключ сервисного аккаунта в ваше приложение. Эта настройка не зависит от Firebase. [Узнать больше](/ru/developer/first-steps/connect-messaging-services/android-configuration/android-google-wallet-configuration/)

2. **Создайте и выпустите карту**

   Создайте карту в конструкторе карт, затем поделитесь ссылкой для сохранения "Добавить в Google Wallet" или QR-кодом. [Узнать больше](/ru/product/messaging-channels/google-wallet-passes/pass-builder/)

</Steps>

##### Следующие шаги

*   **Распространяйте и обновляйте карты в Панели управления**

    <LinkCard title="Узнать больше" href="/product/messaging-channels/google-wallet-passes/" />

*   **Отправляйте сообщения держателям карт**

    Обращайтесь к держателям с обновлениями карт, разовыми push-уведомлениями или через Customer Journey.

    <LinkCard title="Узнать больше" href="/product/messaging-channels/google-wallet-passes/message-pass-holders/" />

*   **Управляйте картами через API**

    Используйте Google Wallet API для создания карт, выпуска ссылок для сохранения и отправки их пользователям.

    <LinkCard title="Узнать больше" href="/developer/api-reference/google-wallet-api/" />

## Создавайте омниканальные кампании

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

Чтобы включить омниканальную функциональность, убедитесь, что вы регистрируете и связываете данные пользователей (например, ID устройства, email, номер телефона) под [единым User ID](/ru/developer/pushwoosh-knowledge-hub/users-userids/). Это позволит вам обращаться к одному и тому же пользователю по разным каналам из одной логики кампании.

<LinkCard title="Узнайте больше об омниканальных кампаниях" href="/product/pushwoosh-knowledge-hub/omnichannel-campaigns/" />