Apakah Anda membuat alat yang membangun atau meng-hosting situs web? Tambahkan tombol Connect Notiamo. Pengguna Anda mengekliknya, masuk ke Notiamo (atau mendaftar), lalu mengeklik Izinkan. Notiamo membuat proyek untuk situs web mereka dan memberi alat Anda kode widget. Alat Anda memasang kode itu di situs web, atau menampilkannya untuk disalin.
Yang Anda dapatkan
- Pengguna Anda mendapat masukan situs web tanpa keluar dari alat Anda.
- Setiap pelanggan yang datang lewat tombol Anda memberi Anda 20% dari yang mereka bayar, tanpa pajak, selama 12 bulan pertama. Sebulan sekali, saat Anda punya 50 EUR atau lebih, kami membuat laporan; Anda mengirim invoice kepada kami dan kami membayar Anda lewat transfer bank, PayPal, atau Wise, sesuai pilihan Anda. Biaya pembayaran tergantung metode dan bank Anda, dan ditanggung oleh Anda. Anda menambahkan detail pembayaran di Pengaturan › Ajak dan dapatkan. Aturan program mitra berlaku: Anda tidak perlu paket Notiamo berbayar, dan tidak ada batas tahunan.
- Alat Anda tidak pernah melihat komentar atau proyek lain milik pengguna Anda. Alat Anda hanya mendapat satu hal: kode widget proyek baru.
1. Jadi mitra
Tulis kepada kami dari halaman kontak dengan:
- nama alat Anda dan situs webnya;
- halaman alat Anda yang akan menampilkan tombol (alamat persis, misalnya
https://app.builder.example); - organisasi Notiamo Anda (laporan dan detail pembayaran Anda ada di sana; akun gratis sudah cukup).
Kami mengirim app id kepada Anda. Anda memasangnya di tombol.
2. Tambahkan tombol
Muat skrip sekali, lalu tambahkan tombol dengan app id Anda dan alamat situs web yang sedang dibangun pengguna Anda:
<script src="https://my.notiamo.com/connect/v1.js" defer></script>
<button data-notiamo-connect
data-client="YOUR_APP_ID"
data-site="https://shop.example"
data-name="Shop">
Connect Notiamo
</button>
Jika berhasil, tombol mengirim peristiwa notiamo:connected dengan kode widget:
const button = document.querySelector("[data-notiamo-connect]");
button.addEventListener("notiamo:connected", (event) => {
const { snippet, projectId } = event.detail;
saveToTheHead(snippet); // alat Anda memasangnya di <head> situs web
});
button.addEventListener("notiamo:cancelled", () => { /* the user closed the window or clicked Deny */ });
button.addEventListener("notiamo:error", (event) => console.error(event.detail.message));
Jika alat Anda tidak bisa mengubah kode situs web, tambahkan data-mode="copy". Notiamo lalu menampilkan kode di jendela kecil dengan tombol Salin.
3. Atau panggil dari kode Anda
const result = await Notiamo.connect({
clientId: "YOUR_APP_ID",
site: "https://shop.example",
name: "Shop", // opsional: nama proyek, jika tidak ada pakai alamat situs web
mode: "return", // or "copy"
});
if (result.status === "connected") {
// result.snippet, result.projectId, result.publicKey, result.dashboardUrl
}
Panggil Notiamo.connect() dari sebuah klik. Browser memblokir jendela yang terbuka belakangan.
Yang dilihat pengguna Anda
- Jendela kecil Notiamo terbuka.
- Jika belum masuk, mereka mengetik email. Tautan masuk terbuka di tab lain; jendela menyadarinya dan lanjut sendiri. Pengguna baru mendaftar di jendela yang sama.
- Halaman Izinkan menyebutkan bahwa alat Anda ingin menambahkan Notiamo ke situs web mereka. Mereka memilih organisasi dan ruang kerja, lalu mengeklik Izinkan (atau Tolak).
- Jendela tertutup. Halaman Anda mendapat kode widget.
Batas paket berlaku seperti di dasbor. Akun gratis baru sudah punya satu proyek: Notiamo memakai proyek itu untuk situs web, bukan membuat proyek kedua.
Keamanan
- Hanya aplikasi mitra yang bisa membuat proyek dengan cara ini. Hanya halaman yang Anda berikan kepada kami yang mendapat kode: jendela mengirimnya ke alamat persis mereka, tidak ke tempat lain.
- Skrip memakai PKCE dan
stateacak untuk setiap klik. Aksesnya hanya-baca, terikat pada satu proyek baru, dan berakhir begitu skrip membaca kode widget. - Halaman Notiamo tidak pernah dimuat di dalam frame. Itu sebabnya tombol membuka jendela.
Alat sisi server
Jika alat Anda menyelesaikan proses di servernya sendiri, berikan juga alamat redirect-nya kepada kami. Kirim pengguna Anda ke https://my.notiamo.com/oauth/authorize dengan response_type=code, app id Anda sebagai client_id, redirect_uri Anda, code_challenge PKCE (S256), state, dan connect_site (situs web). Tukar kode di https://my.notiamo.com/api/oauth/token, lalu baca GET https://my.notiamo.com/api/connect/project dengan token akses. Jawabannya berisi snippet, projectId, publicKey, site, dan dashboardUrl.
Pertanyaan
Tulis kepada kami dari halaman kontak. Kami membantu Anda menguji tombol sebelum diluncurkan.