Formatmeldungen

Benutzerdefinierte Emojis in einer SMS verwenden

Chat-Apps können SMS mit benutzerdefinierten Emojis senden, um Nachrichten zu personalisieren. Benutzerdefinierte Emojis sind nur für Google Workspace-Organisationen verfügbar und der Administrator muss sie für die Organisation aktivieren. Weitere Informationen finden Sie unter Benutzerdefinierte Emojis in Google Chat und Berechtigungen für benutzerdefinierte Emojis verwalten.

Wenn Sie Nachrichten mit benutzerdefinierten Emojis erstellen möchten, muss Ihre App Nutzerauthentifizierung verwenden. Benutzerdefinierte Emojis werden nicht in Mitteilungen, die als Webhook erstellt wurden, oder in Mitteilungen, die mit der App-Authentifizierung erstellt wurden, unterstützt.

Wenn Sie dem Text einer Nachricht benutzerdefinierte Emojis hinzufügen möchten, geben Sie die name oder emoji_name der customEmoji-Ressource an:

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

Ersetzen Sie CUSTOM_EMOJI_ID durch die ID des benutzerdefinierten Emojis, um dieses Beispiel zu verwenden. Sie finden diese ID im Feld name oder emoji_name der customEmoji-Ressource.

Nutzer in einer SMS erwähnen

Chat-Apps können Textnachrichten senden, in denen ein oder alle Nutzer in einem Chatbereich mit @erwähnt werden. Wenn Sie Nutzer erwähnen möchten, die dem Gruppenbereich noch nicht beigetreten sind, oder einen Gruppenbereich im Importmodus, müssen Chat-Apps die Nachricht mit Nutzerauthentifizierung senden.

Bestimmte Nutzer mit @erwähnen

Wenn Sie einen bestimmten Nutzer mit @erwähnen möchten, fügen Sie der SMS <users/{user}> hinzu. Dabei ist {user} die ID des Nutzers. Betrachten Sie beispielsweise die folgende SMS, in der 123456789012345678901 die ID für den Nutzer Mahan S. darstellt:

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

Die SMS sieht so aus:

Sie können den users/{user}-Wert auf folgende Weise angeben:

• Wenn Ihre Google Chat App auf eine vom Nutzer gesendete Nachricht antwortet, können Sie das Feld message.sender.name des MESSAGE-Interaktionsereignisses verwenden.

• Wenn Ihre Google Chat App eine asynchrone SMS erstellt, können Sie den Wert für users/{user} auf folgende Weise angeben:

  • Verwenden Sie das Feld name der Google Chat-Ressource User, z. B. users/123456789012345678901.
  • Verwenden Sie die E-Mail-Adresse des Nutzers als Alias für den {user}-Wert. Wenn die E-Mail-Adresse beispielsweise mahan@example.com lautet, können Sie den Nutzer als users/mahan@example.com angeben. Wenn Sie einen E‑Mail-Alias verwenden möchten, muss Ihre Google Chat App als Nutzer authentifiziert werden.

• Wenn Sie die People API verwenden, können Sie auch die Methode people.get verwenden, um die Nutzer-ID zu ermitteln.

Alle Nutzer erwähnen

Wenn Sie eine SMS erstellen möchten, in der alle Personen in einem Gruppenbereich erwähnt werden, ersetzen Sie {user} durch all. Im folgenden JSON-Beispiel werden alle Nutzer in einer Nachricht erwähnt:

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

Text auf Karten formatieren

In Karten wird in den meisten Textfeldern die grundlegende Textformatierung mithilfe einer kleinen Teilmenge von HTML-Tags unterstützt. Sie formatieren Text in Kartenmitteilungen anders als in Textnachrichten, da Textnachrichten mit derselben Syntax formatiert werden, die Chat-Nutzer verwenden.

Mit dem Card Builder können Sie Nachrichten und Benutzeroberflächen für Chat-Apps entwerfen und in der Vorschau ansehen:

Absatztext formatieren

Die unterstützten Tags und ihr Zweck sind in der folgenden Tabelle aufgeführt:

Außerdem können Sie die Markdown-Syntax sowie die folgenden Tags verwenden:

This is a code block.

Im Feld Textsyntax können Sie die Syntax auswählen, die beim Formatieren des Inhalts eines Textabsatzes verwendet werden soll.

Text Symbole hinzufügen

Wenn Sie Symbole neben Text auf einer Karte anzeigen möchten, können Sie die Widgets DecoratedText und ButtonList verwenden.

In den folgenden Abschnitten wird erläutert, wie Sie integrierte Symbole, Google Material-Symbole oder benutzerdefinierte Symbole in formatiertem Text oder Schaltflächen verwenden.

Symbole aus Google Chat verwenden

Wenn Sie ein in Chat verfügbares integriertes Symbol verwenden möchten, geben Sie eines der folgenden Elemente an:

In der folgenden Tabelle sind die integrierten Symbole aufgeführt, die für Kartenmitteilungen verfügbar sind:

Hier ein Beispiel für eine Karte mit einem E‑Mail-Symbol:

Google Material-Symbole verwenden

Sie können Google Material-Symbole verwenden, um aus über 2.500 Symboloptionen auszuwählen und die Stärke, Füllung und den Grad der Symbole anzupassen.

Hier sehen Sie ein Beispiel für eine Karte mit einem Google Material-Symbol:

Benutzerdefinierte Symbole verwenden

Wenn Sie ein benutzerdefiniertes Symbol hinzufügen möchten, fügen Sie das Feld iconUrl ein und geben Sie die entsprechende URL des Symbols an.

Hier ein Beispiel für ein benutzerdefiniertes Symbol: