LinQ2 P-Series XML Structure Description v 2.0

LinQ2 P-Series XML Structure Description v 2.0

This document explains LinQ2's XML structure, which uses ar XML File Channel 

ElementTypeMax. LenRepAllowed ValuesMandatoryDescription
Evnt_IdText101N/AYUnique Event Identifier.
Evnt_SourceText101‘OMS’, ‘CRM’YEvent source.
Put here a text representing which internal system has generated this XML. It should be meaningful enough as it is going to be viewed in reports as it is.
Evnt_PriorityNumber111-9
Default 1
NNotification priority
If not specified then notification will be sent with normal priority
1 is the least priority and 9 is the highest.
Org_IdNumber101Default = 1NOrganization id.
You can find the Organization ID saved in LinQ2 from web interface Organization> Hierarchy .If you used the main organization (i.e. tree root) then you use the default value.
Due_DtText191yyyy-MM-dd HH:mm:ssNDue date
Useful in case you want to schedule messages
If null, notification will be sent immediately.
ValidityNumber101N/ANDefine the validity time in millisecond for this message. after this period the message will be expired
SMS_TypeNumber111- SMS Template Name is passed.
2-English SMS Content is passed
3- Unicode SMS content is passed
4- Arabic text is passed
Y(if SMS notification method is required)Identifier for the SMS Message Content.
Unicode is in the format “\uXXXX\uYYYY\uZZZZ … etc”
SMSText10001Message Content/ Template Name.Y (if SMS notification method is required)SMS Content or Template Name.
SMSSenderText111SenderNIdentifier the SMS Sender
Email_TypeText111- Email Template Name is passed.
2-English Email Content is passed
3- Unicode Email content is passed
4- Arabic text is passed
5 – Html content is passed
Y
(if Email notification method is required)
Identifier for the Email Content.
EmailText100001Template Name /
Email Content (plain text)/
Email Content (html within CDATA tag)
Y(if SMS notification method is required)Email Content or Email Template Name
Rcpnt_LstText00-nN/ANParent tag for recipient list
Rcpnt_DtlsText00-nN/ANrecipient details
Ntfctn_MthdText511st char for SMS activation status
2nd char for Email activation status
3rd -4th Reserved.
5th char for Push Notifications
6th char for Voice Notification

Allowed values for each character:

0: Available but not activated.
1: Available and activated.
N: Not available.
YNotification method SMS/E-mail or both.
e.g.
10000 means only SMS.
01000 means only Email.
11000 means this message is sent as an email and SMS.
Ntfctn_LngText51ar_SA: Arabic
en_US: English
ea: English template with Unicode parameters
Y (if template is used)Notification language
Provider_IdNumber210, 1, 2, 3…NThe assigned provider for this message
Group_IdText141N/ANRecipients Group Id
To get Group ID:
create a group on the root level
Contact a LinQ2 team member to extract Group ID for you.
Contact_IdText141N/ANRecipient Contact Id
To get Contact ID:
create a contact on the root level
Contact a LinQ2 team member to extract Contact ID for you.
Mbl_TelText141N/AY (If sms notification is required and both group_id and contact_id are not specified)Recipient mobile telephone.
The mobile number going to receive the SMS.
It should be in international format 9665NNNNNNNN.
Message_OptionsNumber10: Normal Message
1: Flash Message
NMessage Types : Normal or Flash
Fax_NumberText141N/AY (if fax notification is required)Recipient fax number
Dlv_NtfnText110: No SMSC Delivery Receipt requested (default)

1: SMSC Delivery Receipt requested for delivery success or failure

2: SMSC Delivery Receipt requested for delivery failure
NDelivery Notification
Email_ToText481N/ANRecipient Email Id, mandatory if Email notification is activated
In case of multiple, Email Ids will be separated with ‘,’
Email_CCText48991N/ANCopy carbon Email Id.
In case of multiple CC, Email Ids will be separated with ‘,’
Email_BCCText48991N/ANPrivate copy carbon Email Id.
In case of multiple BCC, Email Ids will be separated with ‘,’
Email_serverText201N/ANNot used
Email_SbjctText601N/ANEmail subject
Att_Fl_NameText2561N/ANIf specified, the file from email folder will be sent as attachment
Att_Dp_NameText2561N/ANThe display name of attachment
Additional_infoText1N/ANNot used
Push_DtlsText00-nN/ANParent tag for push notifications list
SvcNumber11: mPass Push
2: PushWoosh
3: OneSignal
4: Google FCM
YPush service selection
TitleText201N/AYPush notification title
BodyText5001N/AYPush notification body
Notif_TypeNumber11: Normal
2: In App
NOptional notification type not implemented yet
RecipientText301N/AYDevice ID for mPass, and OneSignal & tag value for PushWoosh
Device toke for Google FCM
Device_PlatformText71Android Or
iOS
NDevice platform for mPass push
SegmentText201N/ANSegment name for OneSignal
Template_CodeText201N/AYPush notification template code from P-Series enumerations
Tag_ValueText201N/ANTag value for pushwoosh
Voice_DtlsText00-nN/ANParent tag for voice notifications list
RecipientText301N/AYRecipient’s phone number
TemplateText201N/AYVoice template name from P-Series voice templates
ParametersText1000-nN/AYTemplate parameter
Param-nameText1001N/AYParameter name.
Param-valueText1001N/AYParameter numeric value.
ParametersText1001N/ANTemplate parameters
ParameterText1000-nN/AYTemplate parameter
Param-nameText1001N/AYParameter name.
It is the name you provided inside your template stored in LinQ2.
Usually in the format ${Param}.
IT IS A CASE SENSTIVE ELEMENT.
Param-valueText1001N/AYParameter value.
Can be processed it in the form of “\uXXXX\uYYYY\uZZZZ … etc” if the SMS_Type was Template, Ntfctn_Lng was Arabic and the application could find the string”\u” in this tag Param-value.
Comments
  1. If optional fields do not have values it should not appear in the XML message.
  2. Parameters will be supplied as replaceable tokens in case of using a predefined template.
  3. Parameters names should be synchronized between IT team (who will generate this xml) and Business team (who will define templates)
  4. The following order will be checked to determine the recipient(s):
    1. Group_Id: the message will be sent to all contacts in this group
    2. Contact_Id: the message will be sent to this contact
    3. Mbl_Tel & Email_To: the message will be sent to the specified number.
  5. The XSD file of this XML structure will be provided while project implementation.
  6. Each request can have SMS, Email and Push Notification, this is controlled through Ntfctn_Mthd



XML Samples 

Sample request 1-Send message to group using template 

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>1002</Evnt_Id> 

<Evnt_Source>CreditCard</Evnt_Source> 

  <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>MySenderId</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

<Ntfctn_Lng>en_US</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Group_Id>g1</Group_Id>                              

                                        <Email_CC>abcd@xyz.com</Email_CC> 

<Email_BCC>abcd1@xyz.com </Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>abcd</param-value> 

</parameter> 

<parameter> 

<param-name>accountNumber</param-name> 

<param-value>444883273987</param-value> 

</parameter>              

</parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 


 Sample request 2-Send SMS to multiple recipients using template. 

Request

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>11111</Evnt_Id> 

<Evnt_Source>creditcard</Evnt_Source> 

             <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>MySenderId</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>11000</Ntfctn_Mthd> 

<Ntfctn_Lng>en_US</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966557702129</Mbl_Tel>                               

                          <Email_To>abc@xyz.com</Email_To> 

                                        <Email_CC>abc1@xyz.com</Email_CC> 

<Email_BCC>abc2@xyz.com</Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>abc</param-value> 

</parameter> 

<parameter> 

<param-name>accountNumber</param-name> 

<param-value>444883273987</param-value> 

</parameter>              

</parameters> 

</Rcpnt_Dtls> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>11000</Ntfctn_Mthd> 

<Ntfctn_Lng>en_US</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966557702129</Mbl_Tel>                               

                                        <Email_To>abc@xyz.com</Email_To> 

                                        <Email_CC>abc1@xyz.com</Email_CC> 

<Email_BCC>abc2@xyz.com</Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>abc2</param-value> 

</parameter> 

<parameter> 

<param-name>accountNumber</param-name> 

<param-value>444883273987</param-value> 

</parameter>              

</parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 



Sample - SMS Template Not Available

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>1001</Evnt_Id> 

<Evnt_Source>123</Evnt_Source> 

  <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>MyApplication</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

      <Ntfctn_Lng>en_US</Ntfctn_Lng> 

      <Ntfctn_Enc>A</Ntfctn_Enc> 

       <Group_Id>g1</Group_Id>                              

                            <Email_CC>abcd@xyz.com</Email_CC> 

       <Email_BCC>abcd1@xyz.com </Email_BCC> 

       <Email_Sbjct>Account Opened</Email_Sbjct> 

        <parameters> 

<parameter> 

      <param-name>custName</param-name> 

      <param-value>abcd</param-value> 

 </parameter> 

<parameter> 

                                  <param-name>accountNumber</param-name> 

      <param-value>444883273987</param-value> 

</parameter>     

         </parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 


Sample - Email Template Not Available

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>1002</Evnt_Id> 

<Evnt_Source>123</Evnt_Source> 

  <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>MyApplication</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

      <Ntfctn_Lng>en_US</Ntfctn_Lng> 

      <Ntfctn_Enc>A</Ntfctn_Enc> 

       <Group_Id>g1</Group_Id>                              

                            <Email_CC>abcd@xyz.com</Email_CC> 

       <Email_BCC>abcd1@xyz.com </Email_BCC> 

       <Email_Sbjct>Account Opened</Email_Sbjct> 

        <parameters> 

<parameter> 

      <param-name>custName</param-name> 

      <param-value>abcd</param-value> 

 </parameter> 

<parameter> 

                                  <param-name>accountNumber</param-name> 

      <param-value>444883273987</param-value> 

</parameter>     

         </parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 



Sample - Duplicate Event Id test  

Request

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>1002</Evnt_Id> 

<Evnt_Source>123</Evnt_Source> 

  <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>MyApplication</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

      <Ntfctn_Lng>en_US</Ntfctn_Lng> 

      <Ntfctn_Enc>A</Ntfctn_Enc> 

       <Group_Id>g1</Group_Id>                              

                            <Email_CC>abcd@xyz.com</Email_CC> 

       <Email_BCC>abcd1@xyz.com </Email_BCC> 

       <Email_Sbjct>Account Opened</Email_Sbjct> 

        <parameters> 

<parameter> 

      <param-name>custName</param-name> 

      <param-value>abcd</param-value> 

 </parameter> 

<parameter> 

                                  <param-name>accountNumber</param-name> 

      <param-value>444883273987</param-value> 

</parameter>     

         </parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 



Sample:- Invalid XML  

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>1002</Evnt_Id> 

<Evnt_Source>123</Evnt_Source> 

  <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>MyApplication</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

      <Ntfctn_Lng>en_US</Ntfctn_Lng> 

      <Ntfctn_Enc>A</Ntfctn_Enc> 

       <Group_Id>g1</Group_Id>                              

                            <Email_CC>abcd@xyz.com</Email_CC> 

       <Email_BCC>abcd1@xyz.com </Email_BCC> 

       <Email_Sbjct>Account Opened</Email_Sbjct> 

        <parameters> 

<parameter> 

      <param-name>custName</param-name> 

      <param-value>abcd</param-value> 

 </parameter> 

<parameter> 

                                  <param-name>accountNumber</param-name> 

      <param-value>444883273987</param-value> 

</parameter>     

         </parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 



Sample:- Send message to direct recipients.  

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>11111</Evnt_Id> 

<Evnt_Source>123</Evnt_Source> 

       <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>Bsf</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>11000</Ntfctn_Mthd> 

<Ntfctn_Lng>en_US</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966557702129</Mbl_Tel>                               

                      <Email_To>abc@xyz.com</Email_To> 

                          <Email_CC>abc1@xyz.com</Email_CC> 

<Email_BCC>abc2@xyz.com</Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>abc</param-value> 

             </parameter> 

 

                                         <parameter> 

<param-name>accountNumber</param-name> 

          <param-value>444883273987</param-value> 

           </parameter>     

</parameters> 

</Rcpnt_Dtls> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>11000</Ntfctn_Mthd> 

<Ntfctn_Lng>en_US</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966557702129</Mbl_Tel>                               

                          <Email_To>abc@xyz.com</Email_To> 

                          <Email_CC>abc1@xyz.com</Email_CC> 

<Email_BCC>abc2@xyz.com</Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>abc2</param-value> 

</parameter> 

<parameter> 

<param-name>accountNumber</param-name> 

<param-value>444883273987</param-value> 

</parameter>     

</parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 

 


Sample 6- Send message to group. 


Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>1012</Evnt_Id> 

<Evnt_Source>123</Evnt_Source> 

  <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>MyApplication</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

      <Ntfctn_Lng>en_US</Ntfctn_Lng> 

      <Ntfctn_Enc>A</Ntfctn_Enc> 

       <Group_Id>g1</Group_Id>                              

                            <Email_CC>abcd@xyz.com</Email_CC> 

       <Email_BCC>abcd1@xyz.com </Email_BCC> 

       <Email_Sbjct>Account Opened</Email_Sbjct> 

        <parameters> 

<parameter> 

      <param-name>custName</param-name> 

      <param-value>abcd</param-value> 

 </parameter> 

<parameter> 

                                  <param-name>accountNumber</param-name> 

      <param-value>444883273987</param-value> 

</parameter>     

         </parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 


Sample - Arabic message 

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Source>5677</Evnt_Source> 

<Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>4</SMS_Type> 

<SMS>سيريبرا</SMS> 

<SMSSender>senderId</SMSSender> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

<Ntfctn_Lng>ar_SA</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966511111111</Mbl_Tel> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 

 



Sample - Unicode message 

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Source>5677</Evnt_Source> 

<Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>3</SMS_Type> 

<SMS>\u0634\u0631\u0643\u0629\u0627\u0644\u062d\u0644\u0648\u0644\u0020 

                      \u0627\u0644\u0645\u062a\u0645\u064a\u0632\u0647</SMS> 

<SMSSender>senderId</SMSSender> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>10000</Ntfctn_Mthd> 

<Ntfctn_Lng>ar_SA</Ntfctn_Lng> 

<Ntfctn_Enc>U</Ntfctn_Enc> 

<Mbl_Tel>966511111111</Mbl_Tel> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 

 



Sample - Send Long Message. 

Request 

              <?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>S3</Evnt_Id> 

<Evnt_Source>dMS</Evnt_Source> 

<Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>5</Evnt_Priority> 

<SMS_Type>2</SMS_Type> 

<SMS>User's dashboard displays current messaging activities for you. The up-to-date status of messages are shown in the form of graphical charts. The credit chart displays current available credits and sent messages while message history chart displays sent messages for last 6 months.</SMS> 

<SMSSender>WatanInvest</SMSSender> 

<Email_Type>2</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>11000</Ntfctn_Mthd> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966557702129</Mbl_Tel> 

<Email_To>spatel@is.com.sa</Email_To> 

<Email_CC>spatel@is.com.sa.com</Email_CC> 

<Email_BCC>spatel@is.com.sa.com</Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>Talal Al-Basha</param-value> 

</parameter> 

<parameter> 

<param-name>accountNumber</param-name> 

<param-value>444883273987</param-value> 

</parameter> 

</parameters> 

</Rcpnt_Dtls> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>11000</Ntfctn_Mthd> 

<Ntfctn_Lng>en_US</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966557702129</Mbl_Tel> 

<Email_To>talal_basha@is.com.sa</Email_To> 

<Email_CC>spatel@is.com.sa</Email_CC> 

<Email_BCC>spatel@is.com.sa.com</Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>Talal Al-Basha</param-value> 

</parameter> 

<parameter> 

<param-name>accountNumber</param-name> 

<param-value>444883273987</param-value> 

</parameter> 

</parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 



Sample:- Send SMS and email with attachment 

Request

<?xml version='1.0' ?> 

<EAIMessage> 

<Evnt_Id>11111</Evnt_Id> 

<Evnt_Source>123</Evnt_Source> 

       <Due_Dt>2008-07-16 16:04:04</Due_Dt> 

<Evnt_Priority>1</Evnt_Priority> 

<SMS_Type>1</SMS_Type> 

<SMS>ACCOUNT_OPENED_TPL</SMS> 

<SMSSender>Bsf</SMSSender> 

<Email_Type>1</Email_Type> 

<Email>ACCOUNT_OPENED_EMAIL_TPL</Email> 

<Rcpnt_Lst> 

<Rcpnt_Dtls> 

<Ntfctn_Mthd>11000</Ntfctn_Mthd> 

<Ntfctn_Lng>en_US</Ntfctn_Lng> 

<Ntfctn_Enc>A</Ntfctn_Enc> 

<Mbl_Tel>966557702129</Mbl_Tel>                               

                      <Email_To>abc@xyz.com</Email_To> 

                          <Email_CC>abc1@xyz.com</Email_CC> 

<Email_BCC>abc2@xyz.com</Email_BCC> 

<Email_Sbjct>Account Opened</Email_Sbjct> 

                                            <Att_Fl_Name>Account_details.xls</Att_Fl_Name> 

                                            <Att_Dp_Name>Account_details.xls</Att_Dp_Name> 

<parameters> 

<parameter> 

<param-name>custName</param-name> 

<param-value>abc</param-value> 

             </parameter> 

 

                                         <parameter> 

<param-name>accountNumber</param-name> 

          <param-value>444883273987</param-value> 

           </parameter>     

</parameters> 

</Rcpnt_Dtls> 

</Rcpnt_Lst> 

</EAIMessage> 

 



Sample:- Send Push Notifications OneSignal 

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

      <Evnt_Id>123456</Evnt_Id>   

      <Evnt_Source>Default</Evnt_Source>          

      <Rcpnt_Lst> 

            <Rcpnt_Dtls> 

                  <Ntfctn_Mthd>00001</Ntfctn_Mthd> 

                  <Push_Dtls> 

                      <Svc>2</Svc> 

<Title>A Test Push Message</Title> 

<Body>This is a test push message</Body> 

                      <Recipient>xxx-xxx-xx-xxx-xxx</Recipient> 

              <Template_Code>OneSig01</Template_Code> 

                  </Push_Dtls> 

            </Rcpnt_Dtls>                   

      </Rcpnt_Lst> 

</EAIMessage> 

 




Sample:- Send Push Notifications PushWoosh 

Request 

<?xml version='1.0' ?> 

<EAIMessage> 

      <Evnt_Id>12345678</Evnt_Id>   

      <Evnt_Source>Default</Evnt_Source> 

      <Rcpnt_Lst>      

            <Rcpnt_Dtls> 

                  <Ntfctn_Mthd>00001</Ntfctn_Mthd> 

                  <Push_Dtls> 

 <Svc>2</Svc> 

<Title>A Test Push Message</Title> 

<Body>This is a test push messgage from MQ</Body> 

<Notif_Type>1</Notif_Type> 

<Recipient>1</Recipient> 

<Template_Code>T100</Template_Code> 

<Tag_Value>rfarooq</Tag_Value> 

                  </Push_Dtls> 

            </Rcpnt_Dtls>                        

      </Rcpnt_Lst> 

</EAIMessage> 




Sample:- Send Push Notifications Google FCM 

Request 

<?xml version='1.0' ?> 

  <EAIMessage> 

      <Evnt_Id>12345678</Evnt_Id>   

      <SMSSender></SMSSender> 

      <Evnt_Source>Default</Evnt_Source> 

      <SMS_Type>2</SMS_Type> 

      <Rcpnt_Lst> 

            <Rcpnt_Dtls> 

                  <Ntfctn_Mthd>00001</Ntfctn_Mthd> 

                  <Ntfctn_Lng>en_US</Ntfctn_Lng> 

                  <Ntfctn_Enc>E</Ntfctn_Enc> 

                  <Push_Dtls> 

                      <Svc>4</Svc> 

<Title>Test Google Fcm from Webservice</Title> 

<Body>FCM push from Webservice</Body> 

<Notif_Type>1</Notif_Type> 

              <Recipient>devicetokenfromgooglefcm</Recipient> 

<Template_Code>GoogleFcm01</Template_Code> 

                  </Push_Dtls> 

            </Rcpnt_Dtls>                      

      </Rcpnt_Lst> 

</EAIMessage> 

 

Sample:- PushWoosh template code enumeration value 

Template Code 

name:<template_name>,app_code:<your_app>,auth_token:<your_auth_token>,userTag:<your_pushwoosh_tag>,tagType:<push_woosh_tag_type>,tagScope:<app/gen>,pushSvc:pw 

 

Sample:- OneSignal template code enumeration value 

Template Code 

name:<template_name>,app_code:<onesignal_app_id>,auth_token:<onesignal_auth_toke>,pushSvc:os 

 

Sample:- Google FCM template code enumeration value 

Template Code 

name:<template_name>,auth_token:<fcm_auth_toke>,pushSvc:fc 

 


Sample:- SMS Template  (JSON) 

Request 

{ 

   "EAIMessage": { 

      "Evnt_Id": "5", 

      "Evnt_Source": "Default", 

      "SMS_Type": "1", 

      "SMS": "OTP1", 

      "Rcpnt_Lst": { 

         "Rcpnt_Dtls": { 

            "Ntfctn_Mthd": "1000", 

            "Ntfctn_Lng": "ar_SA", 

            "Mbl_Tel": "966560833897", 

            "parameters": { 

               "parameter": { 

                  "param-name": "code", 

                  "param-value": "9091" 

               } 

            } 

         } 

      } 

   } 

} 

 


Sample:- Send Push Notifications PushWoosh (JSON) 

Request 

{ 

  "EAIMessage": { 

    "Evnt_Id": "1", 

    "Evnt_Source": "Default", 

    "Rcpnt_Lst": { 

      "Rcpnt_Dtls": { 

        "Ntfctn_Mthd": "00001", 

        "Push_Dtls": { 

          "Svc": "2", 

          "Title": "A Test Push Message from WS", 

          "Body": "pushwoosh message from webservice", 

          "Notif_Type": "1", 

          "Recipient": "dnuaimi", 

          "Template_Code": "PWT1", 

          "Tag_Value": "dnuaimi" 

        } 

      } 

    } 

  } 

} 

 

 

 

Sample:- Send Push Notifications OneSignal (JSON) 

Request 

{ 

  "EAIMessage": { 

    "Evnt_Id": "1", 

    "Evnt_Source": "Default", 

    "Rcpnt_Lst": { 

      "Rcpnt_Dtls": { 

        "Ntfctn_Mthd": "00001", 

        "Push_Dtls": { 

          "Svc": "3", 

          "Title": "A Test Push Message from WS", 

          "Body": "OneSignel message from webservice", 

          "Notif_Type": "1", 

          "Recipient": "be37cfd9-5a49-4dff-86f8-1123e83298ce", 

          "Template_Code": "OST1", 

          "Tag_Value": "dnuaimi" 

        } 

      } 

    } 

  } 

} 

 

 

Sample:- Send Push Notifications Google FCM (JSON) 

Request 

{ 

  "EAIMessage": { 

    "Evnt_Id": "1", 

    "Evnt_Source": "Default", 

    "Rcpnt_Lst": { 

      "Rcpnt_Dtls": { 

        "Ntfctn_Mthd": "00001", 

        "Push_Dtls": { 

          "Svc": "3", 

          "Title": "Test Google Fcm from Webservice", 

          "Body": "FCM push from Webservice", 

          "Notif_Type": "1", 

          "Recipient": " cqkILWKXQku9cPA40V0A5K:APA91bFCx3btI7g_aUZMxO6TTafC6rPRRPqa1V5BhyujJIOX1Qt11UxHzFuEdJ7OTnLRP_ntQAxMTaurkomau8XB1GrZUI8RDkwBnS-oJXiP0n0CU5qt03032l1IDLUiJKp1yR4pw6kR 

", 

          "Template_Code": "FCM", 

          "Tag_Value": "dnuaimi" 

        } 

      } 

    } 

  } 

} 

 

 

 

Error description:

S. No
Action To Take
Error Description
1
Xml Is not correct please check the xml format 
Invalid XMl / Unable to parse xml
2
Specified SMS template is not available please add SMS template in English and Arabic 
SMS template should be defined in both languages English and Arabic 
3
Specified Email template is not available please add Email template in English and Arabic and check resource directory path. 
Email template should be defined in both languages English and Arabic
4
Change Event id for this xml 
Please change event id to make this transaction unique 
5
File is not saved in UTF8 format. 

Please save file in UTF 8 Format 
Unable to Validate the file XYZ.xml Error Message::error: Unexpected element: CDATA. This issue occurs in case of XML file channel. 


Constraints 

  1. 1. SMS template should be defined in both languages English and Arabic. 

  1. 2. Email template should be defined in both languages English and Arabic. If email option is also selected. 

  1. 3. Event id should be unique. 

  1. 4. Xml format should be correct as mentioned structure. 

  1. 5. In the case of XML File channel, XML File should be saved in UTF8 format. 

  1. 6. You can't send SMS to groups created by other than administrator. 

  1. 7. For Push Notifications the push template code should be defined in the enumerations as per the required formats of PushWooshOneSignal.and Google FCM.  


© 2024 Cerebra All Copyrights Reserved
    • Related Articles

    • LinQ2 P-Series Xml File Integration Channel

      XML File Integration 1.1 Introduction This interface allows sending requests to LinQ2 through xml file saved in UTF 8 format. Linq2 application will read this file from already defined source directory. In case of successful processing this file will ...
    • LinQ2 P-Series Voice Integration Channel v1.0

      Voice Integration Introduction Now Linq2 P Series supports automated voice calling feature through standard SIP providers e.g. FreePBX. Linq2 P Series is integrated with SIP Providers by using the following approach/steps. Configure SIP account ...
    • Release Note - Voice Module [P-Series - V 4.1.0] - Internal

      LinQ2 P-Series Voice Release Notes This release contains Voice module & integration in LinQ2 P-Series: Introduction: Now Linq2 P Series supports automated voice calling feature through standard SIP providers e.g. FreePBX. Linq2 P Series is integrated ...
    • LinQ2 P-Series Push Notifications Integration Channel v1.1

      Push Notification Integration 1.1 Introduction Linq2 is integrated with Push Providers (PushWoosh/OneSignal/Google FCM) by using following approach. Push notification can be requested in the XML or Rest request by MQ or WebService integration ...
    • LinQ2 P-Series Database Integration Channel

      Data base Integration 1.1 Introduction LinQ2 application has a database monitor component to pull messages from database other then linQ2 database. LinQ2 database monitor can pull message information from the database table and send it to appropriate ...