24K Views

Outlook Configuration in UVdesk Open Source Helpdesk

Office 365 Outlook Mailbox Configuration in UVdesk Open Source Helpdesk

In the blog, we will explain how you can configure UVdesk open source helpdesk with your Outlook Account and transform tickets on the UVdesk when any user sends emails at your Outlook email Id.

Create a New App Password

UVdesk doesn’t support security codes for two-step verification. In these cases, you need to create an app password to sign in. Let’s follow the below step to create a new app password:

Step 1: Login with Outlook account.

Step 2: Go to My account

Step 3: After that, click on the Security tab from the top as shown below:

Step 4: Here, you have to click on the Two-step verification option.

Step 5: On the next page, click on Create a new app password as shown below:

Step 6: This will generate the app password to Sign In.

Use this password in SMTP/IMAP configuration for Outlook instead of your main account password by referring to the below steps.

Steps to configure Outlook account with UVdesk Open Source Helpdesk:

Step 1 : Swift Mailer Configuration

  1. Login into your UVdesk account.
  2. Navigate through Dashboard –> Settings –> Swift Mailer
  3. Click on create configuration button from the top right corner.
  4. Now fill the below-required details and proceed with by clicking “Save Changes” button.

Swift mailer configuration

  • Swift mailer id – Write any random name of mailer id for further reference or leave it blank for creating automatically
  • Transport Type: Select SMTP.
  • Enable Delivery: Enable delivery status active by clicking on check box.
  • Server: Write “smtp.office365.com”
  • Email: Mention valid email id of Outlook
  • Password: Enter the new app password.
  • Port: Enter port number is “587
  • Encryption Mode: Select encryption mode as “TLS” for Outlook from dropdown.
  • Authentication Mode: Select authentication mode as “Login” for Outlook from dropdown.
  • Sender Address: Enter Sender email address.
  • Delivery Address: Enter delivery email address.

Step 2 : Mailbox Configuration

  1. After Swift Mailer Configuration, move to mailbox configuration settings by navigating through Dashboard –> Settings –> Mailbox.
  2. Click on New Mailbox button from the top right corner.
  3. Tapping on mailbox button brings up to Mailbox Configuration setting page, Here admin needs to fill out below required SMTP/IMAP details.

Mailbox Settings

  • Mailbox Id: Enter Mailbox Id else leave blank to automatically create Id.
  • Mailbox Name: Enter Mailbox name for identification.
  • Enable Mailbox: Click on checkbox to enable Mailbox.

Incoming Mail (IMAP) Server

  • Transport: Select IMAP from dropdown.
  • Host: Host name should be “{outlook.office365.com:993/imap/ssl}INBOX” for Outlook.
  • Email: Put email address of IMAP(incoming mail server)
  • Password: Enter the new app password of Outlook.

Outgoing Mail (SMTP) Server

  • Swift Mailer ID: Select swiftmailer id which you have created in Step 1.

Step 3 : Email Settings

Email settings is use to send the reply from ticket panel to the customer email id hence this setting is mandatory. To do this, directly go to email settings by navigating through  Dashboard –> Settings –> Email Settings. 

Now fill the required details Email Id, Name, Swiftmailer id and Proceed.

Email Settings

  • Email Id: This email address sends a ticket reply to your customer email. Mention the same Email id which you’ve used in Swiftmailer configuration.
  • Name: Enter any name for identification.
  • Swiftmailer id (Select from drop down): Choose Switfmailer id which you’ve created.

Step 4 : Setup Site_Url

Now, need to edit few changes in code, navigate through config->packages->uvdesk.yaml  and find site_url, enter the localhost or domain path till public, make sure you have removed http://

For examplelocalhost/folder_name/public

Site URL outlook configuration

Step 5 : Run Cron Job

Run below refresh command through terminal into project root directory to fetch emails as a tickets.

php bin/console uvdesk:refresh-mailbox email-address@example.com

Run Cron Job

Schedule cron Job that need to be executed repeatedly (e.g., hourly, daily, or weekly), you can use the crontabcommand. for more details refer this guide.

Not using Outlook? would like to know the process of mailbox configuration with Gmail, refer this comprehensive user guide – How to Setup Gmail – UVdesk Open Source Helpdesk

Support

That’s all for Mailbox Configuration with Outlook in UVdesk Open Source Helpdesk. For any doubts or suggestions regarding the extension get back to us at support@uvdesk.com or raise a ticket at our Helpdesk system.

Category(s) UVdesk
. . .

Comments (10)

Add Your Comment

  • Rob Pearce
    Hi thanks very much for this . It still doesnt work for me but im closer now…
    • Himani Gupta
      Hello Rob Pearce,
      Thank you so much for your appreciation!! You may also get the support if you’re getting any issue while set up at support@uvdesk.com
      We’re here to guide you in each step.
      Thanks & Regards
      UVdesk Team
  • Zaheer Abbas
    Thank you for the detailed explaination. I am successfuly able to integrate my hotmail, yahoo and gmail accounts in it. But the problem is somehow I am unable to integrate my locally hosted exchange account. Below is the error I am getting during uvdesk:refresh

    php /var/www/html/uvdesk/bin/console uvdesk:refresh-mailbox zaheer.xxx@exchange.local.net

    1. Processing uvdesk mailbox configuration.

    2. Opening imap stream…

    In RefreshMailboxCommand.php line 88:

    Warning: imap_open(): Couldn’t open stream {mail.exchange.local.net:143/imap/tls}INBOX

    uvdesk:refresh-mailbox [-t|–timestamp TIMESTAMP] [-h|–help] [-q|–quiet] [-v|vv|vvv|–verbose] [-V|–version] [–ansi] [–no-ansi] [-n|–no-interaction] [-e|–env ENV] [–no-debug] [–] […]

    Fatal error: Uncaught ErrorException: Notice: Unknown: Kerberos error: No Kerberos credentials available (default cache: KEYRING:persistent:0) (try running kinit) for mail01.exchange.local.net (errflg=1) in Unknown:0
    Stack trace:
    #0 [internal function]: Symfony\Component\Debug\ErrorHandler->handleError()
    #1 {main}
    thrown in Unknown on line 0

    Please help!

    • Himani Gupta
      Hello Zaheer Abbas,
      Thanks for notifying this issue to us.
      This is when you’ve not used New App Office 365 Password while mailbox configuration.
      We’ve updated this guide as per the current issue with resolution, would like to request you to follow the step once again and update us if still in the case.
      Thanks for using UVdesk Open Source Helpdesk.
      Keep delivering the best customer support 🙂
      Regards,
      UVdesk Team
  • satish
    how to run this CRON Job in windows machine, i am using wamp server
  • Satrio Smith
    Thank you for the explanation. But I had a problem that I am unable to integrate my locally hosted account powered by Zimbra Mail Server. Below is the error I am getting during uvdesk:refresh-mailbox

    C:\Bitnami\wampstack-7.2.31-0\apache2\htdocs\uvdesk>php bin/console uvdesk:refresh-mailbox kinerja@pelindo1.co.id

    1. Processing uvdesk mailbox configuration.

    2. Opening imap stream…

    In RefreshMailboxCommand.php line 88:

    Warning: imap_open(): Couldn’t open stream mail.pelindo1.co.id

    uvdesk:refresh-mailbox [-t|–timestamp TIMESTAMP] [-h|–help] [-q|–quiet] [-v|vv|vvv|–verbose] [-V|–version] [–ansi] [–no-ansi] [-n|–no-interaction] [-e|–env ENV] [–no-debug] [–] […]

    PHP Fatal error: Uncaught ErrorException: Notice: Unknown: Can’t open mailbox mail.pelindo1.co.id: no such mailbox (errflg=2) in Unknown:0
    Stack trace:
    #0 [internal function]: Symfony\Component\Debug\ErrorHandler->handleError(8, ‘Unknown: Can’t …’, ‘Unknown’, 0, NULL)
    #1 {main}
    thrown in Unknown on line 0

    Please help me!

    • Himani Gupta
      Hello Satrio Smith,
      Nice day to you!!
      The error shows that this email mail.pelindo1.co.id is not configured properly with mailbox. Kindly do the mailbox configuration again by following all steps mention in this blog.
      If still you will get any difficulty then reach out to us at support@uvdesk.com
      Kind Respects
      UVdesk Team
  • Wilmer
    Hello friends, a pleasure to greet you, I am making the email configuration connecting it to the 365 office to send emails and create tickets automatically and when I go to update the email in the console I get this error

    Warning: imap_open (): Couldn’t open stream outlook.office365.com

    PHP Fatal error: Uncaught ErrorException: Notice: Unknown: Can’t open mailbox outlook.office365.com: no such mailbox (errflg = 2) in Unknown: 0
    Stack trace:
    # 0 [internal function]: Symfony \ Component \ Debug \ ErrorHandler-> handleError (8, ‘Unknown: Can’t …’, ‘Unknown’, 0, NULL)
    # 1 {main}
    thrown in Unknown on line 0
    root @ uvdesk01: / var / www / html / helpdesk-project # PHP Fatal error: Uncaught ErrorException: Notice: Unknown: Can’t open mailbox outlook.office365.com: no such mailbox (errflg = 2) in Unknown: 0

    I would appreciate if you could help me please, thanks Friends

    • Himani Gupta
      Hello Wilmer,
      Greetings for the day!!
      Did you set up a mailbox completely by following this user guide? and are you refreshing the same email id which has configured in Mailbox?
      Please cross-check once, else debug the same by the following step:
      Open your project directory and locate path.
      vendor->uvdesk->mailbox-component->Console->RefreshMailboxCommand.php
      OpenRefreshMailboxCommand.php and reach to the  pushMessage() function.
      Now check step by step by dumping each step while running the refresh mailbox command.
      Here you can check  $requestUrl  if it is correct or not,  and other parameter like  $curlResponse.
      If still unable to check the issue, kindly raise a ticket by email at support@uvdesk.com
      Kind Respects
      UVdesk Team
  • css.php