> For the complete documentation index, see [llms.txt](https://miitel-academy.gitbook.io/miitel-academy/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://miitel-academy.gitbook.io/miitel-academy/integrations/salesforce.md).

# Salesforce

## Overview

Integrasi MiiTel dengan Salesforce memungkinkan tim sales dan support mengelola aktivitas telepon secara efisien langsung dari dalam Salesforce.

## Persiapan sebelum integrasi dengan Salesforce

Berikut adalah **persiapan sebelum melakukan integrasi MiiTel dengan Salesforce** yang perlu dipastikan:

#### ✅ **1. Jenis atau Edisi Salesforce yang Didukung**

Integrasi MiiTel hanya dapat dilakukan pada edisi Salesforce yang **mendukung integrasi API dan AppExchange**, yaitu:

* **Enterprise Edition**
* **Unlimited Edition**
* **Developer Edition**

#### ✅ **2. Memiliki Akun MiiTel**

Pastikan Anda telah memiliki:

* Akun **MiiTel Admin**
* Akses ke dashboard MiiTel: <https://account.miitel.jp>
* Sudah mengatur:
  * **User** yang akan menggunakan MiiTel
  * **Company ID**
  * Akses ke **API Token** (dibutuhkan untuk koneksi dengan Salesforce)

#### ✅ **3. Akses Admin di Salesforce**

Anda harus memiliki **Salesforce System Administrator** privileges untuk:

* Menginstal aplikasi dari **AppExchange**
* Mengatur **Call Center**, **CTI Adapter**, dan **User Assignments**

***

## 🔧 **Langkah-langkah Integrasi MiiTel dengan Salesforce via MiiTel Admin. Ada 4 step:**

Step 1: Salesforce Integration - Basic Settings

Step 2: Salesforce Activity History Integration

Step 3: Link Salesforce user to MiiTel user (Activity history assignee)

Step 4: Salesforce Softphone Deployment

Step 5 (additional): How to set up MiiTel Call History view for Salesforce

***

### <mark style="background-color:blue;">Step 1: Salesforce Integration - Basic Settings</mark>

1. Buka MiiTel Admin

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXfI9aipr0xImbvJEFRCvbAhBxsuVYNTy9v7CinFUyMF0aq5xkVoNk7CmxN7L_v3Ft2Q7RjpVmidDlmuzzCsMPWagVM2MwTaEoANBMWM0U5wDuZWYcq_OAAx6lpVtdhy9K_kVOfj_prXuu_EvqLLL0z1uQ?key=FwH72spJDNOzqu31Wc7B2A" alt=""><figcaption></figcaption></figure>

2. Pilih Menu Integrasi Pihak Ketiga (Third Party Integration)

   * Di sidebar, pilih menu **“Third Party Integration”**
   * Lalu pilih opsi **Salesforce**<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdbG2fUxOd7ioxnbGJcx6sCHL-XyOKiBGFXbYo9KfR41n6KATZw-pstrxZyGzEKI6enQHNDmnZJaAqz9-kfykNpA_O3slNnkWd5EyJkbxB5WnPINmhPBHNhaMep-rmy8CF_VYHGVbtBunH9USeLcmlcuT0?key=FwH72spJDNOzqu31Wc7B2A" alt=""><figcaption></figcaption></figure>
3. **Masukkan Informasi Akun Salesforce**

Isi kolom berikut:

1. **Salesforce Username:**\
   Masukkan **nama pengguna Salesforce** Anda.
2. **Salesforce Password:**\
   Masukkan **kata sandi Salesforce** Anda.
3. **Salesforce Security Token:**\
   Masukkan **token keamanan** dari Salesforce.\
   (Jika belum punya, bisa dapatkan di:\
   Salesforce → **Settings** → **Reset My Security Token**)
4. **Connect to Sandbox environment (Opsional):**\
   Centang opsi ini **jika Anda menghubungkan ke Salesforce Sandbox**.

<figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdV0KTkof3cTldbjusYnb9NfQyjyKfcESDN64N4RfY48_or24Wx_h7MPOJNbV558fzF1CxlxsTmB_D-5DtBKYYflDG93314o7Jn-Qh2Ncm2FBq2mmdJhMq0g4plWfcPrwNwuOYBwi9JU6N7Dl9cfEX18kU?key=FwH72spJDNOzqu31Wc7B2A" alt=""><figcaption></figcaption></figure>

2. Token keamanan tidak selalu diperlukan untuk integrasi. Namun, jika Anda tidak dapat login menggunakan username dan password Salesforce, Anda bisa mendapatkan token tersebut di dashboard Salesforce melalui menu "Settings" > "Reset My Security Token".<br>

   <figure><img src="https://lh7-rt.googleusercontent.com/docsz/AD_4nXdEWhlkJyl3o8IMYYeU7IiqBn5-BZgxNbSnt3PCk7ydXGTiBNQR45aAI6XuDsKn8UQoR80Oc5cmahNT14eDfTHFDjiLr-Lg1aG06IqP5ObB6i_57F6tLy967BnDDtEJMTlvJZXaalt34YWv6wXA1f10pBk?key=FwH72spJDNOzqu31Wc7B2A" alt=""><figcaption></figcaption></figure>
3. **Menggunakan MiiTel Softphone di Salesforce**

Setelah integrasi berhasil:

* Buka dashboard Salesforce.
* Di sisi kiri bawah, Anda akan melihat tombol atau panel **MiiTel Softphone**.
* Anda sekarang bisa **melakukan panggilan langsung dari dalam Salesforce**

***

### Step 2: Salesforce Activity History Integration

1. Kunjungi <https://account.miitel.jp/v1/signin> dan login ke **MiiTel Analytics**.
2. Klik **Open MiiTel Admin** di kanan atas halaman.
3. Klik **Third Party Integration > Salesforce**.
4. Klik tab **Activity history integration**.
5. Centang **Enable activity history integration**.

<img src="https://support.miitel.com/hc/article_attachments/38352963179033" alt="Eng_tab.png" height="326" width="620">

6. Setelah Anda mengatur semua kolom berikut, klik **Save**.

<img src="https://support.miitel.com/hc/article_attachments/38352963180185" alt="eng_activity_Sep28_2023.png" height="789" width="604">

1. **Registration timing**\
   Pilih kapan informasi riwayat panggilan akan dibuat di Salesforce.
   * **After the call begins:** Riwayat aktivitas akan dibuat setelah panggilan dimulai.
   * **After the call ends:** Riwayat aktivitas akan dibuat setelah panggilan berakhir.\
     Jika Anda menyelesaikan pengaturan pada langkah #4 – #9, maka **Dial start time, Call start time, Call end time, Call memo, dll.** juga dapat dibuat di Salesforce.

{% hint style="success" %}
&#x20; **NOTE**

Jika Anda memilih **After the call begins**, informasi berikut akan otomatis dimasukkan ke dalam kolom **Comment** pada riwayat panggilan MiiTel:

* **Panggilan dibatalkan:** Outbound call (No answer)
* **Panggilan tidak terjawab:** Incoming call (No answer)
* **Incoming call, Outbound call, Answering machine, Call forwarding:** URL riwayat panggilan
  {% endhint %}

2. **Outgoing call settings**\
   Jika Anda mengaktifkan pengaturan ini dan melakukan *click to call* pada objek Salesforce yang memiliki aktivitas diaktifkan, MiiTel akan membuat riwayat aktivitas pada record yang Anda gunakan untuk *click to call*. (Detail lebih lanjut tersedia di **Records and fields that can be integrated**.)
3. **Subject**\
   Atur subjek yang akan ditampilkan di riwayat aktivitas Salesforce.

<img src="https://support.miitel.com/hc/article_attachments/38352963180825" alt="Eng_subject.png" height="68" width="400">

4. **Status**\
   Pilih status yang akan digunakan untuk mendaftarkan riwayat aktivitas.
   * Jika diatur ke **Completed**, riwayat panggilan akan ditampilkan sebagai **Tasks**.
   * Jika diatur ke **Open**, riwayat panggilan akan dibuat sebagai **tugas yang akan datang**.

<img src="https://support.miitel.com/hc/article_attachments/38352991360025" alt="Eng_status.png" height="280" width="616">

5. **Dial start time**\
   Pilih *custom field* tempat waktu mulai dial akan didaftarkan. Tipe field harus **Date/Time**
6. **Call start time**\
   Pilih *custom field* tempat waktu mulai panggilan akan didaftarkan. Tipe field harus **Date/Time**.
7. **Call end time**\
   Pilih *custom field* tempat waktu selesai panggilan akan didaftarkan. Tipe field harus **Date/Time**.

{% hint style="success" %}
**NOTE**

* Untuk membuat **custom field** dengan tipe field **Date/Time**, login ke **Salesforce** menggunakan akun yang memiliki **hak administratif**, lalu klik **Settings > Object Manager tab > Activity > Fields and Relationships**. Selanjutnya, masuk ke **Create Custom Fields** dan mulai dari **Langkah #2** untuk membuat custom field tersebut.
  {% endhint %}

&#x20; 8\. **Call memo:** Pilih *custom field* tempat memo panggilan akan didaftarkan. Tipe field harus **Picklist (Multi-Select)**.

{% hint style="success" %}
**NOTE**

* Login ke **Salesforce** menggunakan akun yang memiliki **hak administratif**, lalu klik **Settings**.
* Klik **Object Manager tab > Activity > Fields and Relationships**.
* Klik **New**.
* Pada **Step 1: Choose the field type**, pilih **Picklist (Multi-Select)**.
* Pada **Step 2: Enter the details**, atur sebagai berikut:

  1. **Field Label**: Masukkan nama field.
  2. **Values**: Pilih **Enter values, with each value separated by a new line**.
  3. Masukkan contoh call memo di sini. (*Pengaturan akan tidak lengkap jika bagian ini dibiarkan kosong.*)
  4. Hilangkan centang pada **Restrict picklist to the values defined in the value set**.

<img src="https://support.miitel.com/hc/article_attachments/38352963183001" alt="Eng_call_memo_field.png" data-size="original">

* Klik **Next** dan lanjutkan pengaturan hingga **Step 4: Add to page layouts**, lalu klik **Save**.
  {% endhint %}

&#x20; 9\. **Comment:** Atur semua informasi riwayat panggilan yang ingin Anda sertakan ke dalam kolom komentar riwayat aktivitas.

1. Klik jenis informasi yang ingin Anda masukkan ke dalam komentar dari **Merge field**.
2. Seperti pada gambar contoh, ketik nama field (yang ingin Anda tampilkan di Salesforce).

<img src="https://support.miitel.com/hc/article_attachments/38352991363353" alt="Eng_comment.gif" height="341" width="570">

<img src="https://support.miitel.com/hc/article_attachments/38352991364889" alt="Screen_Shot_2022-03-23_at_21.27.58.png" height="241" width="611">

10. **Comment (canceled calls or missed calls):** Atur informasi yang akan disertakan ke komentar untuk **panggilan dibatalkan** atau **panggilan tidak terjawab**.

<img src="https://support.miitel.com/hc/article_attachments/38352991366809" alt="Screen_Shot_2022-03-23_at_21.29.55.png" height="320" width="520">

{% hint style="success" %}
&#x20; **NOTE**

* Nama field di **Merge field** akan ditampilkan dengan tanda kurung kurawal “{}”.\
  Contohnya, **call type** akan ditampilkan sebagai **{CALL\_TYPE}**.
* Anda tidak dapat memasukkan tanda kurung kurawal “{}” (sebagai karakter opsional) di kolom **Comment**.
* Contoh yang tidak diperbolehkan: `{Call type:} {CALL_TYPE}`

  Pilih **{nama field}** dari **Merge field**. Anda tidak dapat memilih field yang tidak ada di daftar ini.
* Untuk kolom **Comment**, Anda dapat memasukkan hingga **30.000 karakter** (termasuk nilai dari Merge Field).
* Jika Anda menggunakan **{COMMENT}** dari Merge field, komentar yang disimpan di **MiiTel Phone** sebelum analisis suara selesai akan didaftarkan di riwayat aktivitas. (Komentar yang disimpan setelah analisis suara selesai atau komentar yang disimpan di riwayat panggilan tidak akan tercermin di riwayat aktivitas.)
  {% endhint %}

<div data-full-width="true"><figure><img src="/files/mVb0cDLtASmbKYOhBJQD" alt=""><figcaption></figcaption></figure></div>

<figure><img src="/files/rR4T9Ny0K3OwqueK8oP8" alt=""><figcaption></figcaption></figure>