Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Status
colourGreen
titlepost
 
Anchor
toprws
toprws

Service URLreport.asmx

General Information

Report Web Service provides several methods for getting reports for your Email, SMS and Push campaign reports. 



Report Web Service Methods

The following table lists supported methods in Report Web Service and provides a brief description of each method. Click on the method name for detailed information:



Method

Description

GetCampaignReport

Queries and builds campaign report between 2 dates.

GetCampaignReportWithCampID

Queries and builds campaign report between 2 dates based on Campaign ID.

GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtp

Shows the Email Campaign's delivery status between two dates based on Campaign ID.

GetEmailCampaignLinks

Queries links of a campaign.

GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtp

Returns the list of users who clicked on a campaign link between two dates.

GetEmailUnsubscribeReportBetweenTwoDatesViaFtp

Queries and builds a report of members who unsubscribed from email between two dates.

GetFilteredMembers

Allows you to create member inquiries based on specific filters.

GetIncomingSmsMessages

Reports incoming SMS messages.

GetListContent

Queries members in a list.

GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtp

Queries and builds a delivery status report based on a given SMS Campaign ID.

GetSmsCampaignReport

Queries and builds SMS campaign reports between 2 dates. Date format must be dd.mm.yyyy

GetSmsCampaignReportWithCampID

Queries and builds campaign report based on a given SMS Campaign ID.

GetSmsOptoutReportBetweenTwoDates

Queries and builds an SMS opt-out report between two dates.

GetUnsubscribeReportBetweenTwoDates

Queries and builds an unsubscribe report between two dates.

QueryBulkFileProgress

Allows you to inquire about the status of an upload or report request.

QueryDataWarehouseUploadProgress

Queries the status of a Data Warehouse upload.

QueryOngoingEmailStatus

Queries and reports the delivery status of a triggered Email campaign.

QueryOngoingSmsStatus

Queries and reports the delivery status of a triggered SMS campaign.

QuerySendingPushMessageToMembers

Queries push messages sent to members.





Warning

To interact with any Web Services, developers must first use the Login method to create a

Status
subtletrue
colourRed
title Service Ticket
. Developers can send requests to other Web Service and methods using this
Status
subtletrue
colourRed
title Service Ticket



GetEmailUnsubscribeReportBetweenTwoDatesViaFtp 
Anchor
getemailuns
getemailuns

Back to Top ^

<GetEmailUnsubscribeReportBetweenTwoDatesViaFtp>
Queries and builds a report of members who unsubscribed from email between two dates.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampaignIDCampaign ID to get the Report for

Status
colourYellow
titleoptional

MapColumns of the Report File

Status
colourGreen
titlemandatory

ZipPasswordPassword of the Zip File that contains the Report File

Status
colourYellow
titleoptional

NotificationEmailThe address to send notification email about the status of the Report request

Status
colourGreen
titlemandatory

ServerIPIP address of the FTP/SFTP server to send the Report to

Status
colourGreen
titlemandatory

UsernameThe Username for the FTP/SFTP server to send the Report to

Status
colourGreen
titlemandatory

PasswordThe password for the FTP/SFTP server to send the Report to

Status
colourGreen
titlemandatory

ChangeDirThe folder path to send the Report to

Status
colourGreen
titlemandatory

SecureConnection Type

Status
colourGreen
titlemandatory

KeyAccount reference information

Status
colourGreen
titlemandatory




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetEmailUnsubscribeReportBetweenTwoDatesViaFtp xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <CampaignID>string</CampaignID>
      <Map>string</Map>
      <ZipPassword>string</ZipPassword>
      <NotificationEmail>string</NotificationEmail>
      <BeginDate>string</BeginDate>
      <EndDate>string</EndDate>
      <FtpDetails>
        <ServerIP>string</ServerIP>
        <Port>int</Port>
        <Username>string</Username>
        <Password>string</Password>
        <ChangeDir>string</ChangeDir>
        <Secure>boolean</Secure>
        <Key>string</Key>
      </FtpDetails>
    </GetEmailUnsubscribeReportBetweenTwoDatesViaFtp>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetEmailUnsubscribeReportBetweenTwoDatesViaFtpResponse xmlns="http://ws.euromsg.com/report">
      <GetEmailUnsubscribeReportBetweenTwoDatesViaFtpResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetEmailUnsubscribeReportBetweenTwoDatesViaFtpResult>
    </GetEmailUnsubscribeReportBetweenTwoDatesViaFtpResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

If

Status
subtletrue
colourRed
titleCAMP_ID
parameter is left blank, the service returns the report for all members who have unsibscribed between two dates. If
Status
subtletrue
colourRed
titleCAMP_ID
parameter is filled, the system returns the report only for members who have unsubscribed from a particular campaign, between two dates.

Warning

Secure parameter can have a

Status
subtletrue
colourRed
titletrue
or
Status
subtletrue
colourRed
titlefalse
value depending on the connetion type. If the connection type is SFTP or secure FTP, then this flag must be sent as
Status
subtletrue
colourRed
titletrue
.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.



Back to Top ^

<GetEmailCampaignLinks>
Queries links of a campaign.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login
CampaignIDCampaign ID to list the links for




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetEmailCampaignLinks
            xmlns="http://ws.euromsg.com/report">
            <ServiceTicket>string</ServiceTicket>
            <CampaignID>string</CampaignID>
        </GetEmailCampaignLinks>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetEmailCampaignLinksResponse
            xmlns="http://ws.euromsg.com/report">
            <GetEmailCampaignLinksResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <ConversationID>string</ConversationID>
                <ConversationStatus>string</ConversationStatus>
                <TotalRowCountInConversation>int</TotalRowCountInConversation>
                <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
            </GetEmailCampaignLinksResult>
            <Links>
                <CampaignLink>
                    <LinkID>string</LinkID>
                    <LinkName>string</LinkName>
                    <Link>string</Link>
                    <LinkType>string</LinkType>
                    <TotalClickCount>int</TotalClickCount>
                    <UniqueClickCount>int</UniqueClickCount>
                </CampaignLink>
                <CampaignLink>
                    <LinkID>string</LinkID>
                    <LinkName>string</LinkName>
                    <Link>string</Link>
                    <LinkType>string</LinkType>
                    <TotalClickCount>int</TotalClickCount>
                    <UniqueClickCount>int</UniqueClickCount>
                </CampaignLink>
            </Links>
        </GetEmailCampaignLinksResponse>
    </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
9998Not a valid campaign id!The entered CampaignID value does not match any registered Campaigs in the account.



GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtp 
Anchor
getemaillinkreport
getemaillinkreport

Back to Top ^

<GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtp>
Returns the list of users who clicked on a campaign link between two dates.

Parameters


ParameterDeğer
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampaignIDCampaign ID to create the report for

Status
colourGreen
titlemandatory

BeginDateReport start date

Status
colourGreen
titlemandatory

EndDateReport end date

Status
colourGreen
titlemandatory

MapOrder of the Report columns

Status
colourGreen
titlemandatory

ZipPasswordPassword of the Zip File that contains the Report File

Status
colourYellow
titleoptional

NotificationEmailThe address to send notification email about the status of the report request

Status
colourGreen
titlemandatory

ServerIPIP address of the FTP/SFTP server to send the Report to

Status
colourGreen
titlemandatory

UsernameThe Username for the FTP/SFTP server to send the Report to

Status
colourGreen
titlemandatory

PasswordThe password for the FTP/SFTP server to send the Report to

Status
colourGreen
titlemandatory

ChangeDirThe folder path to send the Report to

Status
colourGreen
titlemandatory

SecureConnection Type

Status
colourGreen
titlemandatory

KeyAccount reference information

Status
colourGreen
titlemandatory




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtp xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <CampaignID>string</CampaignID>
      <Map>string</Map>
      <ZipPassword>string</ZipPassword>
      <NotificationEmail>string</NotificationEmail>
      <BeginDate>string</BeginDate>
      <EndDate>string</EndDate>
      <FtpDetails>
        <ServerIP>string</ServerIP>
        <Port>int</Port>
        <Username>string</Username>
        <Password>string</Password>
        <ChangeDir>string</ChangeDir>
        <Secure>boolean</Secure>
        <Key>string</Key>
      </FtpDetails>
    </GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtp>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtpResponse xmlns="http://ws.euromsg.com/report">
      <GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtpResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtpResult>
    </GetEmailCampaignMemberLinkReportBetweenTwoDatesViaFtpResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
9998Not a valid campaign id!The entered CampaignID value does not match any registered Campaigns in the account



GetUnsubscribeReportBetweenTwoDates 
Anchor
getunsnonftp
getunsnonftp

Back to Top ^

<GetUnsubscribeReportBetweenTwoDates>

Lists the members who have unsubscribed between two dates.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login
BeginDateReport start date. Date format must be dd.mm.yyyy
EndDateReport end date. Date format must be dd.mm.yyyy




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetUnsubscribeReportBetweenTwoDates xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <BeginDate>string</BeginDate>
      <EndDate>string</EndDate>
    </GetUnsubscribeReportBetweenTwoDates>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetUnsubscribeReportBetweenTwoDatesResponse xmlns="http://ws.euromsg.com/report">
      <GetUnsubscribeReportBetweenTwoDatesResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetUnsubscribeReportBetweenTwoDatesResult>
      <Unsubscribers>
        <EmUnsubscriberDetails>
          <KeyId>string</KeyId>
          <Email>string</Email>
          <UnsubscribeTime>string</UnsubscribeTime>
          <Reason>string</Reason>
          <GsmNo>string</GsmNo>
          <EmailPermit>string</EmailPermit>
          <GsmPermit>string</GsmPermit>
        </EmUnsubscriberDetails>
        <EmUnsubscriberDetails>
          <KeyId>string</KeyId>
          <Email>string</Email>
          <UnsubscribeTime>string</UnsubscribeTime>
          <Reason>string</Reason>
          <GsmNo>string</GsmNo>
          <EmailPermit>string</EmailPermit>
          <GsmPermit>string</GsmPermit>
        </EmUnsubscriberDetails>
      </Unsubscribers>
    </GetUnsubscribeReportBetweenTwoDatesResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

Date format is yyyy-MM-dd hh:mm:ss. The date range is limited to a maximum of 24 hours since the data size may grow considerably.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Not a valid date!Entered date range exceeds 24 hours or the date format is wrong.



GetFilteredMembers 
Anchor
getfilteredmem
getfilteredmem

Back to Top ^

<GetFilteredMembers>
Allows you to create member inquiries based on specific filters.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

FiltersString that contains the filters to apply

Status
colourGreen
titlemandatory

EmKeyOperatorValueContains the details of the filter to apply

Status
colourGreen
titlemandatory

KeyDemographic or permission information to apply the filtering to

Status
colourGreen
titlemandatory

OperatorComparison operator to apply in the scope of the filter(=, <>, <, > etc)

Status
colourGreen
titlemandatory

ValueThe key parameter value to be used for filtering

Status
colourGreen
titlemandatory

MapColumns of the report to create

Status
colourGreen
titlemandatory

ZipPasswordZip password for the report to create

Status
colourYellow
titleoptional

NotificationEmailThe address to send the notification email depending on the status of the report request

Status
colourGreen
titlemandatory

FtpDetailsThe string that contains the FTP/SFTP field info to send the created report to

Status
colourGreen
titlemandatory

ServerIPIP address of the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

UsernameThe username of the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

PasswordThe password for the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

ChangeDirThe folder path to send the report to

Status
colourGreen
titlemandatory

SecureConnection type

Status
colourGreen
titlemandatory

KeyAccount reference information

Status
colourGreen
titlemandatory



Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetFilteredMembers xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <Filters>
        <EmKeyOperatorValue>
          <Key>string</Key>
          <Operator>string</Operator>
          <Value>string</Value>
        </EmKeyOperatorValue>
        <EmKeyOperatorValue>
          <Key>string</Key>
          <Operator>string</Operator>
          <Value>string</Value>
        </EmKeyOperatorValue>
      </Filters>
      <Map>string</Map>
      <ZipPassword>string</ZipPassword>
      <NotificationEmail>string</NotificationEmail>
      <FtpDetails>
        <ServerIP>string</ServerIP>
        <Port>int</Port>
        <Username>string</Username>
        <Password>string</Password>
        <ChangeDir>string</ChangeDir>
        <Secure>boolean</Secure>
        <Key>string</Key>
      </FtpDetails>
    </GetFilteredMembers>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetFilteredMembersResponse xmlns="http://ws.euromsg.com/report">
      <GetFilteredMembersResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetFilteredMembersResult>
    </GetFilteredMembersResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

If there are no users created based on the specified filter, then the report is created including the "header" line only.

Warning

Secure parameter can have a

Status
subtletrue
colourRed
titletrue
or
Status
subtletrue
colourRed
titlefalse
value depending on the connetion type. If the connection type is SFTP or secure FTP, then this flag must be sent as
Status
subtletrue
colourRed
titletrue
.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.



GetCampaignReport 
Anchor
getcampreport
getcampreport

Back to Top ^

<GetCampaignReport>
Lists the campaign reports between two specified dates.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

BeginDateReport start date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory

EndDateReport end date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetCampaignReport xmlns="http://ws.euromsg.com/report">
            <ServiceTicket>string</ServiceTicket>
            <BeginDate>string</BeginDate>
            <EndDate>string</EndDate>
        </GetCampaignReport>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetCampaignReportResponse
            xmlns="http://ws.euromsg.com/report">
            <GetCampaignReportResult>
                <Code>00</Code>
                <Message />
                <DetailedMessage />
                <ConversationID>string</ConversationID>
                <ConversationStatus>string</ConversationStatus>
                <TotalRowCountInConversation>int</TotalRowCountInConversation>
                <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
            </GetCampaignReportResult>
            <Campaigns>
                <EmCampaignReportResult>
                    <Name>string</Name>
                    <Subject>string</Subject>
                    <CustomerTitle>string</CustomerTitle>
                    <CreationDate>string</CreationDate>
                    <DeliveryStart>string</DeliveryStart>
                    <DeliveryFinish>string</DeliveryFinish>
                    <CampaignID>string</CampaignID>
                    <TotalSent>string</TotalSent>
                    <TotalRead>string</TotalRead>
                    <HardBounce>string</HardBounce>
                    <SoftBounce>string</SoftBounce>
                    <Other>string</Other>
                    <UniqueRead>string</UniqueRead>
                    <UniqueClick>string</UniqueClick>
                    <TotalClick>string</TotalClick>
                    <ReadRatio>string</ReadRatio>
                    <ClickRatio>string</ClickRatio>
                    <HotmailJunkCount>string</HotmailJunkCount>
                    <YahooJunkCount>string</YahooJunkCount>
                    <Lists>string</Lists>
                    <Status>string</Status>
                    <Classification>
                        <string>string</string>
                        <string>string</string>
                    </Classification>
                </EmCampaignReportResult>
                <EmCampaignReportResult>
                    <Name>string</Name>
                    <Subject>string</Subject>
                    <CustomerTitle>string</CustomerTitle>
                    <CreationDate>string</CreationDate>
                    <DeliveryStart>string</DeliveryStart>
                    <DeliveryFinish>string</DeliveryFinish>
                    <CampaignID>string</CampaignID>
                    <TotalSent>string</TotalSent>
                    <TotalRead>string</TotalRead>
                    <HardBounce>string</HardBounce>
                    <SoftBounce>string</SoftBounce>
                    <Other>string</Other>
                    <UniqueRead>string</UniqueRead>
                    <UniqueClick>string</UniqueClick>
                    <TotalClick>string</TotalClick>
                    <ReadRatio>string</ReadRatio>
                    <ClickRatio>string</ClickRatio>
                    <HotmailJunkCount>string</HotmailJunkCount>
                    <YahooJunkCount>string</YahooJunkCount>
                    <Lists>string</Lists>
                    <Status>string</Status>
                    <Classification>
                        <string>string</string>
                        <string>string</string>
                    </Classification>
                </EmCampaignReportResult>
            </Campaigns>
        </GetCampaignReportResponse>
    </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.


Error Parameters


CodeError MessageAçıklama
9998No session. Please try re-logon.No active sessions found. Try login again.



QueryBulkFileProgress 
Anchor
querybulkprog
querybulkprog

Back to Top ^

<QueryBulkFileProgress>
Allows you to inquire about the status of an upload or report request.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

ConversationID32 Byte ID returned by the system as a result of the upload or report request

Status
colourGreen
titlemandatory




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryBulkFileProgress xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <ConversationID>string</ConversationID>
    </QueryBulkFileProgress>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryBulkFileProgressResponse xmlns="http://ws.euromsg.com/report">
      <QueryBulkFileProgressResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </QueryBulkFileProgressResult>
    </QueryBulkFileProgressResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

Report requests are processed between midnight 00:00 and 06:00. Requests sent during the day do not get processed in the database until midnight. Therefore, when you run queries for report requests, the

Status
subtletrue
colourRed
titleTotalRowCountInConversation
and
Status
subtletrue
colourRed
titleProcessedRowCountInConversation
 
parameter values are returned as "0". These values reflect the true statuses after the report request is processed.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Not a valid conversation ID!Conversation ID sent to the service is incorrect.



QueryOngoingSmsStatus 
Anchor
queryongsmsstat
queryongsmsstat

Back to Top ^

<QueryOngoingSmsStatus>
Queries and reports the delivery status of a triggered SMS campaign.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampIDCampaign ID

Status
colourGreen
titlemandatory

TransactionID32 Byte ID returned by the system as a result of the upload or report request

Status
colourGreen
titlemandatory



Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryOngoingSmsStatus xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <CampID>string</CampID>
      <TransacitonID>string</TransacitonID>
    </QueryOngoingSmsStatus>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryOngoingSmsStatusResponse xmlns="http://ws.euromsg.com/report">
      <QueryOngoingSmsStatusResult>
        <Code>string</Code>
        <Message>string</Message>
        <DetailedMessage>string</DetailedMessage>
      </QueryOngoingSmsStatusResult>
      <DeliveryResult>
        <GsmNumber>string</GsmNumber>
        <DeliveryResult>string</DeliveryResult>
        <DeliveryDetail>string</DeliveryDetail>
        <DeliveryTime>string</DeliveryTime>
        <DeliveredMessage>string</DeliveredMessage>
        <PostType>string</PostType>
        <KeyID>string</KeyID>
        <SendDate>string</SendDate>
      </DeliveryResult>
    </QueryOngoingSmsStatusResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.



GetCampaignReportWithCampID 
Anchor
getcampreportwid
getcampreportwid

Back to Top ^


<GetCampaignReportWithCampID>
Queries and builds campaign report between 2 dates based on Campaign ID.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampIDCampaign ID

Status
colourGreen
titlemandatory



Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetCampaignReportWithCampID xmlns="http://ws.euromsg.com/report">
            <ServiceTicket>string</ServiceTicket>
            <CampID>string</CampID>
        </GetCampaignReportWithCampID>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetCampaignReportWithCampIDResponse
            xmlns="http://ws.euromsg.com/report">
            <GetCampaignReportWithCampIDResult>
                <Code>99</Code>
                <Message>Not a valid campaign id!</Message>
                <DetailedMessage />
                <ConversationID>string</ConversationID>
                <ConversationStatus>string</ConversationStatus>
                <TotalRowCountInConversation>int</TotalRowCountInConversation>
                <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
            </GetCampaignReportWithCampIDResult>
            <Campaign>
                <Name>string</Name>
                <Subject>string</Subject>
                <CustomerTitle>string</CustomerTitle>
                <CreationDate>string</CreationDate>
                <DeliveryStart>string</DeliveryStart>
                <DeliveryFinish>string</DeliveryFinish>
                <CampaignID>string</CampaignID>
                <TotalSent>string</TotalSent>
                <TotalRead>string</TotalRead>
                <HardBounce>string</HardBounce>
                <SoftBounce>string</SoftBounce>
                <Other>string</Other>
                <UniqueRead>string</UniqueRead>
                <UniqueClick>string</UniqueClick>
                <TotalClick>string</TotalClick>
                <ReadRatio>string</ReadRatio>
                <ClickRatio>string</ClickRatio>
                <HotmailJunkCount>string</HotmailJunkCount>
                <YahooJunkCount>string</YahooJunkCount>
                <Lists>string</Lists>
                <Status>string</Status>
                <Classification>
                    <string>string</string>
                    <string>string</string>
                </Classification>
            </Campaign>
        </GetCampaignReportWithCampIDResponse>
    </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Not a valid campaign id!Invalid Campaign ID.



GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtp 
Anchor
gettoolongname
gettoolongname

Back to Top ^

<GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtp>
Shows the delivery status between two dates based on a given Campaign ID.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampaignIDCampaign ID to take report for

Status
colourGreen
titleMANDATORY

Map

Columns of the report file

Status
colourGreen
titlemandatory

ZipPasswordThe password of the Zip file that contains the report file

Status
colourYellow
titleoptional

NotificationEmailThe address to send notification email about the status of the report request

Status
colourGreen
titlemandatory

BeginDateReport start date

Status
colourGreen
titlemandatory

EndDateReport end date

Status
colourGreen
titlemandatory

ServerIPIP address of the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

UsernameUsername for the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

PasswordPassword for the ftp/sftp server to send the report to

Status
colourGreen
titlemandatory

ChangeDirThe folder path to send the report to

Status
colourGreen
titlemandatory

SecureConnection Type

Status
colourGreen
titlemandatory

KeyAccount Reference Information

Status
colourGreen
titlemandatory

Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtp
            xmlns="http://ws.euromsg.com/report">
            <ServiceTicket>string</ServiceTicket>
            <CampaignID>string</CampaignID>
            <Map>string</Map>
            <ZipPassword>string</ZipPassword>
            <NotificationEmail>string</NotificationEmail>
            <BeginDate>string</BeginDate>
            <EndDate>string</EndDate>
            <FtpDetails>
                <ServerIP>string</ServerIP>
                <Port>int</Port>
                <Username>string</Username>
                <Password>string</Password>
                <ChangeDir>string</ChangeDir>
                <Secure>boolean</Secure>
                <Key>string</Key>
            </FtpDetails>
        </GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtp>
    </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:xsd="http://www.w3.org/2001/XMLSchema"
    xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
    <soap:Body>
        <GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResponse
            xmlns="http://ws.euromsg.com/report">
            <GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResult>
                <Code>00</Code>
                <Message/>
                <DetailedMessage/>
                <ConversationID>AB85E41E5DC24DA58C90B0D08F87F24B</ConversationID>
                <ConversationStatus>F</ConversationStatus>
                <TotalRowCountInConversation>0</TotalRowCountInConversation>
                <ProcessedRowCountInConversation>0</ProcessedRowCountInConversation>
            </GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResult>
        </GetEmailCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResponse>
    </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

If

Status
subtletrue
colourRed
titleCAMP_ID
parameter is left blank, the service returns the report for all members who have unsibscribed between two dates. If
Status
subtletrue
colourRed
titleCAMP_ID
parameter is filled, the system returns the report only for members who have unsubscribed from a particular campaign, between two dates.

Warning

Secure parameter can have a

Status
subtletrue
colourRed
titletrue
or
Status
subtletrue
colourRed
titlefalse
value depending on the connetion type. If the connection type is SFTP or secure FTP, then this flag must be sent as
Status
subtletrue
colourRed
titletrue
.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.



QueryOngoingEmailStatus 
Anchor
ongoingemailstat
ongoingemailstat

Back to Top ^

<QueryOngoingEmailStatus>
Queries the delivery status a triggered Email campaign.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampIDCampaign ID

Status
colourGreen
titlemandatory

TransactionID32 Byte ID returned by the system as a result of the upload or report request

Status
colourGreen
titlemandatory




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryOngoingEmailStatus xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <CampID>string</CampID>
      <TransacitonID>string</TransacitonID>
    </QueryOngoingEmailStatus>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryOngoingEmailStatusResponse xmlns="http://ws.euromsg.com/report">
      <QueryOngoingEmailStatusResult>
        <CampID>string</CampID>
        <TransacitonID>string</TransacitonID>
        <RelayStatus>string</RelayStatus>
        <DeliveryStatus>string</DeliveryStatus>
        <ReadTime>string</ReadTime>
        <UndeliveryReason>string</UndeliveryReason>
        <MarkedSpam>boolean</MarkedSpam>
      </QueryOngoingEmailStatusResult>
    </QueryOngoingEmailStatusResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Online Campaign does not exist!The sent  CampID parameter does not correspond to any registered campaign in the account.



GetListContent 
Anchor
getlistcontent
getlistcontent

Back to Top ^

<GetListContent>

Lists the members found in a specified list.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

GroupNameGroup that the list to inquire belongs to

Status
colourGreen
titlemandatory

ListNameName of the List to create inquiry

Status
colourGreen
titlemandatory

ListInsertionBeginDateStart date based on saving on the list

Status
colourGreen
titlemandatory

ListInsertionFinishDate

End date based on saving on the list

Status
colourGreen
titlemandatory

MapColumns of the report file

Status
colourGreen
titlemandatory

ZipPasswordThe password of the Zip file that contains the report file

Status
colourYellow
titleoptional

NotificationEmailThe address to send notification email about the status of the report request

Status
colourGreen
titlemandatory

BeginDateReport start date

Status
colourGreen
titlemandatory

EndDateReport end date

Status
colourGreen
titlemandatory

ServerIPIP address of the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

UsernameUsername for the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

PasswordPassword for the ftp/sftp server to send the report to

Status
colourGreen
titlemandatory

ChangeDirThe folder path to send the report to

Status
colourGreen
titlemandatory

SecureConnection Type

Status
colourGreen
titlemandatory

KeyAccount reference information

Status
colourGreen
titlemandatory

Code Block
languagexml
titleÖRNEK REQUEST
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetListContent xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <GroupName>string</GroupName>
      <ListName>string</ListName>
      <ListInsertionBeginDate>string</ListInsertionBeginDate>
      <ListInsertionFinishDate>string</ListInsertionFinishDate>
      <Map>string</Map>
      <ZipPassword>string</ZipPassword>
      <NotificationEmail>string</NotificationEmail>
      <FtpDetails>
        <ServerIP>string</ServerIP>
        <Port>int</Port>
        <Username>string</Username>
        <Password>string</Password>
        <ChangeDir>string</ChangeDir>
        <Secure>boolean</Secure>
        <Key>string</Key>
      </FtpDetails>
    </GetListContent>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleÖRNEK RESPONSE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetListContentResponse xmlns="http://ws.euromsg.com/report">
      <GetListContentResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetListContentResult>
    </GetListContentResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

Secure parameter can have a

Status
subtletrue
colourRed
titletrue
or
Status
subtletrue
colourRed
titlefalse
value depending on the connetion type. If the connection type is SFTP or secure FTP, then this flag must be sent as
Status
subtletrue
colourRed
titletrue
.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.



GetSmsCampaignReport 
Anchor
getsmsreport
getsmsreport

Back to Top ^

<GetSmsCampaignReport>

Queries and builds SMS campaign reports between 2 dates. Date format must be dd.mm.yyyy.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

BeginDateReport start date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory

EndDateReport end date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory



Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsCampaignReport xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <BeginDate>string</BeginDate>
      <EndDate>string</EndDate>
    </GetSmsCampaignReport>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsCampaignReportResponse xmlns="http://ws.euromsg.com/report">
      <GetSmsCampaignReportResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetSmsCampaignReportResult>
      <Campaigns>
        <EmSmsCampaignReportResult>
          <CampaignID>string</CampaignID>
          <Name>string</Name>
          <Originator>string</Originator>
          <CreationDate>string</CreationDate>
          <DeliveryStart>string</DeliveryStart>
          <Status>string</Status>
          <GsmColumn>string</GsmColumn>
          <SmsMessage>string</SmsMessage>
          <UniqueSms>string</UniqueSms>
          <TotalSmsCount>string</TotalSmsCount>
          <DuplicateSmsCount>string</DuplicateSmsCount>
          <PreparedSmsCount>string</PreparedSmsCount>
          <TotalSent>string</TotalSent>
          <Read>string</Read>
          <Waiting>string</Waiting>
          <Fail>string</Fail>
          <Timeout>string</Timeout>
          <Lists>string</Lists>
        </EmSmsCampaignReportResult>
      </Campaigns>
    </GetSmsCampaignReportResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.



GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtp 
Anchor
smsdeliverytwodates
smsdeliverytwodates

Back to Top ^

<GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtp>

Queries and builds a delivery status report based on a given SMS Campaign ID.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampaignIDCampaign ID to take report for

Status
colourYellow
titleoptional

MapColumns of the report file

Status
colourGreen
titlemandatory

ZipPasswordThe password of the Zip file that contains the report file

Status
colourYellow
titleoptional

NotificationEmailThe address to send notification email about the status of the report request

Status
colourGreen
titlemandatory

BeginDateReport start date

Status
colourGreen
titlemandatory

EndDateReport end date

Status
colourGreen
titlemandatory

ServerIPIP address of the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

UsernameUsername for the FTP/SFTP server to send the report to

Status
colourGreen
titlemandatory

PasswordPassword for the ftp/sftp server to send the report to

Status
colourGreen
titlemandatory

ChangeDirThe folder path to send the report to

Status
colourGreen
titlemandatory

SecureConnection Type

Status
colourGreen
titlemandatory

KeyFTP Key ID

Status
colourYellow
titleoptional



Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtp xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <CampaignID>string</CampaignID>
      <Map>string</Map>
      <ZipPassword>string</ZipPassword>
      <NotificationEmail>string</NotificationEmail>
      <BeginDate>string</BeginDate>
      <EndDate>string</EndDate>
      <FtpDetails>
        <ServerIP>string</ServerIP>
        <Port>int</Port>
        <Username>string</Username>
        <Password>string</Password>
        <ChangeDir>string</ChangeDir>
        <Secure>boolean</Secure>
        <Key>string</Key>
      </FtpDetails>
    </GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtp>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResponse xmlns="http://ws.euromsg.com/report">
      <GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResult>
    </GetSmsCampaignDeliveryStatusReportBetweenTwoDatesViaFtpResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

If

Status
subtletrue
colourRed
titleCAMP_ID
parameter is left blank, the service returns the report for all members who have unsibscribed between two dates. If
Status
subtletrue
colourRed
titleCAMP_ID
parameter is filled, the system returns the report only for members who have unsubscribed from a particular campaign, between two dates.

Warning

Secure parameter can have a

Status
subtletrue
colourRed
titletrue
or
Status
subtletrue
colourRed
titlefalse
value depending on the connetion type. If the connection type is SFTP or secure FTP, then this flag must be sent as
Status
subtletrue
colourRed
titletrue
.

Error Parameter


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.



GetSmsCampaignReportWithCampID 
Anchor
smsreportwid
smsreportwid

Back to Top ^

<GetSmsCampaignReportWithCampID>
Queries and builds campaign report based on a given SMS Campaign ID.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

CampIDCampaign ID

Status
colourGreen
titlemandatory

Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsCampaignReportWithCampID xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <SmsCampID>string</SmsCampID>
    </GetSmsCampaignReportWithCampID>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsCampaignReportWithCampIDResponse xmlns="http://ws.euromsg.com/report">
      <GetSmsCampaignReportWithCampIDResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetSmsCampaignReportWithCampIDResult>
      <SmsCampaign>
        <CampaignID>string</CampaignID>
        <Name>string</Name>
        <Originator>string</Originator>
        <CreationDate>string</CreationDate>
        <DeliveryStart>string</DeliveryStart>
        <Status>string</Status>
        <GsmColumn>string</GsmColumn>
        <SmsMessage>string</SmsMessage>
        <UniqueSms>string</UniqueSms>
        <TotalSmsCount>string</TotalSmsCount>
        <DuplicateSmsCount>string</DuplicateSmsCount>
        <PreparedSmsCount>string</PreparedSmsCount>
        <TotalSent>string</TotalSent>
        <Read>string</Read>
        <Waiting>string</Waiting>
        <Fail>string</Fail>
        <Timeout>string</Timeout>
        <Lists>string</Lists>
      </SmsCampaign>
    </GetSmsCampaignReportWithCampIDResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Not a valid campaign id!Invalid Campaign ID.



GetIncomingSmsMessages 
Anchor
incomingsms
incomingsms

Back to Top ^

<GetIncomingSmsMessages>
Lists the SMS messages sent to the short number defined in your account.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

BeginTimeReport start date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory

EndTimeReport end date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory

Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetIncomingSmsMessages xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <BeginTime>string</BeginTime>
      <EndTime>string</EndTime>
    </GetIncomingSmsMessages>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetIncomingSmsMessagesResponse xmlns="http://ws.euromsg.com/report">
      <GetIncomingSmsMessagesResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetIncomingSmsMessagesResult>
      <SmsMessages>
        <EmSmsIncomingMessage>
          <GsmNumber>string</GsmNumber>
          <Message>string</Message>
          <OperatorMessageID>string</OperatorMessageID>
          <SendDate>string</SendDate>
          <Operator>string</Operator>
        </EmSmsIncomingMessage>
        <EmSmsIncomingMessage>
          <GsmNumber>string</GsmNumber>
          <Message>string</Message>
          <OperatorMessageID>string</OperatorMessageID>
          <SendDate>string</SendDate>
          <Operator>string</Operator>
        </EmSmsIncomingMessage>
      </SmsMessages>
    </GetIncomingSmsMessagesResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.Login metodu çalıştırılmamış. Aktif oturum yok.
99Not a valid date!Invalid date format.



GetSmsOptoutReportBetweenTwoDates 
Anchor
optouttwodates
optouttwodates

Back to Top ^

<GetSmsOptoutReportBetweenTwoDates>

Queries and builds an SMS opt-out report between two dates.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

BeginDateReport start date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory

EndDateReport end date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsOptoutReportBetweenTwoDates xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <BeginDate>string</BeginDate>
      <EndDate>string</EndDate>
    </GetSmsOptoutReportBetweenTwoDates>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetSmsOptoutReportBetweenTwoDatesResponse xmlns="http://ws.euromsg.com/report">
      <GetSmsOptoutReportBetweenTwoDatesResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </GetSmsOptoutReportBetweenTwoDatesResult>
      <Unsubscribers>
        <EmSmsOptoutList>
		  <KeyId>string</KeyId>
          <SourceNumber>string</SourceNumber>
          <PhoneNumber>string</PhoneNumber>
          <Message>string</Message>
          <Operator>string</Operator>
          <RecordDate>string</RecordDate>
          <MessageType>string</MessageType>
          <EffectedMembers>
            <EmSmsOptoutEffectedMembers xsi:nil="true" />
            <EmSmsOptoutEffectedMembers xsi:nil="true" />
          </EffectedMembers>
        </EmSmsOptoutList>
        <EmSmsOptoutList>
          <SourceNumber>string</SourceNumber>
          <PhoneNumber>string</PhoneNumber>
          <Message>string</Message>
          <Operator>string</Operator>
          <RecordDate>string</RecordDate>
          <MessageType>string</MessageType>
          <EffectedMembers>
            <EmSmsOptoutEffectedMembers xsi:nil="true" />
            <EmSmsOptoutEffectedMembers xsi:nil="true" />
          </EffectedMembers>
        </EmSmsOptoutList>
      </Unsubscribers>
    </GetSmsOptoutReportBetweenTwoDatesResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

Date format is

Status
subtletrue
colourRed
titleyyyy-MM-dd hh:mm:ss
. The date range is limited to a maximum of 24 hours.

Error Parameters


CodeMessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Not a valid date!Entered date interval exceeds 24 hours or the date format is wrong.



QueryDataWarehouseUploadProgress 
Anchor
datawarehouse
datawarehouse

Back to Top ^

<QueryDataWarehouseUploadProgres

Allows you to inquire about the status of a Data Warehouse upload.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

FileNameName of the file to inquire about upload status

Status
colourYellow
titleoptional

BeginTimeReport start date. Date format must be dd.mm.yyyy

Status
colourYellow
titleoptional

EndTimeReport end date. Date format must be dd.mm.yyyy

Status
colourYellow
titleoptional



Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryDataWarehouseUploadProgress xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <FileName>string</FileName>
      <BeginTime>string</BeginTime>
      <EndTime>string</EndTime>
    </QueryDataWarehouseUploadProgress>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QueryDataWarehouseUploadProgressResponse xmlns="http://ws.euromsg.com/report">
      <QueryDataWarehouseUploadProgressResult>
        <ConversationID>string</ConversationID>
        <ConversationStatus>string</ConversationStatus>
        <TotalRowCountInConversation>int</TotalRowCountInConversation>
        <ProcessedRowCountInConversation>int</ProcessedRowCountInConversation>
      </QueryDataWarehouseUploadProgressResult>
      <DWTables>
        <EmDWTableReport>
          <DWTableID>string</DWTableID>
          <FileName>string</FileName>
          <ZipFileName>string</ZipFileName>
          <Status>string</Status>
          <ErrorMessage>string</ErrorMessage>
          <TotalRowCount>int</TotalRowCount>
          <InvalidEmailCount>int</InvalidEmailCount>
          <InvalidGsmCount>int</InvalidGsmCount>
          <BlackListedEmailCount>int</BlackListedEmailCount>
          <BlackListedGsmCount>int</BlackListedGsmCount>
          <NewMemberCount>int</NewMemberCount>
          <ProcessStartTime>string</ProcessStartTime>
          <ProcessEndTime>string</ProcessEndTime>
          <IsBase>boolean</IsBase>
          <FileVersion>string</FileVersion>
        </EmDWTableReport>
      </DWTables>
    </QueryDataWarehouseUploadProgressResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Warning

If only the date range is sent, the system returns all of the upload statuses performed between the given dates. If only the name of the file is sent, the system returns only the upload statuses for the specified file. If both the date range and file name are sent at the same time, the system returns the upload status of the given file name within the specified date range.

Warning
Date format is
Status
subtletrue
colourRed
titleyyyy-MM-dd hh:mm:ss
.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.No active sessions found. Try login again.
99Not a valid date!Invalid date format



QuerySendingPushMessageToMembers 
Anchor
querypush
querypush

Back to Top ^

<QuerySendingPushMessageToMembers>
Queries Push messages sent to members.

Parameters


ParameterValue
ServiceTicketServiceTicket obtained through Login

Status
colourGreen
titlemandatory

beginDateReport start date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory

endDateReport end date. Date format must be dd.mm.yyyy

Status
colourGreen
titlemandatory

keyEMAIL, MEMBER_ID or a field name of your defined in RMC account management panel.

Status
colourGreen
titlemandatory

valueThe value of the field name specified in the Key field.

Status
colourGreen
titlemandatory

pageSizeSets the page size of the report.

Status
colourGreen
titlemandatory

pageCountSets the page count of thre report.

Status
colourGreen
titlemandatory




Code Block
languagexml
titleREQUEST EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QuerySendingPushMessageToMembers xmlns="http://ws.euromsg.com/report">
      <ServiceTicket>string</ServiceTicket>
      <key>string</key>
      <value>string</value>
      <beginDate>string</beginDate>
      <endDate>string</endDate>
      <pageSize>int</pageSize>
      <pageCount>int</pageCount>
    </QuerySendingPushMessageToMembers>
  </soap:Body>
</soap:Envelope>
Code Block
languagexml
titleRESPONSE EXAMPLE
linenumberstrue
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <QuerySendingPushMessageToMembersResponse xmlns="http://ws.euromsg.com/report">
      <QuerySendingPushMessageToMembersResult>
        <UnreadMessageCount>int</UnreadMessageCount>
        <ReadMessageCount>int</ReadMessageCount>
        <pushReportList>
          <EmPushMessage>
            <PushId>string</PushId>
            <Type>Image or Video or Text or Settings or Survey</Type>
            <Text>string</Text>
            <TargetUrl>string</TargetUrl>
            <MediaUrl>string</MediaUrl>
            <MemberId>string</MemberId>
            <SentTime>dateTime</SentTime>
            <PacketStatus>string</PacketStatus>
            <MessageStatusCode>string</MessageStatusCode>
            <MessageStatus>string</MessageStatus>
            <CampId>string</CampId>
            <CampName>string</CampName>
            <ContentType>string</ContentType>
            <IsABCustomization>boolean</IsABCustomization>
            <TextMessageA>string</TextMessageA>
            <TextMessageB>string</TextMessageB>
            <EmpushToken>string</EmpushToken>
            <Params>string</Params>
            <AlternateMessage>string</AlternateMessage>
            <SystemVariables xsi:nil="true" />
            <PromoTableId>string</PromoTableId>
            <CustomerId>string</CustomerId>
          </EmPushMessage>
          <EmPushMessage>
            <PushId>string</PushId>
            <Type>Image or Video or Text or Settings or Survey</Type>
            <Text>string</Text>
            <TargetUrl>string</TargetUrl>
            <MediaUrl>string</MediaUrl>
            <MemberId>string</MemberId>
            <SentTime>dateTime</SentTime>
            <PacketStatus>string</PacketStatus>
            <MessageStatusCode>string</MessageStatusCode>
            <MessageStatus>string</MessageStatus>
            <CampId>string</CampId>
            <CampName>string</CampName>
            <ContentType>string</ContentType>
            <IsABCustomization>boolean</IsABCustomization>
            <TextMessageA>string</TextMessageA>
            <TextMessageB>string</TextMessageB>
            <EmpushToken>string</EmpushToken>
            <Params>string</Params>
            <AlternateMessage>string</AlternateMessage>
            <SystemVariables xsi:nil="true" />
            <PromoTableId>string</PromoTableId>
            <CustomerId>string</CustomerId>
          </EmPushMessage>
        </pushReportList>
      </QuerySendingPushMessageToMembersResult>
    </QuerySendingPushMessageToMembersResponse>
  </soap:Body>
</soap:Envelope>
Tip

If the request was successful, the

Status
subtletrue
colourRed
titleCode
 parameter will return
Status
subtletrue
colourRed
title00
as a response.

Error Parameters


CodeError MessageDescription
9998No session. Please try re-logon.Login metodu çalıştırılmamış. Aktif oturum yok.
99Not a valid date!Invalid date format.




Parent Topic: SOAP Web Service


...