Integrasi
Hubungkan API apa pun
Pakai layanan yang tidak ada di katalog Konektor, mulai dari API publik sampai layanan yang butuh kunci, atau tambahkan konektor buatanmu sendiri yang bisa dipakai AI untuk membuat aplikasi.
Katalog Konektor mencakup lebih dari 100 layanan, tapi aplikasimu bisa bekerja dengan hampir semua layanan yang punya API (cara bagi software lain untuk berkomunikasi dengannya). Halaman ini menunjukkan tiga cara untuk melakukannya, dari yang tercepat sampai yang paling mudah dipakai ulang.
| Situasimu | Yang perlu dilakukan |
|---|---|
| API-nya publik dan tidak butuh kunci | Minta lewat chat |
| API-nya butuh kunci, dan kamu hanya memerlukannya di satu aplikasi | Biarkan AI meminta kuncinya, lalu kunci itu disimpan sebagai rahasia untuk aplikasi tersebut |
| Kamu akan memakai layanan ini di beberapa aplikasi, atau ingin AI memahaminya dengan baik | Buat konektor sendiri di halaman Konektor |
Mana pun yang kamu pilih, kunci hanya dipakai di kode server aplikasimu, jadi tidak akan sampai ke browser pengunjungmu.
Pakai API publik
Banyak layanan, seperti cuaca, hari libur nasional, atau data terbuka, sama sekali tidak butuh kunci. Sebutkan nama layanannya dan katakan apa yang kamu mau darinya.
Tampilkan prakiraan cuaca 5 hari untuk kota pengunjung di halaman utama, pakai API Open-Meteo.
Kalau AI butuh detail tentang API yang kurang dikenalnya, tempel bagian dokumentasi yang relevan ke chat, misalnya satu contoh permintaan beserta jawaban yang diberikan, atau lampirkan dokumentasinya sebagai file. Lihat Tambahkan gambar dan file.
Pakai API yang butuh kunci
Saat sebuah fitur butuh kunci untuk layanan yang tidak ada di katalog, AI menampilkan kartu kunci di chat beserta nama yang akan dipakainya, misalnya ACME_API_KEY. Tempel kuncinya lalu klik Simpan, atau klik Lewati untuk lanjut tanpa kunci itu.
Kartunya menjelaskan dengan jelas: kunci disimpan dengan aman dan terenkripsi, tidak pernah muncul di chat atau di kode aplikasimu, dan kamu bisa mengubahnya nanti di Kelola → Rahasia (anggota tim akan diberi tahu bahwa pemilik proyek yang bisa mengubahnya).
Tambahkan formulir kontak yang membuat prospek baru di CRM kami lewat API-nya. Minta kunci API-nya dariku.
Kamu juga bisa menambahkan kunci sendiri sebelum meminta: buka tab Kelola, pilih Rahasia, lalu tambahkan satu di bawah Tambah rahasia baru. Pratinjaumu mengambil perubahan secara otomatis; aplikasimu yang sudah terbit mendapatkannya saat kamu menerbitkannya lagi. Lihat Rahasia dan kunci API.
Jangan ketik kunci di pesan chat. Pesan chat disimpan bersama proyekmu. Pakai kartu kunci atau Kelola → Rahasia sebagai gantinya.
Buat konektor sendiri
Kalau kamu akan memakai sebuah layanan di lebih dari satu aplikasi, atau ingin AI memahami API-nya dengan benar, tambahkan sebagai konektor buatanmu sendiri. Kamu menjelaskan API-nya sekali saja; setelah itu cara kerjanya sama seperti konektor katalog mana pun: hubungkan dengan kuncimu, aktifkan atau nonaktifkan per aplikasi, dan AI bisa membuat aplikasi dengannya serta membacanya saat membuat.
Di halaman Konektor, gulir ke Konektor buatanmu sendiri lalu klik Buat konektor. Siapkan dokumentasi API layanannya, karena kamu akan membutuhkan alamat API-nya dan cara layanan itu menerima kunci. Jangan masukkan kunci apa pun ke dalam deskripsinya; kamu menghubungkan dengan kuncimu sendiri di akhir.
Detail
Beri Nama. Kamu juga bisa menambahkan Deskripsi singkat untuk kartunya dan Fungsinya (ini membantu AI tahu kapan harus memakainya). Lalu pilih Kategori, tambahkan Tautan dokumentasi API jika mau, dan pilih Warna. Nama kode menentukan nama pengaturan yang dibaca aplikasimu, misalnya
ACME_CRM_API_KEY. Nama ini tidak bisa diubah nanti.Cara masuknya
Masukkan Alamat API tempat setiap permintaan dimulai (harus diawali
https://). Lalu jawab Bagaimana layanan ini memeriksa siapa kamu?: Token Bearer, Kunci API di header, Kunci API di alamat, atau Nama pengguna dan kata sandi. Kalau layanannya butuh lebih dari satu nilai, misalnya ID akun, tambahkan di bawah Butuh lebih dari satu nilai?. Sebuah pratinjau menampilkan Seperti apa bentuk permintaan.Permintaan tes
Pilih permintaan yang hanya membaca dan butuh kunci, seperti "siapa aku" atau "tampilkan daftar itemku". Buildliy menjalankannya untuk memeriksa setiap kunci sebelum disimpan, jadi permintaan itu tidak boleh mengubah apa pun. Di bawah Coba (opsional) kamu bisa menempel kunci dan klik Jalankan tes permintaan untuk melihat jawabannya; kunci itu hanya dipakai untuk tes dan tidak disimpan kecuali kamu menghubungkan dengannya setelahnya.
Siapa yang melihat data
Pilih Hanya aku — ini pribadi untuk data akun pribadi (kotak masuk, catatan, atau rekening bankmu), atau Siapa pun yang memakai aplikasiku — ini dibagikan untuk data yang memang untuk semua orang, seperti daftar produk atau daftar publik.
Catatan untuk AI
Kamu bisa menempel bagian dokumentasi API yang perlu diketahui AI: endpoint, contoh permintaan, dan jawabannya. Beri setiap catatan Nama file dan, kalau mau, isi Kapan AI perlu membacanya? Kamu bisa menambahkan hingga 10 catatan, masing-masing 20.000 karakter. AI melihat bagian awal setiap catatan dan membaca sisanya saat memerlukannya. Jangan pernah menempel kunci di sini.
Klik Buat konektor. Jendela penghubung terbuka berikutnya, dengan kunci yang kamu ketik di Coba (opsional) sudah terisi: masukkan kuncimu kalau perlu lalu klik Hubungkan. Buildliy menjalankan permintaan tesmu dengan kunci itu sebelum menyimpannya, lalu menyimpannya dalam keadaan terenkripsi. Kunci itu hanya dipakai di kode server aplikasimu.
Pakai konektor Acme CRM milikku untuk menampilkan 20 kontak terbaruku di halaman dasbor, lengkap dengan kotak pencarian.
Setiap konektor buatanmu sendiri punya kartu dengan Hubungkan (Kelola setelah terhubung, atau Hubungkan ulang kalau kuncinya berhenti berfungsi), Ubah, dan tombol hapus. Menghapus akan menghilangkan konektor dan kunci tersimpanmu untuknya, dan aplikasi yang memakainya tidak bisa lagi menjangkau layanan itu sampai kamu menambahkannya lagi. Kamu bisa punya hingga 25 konektor buatanmu sendiri.
Kalau kamu memilih Hanya aku — ini pribadi, AI menaruh semua data dari layanan itu di balik proses masuk aplikasimu. Setelah terhubung, daftar periksa peluncuran akan memblokir penerbitan kalau kode aplikasimu memakainya dan aplikasinya tidak punya proses masuk. Kalau aplikasinya punya proses masuk, daftar periksa mengingatkanmu untuk memastikan hanya kamu (atau orang yang kamu pilih) yang bisa masuk, karena pendaftaran terbuka akan membuat siapa pun bisa melihat datanya.
Terima kejadian dari layanan
Beberapa layanan bisa mengirim pesan ke aplikasimu saat sesuatu terjadi, seperti pesanan baru atau pembayaran yang selesai. Pesan-pesan ini sering disebut webhook. Minta AI menambahkan tempat di aplikasimu untuk menerimanya. Kalau layanan memberimu rahasia penandatanganan untuk memeriksa bahwa pesannya asli, AI memintanya lewat kartu kunci.
Tambahkan endpoint webhook yang menerima kejadian pesanan baru dari sistem gudang kami dan menyimpan setiap pesanan ke database.
Berikan ke layanan itu alamat aplikasimu yang sudah terbit, bukan alamat pratinjau, karena pratinjau tidak selalu berjalan. Lihat Terbitkan aplikasimu.
Terkait
Masih bingung? Baca FAQ atau hubungi kami.