Contacts and devices
Find Contacts and their devices, add Contacts by hand, and import from OneSignal.
A Contact is one person who uses your app. Each Contact can have several devices (push registrations), one per phone or install. The Contacts page lets you look people up, check whether they can receive push, and add Contacts for testing.
In production, Contacts and devices are normally created by your app (through the ComRaid SDK) and your server (through the API), not by hand. Use this page to inspect them and to set up test data.
Find a Contact
Open Contacts and search by External user ID or name. The External user ID is the ID your own product uses for this person, sent to ComRaid as external_user_id.
You can narrow the list to:
- this Project's contacts, contacts With Test devices, or All.
- Contacts that Has active device or No active device. A Contact with no active device can't receive push.
Results show 50 per page.
What's on a Contact's page
| Section | What it shows |
|---|---|
| Profile | Facts the SDK records, such as locale, timezone, language, country, first seen, and last active. Timezone matters for local-time scheduling. |
| Devices | Each push registration: platform, provider, app version, whether it's Active, and when it was last seen. |
| Attributes | Data your server attaches to the Contact, such as plan: premium. You can target Segments on these. |
| Channel opt-out | Whether the Contact has opted out of push. When on, they get no Notifications on any device. |
| Notification preferences | Which categories the Contact has turned on or off. Read-only here. Your app sets them through the API. |
| Notification history | The Notifications sent to this Contact. |
From a Contact's page you can also click Send Notification to send to just this person. See Send a Notification.
Opt a Contact out
Turn on Opted out of push to stop all Notifications to this Contact, for example after a support request. Their devices stay registered. Turn it off to opt them back in. Opting out overrides category preferences.
Devices
Switch to the Devices tab to see every push registration in the Project, including Anonymous ones from people who haven't logged in to your app yet.
Filter by Identity (Anonymous or Identified), Active, Platform (Android or iOS), and Provider (FCM or APNs). Open a device to see its details: provider, platform, whether its login was verified, when it was last seen, and SDK-recorded facts such as app version, OS, model, and session count. Push tokens are never shown.
- When a user logs in to your app, their device moves from Anonymous to their Contact. When they log out, it goes back to Anonymous. The device itself isn't deleted.
- A device that registered successfully has a token, but that doesn't prove a push will reach it. Use a Test send to check.
Add a Contact
Usually for testing. Your app and server create real Contacts.
- Click Add contact.
- Enter an External user ID (required) and, optionally, a Name.
- To add a phone at the same time, paste its push token under Push and choose the platform, provider, and, for APNs, the environment.
- Turn on Test device to add that phone to your Test devices. A push token is required for this.
- Save.
To add a phone to an existing Contact, open the Contact and click Add push device.
Saving a token doesn't check it
ComRaid stores the token as you paste it, without asking Google or Apple whether it's valid. Use Test send to confirm it works.
Import from OneSignal
To bring your existing audience across, click OneSignal Import on the Contacts page.
- Export your audience from OneSignal as a CSV.
- Upload it under OneSignal CSV.
- Leave Dry run on for the first try. ComRaid checks every row and lists errors (column, code, message) without saving anything.
- Choose a Default APNs environment for iOS rows that don't say sandbox or production.
- Fix any errors, turn Dry run off, and upload again.
You can safely run the import again. Rows are matched by push token, so nothing is duplicated. Full guide: Migrate from OneSignal.
There's no export from the Dashboard yet.