Skip to content

Register devices in Pushwoosh and sync data with the platform

To effectively target and engage users through Pushwoosh, it’s crucial to ensure that user devices are properly registered and your data is synchronized. There are several methods for registering devices and synchronizing data with Pushwoosh, depending on your specific needs.

Pushwoosh SDK

Anchor link to

For mobile apps, Pushwoosh SDK integration is the recommended method for seamless device registration and data synchronization between the app, Pushwoosh systems, and, optionally, third-party systems that customers may use for specific data pipelines or workflows.

By integrating the SDK, you can automate the process of registering devices and handling their push tokens. The SDK internally calls the registerDevice API method, ensuring that every device is registered and synchronized with Pushwoosh without requiring any manual intervention.

Additionally, the Pushwoosh SDK allows registering phone numbers for SMS and WhatsApp notifications. You can use the following methods:

Register an SMS number

Anchor link to
+ (void)registerSmsNumber:(NSString * _Nonnull)number;

Example

Pushwoosh.configure.registerSmsNumber("+0000000000")

Replace +0000000000 with the actual phone number in E.164 format (including the “+” sign and country code).

Pushwoosh.getInstance().registerSMSNumber(String number);

Example

Pushwoosh.getInstance().registerSMSNumber("+0000000000");

Replace +0000000000 with the user’s actual phone number in E.164 format, including the “+” and country code.

Register a WhatsApp number

Anchor link to
+ (void)registerWhatsappNumber:(NSString * _Nonnull)number;

Example

Pushwoosh.configure.registerWhatsappNumber("+0000000000")

Replace +0000000000 with the actual phone number in E.164 format (including the “+” sign and country code).

To register a user’s phone number for WhatsApp on Android, use the following method:

Pushwoosh.getInstance().registerWhatsappNumber(String number);

Example

Pushwoosh.getInstance().registerWhatsappNumber("+0000000000");

Replace +0000000000 with the user’s actual phone number in E.164 format, including the “+” and country code.

To register devices for web pushes, use the Web Push SDK.

Learn more about Pushwoosh SDK

Pushwoosh API

Anchor link to

Also, you can use the Pushwoosh API to register devices and synchronize data. The API provides full flexibility for more advanced scenarios.

To register mobile devices, use the registerDevice API method.

Pushwoosh provides built-in subscription forms that you can embed on your website to collect email signups. Learn how to create and embed a form and customize the widget.

After collecting emails, use the registerEmail API method to register email devices. Alternatively, you can use registerDevice.

To associate your app users or site visitors with their email addresses, use the User IDs. That allows you to build cross-channel Customer Journeys and send emails based on user’s actions in your app or on the website. The User ID will also allow you to view the user’s message and event history in User Explorer.

1. Get the User ID.

Each device registered for your Pushwoosh project has its User ID; by default, it’s equal to the device hardware ID (HWID) and is retrieved by the registerDevice API request.

To set a custom User ID, call the registerUser method.

2. Assign the User ID to an email address.

Use the registerEmail or registerEmailUser API method to associate the User ID with an email address.

Learn more about User IDs

To register SMS devices in Pushwoosh, you can use either the registerDevice API method or the createSMSMessage API method. When using the latter, make sure to set the use_auto_registration parameter to true in order to automatically register the phone number as an SMS device. Learn more

To register WhatsApp devices in Pushwoosh, you can use either the registerDevice API method or the createWhatsAppMessage API method. When using the latter, make sure to set the use_auto_registration parameter to true in order to automatically register the phone number as a WhatsApp device.

Importing your existing user base

Anchor link to

If you’re working with large sets of pre-existing data, you can import this data into Pushwoosh.

To import your mobile push subscribers, go to Audience > Import CSV, choose Import push subscribers, and upload a .csv file. The import supports iOS, Android, Huawei, Amazon, macOS, and Windows devices. Learn more

Web users cannot be imported due to technical limitations. Different push providers use varying payload formats and platform configurations, making importing web users ineffective. As a result, the imported user base would either be invalidated or receive incorrect or blank content.

However, web users who have already given permission to receive push notifications for your website can be resubscribed. Learn more

Email, SMS, WhatsApp, and Viber

Anchor link to

To import email, SMS, WhatsApp, and Viber contacts, go to Audience > Import CSV and choose Import Contacts. One .csv file can contain contacts for all four channels. The Import Contacts card is shown only if your account has access to Content > Email content, and it’s hidden in demo applications. Learn more

Using 3rd-party integrations to transfer data

Anchor link to

In addition to the SDK and API, Pushwoosh offers several third-party integrations to help you synchronize and transfer data from other platforms, making it easier to manage users and data across multiple systems.

Explore all available integrations