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, 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
Anchor link toBefore 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
Anchor link toPush notifications
Anchor link toSend timely and personalized alerts to users across mobile and web platforms.
To enable push notifications:
Configure your platform Set up credentials for iOS, Android, Huawei, and Web.
Integrate the SDK Add the Pushwoosh SDK to your app or website.
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.
Register users Subscribe devices and sync user data to enable push delivery.
Set custom User IDs Assign a custom User ID to unify a person’s devices/contacts under one profile.
Once the setup is complete, you can start sending push notifications via the Control Panel or use the createMessage API method.
Message inbox
Anchor link toStore important messages in a dedicated in-app space to reach users even if they opt out of push notifications.
To enable Message inbox:
Configure platforms Set up your app for push messaging on supported platforms.
Integrate the SDK Add Pushwoosh SDK to your app to enable inbox functionality.
Register users Sync user data to allow inbox message delivery.
Set custom User IDs Assign a custom User ID to unify a person’s devices/contacts under one profile.
Implement Message inbox Follow platform-specific guides to implement inbox UI.
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
Anchor link toDisplay contextual messages directly inside your app.
To enable in-app messaging:
Configure your platform Ensure your app supports in-app messaging.
Integrate the SDK Required for in-app message delivery.
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.
Register users Ensure devices are subscribed and user data is synced.
Set custom User IDs Assign a custom User ID to unify a person’s devices/contacts under one profile.
After setup, you can send in-app messages via Customer Journey or use the Instant in-apps functionality.
Emails
Anchor link toReach your users with personalized email campaigns or transactional messages.
To start sending emails:
Configure email platform Authenticate your domain and sender address.
Register users Import and sync user email addresses.
Set custom User IDs Assign a custom User ID to unify a person’s devices/contacts under one profile.
Once setup is complete, you can start sending emails using the Pushwoosh Control Panel or the createEmailMessage method.
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:
Connect your WhatsApp Business account
Approve templates Submit your own templates to Meta or use pre-approved ones.
Register WhatsApp contacts
Set custom User IDs Assign a custom User ID to unify a person’s devices/contacts under one profile.
Once the integration is ready, you can send WhatsApp messages using the Control Panel or the createWhatsAppMessage API method.
Send text messages directly to user mobile numbers.
To enable SMS:
Contact Support Request SMS feature activation and provider setup.
Register phone numbers Collect and format numbers correctly (E.164) with user opt-in.
Set custom User IDs Assign a custom User ID to unify a person’s devices/contacts under one profile.
After setup, you can send SMS messages using the Customer Journey, or via the createSMSMessage API method.
LINE
Anchor link toUse 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:
Set up your LINE accounts Create a LINE Official Business Account and a LINE Developers Account.
Connect LINE to Pushwoosh Configure the LINE platform in your Pushwoosh account.
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.
Next steps
Anchor link toSend messages via API
Use the Pushwoosh API to send LINE messages with template or plain-text content.
Build omnichannel campaigns
Anchor link toOnce 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.