Basis pengetahuan GetMyBot

Studio konten

Siapkan pesan sekali dan gunakan dalam siaran atau di situs. Pelajari draf, penerbitan, isian otomatis, dan pemeriksaan sebelum mengirim.

Di halaman ini

Di bagian Konten, Anda dapat menyiapkan pesan untuk digunakan di beberapa tempat. Misalnya, satu versi program kursus yang diterbitkan dapat dikirim lewat Telegram dan VK. Teks, gambar, dan tombol di dalamnya disebut dokumen konten. Email, jendela pop-up, dan pemberitahuan push memakai jenis dokumen masing-masing.

Buat draf, lihat tampilannya di saluran yang dituju, lalu terbitkan versinya. Dokumen jenis Pesan dapat dipakai di beberapa messenger dan chat situs, tetapi tampilan dan kelayakan pengirimannya diperiksa secara terpisah untuk setiap saluran.

Untuk mengedit, Anda memerlukan hak bot yang sama seperti untuk reaksi. Tanpa hak itu, Anda hanya dapat membaca dokumen. Membuat, mengubah, menerbitkan, mengarsipkan, dan mengirim tes tidak tersedia.

Dokumen, draf, dan versi

Setiap dokumen memiliki jenis yang menentukan tempat penggunaannya: Pesan, Email, Pop-up, Dalam aplikasi, Push, Balasan cepat, atau Bot prospek. Dokumen Push dapat digunakan untuk push browser dan seluler pada siaran atau kampanye.

Setiap dokumen mempunyai tepat satu draf yang dapat diedit dan sejumlah versi terbit:

  • Mengedit hanya mengubah draf saat ini.
  • Terbitkan menyimpan draf sebagai versi tetap yang tidak dapat diubah, lalu membuka draf baru dengan isi yang sama.
  • Versi terbit tidak pernah ditimpa. Siaran terjadwal atau pop-up aktif tetap memakai versi yang dipilih saat dibuat.

Misalnya, siaran dijadwalkan memakai versi 2. Mengedit draf dan menerbitkan versi 3 tidak akan mengubah pesan dalam siaran itu. Jika Anda ingin memakai teks baru, pilih versi baru di pengaturan siaran atau pop-up.

Untuk melindungi perubahan yang dibuat bersama, editor mengirim nomor versi dan revisi yang terakhir dibukanya. Jika orang lain sudah mengubah dokumen, server menjawab 409. Muat ulang halaman sebelum mencoba lagi.

Arsipkan mengeluarkan dokumen dari daftar. Dokumen tidak dapat diarsipkan selama masih dipakai oleh pop-up aktif, siaran email yang terjadwal, berjalan, atau dijeda, maupun siaran push yang sudah diterima atau sedang berjalan. Lepaskan penggunaannya lebih dulu.

Blok dan batasan

Dokumen disusun dari blok:

  • Teks, Judul, Daftar, Pemisah: teks dengan pemformatan opsional.
  • Gambar, Berkas, Video: berkas dari pustaka media atau URL, dengan keterangan.
  • Tombol: teks dengan tautan atau data tindakan saat ditekan (callback).
  • Kolom: kelompok berisi maksimal empat blok anak. Kolom mengelompokkan blok di editor. Saat dikirim, blok anak ditampilkan berurutan. Saluran yang tidak mendukung kolom akan menampilkan peringatan columns_flattened.
  • Konten bersyarat: kelompok yang hanya ditampilkan jika kondisinya terpenuhi.

Server memeriksa batasan berikut saat draf disimpan dan saat diterbitkan:

  • Nama dokumen 1 hingga 120 karakter.
  • Paling sedikit satu blok dan paling banyak 200 blok seluruhnya.
  • Kedalaman blok bersarang maksimal 8 tingkat.
  • Maksimal 10 tombol pada satu tingkat.
  • Blok Kolom memiliki paling banyak 4 blok anak.
  • Setiap blok harus memiliki ID yang unik di dalam dokumen.

Pada kedua tahap itu, server memeriksa seluruh dokumen dan memastikan semua berkas media milik bot ini. Jika browser melewatkan kesalahan, server tetap akan menolaknya.

Mengisi data secara otomatis

Untuk menyisipkan data penerima, tulis penanda di antara dua pasang kurung kurawal. Nilainya diisi saat pesan dikirim:

Halo, {{profile.first_name}}! Pesanan {{event.order_id}} sudah dikirim.

Hanya empat bentuk berikut yang diterima:

  • {{profile.<field>}}: kolom profil penerima.
  • {{event.<field>}}: kolom peristiwa saat ini.
  • {{system.unsubscribe_url}}: tautan berhenti berlangganan milik penerima.
  • {{system.current_date}}: tanggal saat ini dalam format YYYY-MM-DD.

Bentuk lain ditolak. Dokumen konten tidak dapat menjalankan JavaScript, SQL, mesin templat, atau permintaan HTTP.

Tidak semua kolom pelanggan otomatis tersedia. Anda hanya dapat memakai kolom profile dan event yang disediakan oleh tempat pengiriman. Daftar ini disebut kolom yang diizinkan. Jika Anda menulis kolom lain, dokumen akan menampilkan kesalahan “isian tidak diizinkan”, walaupun nilainya ada di basis data.

Jika kolom yang diizinkan tidak memiliki nilai untuk seorang penerima, pengiriman juga gagal kecuali Anda menyediakan nilai pengganti. Nilai pengganti disimpan di pengaturan dokumen pada fallbacks, menggunakan jalur kolom secara lengkap sebagai kunci:

{ "fallbacks": { "profile.first_name": "teman" } }

Nilai pengganti hanya dapat dibuat untuk kolom yang memang diizinkan, dengan panjang maksimal 16.000 karakter.

Sistem mengamankan nilai sesuai tempatnya: dalam teks berformat HTML, karakter khusus diubah agar tidak menjadi kode HTML; dalam URL, nilainya dikodekan sebagai bagian alamat. Nilai system.* yang sudah berupa tautan tidak dikodekan ulang.

Blok bersyarat

Anda dapat memberi kondisi pada blok mana pun. Blok Konten bersyarat menerapkan satu kondisi kepada beberapa blok sekaligus.

Pilihan kondisinya lebih terbatas daripada kondisi segmen. Saat pesan dibuat untuk penerima, hanya profil dan peristiwa saat itu yang tersedia:

  • Subjek hanya profile atau event.
  • Operator: eq, ne, gt, lt, ge, le, gte, lte, exists, not_exists, contains, not_contains, in, not_in, between, before, after, has_any, not_has_any.
  • Kondisi dengan jendela waktu, seperti “dalam N hari terakhir”, tidak tersedia.

Kondisi yang memerlukan data yang tidak tersedia mendapat kode condition_unsupported; kondisi yang salah mendapat condition_invalid. Versi yang sudah diterbitkan juga diperiksa sebelum dikirim, sehingga masalah ini muncul sebagai kesalahan pemeriksaan, bukan kegagalan pengiriman.

Memeriksa saluran dan melihat pratinjau

Tombol Periksa membuat tampilan versi yang dipilih menurut kemampuan saluran yang sebenarnya. Hasilnya memuat daftar kesalahan dan peringatan.

Kesalahan berikut menghalangi penerbitan dan pengiriman:

  • text_too_long: teks melebihi batas saluran.
  • media_missing: blok gambar, berkas, atau video tidak mempunyai berkas maupun URL.
  • media_unsupported: saluran tidak mendukung jenis lampiran tersebut.
  • button_unsupported: saluran tidak memiliki tombol inline, dan tombol tidak mempunyai tautan yang dapat ditampilkan sebagai pengganti.
  • invalid_document: salah satu aturan struktur di atas dilanggar.
  • condition_invalid, condition_unsupported: kondisi salah atau tidak didukung.

Peringatan tidak menghalangi pengiriman, tetapi menunjukkan perubahan tampilan:

  • columns_flattened: kolom tidak didukung; blok anak ditampilkan berurutan.
  • format_flattened: format teks tidak didukung; teks dikirim sebagai teks biasa.
  • button_as_link: tombol menjadi tautan biasa.
  • missing_image_alt: gambar tidak memiliki teks alternatif.
  • vague_link_text: teks tombol kosong atau terlalu umum, seperti “click here”, “here”, “link”, atau “more”.

Pratinjau menampilkan hasil untuk saluran yang dipilih: situs, email, Telegram, VK, atau WhatsApp, dalam tampilan desktop dan seluler. Jika Anda memilih penerima nyata, data orang itu dipakai dalam pratinjau sehingga kesalahan pengisian data terlihat sebelum pesan dikirim.

Satu dokumen dapat lolos pemeriksaan untuk satu saluran tetapi gagal untuk saluran lain. Email, misalnya, mempertahankan kolom dan format HTML serta mendukung gambar dan berkas, tetapi tidak video. Tombolnya menjadi tautan (button_as_link).

Mengirim tes

Kirim tes melewati pemeriksaan, pembuatan tampilan, dan antrean yang sama dengan pengiriman sungguhan, tetapi hanya untuk satu penerima. Anda tidak dapat mengetik sembarang alamat atau chat ID. Pilih kontak bot yang sudah dapat menerima kiriman.

Permintaan ditolak jika:

  • Kontak belum terverifikasi (422).
  • Kontak dikecualikan dari pengiriman, misalnya berhenti berlangganan atau alamatnya tidak dapat menerima pesan (409).
  • Dokumen berubah sejak Anda membukanya (409).
  • Saluran tidak tersedia pada pemasangan ini (422).
  • Konten tidak dapat ditampilkan di saluran yang dipilih (422).
  • Kuota saluran habis (409).
  • Tes terlalu sering dikirim (429). Batasnya berlaku per akun: tiga tes berurutan, lalu satu tes setiap 15 detik.

Jika berhasil, API menjawab 202 dan menaruh pesan di antrean. Setelah itu, mekanisme pengiriman biasa yang mengantarkannya.

Templat

Templat menyediakan rancangan awal. Memilih templat menyalin bloknya ke draf baru. Salinan ini tidak terhubung lagi dengan templat, sehingga perubahan templat di kemudian hari tidak mengubah dokumen yang sudah dibuat.

Galeri menampilkan templat bawaan dan templat milik bot. Jika belum ada, galeri kosong. Tombol “simpan sebagai templat” belum tersedia. Templat bot dibuat dan dihapus melalui API (POST /api/bots/{botID}/content-templates).

Tema, ukuran, dan jarak

Tema dokumen menentukan font dan warna umum. Tampilan sebuah blok dapat diubah secara terpisah di panel pengaturan. Jarak dalam memisahkan isi dari tepi blok; jarak luar memisahkan blok dari blok di sekitarnya. Jarak diukur dalam piksel, sedangkan lebar blok dalam persen dihitung terhadap area konten.

Tinggi baris dinyatakan sebagai pengali: 1.5 berarti jarak satu setengah baris. Periksa pemenggalan baris pada pratinjau desktop dan seluler. Pilihan tampilan bergantung pada saluran; pemeriksaan akan memberi tahu jika format disederhanakan atau kolom dikirim berurutan.

Kode HTML email

Untuk email, Anda dapat beralih antara editor visual dan kode HTML. Setelah mengubah kode, tunggu hasil pemeriksaan. Jika ada kesalahan, perbaiki HTML sebelum kembali ke editor visual atau menyimpan.

Mengimpor HTML dapat mengubah elemen yang tidak didukung. Tinjau hasilnya dan uji email pada aplikasi email penerima, karena tiap aplikasi dapat menampilkan HTML secara berbeda.

Mengubah elemen email

Pilih elemen di editor visual, lalu ubah sifat yang tersedia di panel: teks, tautan, gambar, atau wadahnya. Nilai diterapkan setelah Anda berpindah dari kolom isian. Tautan memiliki alamat tujuan dan teks yang terlihat. Teks alternatif gambar menjelaskannya kepada penerima yang tidak dapat melihat gambar.

Jika terjadi masalah

  1. “Isian tidak diizinkan”: jalur kolom tidak ada dalam daftar untuk konteks ini atau salah ketik. Pilih kolom dari daftar, jangan menulis penandanya secara manual.
  2. “Nilai isian tidak ada”: penerima tidak mempunyai nilai untuk kolom yang diizinkan. Tambahkan nilai pengganti di pengaturan dokumen.
  3. Penerbitan menjawab 409: orang lain sudah mengubah dokumen. Muat ulang, lalu terbitkan lagi.
  4. Pengarsipan ditolak: dokumen masih dipakai oleh pop-up aktif, siaran email aktif, atau siaran push yang berjalan.
  5. Kirim tes tidak tersedia: daftar penerima kosong sampai bot memiliki sedikitnya satu kontak terverifikasi yang tidak dikecualikan pada saluran yang terhubung.

Bacaan berikutnya