# 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**.

![Eng\_tab.png](https://support.miitel.com/hc/article_attachments/38352963179033)

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

![eng\_activity\_Sep28\_2023.png](https://support.miitel.com/hc/article_attachments/38352963180185)

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.

![Eng\_subject.png](https://support.miitel.com/hc/article_attachments/38352963180825)

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**.

![Eng\_status.png](https://support.miitel.com/hc/article_attachments/38352991360025)

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).

![Eng\_comment.gif](https://support.miitel.com/hc/article_attachments/38352991363353)

![Screen\_Shot\_2022-03-23\_at\_21.27.58.png](https://support.miitel.com/hc/article_attachments/38352991364889)

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

![Screen\_Shot\_2022-03-23\_at\_21.29.55.png](https://support.miitel.com/hc/article_attachments/38352991366809)

{% 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://miitel-academy.gitbook.io/miitel-academy/integrations/salesforce.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.