Project setup guide

This guide outlines the steps to set up your Pushwoosh project and messaging channels such as push notifications, message inbox, in-app messaging, email, WhatsApp, LINE, Kakao, SMS, and Apple and Google Wallet passes. Depending on the channel, you’ll configure platform settings, integrate SDKs (if required), and register user data.

Once a channel is configured, you can start sending messages through the Pushwoosh Control Panel or via the API.

Prerequisites

Before you start working with any communication channel, complete these steps:

• Create a Pushwoosh account

• Use your default project or create a new one A default project (My project) is created when you register. Use it for one app across multiple platforms, or create separate projects for different apps

  Learn how to create a project

Set up messaging channels

Push notifications

Send timely and personalized alerts to users across mobile and web platforms.

To enable push notifications:

1. Configure your platform

   Set up credentials for iOS, Android, Huawei, and Web. Learn more

2. Integrate the SDK

   Add the Pushwoosh SDK to your app or website. Learn more

3. Test the integration and publish your app or website

   Ensure push functionality works as expected.

   • For apps, release the version with integrated SDK to the app stores. For websites, just update your live site. Learn more

4. Register users

   Subscribe devices and sync user data to enable push delivery. Learn more

5. Set custom User IDs

   Assign a custom User ID to unify a person’s devices/contacts under one profile. Learn more

Once the setup is complete, you can start sending push notifications via the Control Panel or use the Notify API method.

Message inbox

Store important messages in a dedicated in-app space to reach users even if they opt out of push notifications.

To enable Message inbox:

1. Configure platforms

   Set up your app for push messaging on supported platforms. Learn more

2. Integrate the SDK

   Add Pushwoosh SDK to your app to enable inbox functionality. Learn more

3. Register users

   Sync user data to allow inbox message delivery. Learn more

4. Set custom User IDs

   Assign a custom User ID to unify a person’s devices/contacts under one profile. Learn more

5. Implement Message inbox

   Follow platform-specific guides to implement inbox UI. Learn more

6. Customize the UI (optional)

   Customize the inbox appearance as needed. Learn more

Once integration is complete, you can deliver inbox messages using Pushwoosh Customer Journey or the Notify API method.

In-app messages

Display contextual messages directly inside your app.

To enable in-app messaging:

1. Configure your platform

   Ensure your app supports in-app messaging. Learn more

2. Integrate the SDK

   Required for in-app message delivery. Learn more

3. Test the integration and publish your app

   Ensure in-app functionality works as expected and release the version with the integrated SDK to the app stores. Learn more

4. Register users

   Ensure devices are subscribed and user data is synced. Learn more

5. Set custom User IDs

   Assign a custom User ID to unify a person’s devices/contacts under one profile. Learn more

After setup, you can send in-app messages via Customer Journey or use the Instant in-apps functionality.

Emails

Reach your users with personalized email campaigns or transactional messages.

To start sending emails:

1. Configure email platform

   Authenticate your domain and sender address. Learn more

2. Register users

   Import and sync user email addresses. Learn more

3. Set custom User IDs

   Assign a custom User ID to unify a person’s devices/contacts under one profile. Learn more

Once setup is complete, you can start sending emails using the Pushwoosh Control Panel or the Notify method.

WhatsApp

Engage users on one of the world’s most widely used messaging apps, delivering secure and approved messages that drive meaningful interactions.

To enable WhatsApp messaging:

1. Connect your WhatsApp Business account

   Learn more

2. Approve templates

   Submit your own templates to Meta or use pre-approved ones. Learn more

3. Register WhatsApp contacts

   Learn more

4. Set custom User IDs

   Assign a custom User ID to unify a person’s devices/contacts under one profile. Learn more

Once the integration is ready, you can send WhatsApp messages using the Control Panel or the Notify API method.

SMS

Send text messages directly to user mobile numbers.

To enable SMS:

1. Connect your SMS provider

   Learn more

   For provider callback URLs, see SMS provider webhooks.

2. Register phone numbers

   Collect and format numbers correctly (E.164) with user opt-in. Learn more

3. Set custom User IDs

   Assign a custom User ID to unify a person’s devices/contacts under one profile. Learn more

After setup, you can send SMS messages using the Customer Journey, or via the Notify API method.

LINE

Use LINE to connect with users via Customer Journeys, API, or 1:1 chat, using either templates or plain-text messages. To start using LINE messaging:

1. Set up your LINE accounts Create a LINE Official Business Account and a LINE Developers Account.

2. Connect LINE to Pushwoosh Configure the LINE platform in your Pushwoosh account. Learn more

3. Make sure LINE Messaging is set up and billing is enabled.

   Important: LINE Messaging API pricing is managed directly by LINE. Plans vary by region and usage volume. View pricing details

Next steps

• Send messages via API

  Use the Pushwoosh API to send LINE messages with template or plain-text content.

  Notify

Kakao

Send Kakao messages via Customer Journeys or API using approved templates to reach users on KakaoTalk.

To start using Kakao messaging:

1. Connect Kakao to Pushwoosh

   Configure the Kakao platform in your Pushwoosh account. Learn more

2. Create and approve message templates

   Use approved Kakao templates; custom templates require approval in the Kakao Business Center. Learn more

Next steps

• Send messages via API

  Use the Pushwoosh API to send Kakao messages with approved templates.

  Notify

Apple Wallet passes

Design Apple Wallet passes, including loyalty cards, coupons, event tickets, and more, and push live updates to every device that added them.

To start using Apple Wallet passes:

1. Configure the signing certificate

   Add your Apple Pass Type ID certificate to your application so Pushwoosh can sign passes. Learn more

2. Design and issue a pass

   Build a pass in the pass builder, then share it as an install link or QR code. Learn more

Next steps

• Learn more about Apple Wallet passes

  Design, distribute, and update passes in the Control Panel.

  Learn more

• Manage passes via API

  Use the PassKit API to create, update, and manage passes programmatically.

  Learn more

Google Wallet passes

Design Google Wallet passes, including loyalty cards, offers, event tickets, and more, and let Google sync updates to every device that saved them.

To start using Google Wallet passes:

1. Configure Google Wallet in Pushwoosh

   Add your Issuer ID and service account key to your application. This setup is independent of Firebase. Learn more

2. Design and issue a pass

   Build a pass in the pass builder, then share an “Add to Google Wallet” save link or QR code. Learn more

Next steps

• Distribute, and update passes in the Control Panel

  Learn more

• Message pass holders

  Reach holders with pass updates, one-time push, or Customer Journey.

  Learn more

• Manage passes via API

  Use the Google Wallet API to create passes, issue save links, and send them to users.

  Learn more

Build omnichannel campaigns

Once you’ve configured and integrated the necessary messaging channels, you can create omnichannel campaigns to coordinate communication across multiple touchpoints.

To enable omnichannel functionality, ensure you register and associate user data (e.g., device ID, email, phone number) under a unified User ID. This allows you to address the same user across channels from a single campaign logic.

Learn more about omnichannel campaigns