Email Host's Application Configuration

These steps are performed outside of PhixFlow.

An Office 365 Administrator is required to perform the following step to enable a PhixFlow instance to interact with Microsoft Office 365 Outlook.  

1. Open the Microsoft Entra Admin Center at https://entra.microsoft.com/#home
2. Select Applications → App Registrations
3. Click New Registration
   1. Name: PhixFlow O365 Integration, or another appropriate value
   2. Supported Account types: Choose Accounts in this organizational directory only
   3. Redirect URI:
      1. Select a Platform: Web 
      2. URL: SystemURL+receiveTokenAuthentication.htm
         e.g. http://phixflowhost.com/phixflow/receiveTokenAuthentication.htm
4. Click Register
5. Take a note of the Application (client ID)
6. Click Add a certificate or secret
7. Click New client secret
   1. Give the certificate a name
   2. Set the expires time, after which the secret has to be refreshed. Either use the default 180 days, or pick an alternative value such as 730 days.
      1. Ensure you create a new the secret before it expires.
   3. Press Add
   4. Take a note of the value, this is the Client Secret 

Client Token Configuration in PhixFlow

Create an Email Account in PhixFlow

1. Create an Email Account

1.  in the Full Repository
   1. In PhixFlow version 11.3+, this can be done from the application's repository
2. Set a Name which you'll use to identify the email account, e.g. Customer Service
3. Toggle on Enabled
4. Set the Type to Inbound or Outbound, depending on your requirements

1. For an inbound email account:

   1. Set Host to outlook.office365.com
   2. Set the Protocol to Microsoft
   3. Set the Encryption to SSL/TLS
   4. Toggle on Use Default Port
   5. For the Authorisation Type, select OAuth 2
   6. Set the Login to the email address being monitored

1. 1. For On Email Received choose:

1. 1. 1. Hold for collection via file collector if you want PhixFlow to monitor and

1. 1. 1. hold the emails in

1. 1. 1. a

         Insert excerpt
         _file_collector _file_collector nopanel true

         for later processing
         1. See Reading Data From an Email Account
      2. Choose Trigger an email endpoint actionflow if you want PhixFlow to monitor and process the emails using the

         Insert excerpt
         _email_endpoint _email_endpoint nopanel true

         specified in Email Endpoint Action
         1. See Setting up an Email Endpoint
         2. (Optional) If you want to monitor a specific folder in Outlook, enter its name in the Folder field 
            1. If left blank, only the Inbox will be monitored
            2. If using a sub folder, the folder path must be entered here, for example, Inbox/Endpoint
   2. Select your Client Token Configuration

   3. Insert excerpt
      _save _save nopanel true

      the changes
   4. Next to Status, click

      Insert excerpt
      _emailConfiguration _emailConfiguration name icon nopanel true

       Authenticate Email Account to perform the authentication process which provides access to your Microsoft account
   5. Hover over

      Insert excerpt
      _more_options _more_options nopanel true

      and

1. 1. select 

      Insert excerpt
      _emailConfiguration _emailConfiguration nopanel true

• . When the email address is being polled it will show in the Completed Tasks
  Image Added

What does the error message, "Id is malformed" mean?

• Check the Folder value and ensure this is directing to the right location in the email account. If a sub folder is being used, the values should be folderName/subFolderName

What does it mean if the error message, "AUTHENTICATE failed" shows when the Email Account is displaying AUTHENTICATED?

• Check your Email Account setup matches the above settings
  • For example, for a Microsoft account, ensure the Protocol is set to Microsoft and the Authorisation Type is set to OAuth 2

Need more information on any errors you are experiencing?

• Download the Phixflow.log log files from 

  Insert excerpt
  _administration _administration nopanel true

  → 

  Insert excerpt
  _system_log_download _system_log_download nopanel true

  , then enter phixflow.log in the Log files to Download field

If you need any further help, speak to our support team by using our