SMTP/IMAP Configuration

For sending or transfer emails through your support email id and fetch emails over Helpdesk, you have to set mailer SMTP and IMAP.

Drafting our the complete step to configure SMTP and IMAP settings:

Step 1 – Open with editor

Open the created project with respective editor.

Step 2 – swiftmailer.yaml configuration

Next, go to configure => packages => swiftmailer.yaml

Add to mailers entries to swiftmailer.yaml

swiftmailer:
    # url: '%env(MAILER_URL)%'
    # spool: { type: 'memory' }
    mailers:
        sample:
            transport: gmail
            username: uvdesk_demo@gmail.com
            password: *****

Step 3 – uvdesk.yaml configuration

Now, under packages, you will find uvdesk.yaml file. Open uvdesk.yaml then enabled mailboxes using following entries. refer below command.

parameters:
    app_locales: en|fr|it
    assets_default_agent_profile_image_path: bundles/uvdeskcore/images/uv-avatar-batman.png
    assets_default_customer_profile_image_path: bundles/uvdeskcore/images/uv-avatar-ironman.png
    assets_default_helpdesk_profile_image_path: bundles/uvdeskcore/images/uv-avatar-uvdesk.png
    uvdesk_site_path.member_prefix: member
    uvdesk_site_path.knowledgebase_customer_prefix: customer
uvdesk:
    site_url: localhost
    upload_manager:
        id: uvdesk.core.fs.upload.manager
    support_email: 
        id: uvdesk_demo@gmail.com
        name: UVDesk Community
        mailer_id: sample
    default:
        ticket:
            type: support
            status: open
            priority: low
        templates:
            email: mail.html.twig
    emails: null
    mailboxes: 
        sample:
            name: demo
            email: uvdesk_demo@gmail.com
            enabled: true

Step 4 – SMTP Configuration

Define SMTP mailer id to set up SMTP on your server.

mailer id should be the same which you have already created.

parameters:
    app_locales: en|fr|it
    assets_default_agent_profile_image_path: bundles/uvdeskcore/images/uv-avatar-batman.png
    assets_default_customer_profile_image_path: bundles/uvdeskcore/images/uv-avatar-ironman.png
    assets_default_helpdesk_profile_image_path: bundles/uvdeskcore/images/uv-avatar-uvdesk.png
    uvdesk_site_path.member_prefix: member
    uvdesk_site_path.knowledgebase_customer_prefix: customer
uvdesk:
    site_url: localhost
    upload_manager:
        id: uvdesk.core.fs.upload.manager
    support_email: 
        id: uvdesk_demo@gmail.com
        name: UVDesk Community
        mailer_id: sample
    default:
        ticket:
            type: support
            status: open
            priority: low
        templates:
            email: mail.html.twig
    emails: null
    mailboxes: 
        sample:
            name: demo
            email: uvdesk_demo@gmail.com
            enabled: true
            
            smtp_server:
                mailer_id: sample

Step 5 – IMAP configuration

Please provide your username and password to configure your IMAP.

Here we’ll use the same email address and password for username and password , Add the hostname according to the mail server IMAP setting.

Refer here to check IMAP Port for Gmail.

Now add hostname, username, and password, refer below screenshot

parameters:
    app_locales: en|fr|it
    assets_default_agent_profile_image_path: bundles/uvdeskcore/images/uv-avatar-batman.png
    assets_default_customer_profile_image_path: bundles/uvdeskcore/images/uv-avatar-ironman.png
    assets_default_helpdesk_profile_image_path: bundles/uvdeskcore/images/uv-avatar-uvdesk.png
    uvdesk_site_path.member_prefix: member
    uvdesk_site_path.knowledgebase_customer_prefix: customer
uvdesk:
    site_url: localhost
    upload_manager:
        id: uvdesk.core.fs.upload.manager
    support_email: null
    default:
        ticket:
            type: support
            status: open
            priority: low
        templates:
            email: mail.html.twig
    emails: null
    mailboxes: 
        sample:
            name: demo
            email: uvdesk_demo@gmail.com
            enabled: true
            
            smtp_server:
                mailer_id: sample
            
            imap_server:
                host: '{imap.gmail.com:993/imap/ssl}INBOX'
                username: uvdesk_demo@gmail.com
                password: *****

Common Issues:

If you are getting the error “Can not authenticate to IMAP server: [ALERT]”

Make sure you’re not using 2 step verification.

First sign in into the Gmail account in a browser on the device then, need to ensure you have enabled IMAP status and Allow less secure apps should be ON and have already done the continue step to allow access to your Google account.

Step 6 – Refresh mailbox

At last, you need to run the following command –

Last command - php bin/console uvdesk:refresh-mailbox uvdesk_demo@gmail.com

Here we have done all the settings of SMTP/IMAP configuration, now you can able to send and receive emails over the ticket panel.

Hope this post will help for PHP/Symfony developers who want to build own customizable fully functional helpdesk. Please share your feedback and Comments.

If you have any query you can contact us at support@uvdesk.com Stay tuned for more updates with UVdesk opensource helpdesk …!!!