How to do web call back

How to do web call back


Introduction

This article gives an overview on how to use the Nixxis “ContextData” interface to do a web “Call me back”. 

Definition

There are 2 types of call me back. The first is the “Call me back now” and the second is the “Call me back at”. The main difference between the 2 is that the second have a callback date/time.
For both types it is needed to have a campaign with an outbound activity. 

Create a new record

To create a new record the Nixxis API “ContextData” will be used.  
The action “CreateContextData” allow to create a new record in the “Data” table of the campaign (see documentation about “ContactData” for more details). This will also trigger the creation of a record in the “SystemData” table. 


There are 2 different type of record that can be created: 
  1. A record for the campaign (see “Campaign Record”). 
  2. A record that is directly associated with an activity (see “Record associated to an activity”) 

Campaign record 

The first way is to create a record that can be handled by any activity of the campaign.  
For this a POST of xml data is need to the Nixxis ContextData service, this uri looks like this: 
 
 

Using the following parameters: 
  1. “appserver.Nixxis.com:8088”: the name or ip and port of appserver that is used for the “Call me back” 
  2. {campaignId}: the guid of the campaign that will be used for the “Call me back”. Example: 38e8f8dfgg4fd5g1dfg8df4g618g

Here is how the XML structure should look like:  
contextdata> 
            <campaigndata> 
                        <Name>My Customer Name</Name> 
                        <PhoneNumber>0123456789</PhoneNumber> 
            </campaigndata> 
            <systemdata xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
    <CurrentActivity xsi:nil="true" />
                         <State>15</State>
                         <SortInfo>-2</SortInfo>
                         <DialStartDate>yyyy-MM-dd hh:mm:ss.000</DialStartDate>
                         <DialEndDate>yyyy-MM-dd hh:mm:ss.000</DialEndDate>
                         <CreationTime>yyyy-MM-dd hh:mm:ss.000</CreationTime>
                         <ImportTag>ImportTag</ImportTag>
            </systemdata>
</contextdata> 

  1. The tags under ‘<campaigndata>’ (‘<Name>’ and ‘<PhoneNumber>’ in this sample) are directly linked to the fields defined in the campaign database structure. And can be different for each campaign. 
  2. Respect the casing of the fields.
  3. CurrentActivity = Empty (type: char(32)
  4. State = 15 (state description: Callback | type: int)
  5. DialStartDate = Callback date (type: datetime)
  6. DialEndDate = Callback end validity date (type: datetime)
  7. CreationTime = Optional (type: datetime)
  8. ImportTag = Optional (type: nvarchar(250))

Record associated to an activity 

The seconded way is a record that is associated with an activity. 
For this a POST of xml data is need to the Nixxis ContextData service, this uri looks like this: 


Using the following parameters: 
  1. “appserver.Nixxis.com:8088”: the name or ip and port of appserver that is used for the “Call me back.” 
  2. The phone number is always required and need to be put in 1 of the fields where the field meaning is set to a phone number. 

Here is how the XML structure should look like:  
<contextdata> 
            <campaigndata> 
                        <Name>My Customer Name</Name> 
                        <PhoneNumber>0123456789</PhoneNumber> 
            </campaigndata> 
            <systemdata>
                        <CurrentActivity>47b8f8ead10d45c7ac2331c5b47a48b8</CurrentActivity>
                         <State>15</State>
                         <SortInfo>-2</SortInfo>
                         <DialStartDate>yyyy-MM-dd hh:mm:ss.000</DialStartDate>
                         <DialEndDate>yyyy-MM-dd hh:mm:ss.000</DialEndDate>
                         <CreationTime>yyyy-MM-dd hh:mm:ss.000</CreationTime>
                         <ImportTag>ImportTag</ImportTag>
            </systemdata>
</contextdata> 

  1. The tags under ‘<campaigndata>’ (‘<Name>’ and ‘<PhoneNumber>’ in this sample) are directly linked to the fields defined in the campaign database structure. And can be different for each campaign. 
  2. Respect the casing of the fields.
  3. CurrentActivity = 47b8f8ead10d45c7ac2331c5b47a48b8 (to be replaced with destination activity | type: char(32)
  4. State = 15 (state description: Callback | type: int)
  5. DialStartDate = Callback date (type: datetime)
  6. DialEndDate = Callback end validity date (type: datetime)
  7. CreationTime = Optional (type: datetime)
  8. ImportTag = Optional (type: nvarchar(250))

Example Postman :



    • Related Articles

    • Administrator script URL parameters

      1. Introduction This article gives an overview of the parameters that can be used inside a script URL. 2. Parameters 2.1. Customer id Parameter {0} Name Customer id Description This is a field of the database that the customer can choose during ...

    • Comment faire un rappel web

      Introduction Cet article donne un aperçu de la façon d'utiliser l'interface "ContextData" de Nixxis pour faire un "Rappel" web Définition Il existe 2 types de rappel. Le premier est le "Rappelez-moi maintenant" et le second est le "Rappelez-moi à". ...

    • How to activate a Blacklist for an Outbound activity

      1. Introduction  The purpose of this document is to give an overview on how to setup a blacklist for an outbound activity, and includes the detailed steps of the activation in Nixxis. The blacklist function allows the flagging of a destination that ...

    • Technical Parameters - Answering Machine Detection

      Introduction This article provides an overview of the AMD (Answering Machine Detection) settings in Nixxis Contact Suite. It explores the technical parameters and customisation options available for optimising AMD settings based on specific ...

    • Quality Monitoring Tool - User Interface V3.x

      Access to the interface Once you are in the cockpit, choose via the module selector, the Quality Monitoring Tool When the quality monitoring tool is open, you will find 4 different choices. The first is again the module selector which will allow you ...