Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Fügen Sie interaktive Amazon Lex-Nachrichten für Kunden im Chat hinzu
Interaktive Nachrichten sind umfangreiche Nachrichten, die eine Aufforderung und vorkonfigurierte Anzeigeoptionen enthalten, aus denen der Kunde wählen kann. Diese Nachrichten werden von Amazon Lex bereitgestellt und über Amazon Lex mithilfe eines Lambda konfiguriert.
Tipp
Wenn Sie Apple Messages for Business integriert haben, finden Sie weitere Informationen unter Interaktive Nachrichtentypen
Gültigkeitsbeschränkungen
Es wird erwartet, dass die Grenzwerte für Zeichenfolgefelder (z. B. Titel, Untertitel usw.) vom Client durchgesetzt werden (d. h. von einer benutzerdefinierten Oberfläche oder dem gehosteten Kommunikations-Widget). Es wird nur SendMessageAPIgeprüft, ob die Gesamtgröße der Zeichenfolge weniger als 20 KB beträgt.
-
Wenn Sie das gehostete Kommunikations-Widget verwenden, ohne es anzupassen, und die Zeichenfolge die Feldgrenzen überschreitet, wird sie auf der Benutzeroberfläche gekürzt und ein Auslassungszeichen (...) wird angehängt. Sie können festlegen, wie Feldbeschränkungen durchgesetzt werden, indem Sie das Widget anpassen.
-
Wenn Sie die Integration mit anderen Plattformen (wie Apple Messages for Business) durchführen, lesen Sie sich die Beschränkungen in diesem Thema für Amazon Connect und die Grenzwerte in der Dokumentation für die andere Plattform durch. Beispielsweise werden Schnellantworten auf älteren Versionen von iOS nicht unterstützt.
Alle anderen Feldgrenzen müssen eingehalten werden, damit die Nachricht erfolgreich gesendet werden kann.
Vorlagen für die Anzeige von Nachrichten
Amazon Connect bietet die folgenden Vorlagen für die Nachrichtenanzeige, die Sie verwenden können, um Kunden in einem Chat Informationen zur Verfügung zu stellen:
Diese Vorlagen definieren, wie die Informationen gerendert werden und welche Informationen in der Chat-Oberfläche angezeigt werden. Wenn interaktive Nachrichten über den Chat gesendet werden, überprüfen Flows, ob das Nachrichtenformat einer dieser Vorlagen entspricht.
Listen-Picker-Vorlage
Verwenden Sie die Vorlage für die Listenauswahl, um dem Kunden eine Liste mit bis zu sechs Auswahlmöglichkeiten zu präsentieren. Jede Auswahl kann ein eigenes Bild haben.
Die folgenden Bilder zeigen zwei Beispiele dafür, wie die Vorlage für die Listenauswahl Informationen in einem Chat wiedergibt.
-
Ein Bild zeigt drei Schaltflächen, jede mit dem Namen einer Frucht im Text: Apfel, Orange, Banane.
-
Das zweite Bild zeigt ein Bild eines Ladens und darunter drei Schaltflächen, jeweils mit dem Namen, dem Bild und dem Preis der Frucht.
Der folgende Code ist die Listenauswahlvorlage, die Sie in Ihrem Lambda verwenden können. Beachten Sie Folgendes:
-
Fettgedruckter Text ist ein obligatorischer Parameter.
-
In einigen Fällen, wenn das übergeordnete Element in der Anfrage vorhanden ist und es nicht obligatorisch/fett gedruckt ist, die Felder darin aber schon, dann sind die Felder Pflichtfelder. Sehen Sie sich zum Beispiel die
data.replyMessage
-Struktur in der folgenden Vorlage an. Wenn die Struktur vorhanden ist, ist der Titel erforderlich. Andernfalls istreplyMessage
komplett optional.
{ "templateType":"ListPicker", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting!", "subtitle":"Produce selected", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg", "imageDescription":"Select a produce to buy" }, "content":{ "title":"What produce would you like to buy?", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg", "imageDescription":"Select a produce to buy", "elements":[ { "title":"Apple", "subtitle":"$1.00", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg" }, { "title":"Orange", "subtitle":"$1.50", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/orange_17.7kb.jpg", }, { "title":"Banana", "subtitle":"$10.00", "imageType":"URL", "imageData":"https://interactive-message-testing.s3-us-west-2.amazonaws.com/banana_7.9kb.jpg", "imageDescription":"Banana" } ] }
Limits für die Auswahl auflisten
In der folgenden Tabelle sind die Grenzwerte für jedes der Listenauswahlelemente aufgeführt, falls Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
Um unbegrenzt viele Optionen zu senden, implementieren Sie Aktionsschaltflächen in Ihrer Anwendung. Weitere Informationen finden Sie unter Implementation of action buttons in interactive message list picker/panel
Übergeordnetes Feld | Feld | Erforderlich | Erforderliche Mindestanzahl | Maximale Zeichen | Weitere Voraussetzungen |
---|---|---|---|---|---|
templateType |
Ja |
Gültiger Vorlagentyp |
|||
data |
Ja |
||||
Version |
Ja |
Muss „1.0“ sein. |
|||
data |
Inhalt | Ja | |||
replyMessage | Nein | ||||
Inhalt |
Titel | Ja | 1 |
400 |
Sollte eine Beschreibung für Vorlagen ohne Eingabeaufforderung sein |
Elemente | Ja | 1 Element |
10 artikel |
Dies ist eine Reihe von Elementen. Maximal 10 Elemente im Array. Verwenden Sie die Funktion „Aktionsschaltflächen“, um unbegrenzt viele Elemente zu senden. |
|
Untertitel | Nein | 0 |
400 |
||
imageType | Nein | 0 |
50 |
Muss "URL“ sein |
|
imageData | Nein | 0 |
200 |
Muss eine gültige, öffentlich zugängliche Datei sein URL |
|
imageDescription | Nein | 0 |
50 |
||
referenceId | Nein |
|
Zeichenfolge. Nur für die Action-Button-Funktion erforderlich. |
||
listId | Nein |
|
Zeichenfolge. Nur für die Action-Button-Funktion erforderlich. |
||
preIndex | Nein |
|
Zahl. Nur für die Action-Button-Funktion erforderlich. |
||
nextIndex | Nein |
|
Zahl. Nur für die Action-Button-Funktion erforderlich. |
||
templateIdentifier | Nein |
|
Zahl. Sollte ein seinUUID. Dieses Feld ist erforderlich, wenn Listenauswahl/Panel in einem Karussell verwendet wird. |
||
Elemente |
Titel | Ja | 1 |
400 |
|
Untertitel | Nein | 0 |
400 |
||
imageType | Nein | 0 |
50 |
Muss "URL“ sein |
|
imageData | Nein | 0 |
200 |
Muss eine gültige, öffentlich zugängliche Datei sein URL |
|
imageDescription | Nein | 0 |
50 |
Kann ohne ein Bild nicht existieren |
|
actionDetail | Nein |
|
|
Nur für die Action-Button-Funktion erforderlich. Muss "PREVIOUS_OPTIONS" oder "SHOW_MORE“ sein. |
|
replyMessage |
Titel | Ja | 1 |
400 |
|
Untertitel | Nein | 0 |
400 |
||
imageType | Nein | 0 |
50 |
Muss "URL“ sein |
|
imageData | Nein | 0 |
200 |
Muss eine gültige, öffentlich zugängliche Datei sein URL |
|
imageDescription | Nein | 0 |
50 |
Kann ohne ein Bild nicht existieren |
Vorlage für die Zeitauswahl
Die Vorlage für die Zeitauswahl ist nützlich, damit Kunden Termine planen können. Sie können dem Kunden in einem Chat bis zu 40 Zeitfenster zur Verfügung stellen.
Die folgenden Bilder zeigen zwei Beispiele dafür, wie die Vorlage für die Zeitauswahl Informationen in einem Chat wiedergibt.
-
Ein Bild zeigt ein Datum und darunter ein Zeitfenster.
-
Das zweite Bild zeigt ein Datum und darunter zwei Zeitfenster.
Das folgende Bild zeigt den Zeitwähler mit einem Bild
Anmerkung
Wenn Sie diese Nachrichtenvorlage mit dem Apple Messages for Business-Kanal verwenden und kein Bild hinzufügen, fügt Amazon Connect sowohl in der Antwort als auch in der Antwortnachricht ein Standardbild hinzu.
Der folgende Code ist die Zeitauswahlvorlage, die Sie in Ihrem Lambda verwenden können. Beachten Sie Folgendes:
-
Fettgedruckter Text ist ein obligatorischer Parameter.
-
In einigen Fällen, wenn das übergeordnete Element in der Anfrage vorhanden ist und es nicht obligatorisch/fett gedruckt ist, die Felder darin aber schon, dann sind die Felder Pflichtfelder. Sehen Sie sich zum Beispiel die
data.replyMessage
-Struktur in der folgenden Vorlage an. Wenn die Struktur vorhanden ist, ist der Titel erforderlich. Andernfalls istreplyMessage
komplett optional.
{ "templateType":"TimePicker", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting", "subtitle":"Appointment selected", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/booked.jpg", "imageDescription":"Appointment booked" }, "content":{ "title":"Schedule appointment", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/calendar.jpg", "imageDescription":"Appointment booked", "timeZoneOffset":-450, "location":{ "latitude":47.616299, "longitude":-122.4311, "title":"Oscar", "radius":1, }, "timeslots":[ { "date" : "2020-10-31T17:00+00:00", "duration": 60, }, { "date" : "2020-11-15T13:00+00:00", "duration": 60, }, { "date" : "2020-11-15T16:00+00:00", "duration": 60, } ], } } } }
Limits für die Zeitauswahl
In der folgenden Tabelle sind die Grenzwerte für jedes der Time-Picker-Elemente aufgeführt. Verwenden Sie diese Informationen, wenn Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
Übergeordnetes Feld | Feld | Erforderlich | Erforderliche Mindestanzahl | Maximale Zeichen | Weitere Voraussetzungen |
---|---|---|---|---|---|
templateType |
Ja |
Gültiger Vorlagentyp |
|||
data |
Ja |
||||
Version |
Ja |
Muss „1.0“ sein. |
|||
data |
replyMessage | Nein | |||
Inhalt | Ja | ||||
replyMessage |
Titel |
Ja | 1 |
400 |
Sollte eine Beschreibung für Vorlagen ohne Eingabeaufforderung sein |
Untertitel | Nein | 0 |
400 |
||
imageType | Nein | 0 |
50 |
Muss "“ URL sein | |
imageData | Nein | 0 |
200 |
Muss eine gültige, öffentlich zugängliche Datei sein URL | |
imageDescription | Nein | 0 |
50 |
Kann ohne ein Bild nicht existieren | |
Inhalt |
Titel |
Ja | 1 |
400 |
Sollte eine Beschreibung für Vorlagen ohne Eingabeaufforderung sein |
Untertitel | Nein | 0 |
200 |
||
imageType | Nein | 0 |
50 |
Muss "URL“ sein | |
imageData | Nein | 0 |
200 |
Muss eine gültige, öffentlich zugängliche Datei sein URL | |
imageDescription | Nein | 0 |
50 |
Kann ohne ein Bild nicht existieren | |
Zeitzonen-Versatz | Nein | -720 |
840 |
Dies ist ein optionales Feld, wenn es nicht gesetzt ist. Unser Beispielclient verwendet standardmäßig die Zeitzone des Benutzers. Wenn diese Option gesetzt ist, wird dies gemäß der eingegebenen Zeitzone angezeigt. Das Feld sollte eine Ganzzahl sein, die die Anzahl der Minuten vor dem Ereignis angibt und die Zeitzone angibtGMT, in der sich der Ort des Ereignisses befindet. |
|
location | Nein | ||||
Zeitfenster | Ja | 1 |
40 |
Dies ist eine Reihe von Zeitfenstern. Maximal 40 Elemente im Array. |
|
location |
Längengrad | Ja | -180 |
180 |
Muss doppelt |
Breitengrand | Ja | -90 |
90 |
Muss doppelt |
|
Titel | Ja | 1 |
400 |
||
radius |
Nein | 0 |
200 |
||
Zeitfenster |
date | Ja |
|
Sollte das Zeitformat ISO -8601 haben: .MM+00.00 YYYY-MM-DDTHH Beispielsweise: „2020-08-14T21:21+00.00“ |
|
duration | Ja | 1 |
3600 |
Panel-Vorlage
Mithilfe der Panel-Vorlage können Sie dem Kunden unter einer Frage bis zu 10 Auswahlmöglichkeiten anbieten. Sie können jedoch nur ein Bild und nicht jeder Auswahl ein Bild hinzufügen.
Die folgende Abbildung zeigt ein Beispiel dafür, wie die Panel-Vorlage Informationen in einem Chat wiedergibt. Es zeigt ein Bild oben in der Nachricht und unter dem Bild wird eine Aufforderung angezeigt, in der gefragt wird, wie kann ich helfen? Tippen Sie, um eine Option auszuwählen. Nach der Aufforderung werden dem Kunden drei Optionen angezeigt: Check self-service options, Talk to an agent, End chat.
Der folgende Code ist die Panel-Vorlage, die Sie in Ihrem Lambda verwenden können. Beachten Sie Folgendes:
-
Fettgedruckter Text ist ein obligatorischer Parameter.
-
In einigen Fällen, wenn das übergeordnete Element in der Anfrage vorhanden ist und es nicht obligatorisch/fett gedruckt ist, die Felder darin aber schon, dann sind die Felder Pflichtfelder. Sehen Sie sich zum Beispiel die
data.replyMessage
-Struktur in der folgenden Vorlage an. Wenn die Struktur vorhanden ist, ist der Titel erforderlich. Andernfalls istreplyMessage
komplett optional.
{ "templateType":"Panel", "version":"1.0", "data":{ "replyMessage":{ "title":"Thanks for selecting!", "subtitle":"Option selected", }, "content":{ "title":"How can I help you?", "subtitle":"Tap to select option", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/company.jpg", "imageDescription":"Select an option", "elements":[ { "title":"Check self-service options", }, { "title":"Talk to an agent", }, { "title":"End chat", } ] } } }
Grenzwerte für das Panel
In der folgenden Tabelle sind die Grenzwerte für jedes der Panel-Elemente aufgeführt, falls Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
Um unbegrenzt viele Optionen zu senden, implementieren Sie Aktionsschaltflächen in Ihrer Anwendung. Weitere Informationen finden Sie unter Implementation of action buttons in interactive message list picker/panel
Übergeordnetes Feld | Feld | Erforderlich | Erforderliche Mindestanzahl | Maximale Zeichen | Weitere Voraussetzungen |
---|---|---|---|---|---|
templateType |
Ja |
Gültiger Vorlagentyp |
|||
data |
Ja |
||||
Version |
Ja |
Muss „1.0“ sein. |
|||
data |
replyMessage | Nein | |||
Inhalt | Ja | ||||
Inhalt |
Titel | Ja | 1 |
400 |
Sollte eine Beschreibung für Vorlagen ohne Eingabeaufforderung sein |
Untertitel | Nein | 0 |
400 |
||
Elemente | Ja | 1 Element |
10 artikel |
Dies ist eine Reihe von Elementen. Maximal 10 Elemente im Array. |
|
imageType | Nein | 0 |
50 |
URLMuss "“ sein |
|
imageData | Nein | 0 |
200 |
Muss eine gültige, öffentlich zugängliche Datei sein URL |
|
imageDescription | Nein | 0 |
50 |
Kann ohne ein Bild nicht existieren |
|
referenceId | Nein |
|
Zeichenfolge. Nur für die Action-Button-Funktion erforderlich. |
||
listId | Nein |
|
Zeichenfolge. Nur für die Action-Button-Funktion erforderlich. |
||
preIndex | Nein |
|
Zahl. Nur für die Action-Button-Funktion erforderlich. |
||
nextIndex | Nein |
|
Zahl. Nur für die Action-Button-Funktion erforderlich. |
||
templateIdentifier | Nein |
|
Zahl. Sollte ein seinUUID. Dieses Feld ist erforderlich, wenn Listenauswahl/Panel in einem Karussell verwendet wird. |
||
Elemente |
Titel | Ja | 1 |
400 |
|
actionDetail | Nein |
|
|
Nur für die Action-Button-Funktion erforderlich. Muss "PREVIOUS_OPTIONS" oder "SHOW_MORE“ sein. |
|
replyMessage |
Titel | Ja | 1 |
400 |
|
Untertitel | Nein | 0 |
400 |
Schnellantwort-Vorlage
Verwenden Sie Schnellantwortnachrichten, um einfache Antworten von Kunden und ihnen an Kunden in einer Inline-Liste zu erhalten. Sie können Kunden in einer Schnellantwortnachricht bis zu 5 Optionen anbieten. Bilder werden für Schnellantworten nicht unterstützt.
Die Schnellantwort-Vorlage zeigt in einem Beispiel, wie die Schnellantwort-Vorlage Informationen in einem Chat wiedergibt.
Der folgende Code ist die Schnellantwortvorlage, die Sie in Ihrem Lambda verwenden können.
{ "templateType": "QuickReply", "version": "1.0", "data": { "replyMessage": { "title": "Thanks for selecting!" }, "content": { "title": "Which department would you like?", "elements": [{ "title": "Billing" }, { "title": "Cancellation" }, { "title": "New Service" } ] } } }
Schnellantwort-Limits
In der folgenden Tabelle sind die Grenzwerte für jedes der Schnellantwortelemente aufgeführt. Verwenden Sie diese Informationen, wenn Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
Feld | Erforderlich | Erforderliche Mindestanzahl | Maximale Zeichen | Weitere Voraussetzungen |
---|---|---|---|---|
templateType |
Gültiger Vorlagentyp |
|||
data |
Ja |
|||
Version |
Ja |
Muss „1.0“ sein. |
||
Inhalt |
Ja | |||
Titel | Ja | 1 |
400 |
Sollte eine Beschreibung für Vorlagen ohne Eingabeaufforderung sein |
Elemente | Ja | 2 Elemente |
10 artikel |
Dies ist eine Reihe von Elementen. Mindestens 2 Elemente und maximal 10 Elemente im Array. |
Titel | Ja | 1 |
200 |
Karussell-Vorlage
Verwenden Sie Karussells, um Kunden bis zu 5 Listenauswahlfelder oder Panels in einer einzigen Nachricht anzuzeigen. Ähnlich wie bei der Listenauswahl und der Zeitauswahl können Sie dem Karussell mithilfe der Funktion _ weitere Optionen hinzufügen. SHOW MORE
Im Folgenden finden Sie GIF ein Beispiel dafür, wie die Karussellvorlage Informationen in einem Chat wiedergibt. Kunden scrollen mithilfe der Pfeiltasten nach links und rechts durch das Bilderkarussell.
Die folgende Abbildung zeigt zwei Hyperlinks für Learn More, bei denen es sich um Beispiele für Hyperlink-Elemente in der Karussellauswahl handelt.
Der folgende Code ist die Karussellvorlage, die Sie in Ihrem Lambda verwenden können.
{ "templateType": "Carousel", "version": "1.0", "data": { "content": { "title": "View our popular destinations", "elements": [ { "templateIdentifier": "template0", "templateType": "Panel", "version": "1.0", "data": { "content": { "title": "California", "subtitle": "Tap to select option", "elements": [ { "title": "Book flights" }, { "title": "Book hotels" }, { "title": "Talk to agent" } ] } } }, { "templateIdentifier": "template1", "templateType": "Panel", "version": "1.0", "data": { "content": { "title": "New York", "subtitle": "Tap to select option", "elements": [ { "title": "Book flights" }, { "title": "Book hotels" }, { "title": "Talk to agent" } ] } } } ] } } }
Für Benutzer des Widgets für gehostete Kommunikation:
-
Die Auswahlen in der Karussellvorlage führen zu einer JSON Zeichenkettenantwort, die wie im folgenden Beispiel strukturiert ist und an Lambda zurückgesendet wird (andere interaktive Nachrichtentypen geben eine reguläre Zeichenkettenantwort mit nur einem Wert zurück):
selectionText
{ templateIdentifier: "template0", listTitle: "California", selectionText: "Book hotels" }
-
In Karussells können Sie Hyperlinks in den Listenauswahl-/Bedienfeldelementen angeben. Um einen Hyperlink anstelle einer Schaltfläche zu erstellen, fügen Sie die folgenden zusätzlichen Felder für das Element hinzu, bei dem es sich um einen Hyperlink handeln soll:
{ title: "Book flights", ... type: "hyperlink", url: "https://www.example.com/Flights" }
Karussell-Limits
Die Limits für jedes Karussellelement sind in der folgenden Tabelle aufgeführt. Verwenden Sie diese Informationen, wenn Sie Ihr eigenes Lambda von Grund auf neu erstellen möchten. Die obligatorischen Parameter sind fett gedruckt.
Übergeordnetes Feld | Feld | Erforderlich | Erforderliche Mindestanzahl | Maximale Zeichen | Weitere Voraussetzungen |
---|---|---|---|---|---|
templateType |
Ja |
Gültiger Vorlagentyp |
|||
data |
Ja |
||||
Version |
Ja |
Muss „1.0“ sein. |
|||
data |
Inhalt | Ja | |||
Inhalt |
Titel | Ja | 1 |
400 |
Sollte eine Beschreibung für Vorlagen ohne Eingabeaufforderung sein |
Elemente | Ja | 2 Elemente |
5 artikel |
Dabei handelt es sich um eine Reihe von Vorlagen für die Listenauswahl oder für Bedienfelder. Pro Karussell wird nur ein interaktiver Nachrichtentyp akzeptiert. Jedes Element sollte das Feld der obersten Ebene enthalten. templateIdentifier Mindestens 2 Vorlagen und maximal 5 Vorlagen im Array. AnmerkungFür ein optimales Kundenerlebnis empfehlen wir, dass jede Vorlage einheitlich Bilder/Anzahl von Elementen verwendet. |
|
omitTitleFromCarouselResponse | Nein |
Boolean — Antworten Sie optional mit“ |
|||
carouselIsVertical | Nein |
Boolean – Rendern Sie optional Elemente mit vertikalem Scrollen. |
Apple-Formularvorlage
Anmerkung
Diese Vorlage gilt nur für Apple Messages for Business-Kontaktabläufe.
Ein Unternehmen kann seinen Endkunden eine interaktive Formularnachricht über eine einzige Nachricht senden, die mehrere Seiten mit angeforderten Eingaben enthält. Wenn die Nachricht auf dem Apple-Gerät eines Endkunden eingeht, kann dieser das Formular öffnen und durch die Seiten navigieren, wobei für jede Seite eine Antwort bereitgestellt wird, bevor alle Antworten am Ende des Formulars eingereicht werden.
Beispielsweise können Unternehmen Apple-Formulare für verschiedene Zwecke verwenden, z. B. für Auswahlverfahren, Kundenbefragungen und Kontoerstellung/-registrierung.
Warnung
Interaktive Nachrichteninhalte und Antworten von Endkunden werden im Transkript der Kontaktdatensätze gespeichert und können von anderen Chat-Teilnehmern und Kontaktanalysten mit Zugriff auf die Transkripte eingesehen werden. Um zu PII verhindern, dass sie nach Beendigung des Kontakts in Ihrem Kontaktdatensatz erscheinen, sollten Sie den Block Aufzeichnungs- und Analyseverhalten festlegen in Ihrem step-by-step Guide-Kontaktablauf verwenden, Kontaktlinsen aktivieren und die Schwärzung vertraulicher Daten aktivieren. Vollständige Informationen zur Aktivierung der Schwärzung finden Sie PII unter Schwärzung vertraulicher Daten aktivieren.
Folgende Seitentypen werden unterstützt:
-
ListPicker: eine Liste von Optionen, aus denen der Benutzer mit Bildunterstützung auswählen muss.
-
WheelPicker: Ähnlich wie, ListPicker aber die Auswahl erfolgt über ein scrollbares Optionsrad.
-
DatePicker: eine Kalenderansicht, in der der Benutzer ein Datum auswählen kann.
-
Eingabe: ein Textfeld, das der Benutzer ausfüllen muss.
Der folgende Code ist ein Beispiel für eine Apple-Formularvorlage, die Sie in Ihrem Lambda verwenden können.
Anmerkung
-
Fettgedruckter Text ist ein obligatorischer Parameter.
-
In einigen Fällen, wenn das übergeordnete Element in der Anfrage vorhanden ist und es nicht obligatorisch/fett gedruckt ist, die Felder darin aber schon, dann sind die Felder Pflichtfelder.
Einfaches Beispiel für ein Umfrageformular:
{ "templateType": "AppleForm", "version": "1.0", "data": { "content": { "title": "Survey", "pages": [ { "pageType": "DatePicker", "title": "Date you visited", "subtitle": "When did you last visit?", "minDate": "2024-01-02" }, { "pageType": "ListPicker", "title": "Rating", "subtitle": "How do you rate the experience?", "items": [ { "title": "Good", "imageType": "URL", "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/good.jpg" }, { "title": "Okay", "imageType": "URL", "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/okay.jpg" }, { "title": "Poor", "imageType": "URL", "imageData": "https://mybucket.s3.us-west-2.amazonaws.com/poor.jpg" } ] }, { "pageType": "ListPicker", "title": "Dine type", "subtitle": "Select all dine types that apply", "multiSelect": true, "items": [ { "title": "Pickup" }, { "title": "Dine-in" }, { "title": "Delivery" } ] }, { "pageType": "WheelPicker", "title": "Visits", "subtitle": "How often do you visit?", "items": [ { "title": "Often" } { "title": "Sometimes" }, { "title": "Rarely" } ] }, { "pageType": "Input", "title": "Additional notes", "subtitle": "Anything else you'd like to mention about your visit?", "multiLine": true } ] } } }
Einschränkungen bei Apple-Formularen
InteractiveMessage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
version | Zeichenfolge | Ja | Versionsnummer. Zulässiger Wert: „1.0" |
templateType | TemplateType | Ja | Interaktiver Nachrichtenvorlagentyp. Zulässige Werte: [“ ListPicker „," TimePicker „, „Panel“, "QuickReply„, „Carousel“, "ViewResource„," AppleForm„] |
data | InteractiveMessageData | Ja | Interaktive Nachrichtendaten |
InteractiveMessageData
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
Inhalt | InteractiveMessageContent | Ja | Wichtigster Inhalt der interaktiven Nachricht |
replyMessage | ReplyMessage | Nein | Konfiguration der Nachrichtenanzeige nach dem Senden einer Antwort auf eine interaktive Nachricht |
AppleFormContent
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
Titel | String | Ja | Titel des Formulars auf oberster Ebene. Wird in Apple in der Sprechblase für Empfangsnachrichten und beim Rendern von Transkripten angezeigt |
Untertitel | String | Nein | Wird als Untertitel verwendet in ReceivedMessage |
imageType | String | Nein | Gültige Werte: "URL" Wird für das Bild verwendet in ReceivedMessage |
imageData | String | Nein | S3-Bild-URL Wird für Bild in verwendet ReceivedMessage |
pages | AppleFormPage[] | Ja | Liste der Formularseiten |
showSummary | Boolesch | Nein | Ob eine Übersichtsseite mit Antworten angezeigt werden soll, die vor dem Absenden überprüft werden müssen. Standardeinstellung: Falsch (keine Bestätigungs-/Übersichtsseite) |
splashPage | AppleFormSplashPage | Nein | Erste Begrüßungsseite, die vor den eigentlichen Seiten angezeigt wird Standard: Keine Begrüßungsseite |
AppleFormSplashPage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
Titel | String | Ja | Titel der Splash-Seite |
Untertitel | String | Nein | Untertitel/Hauptteil der Splash-Seite |
imageType | ImageType | Nein | Wird angezeigt, wenn ein Bild auf der Splash-Seite angezeigt wird Zulässiger Wert: URL "" Standard: Kein Bild wird angezeigt |
imageData | String | Nein | Für imageType =“ URL „ist dies der URL Wert Standard: Kein Bild wird angezeigt |
buttonTitle | String | Ja | Text der Schaltfläche „Weiter“. Von Apple erforderlich, Standardtext mit Lokalisierung wird nicht unterstützt |
AppleFormPage
-
Basismodell für Formularseiten. Spezifische Seitentypen gehen von diesem Modell aus
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
pageType | ApplePageType | Ja | Aufzählung für Seitentyp. Zulässige Werte: ["Input“, "DatePicker„," WheelPicker „," ListPicker „] |
Titel | String | Ja | Seitentitel |
Untertitel | String | Ja | Untertitel der Seite. Wird auf der Bestätigungsseite verwendet |
AppleFormDatePickerPage
AppleFormDatePickerPageerweitert AppleFormPage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
pageType | ApplePageType | Ja | Wert: "DatePicker“ |
labelText | String | Nein | Text, der neben der Datumseingabe angezeigt wird. Beispiel-Screenshots finden Sie im Anhang |
helperText | String | Nein | Hilfstext, der unter der Datumseingabe angezeigt wird. Beispiel-Screenshots finden Sie im Anhang Standard: Kein Hilfstext |
dateFormat | String | Nein | ISO8601-Datumsformat. Standard: yyyy-MM-dd |
startDate | String | Nein | Anfängliches /standardmäßig ausgewähltes Datum im gültigen Datumsformat Standard: Aktuelles Datum für den Endbenutzer, an dem die Nachricht gesendet wird |
minDate | String | Nein | Das Mindestdatum darf im gültigen Datumsformat ausgewählt werden. Standard: Kein Mindestdatum |
maxDate | String | Nein | Maximales Datum, das im gültigen Datumsformat ausgewählt werden darf Standard: Aktuelles Datum für den Endbenutzer, an dem die Nachricht gesendet wird |
AppleFormListPickerPage
AppleFormListPickerPageerweitert AppleFormPage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
pageType | ApplePageType | Ja | Wert: "ListPicker“ |
multiSelect | Boolesch | Nein | Ermöglicht die Auswahl mehrerer Elemente Standard: falsch (Einzelauswahl) |
Elemente | AppleFormListPickerPageItem[] | Ja | Liste der Elemente auf der Listenseite |
AppleFormListPickerPageItem
AppleFormListPickerPageItemerweitert AppleFormPage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
Titel | String | Ja | Text des Artikels anzeigen |
imageType | ImageType | Nein | Wird angezeigt, wenn ein Bild innerhalb eines Elements angezeigt wird Zulässiger Wert: URL "" Standard: Es wird kein Bild angezeigt |
imageData | String | Nein | Für imageType =“ URL „ist dies der URL Wert Standard: Es wird kein Bild angezeigt |
Anmerkung
Ähnliches Bildmodell wie bestehende interaktive Nachrichtenmodelle (ListPicker), außer dass imageDescription
es nicht enthalten ist. Es wird für Bild-Alt-Text in Chat-Widgets/Web-Chats verwendet und für interaktive Apple-Nachrichten ignoriert.
AppleFormWheelPickerPage
AppleFormWheelPickerPageerweitert AppleFormPage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
pageType | ApplePageType | Ja | Wert: "WheelPicker“ |
Elemente | AppleFormWheelPickerPageItem[] | Ja | Liste der Wheelpicker-Artikel |
labelText | String | Nein | Text, der neben der Eingabe angezeigt wird. Beispiel-Screenshots finden Sie im Anhang |
AppleFormWheelPickerPageItem
AppleFormWheelPickerPageItemerweitert AppleFormPage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
Titel | String | Ja | Text des Auswahlelements anzeigen |
AppleFormInputPage
AppleFormInputPageerweitert AppleFormPage
Feld | Typ | Erforderlich | Beschreibung/Hinweise |
---|---|---|---|
pageType | ApplePageType | Ja | Wert: „Eingabe“ |
labelText | String | Nein | Text, der neben dem Eingabefeld angezeigt wird. Beispiel-Screenshots finden Sie im Anhang |
helperText | String | Nein | Zusätzlicher Text wird unter dem Eingabefeld angezeigt Standard: Kein Hilfstext |
placeholderText | String | Nein | Platzhaltertext, der anfänglich angezeigt wird, wenn keine Eingabe erfolgt. Standard: Platzhaltertext „(Optional)“ oder „(Erforderlich)“ |
prefixText | String | Nein | Präfixtext, der neben der Eingabe angezeigt werden soll. Beispiel: '$', wenn es sich bei der Eingabe um einen monetären Wert handelt. Standard: Kein Präfixtext |
Erforderlich | Boolesch | Nein | Gibt an, ob der Endbenutzer Eingaben machen muss Standard: false |
multiLine | Boolesch | Nein | Ob mehrzeilige Eingaben bereitgestellt werden können Standard: false (einzeilig) |
maxCharCount | Zahl | Nein | Max. Zeichenanzahl der Eingabe. Auf dem Apple-Client erzwungen. Standardeinstellung: Keine Begrenzung |
regex | String | Nein | Regex-Zeichenfolge, mit der Einschränkungen für die Eingabe festgelegt werden sollen. Standard: Keine Regex-Einschränkungen |
keyboardType | String | Nein | Legt fest, welcher Tastaturtyp angezeigt wird, wenn der Endbenutzer die Eingabe eingibt. Zulässige Werte: Wie bei Apple. Siehe Dokumente |
textContentType | String | Nein | Hilft bei Vorschlägen zum automatischen Ausfüllen auf Apple-Geräten. Zulässige Werte: Wie bei Apple. Siehe Dokumente |
Apple Pay-Vorlage
Anmerkung
Diese Vorlage gilt nur für Apple Messages for Business-Kontaktabläufe.
Verwende die Apple Pay-Vorlage, um Kunden eine einfache und sichere Möglichkeit zu bieten, Waren und Dienstleistungen über Apple Messages for Business mit Apple Pay zu kaufen.
Der folgende Code ist die Apple Pay-Vorlage, die Sie in Ihrem Lambda verwenden können:
Anmerkung
-
Fettgedruckter Text ist ein obligatorischer Parameter.
-
In einigen Fällen, wenn das übergeordnete Element in der Anfrage vorhanden ist und es nicht obligatorisch/fett gedruckt ist, die Felder darin aber schon, dann sind die Felder Pflichtfelder.
{ "templateType":"ApplePay", "version":"1.0", "data":{ "content":{ "title":"Halibut", "subtitle":"$63.99 at Sam's Fish", "imageType":"URL", "imageData":"https://interactive-msg.s3-us-west-2.amazonaws.com/fish.jpg", "payment": { "endpoints": { "orderTrackingUrl": "https://sams.example.com/orderTrackingUrl/", "paymentGatewayUrl": "https://sams.example.com/paymentGateway/", "paymentMethodUpdateUrl": "https://sams.example.com/paymentMethodUpdate/", "shippingContactUpdateUrl": "https://sams.example.com/shippingContactUpdate/", "shippingMethodUpdateUrl": "https://sams.example.com/shippingMethodUpdate/", "fallbackUrl": "https://sams.example.com/paymentGateway/" }, "merchantSession": { "epochTimestamp": 1525730094057, "expiresAt": 1525730094057, "merchantSessionIdentifier": "PSH40080EF4D6.........9NOE9FD", "nonce": "fe72cd0f", "merchantIdentifier": "merchant.com.sams.fish", "displayName": "Sam's Fish", "signature": "308006092a8.......09F0W8EGH00", "initiative": "messaging", "initiativeContext": "https://sams.example.com/paymentGateway/", "signedFields": [ "merchantIdentifier", "merchantSessionIdentifier", "initiative", "initiativeContext", "displayName", "nonce" ], }, "paymentRequest": { "applePay": { "merchantCapabilities": [ "supports3DS", "supportsDebit", "supportsCredit" ], "merchantIdentifier": "merchant.com.sams.fish", "supportedNetworks": [ "amex", "visa", "discover", "masterCard" ] }, "countryCode": "US", "currencyCode": "USD", "lineItems": [ { "amount": "59.00", "label": "Halibut", "type": "final" }, { "amount": "4.99", "label": "Shipping", "type": "final" } ], "requiredBillingContactFields": [ "postalAddress" ], "requiredShippingContactFields": [ "postalAddress", "phone", "email", "name" ], "shippingMethods": [ { "amount": "0.00", "detail": "Available within an hour", "identifier": "in_store_pickup", "label": "In-Store Pickup" }, { "amount": "4.99", "detail": "5-8 Business Days", "identifier": "flat_rate_shipping_id_2", "label": "UPS Ground" }, { "amount": "29.99", "detail": "1-3 Business Days", "identifier": "flat_rate_shipping_id_1", "label": "FedEx Priority Mail" } ], "total": { "amount": "63.99", "label": "Sam's Fish", "type": "final" }, "supportedCountries" : [ "US", "CA", "UK", "JP", "CN" ] } }, "requestIdentifier" : "6b2ca008-1388-4261-a9df-fe04cd1c23a9" } } }
Apple Pay-Limits
Übergeordnetes Feld | Feld | Erforderlich | Erforderliche Mindestanzahl | Maximale Zeichen | Weitere Voraussetzungen |
---|---|---|---|---|---|
templateType | Ja | Gültiger Vorlagentyp | |||
data | Ja | ||||
version | Ja | Muss „1.0“ sein. | |||
data | Inhalt | Ja | |||
Inhalt | Titel | Ja | 1 | 512 | Der Titel der Bubble mit empfangener Nachricht |
Untertitel | Nein | 0 | 512 | Untertitel, der unter dem Titel der Blase mit empfangenen Nachrichten angezeigt werden soll | |
imageData | Nein | 0 | 200 | Muss gültig und öffentlich zugänglich sein URL | |
imageType | Nein | 0 | 50 | Muss "URL“ sein | |
Zahlung | Ja | Ein Wörterbuch mit Feldern, die die Einzelheiten einer Apple Pay-Anfrage enthalten. | |||
requestIdentifier | Nein | Zeichenfolge, ein Bezeichner für die ApplePay Anfrage. Wenn nicht angegeben, UUID wird ein generiert und verwendet. | |||
Zahlung | Endpunkte | Ja | Ein Wörterbuch mit den Endpunkten für Zahlungsabwicklung, Kontaktaktualisierungen und Auftragsverfolgung. | ||
merchantSession | Ja | Ein Wörterbuch mit der Zahlungssitzung, das von Apple Pay nach der Anforderung einer neuen Zahlungssitzung bereitgestellt wird. | |||
paymentRequest | Ja | Ein Wörterbuch mit Informationen zur Zahlungsanforderung | |||
Endpunkte | paymentGatewayUrl | Ja | Zeichenfolge. Wird von Apple Pay aufgerufen, um die Zahlung über den Zahlungsanbieter abzuwickeln. Das URL sollte mit dem URL im initiativeContext Feld der Händlersitzung angegebenen übereinstimmen | ||
fallbackUrl | Nein | AURL, das in einem Webbrowser geöffnet wird, sodass der Kunde den Kauf abschließen kann, wenn sein Gerät keine Zahlungen mit Apple Pay tätigen kann. Falls angegeben, fallbackUrl müssen sie übereinstimmen paymentGatewayUrl. | |||
orderTrackingUrl | Nein | Wird nach Abschluss der Bestellung von Messages for Business aufgerufen. Bietet Ihnen die Möglichkeit, die Bestellinformationen in Ihrem System zu aktualisieren. | |||
paymentMethodUpdateUrl | Nein | Wird von Apple Pay aufgerufen, wenn der Kunde die Zahlungsmethode ändert. Wenn Sie diesen Endpunkt nicht implementieren und diesen Schlüssel in das Wörterbuch aufnehmen, wird dem Kunden eine Fehlermeldung angezeigt. | |||
shippingContactUpdateUrl | Nein | Wird von Apple Pay aufgerufen, wenn der Kunde seine Lieferadresse ändert. Wenn Sie diesen Endpunkt nicht implementieren und diesen Schlüssel in das Wörterbuch aufnehmen, wird dem Kunden eine Fehlermeldung angezeigt | |||
shippingMethodUpdateUrl | Nein | Wird von Apple Pay aufgerufen, wenn der Kunde die Versandart ändert. Wenn Sie diesen Endpunkt nicht implementieren und diesen Schlüssel in das Wörterbuch aufnehmen, wird dem Kunden eine Fehlermeldung angezeigt. | |||
merchantSession | displayName | Ja | 1 | 64 | Zeichenfolge. Der kanonische Name für Ihren Shop, der zur Anzeige geeignet ist. Lokalisieren Sie den Namen nicht. |
Initiative | Ja | Zeichenfolge. Muss „Nachrichtenübermittlung“ sein | |||
initiativeContext | Ja | Zeichenfolge. Übergeben Sie Ihr ZahlungsgatewayURL. | |||
merchantIdentifier | Ja | Zeichenfolge. Eine eindeutige Kennung, die einen Händler für Apple Pay darstellt. | |||
merchantSessionIdentifier | Ja | Zeichenfolge. Eine eindeutige Kennung, die die Sitzung eines Händlers für Apple Pay darstellt. | |||
epochTimestamp | Ja | Zeichenfolge. Die Zeitdarstellung in Sekunden, die seit 00:00:00 Uhr am DonnerstagUTC, 1. Januar 1970 vergangen sind. | |||
expiresAt | Ja | Zeichenfolge. Die Darstellung der Ablaufzeit in Sekunden, die seit 00:00:00 Uhr am Donnerstag, 1. Januar 1970 vergangen sind. UTC | |||
nonce | Nein | Binär. Eine einmalig verwendbare Zeichenfolge, die die Integrität der Interaktion überprüft. | |||
signature | Nein | Binär. Ein Hash des öffentlichen Schlüssels, der zum Signieren der Interaktionen verwendet wurde. | |||
signedFields | Nein | Die Liste der Zeichenketten enthält die signierten Eigenschaften. | |||
paymentRequest | applePay | Ja | Ein Wörterbuch, das die Apple Pay-Konfiguration beschreibt. | ||
countryCode | Ja | Zeichenfolge. Der aus zwei Buchstaben bestehende ISO 3166-Ländercode des Händlers. | |||
currencyCode | Ja | Zeichenfolge. Der dreibuchstabige ISO 4217-Währungscode für die Zahlung. | |||
lineItems | Nein | Eine Reihe von Einzelposten, in denen Zahlungen und zusätzliche Gebühren erläutert werden. Einzelposten sind nicht erforderlich. Das Array darf jedoch nicht leer sein, wenn der lineItems Schlüssel vorhanden ist. | |||
total | Ja | Ein Wörterbuch, das die Summe enthält. Der Gesamtbetrag muss größer als Null sein, um die Validierung zu bestehen. | |||
requiredBillingContactFelder | Nein | Die Liste der für den Kunden erforderlichen Rechnungsinformationen, die für die Bearbeitung der Transaktion erforderlich sind. Eine Liste der möglichen Zeichenketten finden Sie unter requiredBillingContactFelder |
|||
requiredShippingContactFelder | Nein | Die Liste der Versand- oder Kontaktinformationen, die der Kunde zur Ausführung der Bestellung benötigt. Wenn Sie beispielsweise die E-Mail-Adresse oder Telefonnummer des Kunden benötigen, geben Sie diesen Schlüssel an. Eine Liste der möglichen Zeichenketten finden Sie unter requiredShippingContactFelder |
|||
shippingMethods | Nein | Ein Array, das die verfügbaren Versandmethoden auflistet. Auf dem Apple Pay-Zahlungsblatt wird die erste Versandart aus dem Array als Standardversandart angezeigt. | |||
supportedCountries | Nein | Eine Reihe von Ländern, die unterstützt werden sollen. Listet jedes Land mit seiner ISO 3166-Landesvorwahl auf. | |||
applePay | merchantIdentifier | Ja | Eine eindeutige Kennung, die einen Händler für Apple Pay darstellt. | ||
merchantCapabilities | Ja | Eine Reihe von Zahlungsmöglichkeiten, die vom Händler unterstützt werden. Das Array muss Supports3DS enthalten und kann optional,, und Supports enthaltensupportsCredit. supportsDebit EMV | |||
supportedNetworks | Ja | Eine Reihe von Zahlungsnetzwerken, die vom Händler unterstützt werden. Das Array muss einen oder mehrere der folgenden Werte enthalten: amex, discover, jcb, masterCardprivateLabel, oder visa | |||
lineItem | Betrag | Ja | Der monetäre Betrag des Einzelpostens. | ||
Bezeichnung | Ja | Eine kurze, lokalisierte Beschreibung des Einzelpostens. | |||
Typ | Nein | Ein Wert, der angibt, ob es sich bei der Einzelposition um eine endgültige oder ausstehende Position handelt. | |||
total | Betrag | Ja | Der Gesamtbetrag der Zahlung. | ||
Bezeichnung | Ja | Eine kurze, lokalisierte Beschreibung der Zahlung. | |||
Typ | Nein | Ein Wert, der angibt, ob die Zahlung abgeschlossen oder ausstehend ist. | |||
shippingMethods | Betrag | Ja | Zeichenfolge. Die nicht negativen Kosten im Zusammenhang mit dieser Versandart. | ||
Detail | Ja | Zeichenfolge. Zusätzliche Beschreibung der Versandart. | |||
Bezeichnung | Ja | Zeichenfolge. Eine kurze Beschreibung der Versandart. | |||
Bezeichner | Ja | Zeichenfolge. Ein vom Kunden definierter Wert, der zur Identifizierung dieser Versandart verwendet wird. |
iMessage App-Vorlage
Anmerkung
Diese Vorlage gilt nur für Kontaktabläufe mit Apple Messages for Business.
Verwenden Sie die iMessage Apps-Vorlage, um dem Kunden Ihre maßgeschneiderte iMessage App zu präsentieren.
Der folgende Code ist ein Beispiel für eine iMessage App-Vorlage, die Sie in Ihrem Lambda verwenden können.
{ templateType: AppleCustomInteractiveMessage, version: "1.0", data: { content: { appIconUrl: "https://interactive-message-testing.s3-us-west-2.amazonaws.com/apple_4.2kb.jpg", appId: "123456789", appName: "Package Delivery", title: "Bubble Title CIM", bid: "com.apple.messages.MSMessageExtensionBalloonPlugin:{team-id}:{ext-bundle-id}", dataUrl: "?deliveryDate=26-01-2024&destinationName=Home&street=1infiniteloop&state=CA&city=Cupertino&country=USA&postalCode=12345&latitude=37.331686&longitude=-122.030656&isMyLocation=false&isFinalDestination=true", subtitle: "Bubble package", }, replyMessage: { title: "Custom reply message title", subtitle: "Custom reply message subtitle", imageType: "URL", imageData: "https://interactive-msg.s3-us-west-2.amazonaws.com/fruit_34.3kb.jpg", } } }
iMessage App-Grenzwerte
Übergeordnetes Feld | Feld | Erforderlich | Typ | Andere Hinweise |
---|---|---|---|---|
templateType | Ja | TemplateType | Gültiger Vorlagentyp, "AppleCustomInteractiveMessage“ | |
data | Ja | InteractiveMessageData | Enthält Inhalt und receivedMessage Wörterbücher | |
Version | Ja | Zeichenfolge | Muss „1.0“ sein. | |
data | Inhalt | Ja | InteractiveMessageContent | Interaktiver Inhalt der App iMessage |
replyMessage | Ja | ReplyMessage | Konfiguration der Nachrichtenanzeige nach dem Senden einer Antwort auf eine interaktive Nachricht | |
Inhalt | appIconUrl | Ja | Zeichenfolge | AWSS3 URL |
appId | Ja | Zeichenfolge | ID IMessage der Geschäfts-App | |
appName | Ja | Zeichenfolge | Name IMessage der Geschäfts-App | |
bieten | Ja | Zeichenfolge | Gebot IMessage für Geschäftsanwendungen. Muster: com.apple.messages. MSMessageExtensionBalloonPlugin: {Team-ID}: {} ext-bundle-id | |
dataUrl | Ja | Zeichenfolge | Daten, die an die App übergeben werden iMessage | |
useLiveLayout | Nein | boolesch | Standard: Wahr | |
Titel | Ja | Zeichenfolge | Titel der Imessage-App-Blase | |
untertitel | Nein | Zeichenfolge | Untertitel der Imessage-App-Blase | |
replyMessage | Titel | Nein | Zeichenfolge | |
untertitel | Nein | Zeichenfolge | ||
imageType | Nein | Zeichenfolge | Muss ein gültiger, öffentlich zugänglicher sein URL | |
imageData | Nein | Zeichenfolge | Kann ohne ein Bild nicht existieren |
Umfangreiche Formatierung von Titeln und Untertiteln
Sie können den Titeln und Untertiteln Ihrer Chat-Nachrichten umfangreiche Formatierungen hinzufügen. Sie können beispielsweise Links, kursive, fett gedruckte, nummerierte Listen und Aufzählungen hinzufügen. Sie können Markdown
Die folgende Abbildung einer Chatbox zeigt ein Beispiel für eine Listenauswahl mit umfangreicher Formatierung im Titel und Untertitel.
-
Der Titel How can we help? aws.amazon.com ist fett gedruckt und enthält einen Link.
-
Der Untertitel enthält kursiv und fett formatierten Text, eine Aufzählung und eine nummerierte Liste. Außerdem werden ein einfacher Link, ein Textlink und ein Beispielcode angezeigt.
-
Am unteren Rand des Chat-Felds werden drei Elemente zur Listenauswahl angezeigt.
Wie formatiert man Text mit Markdown
Sie können Titel- und Untertitelzeichenfolgen in einem mehrzeiligen Format oder in einer einzigen Zeile mit `\r\n`
Zeilenumbruchzeichen schreiben.
-
Mehrzeiliges Format: Das folgende Codebeispiel zeigt, wie Sie Listen im Markdown-Format in einem mehrzeiligen Format erstellen.
const MultiLinePickerSubtitle = `This is some *emphasized text* and some **strongly emphasized text** This is a bulleted list (multiline): * item 1 * item 2 * item 3 This is a numbered list: 1. item 1 2. item 2 3. item 3 Questions? Visit https://plainlink.com/faq [This is a link](https://aws.amazon.com) This is \`
\` ` const PickerTemplate = { templateType: "ListPicker|Panel", version: "1.0", data: { content: { title: "How can we help?", subtitle: MultiLinePickerSubtitle, elements: [ /* ... */ ] } } }
-
Einzeiliges Format: Das folgende Beispiel zeigt, wie Sie mithilfe von
`\r\n`
-Zeilenumbruchzeichen einen Untertitel in einer einzigen Zeile erstellen.const SingleLinePickerSubtitle = "This is some *emphasized text* and some **strongly emphasized text**\r\nThis is a bulleted list:\n* item 1\n* item 2\n* item 3\n\nThis is a numbered list:\n1. item 1\n2. item 2\n3. item 3\n\nQuestions? Visit https://plainlink.com/faq\r\n[This is a link](https://aws.amazon.com)\r\nThis is `<code/>`"; const PickerTemplate = { templateType: "ListPicker|Panel", version: "1.0", data: { content: { title: "How can we help?", subtitle: SingleLinePickerSubtitle, elements: [ /* ... */ ] } } }
Im folgenden Beispiel wird gezeigt, wie kursiv und fett formatierter Text mit Markdown formatiert wird:
This is some *emphasized text* and some **strongly emphasized
text**
Im folgenden Beispiel wird gezeigt, wie Sie Text als Code mit Markdown formatieren:
This is `<code />`
Wie formatiert man Links mit Markdown
Verwenden Sie die folgende Syntax, um einen Link zu erstellen:
[aws](https://aws.amazon.com)
Die folgenden Beispiele zeigen zwei Möglichkeiten, wie Sie Links mit Markdown hinzufügen können:
Questions? Visit https://plainlink.com/faq
[This is a link](https://aws.amazon.com)