Accessing Atomic’s Connect apps
Atomic Connect apps are available for iOS, Android, and Web. Each of them handle customer authentication, which means you don't have to install our SDKs to get started testing cards.
The following video will walk you through how to easily get and configure the Atomic Demo apps:
iOS Demo app
Available in the Apple App Store. Search for Atomic Connect.
Android Demo app
Available in the Google Play Store. Search for Atomic Connect.
Web Demo app
You can login to a Web Demo app by visiting https://demo.atomic.io/.
Use the same email and password as you do for the Workbench.
You can read more about sending test cards in our sending cards tutorial.
Configuring the Connect app
There are different ways to use the Connect app:
Log in using your workbench credentials. You will need to open the Connect app, select ‘Get magic auth link’, and then login using your workbench login credentials. Choose the Organization, Environment, Container, and User you would like to connect to, before clicking 'Finish setup'.
Use a magic link. Without having to log in first, you can paste your magic link into the welcome screen at the bottom (under the heading "Enter details manually").
You can read more about creating and using magic links in our sending cards tutorial.
Troubleshooting Demo Apps
This article outlines steps to check if you are not receiving cards sent through the Atomic platform to the Atomic Demo apps.
We’ve divided the things you can check into the two areas: Atomic Demo App and the Workbench.
Atomic Demo App
Before receiving cards, you need to have the Atomic Connect app installed for either iOS or Android. The Web Connect app does not require installation.
1. Refresh your app
- iOS: perform a force close by swiping up from the home screen or double-tapping the home button, finding the Atomic Demo App, and then swiping up on the preview. To see updates to themes, a second force close may be required, as the old theme may be cached.
- Android: on the navigation bar at the bottom of the screen, select the square, and then swipe the Atomic Demo App away to close it.
- Web: refresh your browser to ensure you have any recent updates.
2. Configure the app
- Open the settings screen, and check you are connected to your desired Organization, Environment, Container, and are assuming your desired user profile.
- See more on configuring the Demo App.
3. Notifications are enabled on your device
- Go to Settings > Do Not Disturb and check that Do Not Disturb is off, or not currently scheduled.
- Go to Settings > Notifications > Atomic Demo App and make sure that Notifications are on.
- Go to Settings > Do not disturb, and check it is off.
- Go to Settings > Apps and Notifications, and for the Atomic Demo App, select App notifications. Check they are on.
4. Get the latest version of the app
- iOS: iOS automatically updates Atomic Connect by default, but if there is an issue go to the App Store, and tap your profile icon at the top of the screen, and then scroll to see pending updates and release notes. Tap Update next to an app to update only that app, or tap Update All.
- Android: You can have auto updates for Atomic Connect enabled for Android. If it is not enabled, to manually update it go to the Google Play Store app and at the top right tap the profile icon. Next tap "Manage apps & device", and check Atomic Demo App is not labeled "Update available." If it is, tap Update.
- Web: Refresh your browser to ensure you have the latest version.
5. For the Web Demo App, check you are not using any browser plugins that may be blocking content.
If you’ve checked all the above steps, then you can log into the Atomic Workbench and check the following:
1. Refresh your browser to ensure you are using the latest version;
2. Sign out and then sign back in.
3. Notification configuration
If you are expecting to see a notification, check the card has a notification configured for it.
4. Sent to the correct user
In the Workbench, when sending a test card, check you are selecting the user ID that matches the Demo App you are expecting to receive the card on.
5. Correct organization and Environment
If you are a member of multiple organizations, check you are sending the test card from the correct one.
Similarly, check you are in the correct Environment.
6. Theme configured
A theme needs to be configured before cards can be received. You can add a theme in the Workbench under Configuration > SDK > Container themes.
7. Container and stream configured
Check the container is referencing the stream that the card is also referencing. To check:
- In Configuration > SDK > Stream container, check the Container you are connecting to is using that stream.
Read more about displaying a stream container.
If you are expecting to see a notification, check in the user preferences API endpoint that the "do not disturb" preferences set for your user, indicate that notifications should be sent at the time of testing.