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
Mobile
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
iOS
- (void)registerSmsNumber:(NSString * _Nonnull)number;Example
Pushwoosh.sharedInstance().registerSmsNumber(@"+0000000000");Replace +0000000000 with the actual phone number in E.164 format (including the “+” sign and country code).
Android
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
iOS
- (void)registerWhatsappNumber:(NSString * _Nonnull)number;Example
Pushwoosh.sharedInstance().registerWhatsappNumber(@"+0000000000");Replace +0000000000 with the actual phone number in E.164 format (including the “+” sign and country code).
Android
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.
Web
To register devices for web pushes, use the Web Push SDK.
Learn more about Pushwoosh SDK
Pushwoosh API
Also, you can use the Pushwoosh API to register devices and synchronize data. The API provides full flexibility for more advanced scenarios.
Mobile
To register mobile devices, use the registerDevice API method.
To let users subscribe to your emails, collect their emails by custom opt-in form and 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.
SMS
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
If you’re working with large sets of pre-existing data, you can import this data into Pushwoosh.
Mobile
To migrate your Mobile push subscribers base, please contact us via the Contact Us form and provide a sample of your user base. Our team will review the data format and assess whether the migration is feasible.
Web
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
To import your email subscriber database, upload a .csv file with the email addresses. The emails imported will be registered as subscribers on the email platform. You can also submit additional data for each email address, such as the recipient’s name, gender, or location, to better segment and personalize your email communications.
SMS
Import a .csv file with phone numbers for SMS subscribers. You can provide additional data, such as the recipient’s name, gender, or location, to further segment and personalize your SMS communications.
To import your WhatsApp contacts, upload a .csv file with WhatsApp contacts. You can also provide extra details, such as the recipient’s name, gender, or location, to customize your WhatsApp messages.
Using 3rd-party integrations to transfer data
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.