Moving from OneSignal

Moving from OneSignal is mostly a rename. Your backend sends the same request to a new URL, the Flutter and web calls keep their names under Takeed, and your Android and iOS subscribers come with you. Your app no longer needs google-services.json, and WhatsApp login codes come in the same account.

The code change is small. The slow part is the app store release, so plan the switch around your next release. Five steps:

1. Create the app and add your keys.
2. Point your backend at Takeed.
3. Swap the SDK in the app.
4. Import your subscribers.
5. Cut over.

1Create the app and add your keys#

Create an account, enter the company name and add an app. Open Settings → Notification settings → Firebase and Apple keys, then choose Add key:

• Android: the Firebase service account JSON (Firebase console, Project settings, Service accounts, Generate new private key). Takeed reads the project's Android apps from Firebase itself; nothing goes in your app.
• iOS: your APNs .p8 key with its Key ID, your Team ID and the app's Bundle ID.

The Flutter quick start has the details.

2Point your backend at Takeed#

Change the URL, the key and the App ID. The body stays as it is:

-curl https://api.onesignal.com/notifications \-  -H "Authorization: Key $ONESIGNAL_REST_KEY" \+curl https://takeed-iq.com/api/v1/notifications \+  -H "Authorization: Key $TAKEED_KEY" \   -H "Content-Type: application/json" \-  -d '{"app_id": "ONESIGNAL-APP-ID",+  -d '{"app_id": "TAKEED-APP-ID",        "included_segments": ["All"],        "headings": {"en": "Hello"}, "contents": {"en": "It works"}}'

Check the fields your backend sends against the list under Supported fields.

3Swap the SDK in the app#

Flutter#

From onesignal_flutter v5 to takeed_flutter 2.1.2 or later:

 dependencies:-  onesignal_flutter: ^5.2.0+  takeed_flutter: ^2.1.2

-import 'package:onesignal_flutter/onesignal_flutter.dart';+import 'package:takeed_flutter/takeed_flutter.dart'; -OneSignal.initialize('ONESIGNAL-APP-ID');+await Takeed.initialize('TAKEED-APP-ID');-OneSignal.login(user.id);+await Takeed.login(user.id);-OneSignal.User.addTagWithKey('plan', 'gold');+await Takeed.User.addTag('plan', 'gold');

1. Remove google-services.json and the Google services Gradle plugin if they were only there for OneSignal. Takeed gives the SDK the Firebase settings from the service account you added in step 1.
2. iOS: replace the Notification Service Extension's file with the package's extension/NotificationService.swift, and remove the OneSignal pod from that target.
3. Rename the other calls with this table:

Web (v16)#

-<script src="https://cdn.onesignal.com/sdks/web/v16/OneSignalSDK.page.js" defer></script>+<script src="https://takeed-iq.com/sdk/v1/takeed.js" defer></script> <script>-  window.OneSignalDeferred = window.OneSignalDeferred || [];-  OneSignalDeferred.push(async (OneSignal) => {-    await OneSignal.init({ appId: 'ONESIGNAL-APP-ID' });+  window.TakeedDeferred = window.TakeedDeferred || [];+  TakeedDeferred.push(async (Takeed) => {+    await Takeed.init({ appId: 'TAKEED-APP-ID', serviceWorkerPath: '/push/TakeedSDKWorker.js', serviceWorkerScope: '/push/' });   }); </script>

The Web quick start shows where the worker file goes.

4Import your subscribers#

1. In OneSignal, export your subscribers as a CSV file.
2. In Takeed, open the app's Notification users page and use Import from OneSignal. Choose the key the Android and iOS tokens use.
3. Android and iOS tokens move over, and the phones still on your old app version receive Takeed's notifications. Web subscriptions can't move (they are tied to OneSignal's keys); browsers that allowed notifications subscribe again silently on their next visit to a page with the Takeed SDK.

5Cut over#

1. Test first: on Notification users, mark your own phone as a test device, then send to the Test Users segment from Test notifications.
2. Switch your backend to Takeed for every send. Don't send the same notification through both: phones that are in both would get it twice.
3. Release the app version with the Takeed SDK. Updated phones and new installs register with Takeed directly.
4. When the counts in Notification log look right, turn off the OneSignal app.