Skip to content

Get started with your project

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, and SMS. 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

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.

  2. Integrate the SDK
    Add the Pushwoosh SDK to your app or website.

  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.
  4. Register users
    Subscribe devices and sync user data to enable push delivery.

Once the setup is complete, you can start sending push notifications via the Control Panel or use the createMessage 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.

  2. Integrate the SDK
    Add Pushwoosh SDK to your app to enable inbox functionality.

  3. Register users
    Sync user data to allow inbox message delivery.

  4. Implement Message inbox
    Follow platform-specific guides to implement inbox UI.

  5. Customize the UI (optional)
    Customize the inbox appearance as needed.

Once integration is complete, you can deliver inbox messages using Pushwoosh Customer Journey or the createMessage 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.

  2. Integrate the SDK
    Required for in-app message delivery.

  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.

  4. Register users
    Ensure devices are subscribed and user data is synced.

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.

  2. Register users
    Import and sync user email addresses.

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

WhatsApp messages

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

  2. Approve templates
    Submit your own templates to Meta or use pre-approved ones.

  3. Register WhatsApp contacts

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

SMS

Send text messages directly to user mobile numbers.

To enable SMS:

  1. Contact Support
    Request SMS feature activation and provider setup.

  2. Register phone numbers
    Collect and format numbers correctly (E.164) with user opt-in.

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

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.