Variabel dinamis dapat digunakan untuk mempersonalisasi pesan keluar. Berbicara secara pribadi kepada Kontak dalam Percakapan dapat menjadi komponen penting dalam membangun hubungan dengan membuat mereka merasa diperhatikan dan dilibatkan.

Ada tiga jenis variabel dinamis pada platform:

Variabel Kontak Standar mewakili bidang kontak standar seperti nama depan, nama belakang, dan email.
Variabel Bidang Kontak Kustom melambangkan bidang kustom yang ditambahkan ke ruang.
Variabel Alur Kerja adalah variabel sementara yang hanya ada selama sesi Alur Kerja. Setelah Kontak keluar dari Alur Kerja, nilai variabel akan dihapus.

Ada tiga jenis Variabel Alur Kerja: Variabel Pemicu, Variabel Keluaran, dan variabel yang dibuat melalui langkah Ajukan Pertanyaan.

Contoh variabel dinamis

Variabel dinamis dapat disertakan dengan menambahkan awalan "$" ke bidang kontak. Berikut ini adalah sintaksnya:

$contact, $assignee atau $system

Platform ini mendukung interpolasi teks statis + variabel dinamis.

Variabel Kontak Standar

Variabel	Deskripsi
$contact.name	Diganti dengan nama lengkap kontak (Nama Depan + Nama Belakang).
$contact.firstname	Diganti dengan nama depan kontak.
$contact.lastname	Diganti dengan nama belakang kontak.
$contact.email	Diganti dengan email Kontak.
$contact.country	Digantikan oleh negara Kontak. Jika Kontak tidak memiliki negara yang tersimpan, negara tersebut tidak akan diganti dan string sebenarnya akan dikirim.
$contact.id	Diganti dengan ID kontak dari Kontak.

Variabel Bidang Kontak Kustom

Variabel	Deskripsi
$contact.field_name	Diganti dengan nilai di bidang khusus. Misalnya, jika Bidang Kustom "City" ada dan satu kontak memiliki nilai "New York", pengiriman $contact.city akan digantikan oleh New York.

Variabel Sistem

Variabel	Deskripsi
$system.current_datetime	Diganti dengan tanggal dan waktu saat ini di zona waktu Ruang Kerja. Format: YYYY-MM-DD hh:mm:ss (misalnya 2023-01-10 09:15:27)
$system.current_date	Diganti dengan tanggal saat ini di zona waktu ruang kerja. Format: YYYY-MM-DD (misalnya 2023-01-10)
$system.current_time	Diganti dengan waktu saat ini di zona waktu ruang kerja. Format: hh:mm:ss (misalnya 09:15:27)

Variabel Penerima Tugas

Variabel	Deskripsi
$assignee.id	Digantikan oleh ID pengguna penerima tugas untuk Kontak.
$assignee.name	Diganti dengan nama lengkap penerima tugas untuk Kontak (Nama Depan + Nama Belakang).
$assignee.email	Diganti dengan email penerima tugas untuk Kontak.
$assignee.firstname	Diganti dengan nama depan penerima tugas untuk kontak.
$assignee.lastname	Diganti dengan nama belakang penerima tugas untuk kontak.
$assignee.team	Diganti dengan nama tim penerima tugas.

Variabel Pemicu Alur Kerja

Variabel pemicu adalah variabel yang terikat pada pemicu Alur Kerja. Mereka hanya tersedia ketika pemicu tertentu digunakan untuk Alur Kerja.

Variabel pemicu untuk peristiwa "Percakapan Terbuka"

Variabel	Deskripsi
$conversation.opened_timestamp	Tanggal dan waktu saat percakapan dibuka. Format: YYYY-MM-DD hh:mm:ss (misalnya 2023-11-10 09:15:27)
$conversation.opened_by_source	Sumber (misalnya Kontak, Pengguna, Alur Kerja, Zapier, API, Make) yang memicu percakapan.
$conversation.opened_by_channel	ID saluran yang memicu percakapan dibuka.
$conversation.contact_type	Jenis Kontak (Kontak Baru atau Kontak yang Kembali) dari percakapan.
$conversation.first_incoming_message	Pesan masuk pertama dalam percakapan setelah percakapan dibuka.
$conversation.first_incoming_message_channel_id	ID saluran dari pesan masuk pertama dalam percakapan setelah percakapan dibuka

Variabel pemicu untuk peristiwa "Percakapan Ditutup"

Variabel	Deskripsi
$conversation.opened_timestamp	Tanggal dan waktu saat percakapan dibuka. Format: YYYY-MM-DD hh:mm:ss (misalnya 2023-11-10 09:15:27)
$conversation.opened_by_source	Sumber (misalnya Kontak, Pengguna, Alur Kerja, Zapier, API, Make) yang memicu percakapan dibuka.
$conversation.opened_by_channel	ID saluran yang memicu percakapan dibuka.
$conversation.closed_time	Tanggal dan waktu saat percakapan ditutup. Format: YYYY-MM-DD hh:mm:ss (misalnya 2023-11-10 09:15:27)
$conversation.closed_by_source	Sumber (misalnya Kontak, Pengguna, Alur Kerja, Zapier, API, Make) yang memicu percakapan ditutup.
$conversation.closed_by	ID pengguna dari pengguna yang menutup percakapan. Jika percakapan ditutup oleh bot, alur kerja atau API, kolom ini akan kosong.
$conversation.closed_by_team	ID tim pengguna yang menutup percakapan.
$conversation.contact_type	Jenis Kontak (Kontak Baru atau Kontak yang Kembali) dari percakapan.
$conversation.assignee_team	Nama tim pengguna yang menugaskan percakapan.
$conversation.first_assignment_timestamp	Tanggal dan waktu saat percakapan pertama kali ditetapkan. Format: YYYY-MM-DD hh:mm:ss (misalnya 2023-11-10 09:15:27)
$conversation.first_assignee	ID pengguna penerima tugas pertama.
$conversation.first_response_time	Waktu yang dibutuhkan untuk memberikan respons pertama sejak percakapan dibuka. Tidak ada nilai yang ditampilkan jika salah satu hal berikut terjadi: - percakapan ditutup tanpa respons apa pun. - jika respons pertama diberikan oleh API atau Kontak telah ditetapkan kepada pengguna sebelumnya, lalu percakapan dibuka oleh agen. Format: YYYY-MM-DD hh:mm:ss (misalnya 2023-11-10 09:15:27)
$conversation.first_response_by	ID pengguna dari pengguna yang memberikan respons pertama.
$conversation.last_assignment_timestamp	Tanggal dan waktu saat percakapan terakhir kali ditetapkan. Tidak ada nilai yang ditampilkan jika salah satu hal berikut terjadi: - percakapan ditutup tanpa penerima tugas. - tidak ada penugasan yang terjadi dalam percakapan, misalnya percakapan ditugaskan kepada pengguna sebelum percakapan dibuka. Format: YYYY-MM-DD hh:mm:ss (misalnya 2023-11-10 09:15:27)
$conversation.last_assignee	ID pengguna penerima terakhir.
$conversation.time_to_first_assignment	Waktu yang dibutuhkan untuk pertama kali menetapkan percakapan ke pengguna pertama. Format: hh:mm:ss (misalnya 00:19:08)
$conversation.first_assignment_to_first_response_time	Waktu yang dibutuhkan untuk memberikan respons pertama sejak percakapan pertama kali ditugaskan. Format: hh:mm:ss (misalnya 00:19:08)
$conversation.last_assignment_to_response_time	Waktu yang dibutuhkan untuk memberikan respons pertama oleh penerima tugas terakhir sejak percakapan terakhir ditugaskan. Format: hh:mm:ss (misalnya 00:19:08)
$conversation.resolution_time	Waktu yang dibutuhkan untuk menyelesaikan percakapan sejak percakapan dibuka. Format: hh:mm:ss (misalnya 00:19:08)
$conversation.first_assignment_to_close_time	Waktu yang dibutuhkan untuk menyelesaikan percakapan sejak percakapan pertama kali ditugaskan. Format: hh:mm:ss (misalnya 00:19:08)
$conversation.last_assignment_to_close_time	Waktu yang dibutuhkan untuk menyelesaikan percakapan sejak percakapan terakhir kali ditetapkan. Format: hh:mm:ss (misalnya 00:19:08)
$conversation.average_response_time	Rata-rata waktu yang dibutuhkan untuk memberikan tanggapan pada Kontak. Format: hh:mm:ss (misalnya 00:19:08)
$conversation.assignments_count	Jumlah penugasan dalam percakapan.
$conversation.incoming_messages_count	Jumlah pesan masuk yang diterima selama percakapan.
$conversation.outgoing_messages_count	Jumlah pesan keluar yang dikirim selama percakapan (tidak termasuk pesan siaran).
$conversation.responses_count	Jumlah tanggapan yang dikirim dalam percakapan.
$conversation.category	Kategori percakapan seperti yang ditentukan dalam catatan penutup.
$conversation.summary	Ringkasan catatan penutup percakapan.

Variabel pemicu untuk iklan Klik-Untuk-Obrolan

Nama Variabel	Deskripsi
$clicktochat.ad_timestamp	Stempel waktu saat pesan masuk diterima.
$clicktochat.ad_first_incoming_message	Pesan pertama dalam percakapan yang dihasilkan dari iklan Klik-Untuk-Obrolan.
$clicktochat.ad_channel_id	ID saluran tempat pesan iklan masuk diterima.
$clicktochat.ad_channel_type	Saluran tempat berlangsungnya percakapan terkait iklan.
$clicktochat.ad_contact_type	Jenis Kontak yang terkait dengan iklan: baru atau kembali
$clicktochat.ad_id	Nomor ID iklan CTC.
$clicktochat.ad_name	Nama iklan CTC.
$clicktochat.ad_campaign_id	Nomor ID kampanye iklan CTC.
$clicktochat.ad_campaign_name	Nama kampanye CTC.
$clicktochat.ad_adset_id	Nomor ID set iklan CTC.
$clicktochat.ad_adset_name	Nama set iklan CTC.
$clicktochat.ad_ad_url	URL iklan CTC.
$clicktochat.ad_reference	Referensi yang dikaitkan dengan iklan CTC.
$clicktochat.ad_status	Status iklan CTC.
$clicktochat.ad_objective	Tujuan iklan CTC.
$clicktochat.ad_optimization_goal	Sasaran pengoptimalan iklan CTC.
$clicktochat.ad_destination_type	Jenis tujuan yang dikaitkan dengan iklan CTC.

Variabel pemicu untuk peristiwa iklan pesan TikTok

Variabel	Deskripsi
$tiktokmessagingad.ad_timestamp	Waktu iklan diklik
$tiktokmessagingad.ad_first_incoming_message	Pesan pertama yang dikirim oleh Kontak
$tiktokmessagingad.ad_channel_id	ID saluran pesan
$tiktokmessagingad.ad_channel_type	Jenis saluran (misalnya TikTok)
$tiktokmessagingad.ad_contact_type	Tipe Kontak (misalnya baru atau sudah ada)
$tiktokmessagingad.ad_id	ID iklan
$tiktokmessagingad.ad_name	Nama iklan
$tiktokmessagingad.ad_campaign_id	ID Kampanye
$tiktokmessagingad.ad_campaign_name	Nama kampanye
$tiktokmessagingad.ad_adgroup_id	ID grup iklan
$tiktokmessagingad.ad_adgroup_name	Nama grup iklan
$tiktokmessagingad.ad_advertiser_id	ID Pengiklan
$tiktokmessagingad.ad_operation_status	Status operasi iklan
$tiktokmessagingad.ad_secondary_status	Status sekunder iklan

Jika bidang kontak standar memiliki nama yang sama dengan bidang kontak khusus, prioritas pengambilan data akan diberikan ke variabel kontak standar. Untuk pengambilan data yang benar, pastikan semua nama variabel unik.

Ikhtisar Variabel Dinamis