---
title: "Hubungkan Apsis One"
description: "Buat kunci API di Apsis One, hubungkan, lalu kirim pendaftar baru ke sebuah section beserta atribut dan langganan mereka, langkah demi langkah."
url: https://scratcher.io/id/help/integrations/apsis-one
language: id
---

1. [Pusat bantuan](https://scratcher.io/id/help)
2. [Integrasi](https://scratcher.io/id/help/integrations)
3. Hubungkan Apsis One

# Hubungkan Apsis One

Buat kunci API di Apsis One, hubungkan, lalu kirim pendaftar baru ke sebuah section beserta atribut dan langganan mereka, langkah demi langkah.

Dengan integrasi Apsis One, setiap orang yang mendaftar akan dibuat atau diperbarui sebagai profil di Apsis One, di section yang Anda pilih, dan dapat didaftarkan (opt-in) ke salah satu langganan Apsis One Anda.

## Yang Anda perlukan

- Akun Apsis One, dan pengguna yang dapat mengelola kunci API (biasanya administrator).
- Mengetahui apakah akun Apsis One Anda berada di region **Europe** atau **Asia**. Sebagian besar akun berada di Eropa.

## Langkah 1: Buat kunci API di Apsis One

1. Di Apsis One, buka **Account settings** lalu masuk ke **API keys** (di bawah integrasi).
2. Klik untuk membuat kunci API baru. Beri nama yang mudah Anda kenali, misalnya “Scratcher”.
3. Berikan kunci tersebut akses ke section yang ingin Anda gunakan untuk menerima profil dari Scratcher, dengan izin seperti di bawah ini.
4. Simpan, lalu salin **Client ID** dan **Client secret**. Secret hanya ditampilkan satu kali.

Apsis memiliki panduan langkah demi langkah sendiri untuk hal ini. Tautannya tersedia di **Setup guide** pada dialog instalasi di Scratcher (“To install the integration, follow the guide here”).

## Izin yang dibutuhkan kunci

Scratcher menggunakan kunci ini untuk:

- membaca section Anda, beserta atribut, langganan (topik persetujuan) dan event di dalamnya, sehingga Anda dapat memilihnya di kampanye;
- membuat profil dan memperbarui atributnya;
- menambahkan persetujuan (opt-in) ke profil;
- menambahkan event ke profil.

Jadi, kunci memerlukan akses baca ke section dan akses tulis ke profil, persetujuan, dan event di section yang Anda gunakan. Tanpa akses tulis, pengiriman akan gagal dengan pesan galat dari Apsis One.

## Langkah 2: Hubungkan Apsis One ke Scratcher

1. Di Scratcher, buka **Settings** > **Integrasi** lalu klik **Apsis One**.
2. Pilih **API region**: **Europe** atau **Asia**.
3. Tempelkan **Client ID** dan **Client secret**.
4. Klik **Install integration**. Scratcher akan masuk ke Apsis One untuk memeriksa detailnya.

## Langkah 3: Aktifkan di kampanye

1. Di editor, buka **Connect** > **Integrasi** > **Apsis One** lalu klik **Activate**.
2. Jika Anda telah menghubungkan lebih dari satu akun Apsis One, pilih akunnya di **Select account**.
3. Di **Apsis section**, pilih section-nya (**Select a section**).
4. Di **Field mappings**, klik **Add field mapping** untuk setiap kolom dan cocokkan **Scratcher field** dengan atribut Apsis One di **Destination field**. Daftar tersebut menampilkan atribut dari section yang Anda pilih, termasuk atribut buatan Anda sendiri.
5. Di **Subscriptions (consents)**, pilih langganan yang akan diikuti peserta, atau **None**. “Choose any subscription that the participant should be opted into.”
6. Di **Filter by permissions (optional)**, pilih kotak centang persetujuan pemasaran Anda, agar hanya orang yang mencentangnya yang dikirim.
7. Klik **Save**, lalu **Test** untuk mengirim profil uji.

## Pemetaan kolom

- Alamat email selalu dikirim dan digunakan untuk mengidentifikasi profil. Anda tidak perlu memetakannya.
- Untuk nomor telepon, gunakan pengaturan **Format** agar nomor dikirim sesuai format yang diharapkan atribut Anda.
- Atribut ya/tidak menerima nilai true atau false, jadi petakan kolom **Accepted** dari persetujuan ke atribut ya/tidak.

## Persetujuan

Jika Anda memilih langganan, setiap orang akan didaftarkan ke langganan tersebut dengan alasan “Subscribed via” beserta nama kampanye, dan sumber “Scratcher”. Jika orang tersebut sudah terdaftar, tidak ada yang berubah. Gunakan **Filter by permissions** agar hanya orang yang mencentang kotak pemasaran Anda yang didaftarkan.

Jika section Anda memiliki event formulir persetujuan Apsis One, Scratcher juga mencatat pendaftaran sebagai event pada profil, beserta alamat kampanye.

## Apa yang dikirim dan kapan

Pendaftar baru dikirim dalam satu atau dua menit. Saat Anda mengaktifkan integrasi, lead yang sudah ada di kampanye juga ikut dikirim. Jika seseorang berpartisipasi lagi, profilnya akan diperbarui. Periksa setiap pengiriman di **Settings** > **Integrasi** > **Delivery status**; di sana juga ditampilkan apakah profil tersebut baru atau sudah ada sebelumnya. Lihat [Periksa status pengiriman dan kirim ulang lead](https://scratcher.io/id/help/integrations/delivery-status).

## Pemecahan masalah

- “All or some of the fields are invalid...” saat instalasi: periksa region, lalu salin ulang client ID dan secret.
- Pengiriman gagal dengan galat akses dari Apsis One: kunci tidak memiliki akses ke section, atau tidak memiliki izin tulis. Edit kunci tersebut di Apsis One.
- **Subscriptions (consents)** kosong: section belum memiliki langganan. Buat langganan di Apsis One, lalu buka kembali integrasinya.

Integrasi

- [Cara kerja integrasi](https://scratcher.io/id/help/integrations/how-integrations-work)
- [Semua integrasi](https://scratcher.io/id/help/integrations/other-integrations)
- [Periksa status pengiriman dan kirim ulang lead](https://scratcher.io/id/help/integrations/delivery-status)
- [Hubungkan HubSpot](https://scratcher.io/id/help/integrations/hubspot)
- [Hubungkan Salesforce Marketing Cloud](https://scratcher.io/id/help/integrations/salesforce-marketing-cloud)
- [Hubungkan Microsoft Dynamics 365 dengan Zapier](https://scratcher.io/id/help/integrations/microsoft-dynamics-365)
- [Hubungkan Emarsys](https://scratcher.io/id/help/integrations/emarsys)
- [Hubungkan Klaviyo](https://scratcher.io/id/help/integrations/klaviyo)
- [Hubungkan Mailchimp](https://scratcher.io/id/help/integrations/mailchimp)
- [Hubungkan ActiveCampaign](https://scratcher.io/id/help/integrations/activecampaign)
- [Hubungkan Apsis One](https://scratcher.io/id/help/integrations/apsis-one)
- [Hubungkan Drip](https://scratcher.io/id/help/integrations/drip)
- [Hubungkan HeyLoyalty](https://scratcher.io/id/help/integrations/heyloyalty)
- [Hubungkan Peytz](https://scratcher.io/id/help/integrations/peytz)
- [Hubungkan Marketingplatform](https://scratcher.io/id/help/integrations/marketingplatform)
- [Hubungkan Campaign Monitor dengan Zapier](https://scratcher.io/id/help/integrations/campaign-monitor)
- [Hubungkan ActiveTrail dengan Zapier](https://scratcher.io/id/help/integrations/activetrail)
- [Hubungkan Bloomreach](https://scratcher.io/id/help/integrations/bloomreach)
- [Hubungkan Iterable](https://scratcher.io/id/help/integrations/iterable)
- [Hubungkan Mapp](https://scratcher.io/id/help/integrations/mapp)
- [Hubungkan Agillic](https://scratcher.io/id/help/integrations/agillic)
- [Hubungkan Ortto](https://scratcher.io/id/help/integrations/ortto)
- [Hubungkan Emarketeer](https://scratcher.io/id/help/integrations/emarketeer)
- [Hubungkan Shopify](https://scratcher.io/id/help/integrations/shopify)
- [Hubungkan Hello Retail](https://scratcher.io/id/help/integrations/hello-retail)
- [Hubungkan 8.000+ aplikasi dengan Zapier](https://scratcher.io/id/help/integrations/zapier)
- [Hubungkan monday.com dengan Zapier](https://scratcher.io/id/help/integrations/monday-com)
- [Hubungkan Asana dengan Zapier](https://scratcher.io/id/help/integrations/asana)
- [Hubungkan Podio dengan Zapier](https://scratcher.io/id/help/integrations/podio)
- [Hubungkan Intercom dengan Zapier](https://scratcher.io/id/help/integrations/intercom)

Terus belajar

## Artikel terkait

- [Cara kerja integrasi](https://scratcher.io/id/help/integrations/how-integrations-work): Hubungkan alat email atau CRM Anda sekali saja, aktifkan di setiap kampanye, pilih daftar, petakan kolom Anda, dan kirim hanya orang yang telah memberikan persetujuan.
- [Periksa status pengiriman dan kirim ulang lead](https://scratcher.io/id/help/integrations/delivery-status): Lihat lead mana saja yang telah dikirim ke alat Anda, pahami pesan kesalahannya, perbaiki masalahnya, lalu kirim ulang.
- [Minta persetujuan dan tambahkan syarat dan ketentuan](https://scratcher.io/id/help/forms/consent-and-permissions): Tambahkan kotak centang persetujuan untuk buletin, tautkan syarat Anda, pilih kotak centang mana yang mendaftarkan orang sebagai pelanggan, dan kirim hanya orang yang menyetujuinya ke alat email Anda.

Butuh bantuan?

## Masih butuh bantuan?

Tim kami siap membantu. Jika Anda sudah menggunakan Scratcher, cara tercepat adalah lewat chat di dalam platform.

- **[Chat dengan kami](https://platform.scratcher.io/id/login)**

    Masuk dan klik tombol chat di pojok kanan bawah. Rex langsung menjawab, dan tim kami hanya sejauh satu klik.
- **[Jadwalkan pertemuan](https://scratcher.io/id/book-a-meeting)**

    Panggilan video gratis 30 menit dengan tim kami: tur produk, ide kampanye, atau bantuan penyiapan.
- **[Kirim email](mailto:contact@scratcher.io)**

    Kirim email ke contact@scratcher.io dan kami akan segera membalas.
