Office 365 - Exchange Web Services API

Owned by Kiss, Mate
Jul 31, 2018
2 min read
Available in version 8.6 and later

This page provides a guide to configuring an Exchange Web Service (EWS) Storage Target in the Verba Recording System.

Creating an Exchange Web Services (EWS) target

Follow the steps below to create a new Verba Storage target for EWS:

Step 1 - Open the Verba Web interface then select Policies > Storage Targets from the top menu.

Step 2 - Click on Add New Storage Target

Step 3 - Fill out the configuration form according to the requirements in the following table.

Configuration itemDescription
Storage Target Data
NameName your storage target. This name will identify this target across the system.
TypeExchange Web Services (EWS)
Host Name or IP Address

https://office365ingestionsvc.gble1.protection.outlook.com/service/ThirdPartyIngestionService.svc

You check the URL here: Archiving third-party data in Office 365

TLS EncryptionChecked
Port443
Login NameThird-party data mailbox username
PasswordThird-party data mailbox password
Headers
From (Header)This is the from header of the message, the recipient client displays this value.
To (Header)This is the to header of the message, the recipient client displays this value.
CC (Header)This is the CC header of the message, the recipient client displays this value.
(add new header) You can specify your own key-value headers here.
Content
SubjectThis is the subject of your e-mail.
BodyThis is the body content of your e-mail.
Attachments
(add new attachment)

You can add 3 different kind of attachments with the following attributes:

  • Metadata:
    1. Content-Type

  • Media:
    1. Content-Type

  • Text file:
    1. Content-Type
    2. Filename
    3. Content

If you leave the Content-Type field empty the default application/x-msdownload will be used.

Step 4 - Click Save to save the settings

After this, the Storage Target is available for use by other Verba components (e.g. Data management policies).

How to enable archiving third-party data in Office 365

Please follow the instructions provided by Microsoft on this page: Archiving third-party data in Office 365

Hint and default values

In the Headers, Content and Attachments input fields you can use the following strings to include call related metadata information:

  • [VerbaConversationID]
  • [PlatformConversationID]

  • [From]
  • [FromName]
  • [FromIP]
  • [FromDeviceID]
  • [FromRtpCount]

  • [FromLoginName]
  • [FromEmailAddress]
  • [FromUserCustomField0]
  • [FromUserCustomField1]
  • [FromUserCustomField2]
  • [FromUserCustomField3]
  • [FromUserCustomField4]

  • [To]
  • [ToName]
  • [ToIP]
  • [ToDeviceID]
  • [ToRtpCount]

  • [ToLoginName]
  • [ToEmailAddress]
  • [ToUserCustomField0]
  • [ToUserCustomField1]
  • [ToUserCustomField2]
  • [ToUserCustomField3]
  • [ToUserCustomField4]

  • [ConferenceParticipants]

  • [StartDateTime]
  • [EndDateTime]

  • [Duration] format: days hours:minutes:seconds

  • [MediaLength]
  • [RecordedParty]
  • [RecordingServer]
  • [Direction]
  • [EndCause]

  • [RecordingFailed]
  • [MediaError]

  • [AgentID]
  • [Conference]
  • [MeetingID]

  • [SilenceRatio]
  • [TalkoverRatio]
  • [LongestSilence]

  • [IMTranscript]

  • [Year]
  • [Month]
  • [Day]
  • [Hour]
  • [Minute]
  • [Second]
  • [DateTime] format:"%yyyy.%MM.%dd %HH:%mm:%ss"

 

You can use the following syntax to insert the first not empty value from a range of values:

  • ISNULL( [value1] , [value2] , [value3] )

 

If you leave blank fields then Verba will use the following default values:

  • Header From = ISNULL([FromEmailAddress],[From],[FromName],[FromDeviceID],[FromIP],[FromLoginName],[FromUserCustomField0])
  • Header To = ISNULL([ToEmailAddress],[To],[ToName],[ToDeviceID],[ToIP],[ToLoginName],[ToUserCustomField0])
  • Header CC = [ConferenceParticipants]
  • Title = Verba Technologies - Export action (  <policy_name> ) - [VerbaConversationID]

This is because there are mandatory fields (From, To) that mustn't left empty: Mandatory fields.