# Gateway email

**Gerbang email** adalah layanan pesan yang memungkinkan komunikasi otomatis dengan pelanggan Anda. Pengguna menerima email otomatis dalam beberapa skenario kunci:

* Notifikasi peristiwa: Peringatan yang dipicu oleh aktivitas perangkat tertentu atau pelanggaran geofence.
* Laporan terjadwal: Laporan Excel atau PDF yang dikirim sesuai jadwal yang disesuaikan.
* Pemberitahuan penagihan: Notifikasi mengenai saldo rendah atau kebutuhan untuk mengisi ulang dana.

Sebagai operator layanan, Anda dapat menentukan gerbang mana yang menangani pengiriman ini dan menyesuaikan alamat pengirim.

<figure><img src="https://909374093-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKdgeXg71LpaDrwexQYwp%2Fuploads%2FpqCChSMCGhnAD7A2cDp4%2Fimage.png?alt=media&#x26;token=8142a03e-c688-4bc7-b6f9-56a595142ab2" alt="Email gateway page" width="563"><figcaption><p>halaman gerbang email</p></figcaption></figure>

Halaman **Gerbang email** terdiri dari dua bagian:

* **Konfigurasi server SMTP**: Pilih antara layanan email Navixy atau masukkan gerbang kustom
* **Pengaturan email**: Masukkan alamat email pengirim dan tanda tangan yang secara otomatis diterapkan ke semua email yang dikirim

## Cara memilih gerbang email

Tergantung pada produk dan kebutuhan spesifik Anda, Anda dapat memilih antara dua opsi:

* **Gerbang Email Navixy**: Ini adalah opsi yang direkomendasikan untuk **ServerMate** pengguna. Ini adalah layanan cepat gratis yang diselenggarakan melalui Mandrill untuk memastikan tingkat pengantaran dan penempatan ke kotak masuk yang tinggi. Layanan ini terintegrasi dengan Navixy dan memastikan bahwa email Anda dikirim ke kotak masuk pengguna tanpa ditandai sebagai spam.
* **Gerbang SMTP pihak ketiga**: Metode universal ini tersedia untuk **ServerMate**, **Cloud**, dan **On-Premise** produk. Ini memungkinkan Anda menentukan server kustom untuk pengiriman email, seperti server email khusus Anda, layanan publik seperti Gmail, atau layanan pengiriman khusus seperti SendGrid, Mailgun, atau Mandrill.

## Gerbang Email Navixy

{% hint style="warning" %}
Opsi ini hanya tersedia untuk **penyebaran Navixy ServerMate** .
{% endhint %}

### Cara mengubah alamat pengirim

Secara default, **kolom From** diatur ke `no-reply@x-gpsmail.com`. Dalam konfigurasi ini, tidak diperlukan pengaturan tambahan. Jika Anda ingin menggunakan alamat sendiri (misalnya, `no-reply@yourdomain.com`), Anda harus mengotorisasi domain Anda untuk mencegah email ditandai sebagai spam. Untuk mengautentikasi dan mengotorisasi pengiriman email, ikuti langkah-langkah ini:

{% stepper %}
{% step %}

### Autentikasi domain Anda

Hubungi [dukungan Navixy](mailto:support@navixy.com) dengan nama domain yang ingin Anda gunakan. Domain tersebut tidak harus merupakan domain platform Anda, tetapi Anda harus memiliki akses ke domain tersebut untuk melakukan perubahan DNS. Anda akan menerima sebuah record TXT untuk ditambahkan ke pengaturan DNS Anda sebagai bukti kepemilikan.

Format: `yourdomain.com. 1 IN TXT "mandrill_verify.KEY_PROVIDED_HERE"`.

Pengaturan DNS disediakan oleh penyedia DNS Anda. Setiap penyedia DNS memiliki alat dan pengaturan masing-masing. Jika Anda memerlukan bantuan dalam mengubah pengaturan ini, hubungi penyedia DNS Anda.
{% endstep %}

{% step %}

### Otorisasi domain Anda

Tambahkan lima record DNS tambahan ke domain Anda untuk memverifikasi otorisasi:

* Record SPF: Tambahkan `v=spf1 include:spf.mandrillapp.com -all`. Jika record SPF sudah ada, sisipkan `include:spf.mandrillapp.com` sebelum mekanisme terminasi.\
  Misalnya, jika record SPF Anda saat ini terlihat seperti `v=spf1 a -all`, perbarui menjadi

  `v=spf1 a include:spf.mandrillapp.com -all` .
* Record DKIM: Buat dua record CNAME. Atur satu nama menjadi `mte1._domainkey.yourdomain.com` dengan nilai `dkim1.mandrillapp.com` dan yang kedua menjadi `mte2._domainkey.yourdomain.com` dengan nilai `dkim2.mandrillapp.com`, mengganti `yourdomain.com` dengan nama domain yang terkait dengan And&#x61;**.**
* Record DMARC: Di pengaturan DNS Anda, buat dan simpan sebuah record TXT bernama `_dmarc.yourdomain.com` dengan nilai `v=DMARC1; p=none;`, mengganti `yourdomain.com` dengan nama domain yang terkait dengan And&#x61;**.**

Setelah membuat record tersebut, ingat untuk menyimpan informasi DNS. Pengaturan akan mulai berlaku dalam 30 menit atau hingga 4 jam.
{% endstep %}

{% step %}

### Tentukan alamat pengirim

Setelah record DNS tersebar, email <support@navixy.com> dengan login Panel Admin Anda dan alamat pengirim yang diinginkan. Tim dukungan akan menguji konfigurasi dan mengonfirmasi ketika pengaturan selesai.
{% endstep %}
{% endstepper %}

### Cara memverifikasi konfigurasi DKIM Anda

Setelah Anda menyelesaikan pengaturan DNS, Anda harus memverifikasi bahwa email Anda ditandatangani secara digital dengan benar. Ini memastikan pesan Anda dikenali sebagai asli oleh server email penerima.

1. Dari Panel Admin, kirim pesan uji ke akun email pribadi (seperti Gmail atau Outlook).
2. Buka email yang diterima, klik **opsi More** (biasanya tiga titik), dan pilih **Show original** atau **View message details**.
3. Gunakan fungsi pencarian untuk menemukan frasa `dkim=pass`. Menemukannya berarti bidang tersebut dikonfigurasi dengan benar. Jika tidak, pesan tersebut tidak ditandatangani atau tanda tangannya tidak benar.

## **Gerbang pihak ketiga**

{% hint style="info" %}
Jika Anda menggunakan layanan SMTP kustom, Anda bertanggung jawab memastikan email dikirim ke kotak masuk pengguna Anda dan tidak ditandai sebagai spam.
{% endhint %}

Untuk menggunakan penyedia SMTP Anda sendiri, masuk ke **Panel Admin** dan buka **Pengaturan** > **Gerbang email**.

{% stepper %}
{% step %}

### Pilih jenis gerbang

Di bagian **server SMTP** , pilih **Custom SMTP**.
{% endstep %}

{% step %}

### Konfigurasikan server dan keamanan

Masukkan alamat host yang disediakan oleh layanan Anda (mis., `smtp.gmail.com`).

1. Tentukan apakah Anda menggunakan protokol transfer data yang aman (SSL atau TLS).
2. Setelah protokol keamanan dipilih, bidang port SMTP akan terisi otomatis berdasarkan rekomendasi standar untuk layanan email publik. Anda dapat menimpa nomor port ini secara manual jika penyedia Anda memerlukan konfigurasi non-standar.
3. Saat menggunakan SSL/TLS, Anda akan melihat kotak centang **Trust all** . Ini digunakan untuk melewati kesalahan jika server SMTP Anda menggunakan sertifikat self-signed atau sertifikat yang tidak dikenali oleh otoritas sertifikat standar. Hanya aktifkan ini jika Anda yakin terhadap keamanan server Anda.
   {% endstep %}

{% step %}

### Konfigurasikan otorisasi

Jika penyedia Anda memerlukan login (seperti kebanyakan layanan publik seperti Gmail), centang kotak otorisasi dan masukkan nama pengguna serta kata sandi Anda.
{% endstep %}

{% step %}

### Masukkan informasi pengirim

Masukkan email pengirim dan tanda tangan kustom yang akan otomatis ditambahkan sistem ke setiap email keluar.
{% endstep %}

{% step %}

### Uji pengaturan Anda

Klik **Kirim Email Uji** dan masukkan alamat tujuan untuk memverifikasi koneksi. Jika semuanya dikonfigurasi dengan benar, Anda akan menerima pesan uji pada alamat yang ditentukan.
{% endstep %}
{% endstepper %}