Basis pengetahuan GetMyBot

Integrasi

Hubungkan bot dengan Google Sheets, Drive, GetCourse, atau AI. Simpan koneksinya, lalu pilih tindakan yang menggunakannya.

Di halaman ini

Integrasi memungkinkan bot bekerja dengan layanan lain, misalnya menambahkan permintaan pelanggan ke Google Sheets atau mengirim data pelanggan ke GetCourse. Ada dua langkah: simpan koneksi ke layanan, lalu pilih koneksi tersebut dalam tindakan reaksi.

Buka Integrasi → Tambah integrasi, pilih layanan, dan isi pengaturannya. Data akses disimpan dalam bentuk terenkripsi. Pada kartu integrasi, Anda dapat mengaktifkan, menonaktifkan, atau mengubah koneksi melalui Atur.

Layanan yang tersedia

  • AI: model bahasa melalui API yang kompatibel dengan OpenAI. Lihat Balasan AI dan agen AI.
  • Google Sheets: menambah, membaca, mencari, dan mengubah baris berdasarkan judul kolom. Lihat Tindakan.
  • Google Drive: mengunggah berkas ke folder.
  • GetCourse: membuat dan mengubah pengguna serta transaksi; mengambil daftar pengguna, transaksi, dan grup.
  • Webhook: mengirim data ke alamat layanan lain melalui HTTP.
  • Penangan eksternal: menyerahkan reaksi kepada program di server Anda melalui WebSocket. Lihat Penangan eksternal.

Google Kalender juga dapat dihubungkan, tetapi melalui AI → Kalender, bukan halaman ini. Di sana Anda memberi izin melalui Google dan mengatur jenis pertemuan. Lihat Pertemuan dan Google Kalender.

Untuk CRM amoCRM/Kommo, Bitrix24, RetailCRM, dan OzmaCRM, gunakan Integrasi → CRM. Di sana Anda dapat menghubungkan CRM, mencocokkan kolom datanya dengan GetMyBot, menguji hasil sebelum mulai, melihat riwayat pertukaran, dan menyelesaikan konflik. Data dapat bergerak ke dua arah. amoCRM/Kommo menggunakan OAuth, RetailCRM menggunakan kunci API, OzmaCRM menggunakan OIDC, dan Bitrix24 menggunakan webhook portal. Lihat Integrasi CRM.

Mengatur koneksi

Saat menambahkan integrasi, pilih Layanan, beri Nama, lalu isi kolom sesuai layanan.

Webhook

  • URL webhook: alamat layanan yang akan menerima permintaan.
  • Tanda tangan HMAC (rahasia): kunci bersama untuk memastikan bahwa permintaan benar-benar dikirim oleh GetMyBot. Tanda tangan dikirim dalam header X-Signature: sha256=....

GetCourse

  • Akun: nama sekolah, misalnya myschool, dan kunci rahasia API.
  • Objek: Pengguna atau Transaksi.

Tindakan GetCourse mendukung dua jenis pekerjaan.

Mengirim data ke GetCourse. Kolom dikelompokkan sesuai API GetCourse: Pengguna (email, phone, first_name, last_name, city, country, group_name), Pengaturan impor seperti refresh_if_exists, Sumber kunjungan (utm_source, utm_campaign, referer), Transaksi (offer_code, deal_cost, deal_status, deal_is_paid), dan Kolom pengguna tambahan. Anda dapat mengambil nilai dari data pelanggan, misalnya email = {{param.email}}, atau memasukkan nilai tetap seperti utm_source = telegram. Nama grup dan kolom tambahan dapat diambil dari akun Anda; jika gagal dimuat, masukkan secara manual. Tindakan lama dengan daftar kolom gabungan tetap bekerja. Tombol Pisahkan ke bagian memindahkan kolom yang dikenal ke bagiannya dan sisanya ke kolom tambahan.

Respons HTTP 200 dari GetCourse belum tentu berarti berhasil. Jika respons berisi success: false, tindakan dianggap gagal dan menampilkan error_message. Jika berhasil, ID {user_id, deal_id, lead_id} disimpan dalam data sementara reaksi. ID yang tidak tersedia bernilai nol.

Mengambil data dari GetCourse. Pilih Ekspor pengguna, Ekspor transaksi, atau Ekspor grup. GetMyBot meminta ekspor lalu menunggu kesiapan hingga 25 detik. Jika belum siap, tindakan mengembalikan export_not_ready; coba lagi nanti atau persempit filter. Filter terdiri dari baris kunci, jenis, nilai, misalnya created_at[from] = 2026-10-01. Kunci yang tidak dikenal tetap diteruskan. Hasil berupa daftar dengan nama kolom dari akun Anda, paling banyak 1.000 baris per proses, nilai bawaan 50. has_more pada Informasi halaman menunjukkan apakah ada bagian berikutnya. Karena GetCourse membatasi frekuensi ekspor, jangan jalankan ekspor untuk setiap pesan pelanggan. Gunakan alur berkala atau jadwal.

Google Sheets

  • Tautan atau ID spreadsheet.
  • JSON akun layanan (rahasia): berkas kunci akun Google khusus untuk program. Berikan akun tersebut akses ke spreadsheet, jika tidak pembacaan dan penulisan akan gagal. Kesalahan akses ditampilkan saat tindakan diuji dan diedit.

Tindakan menggunakan judul kolom pada baris judul, secara bawaan baris pertama. Anda dapat memilih baris lain. Tindakan yang tersedia:

  • Tambah baris: setiap nilai masuk ke kolom dengan judul yang sama. Urutan kolom tidak penting, tetapi judul yang tidak ditemukan menyebabkan kesalahan. Hasilnya {row_number, range}.
  • Baca baris: baris setelah judul dikembalikan sebagai data dengan nomor _row. Satu halaman berisi 50 baris secara bawaan, paling banyak 500. has_more dan next_offset dapat disimpan untuk membaca halaman berikutnya.
  • Baca baris terakhir dan Cari baris: membaca spreadsheet sedikit demi sedikit. Jika terlalu besar, tindakan memberi kesalahan alih-alih mengembalikan baris yang salah.
  • Ubah baris: mengubah kolom pada nomor row_number, misalnya {{ctx.found.row_number}} setelah pencarian.

Nilai dapat ditulis seperti saat diketik, sehingga Google Sheets mengenali tanggal dan rumus, atau sebagai teks. Editor menawarkan judul kolom dari spreadsheet; jika gagal dibaca, masukkan secara manual. Pratinjau baris menampilkan hingga 20 baris tanpa mengubah spreadsheet. Hasil pratinjau dapat digunakan sebagai contoh saat memilih bagian respons yang diperlukan tindakan berikutnya.

Google Drive

  • ID folder.
  • JSON akun layanan (rahasia). Beri akun tersebut hak mengedit folder.

Tindakan Google Drive mengunggah berkas beserta nama, jenis berkas (MIME), dan isinya. ID dan tautan {file_id, web_view_link} disimpan dalam data sementara reaksi, misalnya dengan nama upload. Tautannya dapat dipakai sebagai {{ctx.upload.web_view_link}}. Anda juga dapat memilih bagian respons yang ingin disimpan, sama seperti pada tindakan lain.

AI

Satu koneksi AI dapat dipakai untuk tindakan AI dalam reaksi, agen AI, dan persiapan sumber pengetahuan agar dapat dicari. Untuk pencarian, model membuat representasi angka dari teks yang disebut embedding. GetMyBot menggunakan alamat dan kunci yang sama, serta model text-embedding-3-small secara bawaan. Tanpa koneksi AI yang berfungsi, sumber pengetahuan tidak dapat disiapkan untuk pencarian dan agen tidak dapat diaktifkan.

Penangan eksternal

Server Anda terhubung ke GetMyBot melalui WebSocket dan menangani reaksi dengan mengirim perintah berformat Telegram Bot API.

  • Alamat WebSocket: alamat yang digunakan program Anda untuk terhubung.
  • Token koneksi (rahasia): hanya ditampilkan sekali saat dibuat; token baru dapat diterbitkan melalui tombol.

Lihat protokol dan contoh di Penangan eksternal.

Menggunakan integrasi dalam reaksi

  • AI dan Webhook dapat digunakan langsung: tambahkan tindakan AI atau kirim data melalui Permintaan web ke alamat webhook.
  • Tindakan GetCourse, Google Sheets, dan Google Drive tersedia dalam editor reaksi. Anda dapat memilih bagian dari hasil tindakan untuk disimpan dalam data sementara, serta mengatur tindakan saat terjadi kesalahan. Jika paket tidak mendukung fitur tersebut, langkah berakhir dengan alasan feature_unavailable.

Memeriksa koneksi

Tombol Periksa pada kartu integrasi tidak mengubah data. Untuk Google Sheets, GetMyBot membaca informasi spreadsheet; untuk Google Drive, informasi folder; untuk GetCourse, melakukan permintaan baca yang aman; untuk AI, hanya memeriksa apakah pengaturan terisi tanpa panggilan model berbayar. Jenis koneksi lain tidak memiliki pemeriksaan. Hasil menampilkan hal yang berhasil dan gagal beserta penjelasan singkat.

Keamanan

GetMyBot tidak mengirim permintaan integrasi ke jaringan internal dan membatasi ukuran respons. Ini mencegah akses ke alamat yang tidak dimaksudkan untuk layanan luar (SSRF). Rahasia integrasi disimpan dalam bentuk terenkripsi.

Pengambilan halaman web dan pembacaan berkas memiliki batas tambahan: hanya alamat HTTPS yang diizinkan, mengikuti robots.txt, membatasi pengalihan, ukuran, dan waktu, serta tidak menjalankan makro, skrip, atau objek tertanam. Lihat Sumber pengetahuan.

Langkah berikutnya

Transkripsi suara

Pilih penyedia yang kompatibel dengan OpenAI atau layanan Anda sendiri, lalu isi alamat dasar API, model, dan kunci API. Kode bahasa opsional seperti ru atau en membantu mengenali bahasa suara; jika kosong, penyedia akan menentukannya. Model dan kunci harus berasal dari penyedia yang dipilih.