How to Setup Email Outlook

Saat ini kami menyediakan integrasi antara 3Dolphins dengan outlook email. Untuk dapat melakukan integrasi tersebut, sebelumnya Anda harus memenuhi persyaratan minimum berikut ini:

• Anda harus sudah memiliki email bisnis.

• Email tersebut harus sudah berlangganan Office 365.

Create App Registration on Microsoft Azure

Setelah memastikan bahwa Anda telah memenuhi persyaratan minimum diatas, silahkan buat app registration pada microsoft azure. Pertama, masuk ke halaman https://portal.azure.com/#home menggunakan akun email bisnis Anda.

Dashboard Portal Azure

Kemudian, buka menu App Registrations. Pada halaman app registrations, klik tombol '+ New Registration'.

New Registration

Masukkan informasi pendaftaran aplikasi Anda:

1. Name: Masukkan nama aplikasi yang akan ditampilkan kepada user.

2. Pilih opsi Accounts in any organizational directory and personal Microsoft accountsdari bagian Supported account types.

3. Pilih platform 'Web' dan isi URL dengan https://[url]/dolphin/channel/authorization/channel-email-outlook.xhtml

Kemudian, klik tombol 'Register' untuk membuat aplikasi.

Register Application

Setelah beberapa saat, pendaftaran aplikasi yang baru berhasil dibuat akan terbuka.

Created App Registration

Simpan informasi app Anda berupa Client ID dan juga Tenant ID.

Setelah itu, buat client crediantials Anda dengan mengklik tombol 'Add a certificate or secret'. Kemudian, klik tombol 'New client secret'.

Add Client Secret

Pada dialog yang muncul, masukkan deskripsi opsional untuk client secret Anda dan pilih periode expired dari tombol drop-down list Expires, lalu klik tombol 'Add'.

Add Client Secret

Client secret Anda sudah berhasil terbuat. Perlu diingat, untuk menyimpan value dan tanggal expired dari client secret tersebut.

Client Secret Added

Modify IMAP & SMTP Via Windows Powershell

Setelah berhasil membuat aplikasi azure, Anda harus memodifikasi IMAP & SMTP email tersebut via windows powershell, sehingga email tersebut memilki akses lengkap. Berikut merupakan command untuk memodifikasi di masing-masing sistem operasi.

Windows OS

Pertama, buka windows powershell sebagai Administrator. Kemudian, masukkan command berikut.

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
Install-Module -Name ExchangeOnlineManagement
Install-Module Microsoft.Graph 
Import-module ExchangeOnlineManagement
Install-Module -Name AzureADPreview

Kemudian, klik Enter dan masukkan Y. Tunggu sampai installing package selesai lalu masukkan command berikutnya.

Connect-AzureAD -TenantId <your tenant id>

Login menggunakan alamat email bisnis Anda dan masukkan password. Tunggu sampai proses selesai. Kemudia, masukkan command berikut.

Connect-ExchangeOnline -Organization <your tenant id> 

Lalu, login kembali menggunakan email bisnis Anda. Setelah berhasil connect masukkan data aplikasi ke variabel dengan cara:

$MyApp = Get-AzureADServicePrincipal -SearchString "your app name"

New-ServicePrincipal -AppId $MyApp.AppId -ServiceId $MyApp.ObjectId -DisplayName "Service Principal for IMAP"

Add-MailboxPermission -Identity [e-mail] -User $MyApp.ObjectId -AccessRights FullAccess

Jika Anda sudah sampai langkah ini maka, channel email Anda sudah dapat menerima inbound email. Berikut merupakan command untuk mendapatkan akses penuh untuk outbound email.

Set-CASMailbox -Identity [e-mail] -SmtpClientAuthenticationDisabled $false

Mac OS

Bila sistem operasi Anda menggunakan Mac, Anda harus menginstall powershell terlebih dahulu dengan menggunakan command berikut pada terminal.

brew install --cask powershell

Lalu, buka windows powershell dan masukkan command berikut.

Register-PSRepository -Default
Install-Module -Name ExchangeOnlineManagement -allowprerelease
Install-Module Microsoft.Graph -allowprerelease
Install-Module -Name Az
Import-module ExchangeOnlineManagement

Kemudian, klik Enter dan masukkan Y. Tunggu sampai installing package selesai lalu masukkan command berikutnya.

Connect-AzAccount -Tenant <your tenant id>  

Lalu, login kembali menggunakan email bisnis Anda. Setelah berhasil connect masukkan data aplikasi ke variabel dengan cara:

Connect-ExchangeOnline -Organization <your tenant id> 

Lalu, login kembali menggunakan email bisnis Anda. Setelah berhasil connect masukkan data aplikasi ke variabel dengan cara:

$MyApp = Get-AzADServicePrincipal -SearchString "your app name"

New-ServicePrincipal -AppId $MyApp.AppId -ServiceId $MyApp.Id -DisplayName "Service Principal for IMAP"

Add-MailboxPermission -Identity [e-mail] -User $MyApp.Id -AccessRights FullAccess

Jika Anda sudah sampai langkah ini maka, channel email Anda sudah dapat menerima inbound email. Berikut merupakan command untuk mendapatkan akses penuh untuk outbound email.

Set-CASMailbox -Identity [e-mail] -SmtpClientAuthenticationDisabled $false