Office 365 - Exchange Web Services API

Office 365 - Exchange Web Services API

Available in version 8.6 and later

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 item

Description

Configuration item

Description

Storage Target Data

Name

Name your storage target. This name will identify this target across the system.

Type

Exchange 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 Encryption

Checked

Port

443

Login Name

Third-party data mailbox username

Password

Third-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

Subject

This is the subject of your e-mail.

Body

This 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.