Panduan/Untuk developer

Saya tidak ingin klien melihat alamat infrastruktur Anda

Pakai subdomain Anda sendiri untuk ruang percakapan tiap klien, lewat CNAME. 3 menit baca

Ruang percakapan tiap klien punya alamat bawaan yang panjang dan menyebut infrastruktur kami. Kalau Anda tidak ingin klien melihatnya, alamat itu bisa diganti dengan subdomain milik Anda sendiri. Yang dilihat dan disimpan staf klien sepenuhnya alamat Anda.

Satu subdomain per klien

Ini penting dipahami sejak awal: tiap klien butuh subdomain sendiri. Setiap klien punya ruang percakapan terpisah, dan satu nama domain hanya bisa menunjuk ke satu ruang. Tidak ada cara membuat satu alamat melayani semua klien Anda tanpa mengembalikan mereka ke alamat aslinya.

Jadi tiap klien baru berarti satu CNAME baru dari sisi Anda, dan satu penyiapan dari sisi kami.

Langkahnya, tanpa menghubungi kami

  1. Buat CNAME lebih dulu. Arahkan subdomain pilihan Anda ke alamat bawaan klien tersebut:
    klinikanu.domainanda.id. CNAME waco-klinikanu-a1b2c3.s3.idcloudhost.com.
  2. Daftarkan lewat API:
    POST /api/partner/v1/tenants/<tenant_id>/domain dengan {"domain": "klinikanu.domainanda.id"}
    Balasannya juga memuat cname_tujuan, jadi kalau Anda memanggilnya lebih dulu pun tetap tahu harus mengarah ke mana.
  3. Selesai. Kami memeriksa DNS tiap 5 menit, memasang domainnya, menerbitkan sertifikat HTTPS, lalu mengarahkan seluruh tautan internal termasuk email ke domain Anda.

Statusnya bisa Anda pantau sendiri lewat GET /api/partner/v1/tenants: kolom domain_status berisi menunggu, aktif, atau gagal, dan domain_galat menjelaskan sebabnya bila belum aktif. Anda tidak perlu bertanya kepada kami.

Biasanya selesai beberapa menit setelah DNS Anda menyebar. Kalau CNAME belum juga terpasang, kami menunggu sampai 48 jam sebelum menyerah, jadi tidak perlu buru-buru.

Alamat bawaan tetap berfungsi selama proses ini, dan tetap hidup sesudahnya. Kalau ada yang salah dengan domain Anda, klien tidak pernah kehilangan akses.

Kenapa CNAME harus lebih dulu

Sertifikat HTTPS diterbitkan dengan cara membuktikan bahwa nama itu memang menunjuk ke kami. Kalau kami menyiapkan sebelum DNS Anda mengarah, pembuktiannya gagal dan harus diulang. Satu menit menunggu DNS menghemat satu putaran bolak-balik.

Yang tidak cukup

CNAME saja tidak membuatnya jalan. DNS hanya menunjuk mesin, tidak memberi tahu mesin harus menyajikan apa. Tanpa penyiapan di sisi kami, pengunjung mendapat halaman 404, dan sebelum itu pun browser sudah menampilkan peringatan keamanan karena sertifikatnya tidak mencakup nama tersebut.

Kalau Anda lebih suka memakai reverse proxy di server sendiri, itu juga bisa. Tetapi tetap kabari kami domain finalnya: tautan di email undangan staf dan reset kata sandi dibuat dari sisi kami, dan hanya kami yang bisa mengarahkannya ke domain Anda. Tanpa itu, alamat asli tetap muncul di email meskipun tampilan webnya sudah tersamar.

Sebelum memutuskan namanya

Pilih subdomain yang tidak akan Anda ubah. Setelah dipakai, alamat itu tersimpan di bookmark staf klien dan tertulis di email yang sudah terkirim. Menggantinya berarti tautan lama berhenti bekerja, dan yang kebingungan adalah staf klien Anda, bukan Anda.

Fitur ini opsional. Banyak partner memilih membiarkan alamat bawaan karena klien mereka tidak mempermasalahkannya, dan itu sama sekali tidak mengurangi apa pun. Pertimbangkan ini kalau merek Anda memang perlu tampil utuh di depan klien.
Masih menemui kendala setelah mengikuti panduan ini? Hubungi kami dari dashboard — sertakan tangkapan layar bila ada, itu mempercepat semuanya.