Guides

Actions

In this area you'll learn all about Actions and how you can extend your messages with interactions that harness the power of mobile and web technology to achieve more with remote notifications.

In every wizard where you can create content, depending on the Rich Push Templates you choose (learn more about these templates here), you will find a section like the one below:

Messages actions actions area 752df4a6c8

For templates that support actions, you will be able to add one more actions from the list of supported actions.

Response

With this type of actions you can create buttons in your message that can trigger the user input using text or the device's camera and quickly collect that input in Notificare or even in your own servers.

Messages actions response cfd4db8532

Clicking Add Action will create an entry like this one:

Messages actions response entry 0a86df07c3

Expand that entry to see all the options for this action. You can start by customizing the text in your button by changing the Label field:

Messages actions label 8f040e1c19

If you wish to create a Webhook with the user's input and handle it in your own servers, add an endpoint URL in the Target field:

Messages actions response target 3cf62d7985

We will make a POST request to the provided URL with a JSON body that will look like the following:

1
2
3
4
5
6
7
8
{
	"label": "Label of the action",
	"notification": "ID of the notification",
	"deviceID": "Device token that clicked the action",
	"userID": "The userID (if applicable) that clicked the action",
	"message": "The text the user replied with (if keyboard selected)",
	"media": "The URL of the image taken by the user (if camera selected)"
}

You can add placeholders in this field, by selecting them from the selector below:

Messages actions placeholders 67021e5959

For this type of action it is possible to prompt the user to reply with text, for that you will need to check the following box:

Messages actions response keyboard 5c2b700f50

For this type of action it is possible to prompt the user to reply with a picture taken from the device's camera, for that you will need to check the following box:

Messages actions response camera ffdf683c98

Make a Phone Call

If your message is targeting mobile devices with phone capabilities, you can include actions that trigger the user to make a phone call. To do that select the following option:

Messages actions call 699490e55a

Clicking Add Action will create an entry like this one:

Messages actions call entry 9fda584345

Expand that entry to see all the options for this action. You can start by customizing the text in your button by changing the Label field:

Messages actions label 8f040e1c19

And you will have to provide a valid phone number in the Target field:

Messages actions call target 7101c3b75c

You can add placeholders in this field, by selecting them from the selector below:

Messages actions placeholders 67021e5959

Send a SMS

If your message is targeting mobile devices with SMS capabilities, you can include actions that trigger the user to send a SMS. To do that select the following option:

Messages actions sms 882c46f380

Clicking Add Action will create an entry like this one:

Messages actions sms entry f258292a5e

Expand that entry to see all the options for this action. You can start by customizing the text in your button by changing the Label field:

Messages actions label 8f040e1c19

And you will have to provide one or more valid phone numbers (comma separated) in the Target field:

Messages actions sms target 62d92a8d8d

You can add placeholders in this field, by selecting them from the selector below:

Messages actions placeholders 67021e5959

Open Mail Client

If your message is targeting mobile devices with email capabilities, you can include actions that trigger the user to send an email. To do that select the following option:

Messages actions email 3c58211554

Clicking Add Action will create an entry like this one:

Messages actions email entry 16d0b8f809

Expand that entry to see all the options for this action. You can start by customizing the text in your button by changing the Label field:

Messages actions label 8f040e1c19

And you will have to provide one or more valid email addresses (comma separated) in the Target field:

Messages actions email target 885cf1aedb

You can add placeholders in this field, by selecting them from the selector below:

Messages actions placeholders 67021e5959

Open Browser

If you would like to include a button in your message that opens the default browser in the user's device, you should select the following option:

Messages actions browser 87b0cd65ee

Clicking Add Action will create an entry like this one:

Messages actions browser entry be75fb5a5a

Expand that entry to see all the options for this action. You can start by customizing the text in your button by changing the Label field:

Messages actions label 8f040e1c19

And you will have to provide the URL you wish to open in the Target field:

Messages actions browser target 675a01b46b

You can add placeholders in this field, by selecting them from the selector below:

Messages actions placeholders 67021e5959

Open App

If your app supports deep linking, you may want to open your app in a certain view when users click in a button from a notification. To do that select the following option:

Messages actions app 132b0da405

Clicking Add Action will create an entry like this one:

Messages actions app entry 3765415383

Expand that entry to see all the options for this action. You can start by customizing the text in your button by changing the Label field:

Messages actions label 8f040e1c19

And you will have to provide the URL (your app must handle custom URL Schemes) you wish to open in the Target field:

Messages actions app target f13d535585

You can add placeholders in this field, by selecting them from the selector below:

Messages actions placeholders 67021e5959

Custom App Method

If you would like to execute certain functionality custom built in your app this action type will simply invoke that method. This requires some implementation work from your app development team before it can be used. If you've implemented the necessary steps to use this, select the following option:

Messages actions custom 4d459da14f

Clicking Add Action will create an entry like this one:

Messages actions custom entry ffbb05365e

Expand that entry to see all the options for this action. You can start by customizing the text in your button by changing the Label field:

Messages actions label 8f040e1c19

And you will have to provide the name of the method you wish to invoke in the Target field:

Messages actions custom target 7e090da345

You can add placeholders in this field, by selecting them from the selector below:

Messages actions placeholders 67021e5959

About Segmentation Rules

All the actions shown above support segmentation rules, which will allow you to automatically categorize users when they click in those actions. This can be extremely useful since you can then later address these users based on their behaviour. So in every action you create you will see an area like the one below:

Messages actions segmentation rules 877e9426fd

There's four types of rules you can select, add or remove users from segments and add or remove devices from tags. You can add an unlimited number of rules and even combine two or more segments or tags in each rule.

To add users to one or more segments, select the following:

Automation connectors segmentation add segments 719aca115d

If you want to remove users from one or more segments, select the following:

Automation connectors segmentation remove segments e7fa3f4810

Then go ahead and proceed to select the segments you want:

Automation connectors segmentation segments selection fa2eac589f

In the Search Segments field, search for existing segments:

Automation connectors segmentation search segments 303f66f793

If the segment you are looking for does not exist you can create one on-the-fly, just click in the Create it? link:

Automation connectors segmentation create segment 98280546f6

When you are done selecting segments, just go ahead and add the rule by clicking in the Add Rule button:

Automation connectors segmenation add segments rule e71b0db0d2

The exact same thing can be done with tags, to add devices to one or more tags, select the following:

Automation connectors segmentation add tags 5f75db0bda

If you want to remove devices from one or more tags, select the following:

Automation connectors segmentation remove tags e68fabc1f5

Then go ahead and proceed to select the tags you want:

Automation connectors segmentation tags selection 5043a7135d

In the Search Tags field, search for existing segments:

Automation connectors segmentation search tags a99c9a31ba

If the tag you are looking for does not exist you can create one on-the-fly, just click in the Create it? link:

Automation connectors segmentation create tag e98dd27064

When you are done selecting tags, just go ahead and add the rule by clicking in the Add Rule button:

Automation connectors segmentation add tags rule 58f421db91

As you add rules, you will see them in a list as follows:

Automation connectors segmentation rules list 2bb00ca1b0

Finally, because these actions will be displayed to the user, before sending the message you can change the order which they will be displayed. To do that simply drag and drop an action to a different position in the list by clicking in the following icon:

Messages actions drag handler c2e139e3e2