Login

Learning & Support

Documentation

Sending Push Notifications

Twixl Support Team Updated: - Created :

    A notification is a great way to let users/readers know when new content is available.

    1. To start

    Before you can start sending push notifications, make sure the required push notification configuration information has been added for your app on the platform.

    Check out the following articles for help on how to setup your app for Push Notifications:

    IMPORTANT NOTE:

    If you activate push notifications for an existing app, you'll need to create an updated build of the app.

    2. Testing

    If you want to use push notifications in your app, we recommend to test this before going live. You can register a number of test devices (phones, tablets) and send a test message to these devices only. Read below for more details on how to do this.

    We provide a special custom URL scheme that allows you to test push notifications before distributing the app to the public. If your app is already live, you can enter this  tp-register-test-device://  to a discrete location in your app so your users don't register their devices by accident.  

    1. Make sure push notifications for your app have been configured properly, as described above.
    2. After you have completed the setup (for iOS and/or Android), create a new or updated build of your app.
    3. On the platform, add a web link to your app with the URL tp-register-test-device:// .
    4. Install the app on your device and make sure the app has requested you to allow push notifications. Usually this requires you to open the app, close it and open it again before a pop-up will appear requesting your approval.  
    5. Selecting the link in the app will then add the current device to the list of test devices for push notifications.
    Thank you!

    NOTE:

    The test functionality is on iOS devices only available in Test Flight builds of your app. Android builds of your app can just be installed on your Android device to register as a test device and test your Push Notifications.

    3. Sending Push Notifications

    Sending Push Notifications is done from the app menu on the platform.
    You can send Plain or Rich Push Notifications. Rich Push Notifications can include an optional Title, Description and even an Image.

    App Menu

    3.1. Available options

    These are the available options:

    1. Type: Plain or Rich Push Notifications
    2. Title: Your Rich Push Notification can include a Title
    3. Message or Description: Of course you want to include a Message in your Plain Push Notification. This Message can include 140 characters. The Description has no limitations in terms of the number of characters.
    4. Image: Your Rich Push Notification can include an optional Image.
    5. Link: You can attach a tp-collection url scheme. This way, when readers tap on the Push Notification, they will be redirected to the right Collection or Content Item. For more info, see Using custom URL Schemes in your app.
    6. Send at: This way, a Push Notification can be sent out at a specified time in the future.
    7. Bundle Identifier: Informs you about the targeted app. See the following article for more info: iOS: Setup Key based authentication for Apple Push Notifications (>8.0)
    8. Which Devices: You can target specific segments of devices, i.e.:  
      • All devices: Will send the Push Notification to all registered devices.
      • All iOS devices: Will send the Push Notification to all registered iOS devices.
      • All Android devices: Will send the Push Notification to all registered Android devices.
      • Specific test devices: Here you can select specific Test Devices as a target for your Push Notification. Fore more info, see Testing

    3.2. Support Matrix Plain vs. Rich Push Notifications

    What? Supported in Rich Push Notifications Supported in Plain Push Notifications
    Title yes
    no
    Description yes
    no
    Message no
    yes
    Image yes
    no
    Link yes
    yes
    Send At yes
    yes
    Bundle Identifier yes
    yes
    Send to yes
    yes

    NOTE:

    You will only be able to start sending notifications, when your app has been installed and opened on at least 1 device.

    Was this article helpful?

    1 out of 2 found this helpful