Flow: Send

This node is used to send messages to customers through the channels that are configured within a service. As the configuration of each channel differs, the options available will depend on the selected channel.

To create a service, from the Settings dashboard, click on Numbers and select the Shortcodes, Keywords and Phone numbers previously bought on the platform. These can be mapped to a service in number settings.

Once a service is created, you can configure the required channels from the settings screen. These channels are then displayed in the Send node screen. Following channels are supported:

SMS
Voice
Email
OTT channels
- Facebook
- Twitter
- WeChat
Push Notifications
- iOS
- Android

SETTINGS

The node specific configuration is accessed by double-clicking on the node. This screen displays the channels that are configured for the service.

SMS

The SMS channel is used to send short messages of upto 1024 characters, using the parameters shown in Figure 3.

The below screen appears when the SMS channel is selected.

The parameters of SMS channel are:

Field	Description
Destination	A value or Session Data variable used to do perform a user profile lookup in order to access all possible channels associated with the user. This should correspond with the Destination Type field.
Destination Type	This parameter specifies the destination type of the information entered in the Destination parameter. This list below shows supported values for the Destination Type parameter: Customer Id: The ID of the customer. msidn: The phone number that this inbound message wassent from. Android Push Id iOS Push Id Twitter Id PS Id Wechat Id
Message Type	Specifies the message type. The options are: Text: Supports a maximum of 1024 characters. Flash: A Flash message is a one-time message and has a sender ID. Binary: Allows you to send single binary message to one or more destination addresses. Unicode: Only use unicode when your SMS must contain special characters.
senderId	Select the senderId from the drop-down using which the message is sent.
Message	The content of the message to be sent. If applicable, message length restrictions will be displayed.
Add Smartlink	Add a Smartlink and select the Smartlink that is created using IMIconnect.
Link Validity (in Mins)	Specify the time in minutes after which the Smartlink will expire.
CorrelationID	Should be passed to the flow from the event that invoked it and it has to be passed back in all the call back or notify.
Message Expiry (UTC)	Expiry time in UTC format, after which messages should will not be pushed.
Wait For	Select from one of the options: Policy - Wait for a predefined policy DR - Wait until a delivery reported is received. Depending on the selected option, a Time Out (Sec) option will be displayed.
Notify URL	It is used to post the information about the transaction and returns the delivery receipt in JSON format.For more details on example, see code sample below.
Callback Data	Request-specific data that must be returned to the user whenever they are notified via notify URL.
Name	The name of the node is represented as a string. Enter a new name or continue with the displayed name.

{
    "deliveryInfoNotification": {
        "deliveryInfo": {
            "deliveryChannel": "SMS",
            "Description": "Delivered",
            "destinationType": "msisdn",
            "timeStamp": "2016-07-20T17:13:17.908",
            "code": "7500",
            "deliveryStatus": "Delivered",
            "destination": "918886661353"
        },
        "correlationid": "4eef-92ca-79fd0250c4a3-262895e4-2217",
        "callbackData": "return callbackdata",
        "transid": "262895e4-2217-4eef-92ca-79fd0250c4a3"
    }
}

{
  "deliveryInfoNotification": {
    "deliveryInfo": {
      "deliveryChannel": "SMS",
      "pushId": "",
      "Description": "Message expired",
      "destinationType": "msisdn",
      "timeStamp": "2016-07-28T11:47:56.459",
      "code": "7208",
      "deliveryStatus": "Un-Delivered",
      "deviceid": "",
      "destination": "910000000001"
    },
    "correlationid": "",
    "callbackData": "",
    "transid": "8f0fd088-2a80-43e3-9da1-e82e52b17390"
  }
}

{
    "deliveryInfoNotification": {
        "deliveryInfo": {
            "deliveryChannel": "SMS",
            "pushId": "",
            "Description": "Unknown Status",
            "destinationType": "msisdn",
            "timeStamp": "2016-07-28T11:47:56.459",
            "code": "7200",
            "deliveryStatus": "Failed",
            "deviceid": "",
            "destination": "919908505526"
        },
        "correlationid": "",
        "callbackData": "",
        "transid": "f040fe8b-2876-4824-b59e-44420047e204"
    }
}

VOICE

You can initiate a Integrated Voice Response (IVR) voice call with a customer. When call is initiated, you can seek the response of the customer from his keypad. Based on the response, an appropriate flow is continued. You can configure a wait time in minutes to receive the customer response. The call may end if the response is not received within the wait time. For example, when a bank initiates an IVR voice call with its customer on credit card offers, based on the customers response, an SMS can be sent to the sales team or customer support team. If the customer does not respond within a specified time, then the call gets disconnected.

The below screen appears when the Voice channel is selected.

The parameters of Voice channel are:

Field	Description
Destination	A value or Session Data variable used to do perform a user profile lookup in order to access all possible channels associated with the user. This should correspond with the Destination Type field.
Destination Type	This parameter specifies the destination type of the information entered in the Destination parameter. Following are the options: Customer Id msidn Email User Id Android Push Id iOS Push Id Twitter Id PS Id Wechat Id
Message Type	The options are: Flow ID Media
Media	Select the Flow ID or Media file based on the option selected in Message Type.
Wait For	The options are: None - The node will not wait for any info. Policy - Wait for a predefined policy. DR - Wait until a delivery reported is received. Depending on the selected option, a Time Out (Sec) option will be displayed.
senderid	The available Sender ID associated with the Service will be available from the drop-down menu.
Extra Parameters (Optional)	Enter the Parameter and Value.

RTM

You can send an RT message with attachment and Smartlink with an expiry time in minutes. When the Smartlink is configured with an expiry link, the link will expire if it is not clicked within the configured expiry time.

The image below shows the RTM channel and the properties that are required to be configured.

Table below defines the parameters in the RTM channel.

Field	Description
Destination	A value or Session Data variable used to do perform a user profile lookup in order to access all possible channels associated with the user. This should correspond with the Destination Type field.
Destination Type	This parameter specifies the destination type of the information entered in the Destination parameter. This list below shows supported values for the Destination Type parameter: Customer Id msidn Android Push Id iOS Push Id Twitter Id PS Id Wechat Id
Wait For	The options are: None - The node will not wait for any info. Policy - Wait for a predefined policy GW Submit - Wait for message to be submitted to the RTM gateway. Read - Wait for the read receipt. DR - Wait until a delivery reported is received Depending on the selected option, a Time Out (Sec) option will be displayed.
App ID	This parameter displays a read-only value. It specifies the app ID.

MESSAGE

This tab helps you configure a message.

The image below displays the message tab and the properties that are required to be configured.

Field	Description
Message body	Enter a message.
Add Smart Link	Add the smart link that is created using IMIconnect. Toggle the status to ON, for the smart link to be visible in the drop-down.
Link Validity (in Mins)	Enable the Link Validity checkbox, to set the duration for which the Smart Link would be active.
Thread type	Select from one of the following options in the drop-down: Conversation Announcement
Thread title	Enter a title for the thread. Validations: Alpha-numeric values - With any special characters. Maximum length - Upto 100 characters.

Message Attachment

Clients can upload attachments that can be sent in the inbound and outbound messages. Clients can either choose to send the attachment links directly or use media ID.
Each client will be assigned a s3 bucket where the attachment will be stored with a unique media ID. Only one media ID per message should can be allowed while sending, whereas, incoming messages from customers can include multiple attachments.

Field	Description
Select attachment type	Select from the available list of attachment types: PNG JPG MP4 GIF PDF Excel MS Word
Attachment URL	Enter an URL for the attachment.
Attachment Size	Specifies the size of attachment, a maximum of 4kb file can be uploaded.
Attachment play duration	Specifies the duration (in seconds) after which the play duration will expire.
Preview	Applicable when the content type is video. Specifies a base64 string of a JPEG image to display as a preview for video.

Message Notification

A message notification is delivered to a device (iOS, Android, or Web) when a connection is established on a device.

Field	Description
Notification title	Text that should be displayed as notification.
Notification text	Message that should be displayed in the notification text.
iOS Extras	The following parameters must be configured: Notification Sound: Specifies the sound file name, which should be played. Notification Attachment: Specifies the name of the notification attachment. Notification action type: Select from the following options: -- OPEN_URL -- OPENWEBVIEW -- DEEPLINK -- OPEN_HTML -- OPEN_APP Badge: Specifies the badge value, which will be displayed. Collapse key: Specifies the collapse key. Notification Action value: Specifies value of the notification action selected.
Android Extras	The following parameters must be configured: Notification Sound: Specifies the sound file name, which should be played. Notification Image: Specifies the URL with image. Notification action type: Select from the following options: -- OPEN_URL -- OPENWEBVIEW -- DEEPLINK -- OPEN_HTML -- OPEN_APP Collapse key: Specifies the collapse key. Notification Action value: Specifies value of the notification action selected.
Web Extras	The following parameters must be configured: Action text: Specifies the action text; this is applicable for Safari browsers only. On-click URL: Specifies the on-click URL. Collapse key: Specifies the collapse key.
Image URL	Specifies the image URL.

Interactions

This tab helps you configure the parameters to make the message interactive.

The image below shows the Interactions tab and the properties that are required to be configured.

Field	Description
Message Reference	Provide a reference value if the results of the RTM interaction is required as a trigger for rules.
Interactions	Specifies the number of interactive buttons for the message. The options are: Single button Two buttons The chosen option will affect the subsequent options available in the Category field.
Category	Specifies the category for the selected interactive button.
Button	Specifies the action when single or two buttons is selected. For example, if single button is selected in the Interactions list and single button - subscribe is selected in the category list, then the button display takes the value of category and is displayed as Button Subscribe.
Button	Specifies the category value when two buttons is selected from the Interactions list.

Extra Parameters(Optional)

This tab helps you configure extra parameters of the message.

Field	Description
Param	Specifies the parameter for the extras block.
Value	Specifies the value for the defined parameter
Actions	Allows addition of a new parameter.

FACEBOOK

You can send a Facebook message with attachments and Smartlink with an expiry time in minutes. When the Smartlink is configured with an expiry link, the link will expire if not clicked within the expiry time.

The below screen appears when the Facebook channel is selected.

The parameters of Facebook channel are:

Field	Description
App ID	The App ID field should already be populated with the Facebook App ID configured for this channel.
Presence	Select the checkbox to verify whether the user is present at that moment before sending message.
Destination	A value or Session Data variable used to do perform a user profile lookup in order to access all possible channels associated with the user. This should correspond with the Destination Type field.
Destination Type	This parameter specifies the destination type of the information entered in the Destination parameter. Following are the options: Customer Id msidn Android Push Id iOS Push Id Twitter Id PS Id Wechat Id
Message Type	Select the message type from the drop-down. The options are: Text Image Audio Video File Attachment Generic Template Button Template Receipt Template List Template
Notification Type	Specifies how the notification is delivered. The options are: REGULAR SILENT_PUSH NO_PUSH
Message	Specifies the content of the message to be sent.
Smartlink	Select the Smartlink that is created using IMIconnect.
Link Validity (in Mins):	Specify the time in minutes after which the Smartlink will expire.
Attachment URL	This option is appears when the Message Type is selected as Image or Audio or Video. Enter the URL of the attachment.
Message Type > Generic Template: Configure bubbles	Additional options are displayed when the Message Type is selected as Generic Template. The options are: Bubble Title:Enter the bubble title. Bubble URL: Enter the bubble URL. Image URL: Enter the image URL. Bubble Subtitle: Enter the subtitle of the bubble. Configure Buttons: Configure actions for button. Click on Button(0). The configure buttons screen appears. The options are: Button Type: Select the button type from the drop-down. The options are: Postback Web URL Button Title: Enter the button title. URL/Postback: Enter the URL. Click + to configure additional buttons.
Message Type > Button Template: Configure buttons	Additional options are displayed when the Message Type is selected as Button Template. The options are: Button Type: Select the button type from the drop-down. The options are: Postback Web URL Button Title: Enter the button title. URL/Postback: Enter the URL. Click + to configure additional buttons.
Message Type > Receipt Template	This option is displayed when the Message Type is selected as Receipt Template. The options are: Receipt details The options are: Receipt name Order number Currency Payment method Order url Time stamp Order Elements The options are: Title Subtitle Quantity Price Currency Image URL Address The options are: Street 1 Street 2 City Postal code State Country Summary The options are: Subtotal Shipping cost Total tax Total cost Adjustments The options are: Name Amount
Message Type > List Template	Allows you to present a set of items vertically. Configure Elements consists of the following list of parameters: Top element type: Is used to render the first item with a cover image with text overload OR with a plain list. Select from one of the following items: -- Compact: Renders a plain list. -- Large: Renders a cover image with text overload. -- Title -- Sub-title -- Image URL -- Redirect URL -- Button type -- Action
Global Button	If enabled, this button is rendered below the item list. Configure the following parameters: Global Button Title: Name of the global button. Type: Select from one of the following items: -- Postback -- Web URL -- Phone Number -- Link Account -- Unilink Account Payload: Enter corresponding input; for example if Web URL is selected, enter a URL in the payload field.
Add quick reply options	To provide a way to present buttons to the user in response to a message, enable the button and configure the following parameters: Type: Select from the following: --Text: Contains message of text type. -- Location: Used to prompt a person for their location. Title: Enter a name. Payload: Enter corresponding input. Button Image: Users could tap on buttons attached to old messages in a conversation. Actions: Used to add or delete a quick reply.
Add quick replies options	Enable the button to configure quick replies. Quick replies are user configured buttons for others to reply quickly. When a quick reply is tapped, the message is sent in the with user-defined metadata in the callback. You can configure up to 10 quick reply buttons. The configuration options are: Type: Select the type from the drop-down (Text/Location). Title: Enter the title for the button. Payload: Enter the payload for the button. Button Image: Enter the path of the image. Actions: Click respective actions to add or remove buttons.
Wait For	The options are: None - The node will not wait for any info. Policy - Wait for a predefined policy GW Submit - Wait for message to be submitted to the Facebook gateway. DR - Wait for delivery receipt. Depending on the selected option, a Time Out (Sec) option will be displayed.

TWITTER

You can send a Twitter message with attachments and Smartlink with an expiry time in minutes. You can configure the link to expire if not clicked within the expiry time.

The parameters of Twitter channel are:

Field	Description
App ID	The App ID field should already be populated with the Twitter App ID configured for this channel.
Destination	A value or Session Data variable used to do perform a user profile lookup in order to access all possible channels associated with the user. This should correspond with the Destination Type field.
Destination Type	This parameter specifies the destination type of the information entered in the Destination parameter. Following are the options: Customer Id msidn Android Push Id iOS Push Id Twitter Id PS Id Wechat Id
Enter Message	The content of the message to be sent. If applicable, message length restrictions will be displayed.
Smartlink	Select the Smartlink that is created using IMIconnect.
Link Validity (in Mins):	Specify the time in minutes after which the Smartlink will expire.
Wait For	The options are: None - Thw node will not wait for any info. Policy - Wait for a predefined policy. GW Submit - Wait for message to be submitted to the Twitter gateway. Depending on the selected option, a Time Out (Sec) option will be displayed.
Presence	Select the checkbox to verify whether the user is present at that moment before sending message.
Extra Parameters (Optional)	Enter the Parameter and Value. Click + to add additional parameters.

WeChat

You can send a WeChat message with attachments and Smartlink with an expiry time in minutes. You can configure the link to expire if not clicked within the expiry time.

The parameters of WeChat channel are:

Field	Description
App ID	The App ID field should already be populated with the WeChat App ID configured for this channel.
Destination	A value or Session Data variable used to do perform a user profile lookup in order to access all possible channels associated with the user. This should correspond with the Destination Type field.
Destination Type	This parameter specifies the destination type of the information entered in the Destination parameter. Following are the options: Customer Id msidn Android Push Id iOS Push Id Twitter Id PS Id Wechat Id
Enter Message	The content of the message to be sent. If applicable, message length restrictions will be displayed.
Smartlink	Select the Smartlink from the drop-down that is created using IMIconnect.
Link Validity (In Mins)	Specify the time in minutes after which the Smartlink will expire.
Wait For	The options are: None - The node will not wait for any info. Policy - Wait for a predefined policy GW Submit - Wait for message to be submitted to the WeChat gateway. Depending on the selected option, a Time Out (Sec) option will be displayed.
App ID	The App ID field should already be populated with the App ID configured for this channel.
Presence	Select the checkbox to verify whether the user is present at that moment before sending message.

PUSH NOTIFICATION

This screen allows you to configure push notification for iOS and Android platforms.

The parameters of Push Notification channel are:

Field	Description
App ID	The App ID field should already be populated with the App ID configured for this channel.
Destination	A value or Session Data variable used to do perform a user profile lookup in order to access all possible channels associated with the user. This should correspond with the Destination Type field.
Destination Type	This parameter specifies the destination type of the information entered in the Destination parameter. Following are the options: Customer Id msidn Android Push Id iOS Push Id Twitter Id PS Id Wechat Id
Wait For	The options are: None - The node will not wait for any info. Policy - Wait for a predefined policy. GW Submit - Wait for message to be submitted to the Push Notification gateway. DR - Wait for delivery receipt. Read - Wait for read receipt. Depending on the selected option, a Time Out (Sec) option will be displayed.
Presence	Select the checkbox to verify whether the user is present at that moment before sending message.

iOS

This screen allows you to configure push notifications for iOS platform.

The configuration options for iOS platform are:

Field	Description
Enter push body for IOS	Specifies the iOS specific push message.
Notification Action	Specifies the notification action. The actions are: OPEN_URL OPEN DEEPLINK OPEN_HTML OPEN_APP
Notification Value	Specifies value of the notification action selected.
Enter Sound file	Custom sound that should be played when the notification is delivered.
Badge	The number to be displayed as badge of the app icon.
Silent push	The customer will not be notified of the notification delivery, but the app gets the notification if this attribute is true. The options are: `true` `false`
Time to live	Expiration time for the message delivery.

Android

This screen allows you to configure push notification for Android platform.

The configuration options for Android platform are:

Field	Description
Enter push body for Android	Android specific push message text.
Notification Action	Specifies the notification action. The actions are: OPEN_URL OPEN DEEPLINK OPEN_HTML OPEN_APP
Notification Value	Specifies value of the notification action selected.
Enter Sound file	Custom sound will be played when the notification delivered.
Collapse Key	An arbitrary string that is used to break up a group of like messages when the device is offline, the oldest message is discarded and only the last message is sent to the customer.
Time to live	Time limit before delivery attempts for undelivered messages stop and the messages are discarded.
Delay while idle	If true, the message delivery is delayed when the customer’s device is idle.
Priority	A value from 1 to 5, where 5 is the highest.
Image URL	Enter the URL for the image.

###Interactions

The image below allows users to configure the parameters in the interactions tab.

Table below defines the configuration options for interactive buttons.

Field
OS	The options are: iOS Android Both
Push reference	Provide a reference value if the results of the push interaction is required as a trigger for rules.
Interactions	Specifies the type of interaction. The options are: Single button Two buttons The chosen option will affect the subsequent options available in the Category field.
Category	Each category has a specific context and associated set of actions. The table that follows details options available in the Category field depending on the selection in the Interaction field.

Generic Actions for Category options
Table below displays the actions applicable to Single button or Two button interactions.

Generic Actions	Action Parameter	Description
OPENURL	URL	Opens a URL.
OPENAPP	NONE	Opens an application.
DEEPLINK	link	Deep link a page on an app.
OPENWEBVIEW	URL	Opens a URL in a Webview.
SHARE	URL or TEXT	Opens share intent in your app.

Category: Single button

Catergory option	Button assignment
Single button - Dismiss	DISMISS
Single button - Subscribe	Any from the Generic Actions table.
Single button - Unsubscribe	Any from the Generic Actions table.
Single button - Share	Any from the Generic Actions table.
Single button - Open	Any from the Generic Actions table.

Category: Two buttons

Catergory option	Button (1) assignment	Button (2) assignment
Two button - Yes or No	Yes:Any from the Generic Actions table.	No:Any from the Generic Actions table.
Two button - Accept or Cancel	Accept:Any from the Generic Actions table.	Cancel:DISMISS
Two button - Share or Cancel	Share:Any from the Generic Actions table.	Cancel:DISMISS
Two button - Shopnow or Cancel	Shop now:Any from the Generic Actions table.	Cancel:DISMISS
Two button - Later or Now	Later:DISMISS	Now:Any from the Generic Actions table.
Two button - PlayNow or PlayLater	Play Now:Any from the Generic Actions table.	Play Later:DISMISS
Two button - Ok or Learn More	Ok:Any from the Generic Actions table.	Learn More:Any from the Generic Actions table.
Two button - Subscribe or Unsubscribe	Subscribe:Any from the Generic Actions table.	Unsubscribe:Any from the Generic Actions table.
Two button - Buy Now or Buy Later	Buy Now:Any from the Generic Actions table.	Buy Later:DISMISS
Two button - Like or Share	Like:Any from the Generic Actions table.	Share:Any from the Generic Actions table.

Extra Parameters (Optional)

Enter the Parameter and Value. Click + to configure additional parameters.

EMAIL

Users' can send email through a node in two ways:

Text (only plain text)
Templates (from template builder)
All emails will be sent from Connect using Amazon SES via API calls, with the email content formatted as HTML and sent as an API parameter. Once the user selects the available template, all the replaceable parameters from the template are loaded; the user can now map them to session variables in the flow.

From the settings screen as shown below, select Email channel.

The node specific configuration is accessed by double-clicking on the email node.

The key-values to be extracted / translated from the input data set and the corresponding output is configured using these settings.

The table below describes the configuration settings.

Field	Description
Destination	Destination email address.
Email Type	Select Text or Template.
From Email	Senders' email address.
From Name	Senders' name.
Template	Select custom template created in Template Composer.
Notify Status	If checked, provides notification status.
Notify URL	URL through which one or more of the checked items is notified: Sent Delivered Read Bounce Spam Rejected Answered
Wait For	Select one of the following: Policy DR
Destination Type	Select the destination type; for example, Email ID.
App ID	Displays the application ID.

NODE EVENTS

Exit event	Description
onsuccess	This event is triggered if the node completes successfully.
onsubmit	This event is triggered when the message is submitted to the channel gateway.
ondrsuccess	This event is triggered when a Delivery Report is received from the channel gateway.
onpolicysuccess	This event is triggered if Policy check is successful.
onread	This event is triggered if the read event is received before the specified timeout and the Wait For field is set to 'Read'.
ontimeout	This event is triggered if a configured timeout is reached.
ondrfail	This event is triggered when the message failed to deliver it to the recipient.
onpolicyfail	This event is triggered if the Policy check fails. Error code and description:7120 - This error code appears when the payload size exceeds 5Kb.
onerror	This event is triggered if an error occurs.

RESPONSE

Response tab allows you to configure the channels response to be stored into session data.

For example, you can store the MO response of a channel into your session data.

SESSION DATA

For information on session data, click here .

CUSTOM LOGS

For information on custom logs, click here.