Once you have integrated an SDK and one or more users has opted in to receive in-app messages, you can now send in-app messages from your agency console. Your client can also send in-app messages from their client portal if you have enabled this for them.

To send an in-app message from your agency console, click on the app and then select 'Messaging' from the left menu. Click the primary action button to display the Compose Message wizard that will walk you through five simple steps to sending an in-app message.

Compose Wizard

Audience

First, choose the audience that you want to send the in-app message to. You can send a broadcast to all users who have opted-in to receive in-app messages or target a specific segment, channel and/or geofence. As you select a segment, a channel and/or geofence(s), the wizard will tell you how many users will be targeted.

Audience

To send the message to an audience segment, toggle 'Limit to segment' and select the segment from the drop-down list.

Choose segment

To send the message to installs subscribed to a channel, toggle 'Limit to channel' and select the channel from the drop-down list.

Choose channel

To send the message to installs in a geofence, toggle 'Limit to geofence' and choose one of the following options, depending which geofence(s) you want to target.

  • If you want to send the message to installs in any geofence, select 'All enabled geofences'.
  • If you want to send the message to installs in one (or more) geofences, then select 'Specific geofences' and then add the geofence(s) from the drop-down list.
  • If you want to send the message to installs in geofences that match one or more tags, then select 'Geofences matching tags' and select the tags from the drop-down list.

Choose geofence

If you select an audience segment, a channel and a geofence, then a user must match all of the filters in the segment, be subscribed to the channel and be in the geofence at the time the notification is scheduled to be sent in order for the message to be sent to that user.

Click 'Next' when done.

Message Type

When prompted which type of message you want to send, select 'In-App Message' and click 'Next'.

Message Type

Content

To start creating your message, select an appropriate template for the category of message you want to send and click 'Edit Content'. If you want to start from scratch, select the 'Blank' template.

Select Template

Layout

First, you need to decide how to layout your in-app message.

In-App Message Layout

Frame

The frame type controls the size of the in-app message. Choose from fullscreen, inset or alert by clicking the appropriate icon.

In-App Message Frame

You can also choose whether sections should be vertical aligned to the top, middle or bottom and the position of the close button (top-right, top-left or none at all if another close button is being added).

Colors

To change the background color or the foreground color used for text (this can be changed later) and button borders click the appropriate icon. This will open the color picker. Click 'Confirm' once you have selected the desired color.

In-App Message colors

Background

Image

To add a background image, click 'Choose Image' to open your Media Library. Here, you can upload a new image, select an image you have previously uploaded or search the Unsplash stock image library.

To upload a new image, click the upload primary action button. Click 'Choose File' to browse your computer and find the image. Select any tags to help you find the image later or to add a new tag, just start typing and click 'Create new tag'. Click 'Upload' to add the image to your media library and use this as the background image for your in-app message.

In-App Message Upload Image

To use an image you have previously uploaded, simply select the image and click the tick primary action button. You can either scroll through your library or filter by the tags you have added previously.

In-App Message Background Image

To use an image from the Unsplash stock image library, click the 'Stock' tab and enter one or more keywords in the search box. Scroll through the results and select an image to see more information about it. Once you have found the image, click the camera primary action button to add this image to your media library and use it as the background image for your in-app message.

In-App Message Background Stock Image

To clear the background image of your in-app message, click 'Clear Image'.

Gradient

You can also apply a gradient over the background color or image. Select the Top and Bottom color for the gradient using the color picker. If you are applying the gradient over a background image, you may want to adjust the alpha of the colors to aid readability of any content you add.

In-App Message Color Picker

Using the sliders, you can then adjust the blend of the gradient.

In-App Message Background

To clear the gradient, click 'Clear Gradient'

Adding Sections

You can build up the content of your in-app message by adding one or more sections. Sections can be Headings, Subheadings, Text, Images or Buttons and will be added in order according to the vertical alignment of the Frame.

To add a section, click the '+' icon and select the type of section you want to add.

In-App Message Sections

To make it easier to see the sections in the message, toggle the border icon at the top-right of the message. To remove a section, select it and then click the bin icon in the selection pane on the right hand side.

Once you have created your in-app message, click the 'Apply' button and then click 'Next'

Headings, Subheadings and Text

To add a Heading, Subheading or Text to your in-app message, click the '+' icon, select the type of section you want to add and type in the section box.

In-App Message Text

In the right-hand selection pane, you can change the alignment, color, font and size using the appropriate controls. You can also add padding around the text by adjusting the spacing sliders.

Images

To add an image, click the '+' icon and select image. To upload a new image, click the upload primary action button. Click 'Choose File' to browse your computer and find the image. Select any tags to help you find the image later or to add a new tag, just start typing a new tag and click 'Create new tag'. Click 'Upload' to add the image to your media library and use this in your in-app message.

To use an image you have previously uploaded, simply select the image and click the tick primary action button. You can either scroll through your library or filter by the tags you have added previously.

To use an image from the Unsplash stock image library, click the 'Stock' tab and enter one or more keywords in the search box. Scroll through the results and select an image to see more information about it. Once you have found the image, click the camera primary action button to add this image to your media library and use it in your in-app message.

In the right-hand selection pane, you can add padding around the image by using the spacing sliders.

Buttons

To add an image, click the '+' icon and select button and type in the section box.

In-App Message Buttons

In the right-hand selection pane, you can change the alignment, width, shape, elevation, background and border of the button using the appropriate controls. You can also adjust the alignment, color, font and size of the button text and add padding around the button using the spacing sliders.

Actions

To add one or more action(s) to the button, click the actions pencil icon.

  • By default, buttons will close the message. If you do not want this to happen, click the 'Close Message' toggle.
  • If you want to track an analytics event to measure conversion, select the appropriate event from the drop-down.
  • If you want any users who click the button to be subscribed to a channel (to opt-in to receive further promotional messages for example), select the channel from the drop-down.
  • Finally, select where the user should be taken if they click the button (e.g. prompted to subscribe to push notifications or deep link into the section of the app specified by the JSON code).

In-App Message Button Actions

Click 'Done' to set the actions for the button.

Font Styles

While you can change the font and color of individual sections, you can also quickly change the font and color of all sections in the 'Style' tab on the right-hand side. Simply select the desired font for each type of section and click 'Apply to all'.

Alternatively, you can quickly see how your in-app message would look with different combinations of modern, classic or decorative font styles.

In-App Message Font Styles

Delivery Options

Now its time to decide when and how to deliver the message to the user.

In-App Message Delivery Options

By default, the message will be shown to the user on 'Next Open' of the app. If you want any users who have the app open at the time the message is received to see the message 'Immediately', select this from the drop-down. Alternatively, if you only want the message to be shown if the user clicks the push notification (if one is also being sent) or opens the App Inbox, select 'Push/Inbox Only'.

In-App Message Show

If you do not want the message to be sent immediately, click the 'Schedule' toggle and enter the date and time you want the messages to be sent.

In-App Message Schedule

If you also want to send a push notification to users who have also subscribed to push notifications that a new in-app message is available, click the 'Push Notification' toggle and enter an appropriate title and subject.

In-App Message Notification

If you want to save the message in your app inbox, click the 'App Inbox' toggle and enter a title and subtitle for the message. You can also specify how long the message should be available in the inbox, either 'Always', 'Between' two dates/times, 'From' a date/time, or 'To' a date/time.

In-App Message Persist in Inbox

Review & Send

Lastly, review the audience, content and delivery options you have set. Click 'Back' if you want to make any changes, or click 'Send' to send or schedule the in-app message.

In-App Message Review & Send

The message will now appear under 'Recently created messages' in your Messaging Dashboard.

The SDKs supporting In-App Messaging are currently in private beta. Please contact us for a demo or to be notified when the SDKs are available.