ComRaidComRaid Docs

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

SectionWhat it shows
ProfileFacts the SDK records, such as locale, timezone, language, country, first seen, and last active. Timezone matters for local-time scheduling.
DevicesEach push registration: platform, provider, app version, whether it's Active, and when it was last seen.
AttributesData your server attaches to the Contact, such as plan: premium. You can target Segments on these.
Channel opt-outWhether the Contact has opted out of push. When on, they get no Notifications on any device.
Notification preferencesWhich categories the Contact has turned on or off. Read-only here. Your app sets them through the API.
Notification historyThe 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.

  1. Click Add contact.
  2. Enter an External user ID (required) and, optionally, a Name.
  3. To add a phone at the same time, paste its push token under Push and choose the platform, provider, and, for APNs, the environment.
  4. Turn on Test device to add that phone to your Test devices. A push token is required for this.
  5. 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.

  1. Export your audience from OneSignal as a CSV.
  2. Upload it under OneSignal CSV.
  3. Leave Dry run on for the first try. ComRaid checks every row and lists errors (column, code, message) without saving anything.
  4. Choose a Default APNs environment for iOS rows that don't say sandbox or production.
  5. 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.

From the API

  • Create and update Contacts and their Attributes from your server: Contacts.
  • Register devices and set category preferences: Endpoints.
  • Choose who receives a Notification with Segments.

On this page