Memformat pesan

Halaman ini menjelaskan cara aplikasi Google Chat memformat teks untuk mengirim pesan yang berisi salah satu hal berikut:

• Teks kaya yang berisi hyperlink atau @sebutan satu atau semua pengguna di ruang Chat.
• Teks yang muncul di antarmuka kartu, termasuk sebagai teks paragraf atau teks UI yang ditampilkan bersama ikon, seperti tombol.

Memformat pesan teks

Chat memungkinkan Anda menambahkan pemformatan dasar ke pesan teks, termasuk tebal, miring, dan coretan, dengan menggunakan sebagian kecil sintaksis Markdown. Anda memformat teks secara berbeda dalam pesan teks dan pesan kartu karena pesan teks diformat dengan sintaksis yang sama dengan yang digunakan pengguna Chat.

Untuk memformat pesan teks, gunakan sintaksis berikut:

Misalnya, pertimbangkan JSON berikut:

    {
      "text": "Your pizza delivery *has arrived*!\nThank you for using _Cymbal Pizza!_"
    }

Pesan teks yang diformat ini menampilkan hal berikut di ruang Chat:

Melihat pemformatan teks yang dikirim dalam pesan

Saat pengguna mengirim pesan, isi pesan teks biasa ada di kolom text. Beberapa pemformatan yang diterapkan ke pesan teks menggunakan sintaksis Markdown, ada di kolom text. Pemformatan tambahan ada di kolom formattedText hanya output, termasuk yang berikut:

• Sintaks Markdown tambahan untuk teks
• Sebutan pengguna
• Hyperlink kustom
• Emoji kustom

Misalnya, pertimbangkan teks berikut yang dikirim oleh pengguna:

Jika pesan diformat menggunakan menu Format di UI Chat, kolom text hanya berisi teks, sedangkan kolom formattedText berisi markup, teks, dan hyperlink. Contoh berikut menunjukkan draf pesan teks dengan satu kata yang diberi hyperlink, item dalam daftar, dan satu kata yang ditebalkan:

Pesan diterima dalam format berikut:

    {
      "text": "I can meet there at:\nNoon\n3 pm\n5 pm\nWhat time works for you?",
      "formattedText": "I can meet <http://example.com|there> at:\n* Noon\n* 3 pm\n* 5 pm\nWhat time works for *you*?",
    }

Memformat link

Jika Anda menyertakan URL link biasa dalam teks pesan, seperti http://www.example.com/, Google Chat akan menggunakan URL ini sebagai teks link dan secara otomatis membuat hyperlink teks tersebut ke URL yang ditentukan.

Untuk memberikan teks link alternatif bagi link Anda, gunakan sintaksis berikut:

Teks link dan tanda hubung bersifat opsional, sehingga <https://www.example.com/> dan https://www.example.com/ setara.

Menggunakan emoji kustom dalam pesan teks

Aplikasi chat dapat mengirim pesan teks dengan emoji kustom untuk mempersonalisasi pesan. Emoji kustom hanya tersedia untuk organisasi Google Workspace, dan administrator harus mengaktifkan emoji kustom untuk organisasi tersebut. Untuk mengetahui informasi selengkapnya, lihat Mempelajari emoji kustom di Google Chat dan Mengelola izin emoji kustom.

Untuk membuat pesan dengan emoji kustom, aplikasi Anda harus menggunakan autentikasi pengguna. Emoji kustom tidak didukung dalam pesan yang dibuat sebagai webhook atau dalam pesan yang dibuat dengan autentikasi aplikasi.

Untuk menambahkan emoji kustom ke teks pesan, tentukan name atau emoji_name resource customEmoji:

{
    "text": "Hello <customEmojis/CUSTOM_EMOJI_ID>."
}

Untuk menggunakan contoh ini, ganti CUSTOM_EMOJI_ID dengan ID untuk emoji kustom. Anda dapat menemukan ID ini di kolom name atau emoji_name dari resource customEmoji.

Menyebut pengguna dalam pesan teks

Aplikasi Chat dapat mengirim pesan teks yang @menyebut satu atau semua pengguna dalam ruang Chat. Untuk menyebut pengguna yang belum bergabung ke ruang atau ruang yang dalam mode impor, aplikasi Chat harus mengirim pesan dengan autentikasi pengguna.

@sebut pengguna tertentu

Untuk @menyebut pengguna tertentu, tambahkan <users/{user}> ke pesan teks dengan {user} adalah ID pengguna. Misalnya, pertimbangkan pesan teks berikut dengan 123456789012345678901 mewakili ID untuk pengguna Mahan S.:

{
    "text": "A customer has reported an issue. Assigning ticket #942 to <users/123456789012345678901>."
}

Pesan teks ditampilkan sebagai berikut:

Anda dapat menentukan nilai users/{user} dengan cara berikut:

• Jika aplikasi Google Chat Anda merespons pesan yang dikirim oleh pengguna, Anda dapat menggunakan kolom message.sender.name dari peristiwa interaksi MESSAGE.

• Jika aplikasi Google Chat Anda membuat pesan teks asinkron, Anda dapat menentukan nilai untuk users/{user} dengan cara berikut:

  • Gunakan kolom name dari resource Google Chat User, seperti users/123456789012345678901.
  • Gunakan alamat email pengguna sebagai alias untuk nilai {user}. Misalnya, jika alamat emailnya adalah mahan@example.com, Anda dapat menentukan pengguna sebagai users/mahan@example.com. Untuk menggunakan alias email, aplikasi Google Chat Anda harus mengautentikasi sebagai pengguna.

• Jika menggunakan People API, Anda juga dapat menggunakan metode people.get untuk mengidentifikasi ID pengguna.

@sebut semua pengguna

Untuk membuat pesan teks yang @menyebut semua orang dalam ruang, ganti {user} dengan all. Contoh JSON berikut menyebutkan semua pengguna dalam pesan:

{
    "text": "Important message for <users/all>: Code freeze starts at midnight tonight!"
}

Memformat teks yang muncul di kartu

Di dalam kartu, sebagian besar kolom teks mendukung pemformatan teks dasar dengan menggunakan subkumpulan kecil tag HTML. Anda memformat teks secara berbeda dalam pesan kartu daripada dalam pesan teks karena pesan teks diformat dengan sintaksis yang sama dengan yang digunakan pengguna Chat.

Gunakan Pembuat Kartu untuk mendesain dan melihat pratinjau pesan dan antarmuka pengguna untuk aplikasi Chat:

Memformat teks paragraf

Tag yang didukung dan tujuannya ditampilkan dalam tabel berikut:

Selain itu, sintaks Markdown dapat digunakan bersama dengan tag berikut:

This is a code block.

Untuk memilih sintaksis yang akan digunakan saat memformat konten paragraf teks, gunakan kolom Sintaksis teks.

Menambahkan ikon ke teks

Untuk menampilkan ikon bersama teks dalam kartu, Anda dapat menggunakan widget DecoratedText dan ButtonList.

Bagian berikut menjelaskan cara menggunakan ikon bawaan, ikon Google Material, atau ikon kustom dalam teks atau tombol yang dihias.

Menggunakan ikon dari Chat

Untuk menggunakan ikon bawaan yang tersedia di Chat, tentukan salah satu opsi berikut:

Tabel berikut mencantumkan ikon bawaan yang tersedia untuk pesan kartu:

Berikut adalah contoh kartu dengan ikon email:

Menggunakan ikon Material Google

Anda dapat menggunakan ikon Material Google untuk memilih dari lebih dari 2.500 opsi ikon dan menyesuaikan ketebalan, pengisian, dan tingkat ikon.

Berikut adalah contoh kartu dengan ikon Material Google:

Menggunakan ikon kustom

Untuk menambahkan ikon kustom, sertakan kolom iconUrl dan tentukan URL yang sesuai untuk ikon.

Berikut adalah contoh ikon kustom: