Configuration

To configure Office 365 connector, you need to open the ITCOfficeConnectorService.exe config file provided in the installation folder. Look out for the <configuration> </configuration> block in the file which has four config sections as listed below:

  • configSections
  • appSettings
  • userInfo.
  • nlog

appSettings

You need to insert the below code block in this section, the details of which are explained in the table.

<add key="AADInstance" value="https://login.microsoftonline.com" />
<add key="InteleInstance" value="https://api.puzzel.com/ContactCentre5" />
<add key="ClientId" value="d3620793-6e81-4b59-bc20-5bf3ca23b2a9" />
<add key="GraphResource" value="https://graph.microsoft.com/" />
<add key="CertificatePassword" value="certificatePassword"/>
<add key="OfficeUrl" value="https://outlook.office365.com" />
<add key="WinLoginUrl" value="https://login.windows.net" />
<add key="Tenant" value="domain.com" />
<add key="GraphVersion" value="v1.0" />
<add key="InitialPaddingInDays" value="0" />
<add key="forcePaddingDays" value="false" />
 <add key="getReadEmails" value="false" />
<add key="PfxCertificateName" value="certificateFileName.pfx" />
<add key="StateFileName" value="ItcOfficeConnectorService_3.json" />
<add key="PollingFrequency" value="10" />
<add key="GetFromAddressFromReplyFirst" value="true" />
Variable Value
AADInstance Url for authenticating Microsoft https://login.microsoftonline.com
InteleInstance

Url for Puzzel API

https://api.puzzel.com/ContactCentre5

ClientId Application Id registered with your azure application
GraphResource

URL for MS Graph API

https://graph.microsoft.com/
CertificatePassword Password for .pfx certificate used for Azure authentication
OfficeUrl

Base URL of Office 365 API

https://outlook.office365.com
WinLoginUrl

URL of Azure AD from where the certificate token is fetched.

https://login.windows.net
Tenant Company domain name in Azure AD. You can find this in the overview page in Azure or by hovering over your username in the top right corner of the screen.
GraphVersion Version of MS Graph API
StateFileName The file that contains information about last effective polling
InitialPaddingInDays

Defines the number of days into the past, the emails need to be fetched from Office365.  

Note: This only  works for first polling 

forcePaddingDays If set to “True”, all unread emails will be fetched from the number days into the past set in “InitialPaddingInDays” variable, upon restarting the service.
getReadEmails If set to “True” the service will fetch both read and unread mails.
PfxCertificateName Certificate name saved in the Puzzel Office 365 Connector folder.
PollingFrequency Defines the frequency (in seconds) with which the service should poll for new emails. Minimum value is 10 seconds and any value entered less than this will be defaulted to 10 sec.
GetFromAddressFromReplyFirst If set to "True" the e-task field “FromAddress” will be populated with the first email address from “ReplyTo” field of the email.

UserInfo & CustomerInfo Block

<userInfo>
   <user customerKey="customerKey" email="user@domain.com" accessPoint="user@domain.com" password="password" domain="domain.com" type="0" />
  </userInfo>
  <customerInfo>
    <customer key="customerKey"  userName="username"  password="userPassword" />
  </customerInfo>

userInfo block contains the Office 365 information as listed below:

  • customerKey:  Customer number to the Puzzel solution
  • email: Office 365 email address
  • accessPoint: Normally same as the email
  • password:
    • If using a personal mailbox, the password is the one set by yourself
    • If using shared mailbox, the password is left blank
  • domain: domain name of the Microsoft exchange server
  • type= 0
Please ensure that the type is set to 0. This will provide a link that allows the email to be opened in Outlook Web App, which is the ONLY method currently supported. For each mailbox you need to create separate userInfo tags with corresponding information

customerInfo block contains the Puzzel information as listed below:

  • Customer Key: Customer number to the Puzzel solution
  • username: username in the Puzzel solution
  • password: password set by the user

Published

22/07/2020 - 11:38

Last updated

04/06/2021 - 13:40