Vordefinierte Komponente für die Adresssammlung

Die vorgefertigte Komponente zur Adressenerhebung erfasst eine Adresse vom Endnutzer und validiert sie mithilfe der Google Address Validation API.

Beschränkungen

Zusätzlich zu den allgemeinen Einschränkungen für vordefinierte Komponenten gelten für diese vordefinierte Komponente die folgenden Einschränkungen:

Zusätzliche Funktionen

Diese vorgefertigte Komponente bietet die folgenden zusätzlichen Funktionen:

Beispieldialoge

Die folgenden Beispieldialogfelder veranschaulichen gängige Szenarien, die von dieser vorgefertigten Komponente verarbeitet werden. Die Beispieldialoge zeigen das Verhalten, wenn die Komponente über die Telefonie aufgerufen wird. Dadurch werden der Standard-Begrüßungs-Intent und die erste Antwort des Kundenservicemitarbeiters zu Beginn der Unterhaltung ausgelöst.

Vollständige gültige Adresse

Der Endnutzer gibt eine vollständige Adresse an und die Komponente zum Erfassen von Adressen überprüft sie erfolgreich.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
1600 Amphitheatre Parkway, Mountain View, CA 94043-1351, USA
Ich habe die endgültige Adresse erfasst: Hausnummer 1600, Straße „Amphitheatre Parkway“, Ort Mountain View, Bundesland CA, Postleitzahl 94043, Land USA. Ist das richtig? Bitte sagen Sie Ja oder Nein.
Ja
Perfekt, ich habe die Adresse erfasst.

Teilweise gültige Adresse mit abgeleiteten Elementen

Der Endnutzer gibt eine teilweise Adresse an. Der Kundenservicemitarbeiter schätzt den fehlenden Teil und bestätigt ihn nach Bestätigung durch den Endnutzer.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
1600 Amphitheatre Parkway
Ich habe einen Teil der Adresse erraten: Die Stadt ist Mountain View, die Postleitzahl ist 94043, die Verwaltungsregion ist CA und das Land ist die USA.

Ich habe die endgültige Adresse erfasst: Die Hausnummer ist 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, die Verwaltungsregion ist CA, die Postleitzahl ist 94043 und das Land ist die USA. Ist das richtig? Bitte sagen Sie Ja oder Nein.
Ja
Perfekt, ich habe die Adresse erfasst.

Teilweise gültige Adresse mit vom Nutzer bereitgestellten Elementen

Der Endnutzer gibt eine teilweise Adresse an. Der Kundenservicemitarbeiter versucht, den fehlenden Teil zu erraten, aber der Endnutzer gibt nach dem Aussprechen von „Nein“ seine eigene Eingabe ein. Der Kundenservicemitarbeiter akzeptiert die Adresse.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
1600 Amphitheatre Parkway
Ich habe einen Teil der Adresse erraten: Die Stadt ist Mountain View, die Postleitzahl ist 94043, die Verwaltungsregion ist CA und das Land ist die USA.

Ich habe die endgültige Adresse erfasst: Die Hausnummer ist 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, die Verwaltungsregion ist CA, die Postleitzahl ist 94043 und das Land ist die USA. Ist das richtig? Bitte sagen Sie Ja oder Nein.
Nein
Okay. Nennen Sie mir bitte, welcher Teil der Adresse geändert werden muss.
Postleitzahl
Können Sie mir bitte Ihre Postleitzahl nennen?
94044
Ich bin mit diesem Update fertig. Muss sonst noch etwas geändert werden? Bitte sagen Sie Ja oder Nein.
no
Nach der Überprüfung habe ich die Postleitzahl durch 94043 ersetzt.

Ich habe die endgültige Adresse erfasst: Die Hausnummer lautet 1600, die Straße ist Amphitheatre Parkway, die Stadt ist Mountain View, der Verwaltungsbezirk ist CA, die Postleitzahl ist 94043 und das Land ist USA. Ist das richtig? Bitte sagen Sie Ja oder Nein.
Ja
Perfekt, ich habe die Adresse erfasst.

Unbekannte Eingabe

Die Komponente beendet den Ablauf, nachdem der Endnutzer dreimal eine nicht erkannte Eingabe gemacht hat.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
Alles in Ordnung
Das habe ich nicht verstanden. Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
nett
Hm, das habe ich immer noch nicht verstanden. Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
sehr gut
Ich habe Ihre Antwort leider nicht verstanden.

Nicht unterstützte Adresse

Die Komponente beendet den Ablauf, nachdem der Endnutzer eine Adresse angegeben hat, die derzeit nicht von der Address Validation API unterstützt wird.

Nutzereingabe Antwort des Kundenservicemitarbeiters
Nennen Sie mir bitte zuerst Ihre vollständige Adresse.
Indien
Leider kann ich Adressen in dieser Region derzeit nicht prüfen.

Adressbestätigung

Informationen dazu, wie die Komponente zur Adressenerhebung Adressen validiert, finden Sie unter Address Validation API – Übersicht.

Die Komponente zum Erfassen von Adressen erfasst die Eingaben des Endnutzers mithilfe der Systementität@sys.address und sendet die erfasste Adresse an die Address Validation API, um Adresselemente für die weitere Verarbeitung zu extrahieren.

Die folgenden Adresselemente werden von der Address Validation API zurückgegeben und von der Komponente verwendet, um eine vollständige Adresse zu erfassen und zu validieren:

  • administrative_area_level_1
  • Archipel
  • country
  • locality
  • postal_code
  • route
  • street_number

Sie können die Demo zur Google-Adressüberprüfung mit einer beliebigen Adresse aus einer unterstützten Region ausprobieren.

Namenskonventionen

Für diese vorgefertigte Komponente gelten die folgenden Namenskonventionen:

Funktion Format Beispiel
Flow [Component Name] Adresserfassung
Komponentenspezifischer Intent prebuilt_components_[component_name]_[intent_name] prebuilt_components_address_collection_locality
Parameter [param_name] user_provided_address
Webhook prebuilt_components_[component_name]:[webhook_action] prebuilt_components_address_collection:address_validation

Eingabeparameter

Mit Eingabeparametern werden bestimmte Verhaltensweisen der Komponente konfiguriert. Die Parameter werden von einer oder mehreren Bedingungen innerhalb des Ablaufs verwendet, um zu bestimmen, wie sich die Komponente verhalten soll. Parameter auf Ablaufebene müssen wie unten beschrieben auf der Startseite der Komponente festgelegt werden. Parameter auf Sitzungsebene können entweder über einen Aufrufablauf oder auf der Startseite dieser Komponente festgelegt werden.

Sie können konfigurieren, welche Adresselemente für diese Komponente erforderlich sind, indem Sie die Parametervorgaben auf der Startseite des Workflows ändern.

Diese vordefinierte Komponente akzeptiert die folgenden Eingabeparameter:

Parametername Beschreibung Eingabeformat
$flow.zip_code Wenn das Postleitzahlelement erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.city Wenn das Ortselement erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.admin_area Wenn das Adresselement für den Verwaltungsbezirk erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.street_number Wenn das Adresselement „Hausnummer“ erforderlich ist, legen Sie true fest, andernfalls false. boolean
$flow.route Wenn das Routenadressenelement erforderlich ist, legen Sie es als true fest, andernfalls als false. boolean
$flow.country Wenn das Element „Adresse des Landes“ erforderlich ist, legen Sie true fest. Andernfalls false. boolean
$flow.island Wenn das Element „island_address“ erforderlich ist, legen Sie es als true fest, andernfalls als false. boolean
$flow.retry_num Legt das maximale Limit für Wiederholungsversuche für Webhook-Aufrufe der Maps Address Validation API fest integer

Maximieren Sie diesen Abschnitt, um eine Anleitung zum Konfigurieren der Eingabeparameter für diese Komponente aufzurufen.

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Erstellen aus.
  5. Klicken Sie im Bereich Abläufe auf die importierte Komponente.
  6. Klicken Sie im Bereich Seiten auf die Startseite.
  7. Klicken Sie auf der Startseite auf die Route true.
  8. Bearbeiten Sie im Fenster „Route“ die Werte für die Parametervorgaben nach Bedarf.
  9. Klicken Sie auf Speichern.

Ausgabeparameter

Ausgabeparameter sind Sitzungsparameter, die nach dem Verlassen der Komponente aktiv bleiben. Diese Parameter enthalten wichtige Informationen, die von der Komponente erfasst werden. Diese vordefinierte Komponente liefert Werte für die folgenden Ausgabeparameter:

Parametername Beschreibung Ausgabeformat
address_collection_address Dieser Parameter gibt das Adressobjekt zurück, wenn eine Adresse von der Komponente erfasst wurde. 
{
  "admin-area": string,
  "city": string,
  "country": string,
  "island": string,
  "route": string,
  "zip-code": string,
  "street-number": string
}
address_collection_status Dieser Parameter gibt den Status der erfassten Adresse zurück. Der zurückgegebene Wert kann einer der folgenden sein:

VALID_ADDRESS: Die Adresse wurde von der Address Validation API erfasst und validiert.

INVALID_ADDRESS: Die Adresse wurde vom Endnutzer bestätigt, aber mindestens eines der Elemente wurde nicht validiert oder von der Address Validation API als UNCONFIRMED_BUT_PLAUSIBLE (NICHT BEStätigt, ABER WAHRSCHEINLICH) gekennzeichnet.

MAPS_API_ERROR: Die Adresse wurde aufgrund eines Fehlers der Address Validation API nicht erfasst.

COUNTRY_NOT_SUPPORTED: Die Adresse wurde nicht erfasst, da die Region von der Address Validation API nicht unterstützt wird.

NO_USER_CONFIRMATION: Die Adresse wurde nicht bestätigt, da der Endnutzer keine Adresse bestätigt hat.		 
string

Grundlegende Einstellungen

So richten Sie diese vorkonfigurierte Komponente ein:

  1. Importieren Sie die vordefinierte Komponente.
  2. Aktivieren Sie die Address Validation API.
  3. Konfigurieren Sie den bereitgestellten flexiblen Webhook mit Ihrem Maps API-Schlüssel. Weitere Informationen finden Sie unten unter „Webhook einrichten“.

Webhook-Einrichtung

Damit Sie die Address Validation API zur Validierung von Adressen verwenden können, müssen Sie den bereitgestellten flexiblen Webhook mit den richtigen Anmeldedaten konfigurieren.

Webhook für die Adressbestätigung

Dieser Webhook führt die folgenden Aktionen aus:

  1. Verarbeitet erfasste Parameter von Conversational Agents (Dialogflow CX), stellt eine Anfrage und überprüft die Adresse mithilfe der Address Validation API.
  2. Hiermit werden bestätigte, nicht bestätigte, fehlende und abgeleitete Adresselemente aus der Antwort der Google Address Validation API extrahiert.

Wenn Sie den Webhook für diese Komponente konfigurieren möchten, müssen Sie die Webhook-Einstellungen mit Ihrem Maps API-Schlüssel aktualisieren.

  1. So rufen Sie Ihren API-Schlüssel ab: Gehen Sie zu Google Cloud Platform Console > APIs & Services > Credentials (Google Cloud Platform Console > APIs und Dienste > Anmeldedaten), wählen Sie Ihren Maps API-Schlüssel aus und kopieren Sie das Feld „API-Schlüssel“.

So konfigurieren Sie den Webhook:

  1. Öffnen Sie die Dialogflow CX Console.
  2. Wählen Sie Ihr Google Cloud-Projekt aus.
  3. Wählen Sie den Agent aus.
  4. Wählen Sie den Tab Verwalten.
  5. Klicken Sie auf Webhooks.
  6. Wählen Sie den Webhook „prebuilt_components_address_collection:address_validation“ aus.
  7. Ersetzen Sie die URL im Feld Webhook-URL für Konversations-Agents (Dialogflow CX) durch die URL mit Ihrem Maps API-Schlüssel: https://addressvalidation.googleapis.com/v1:validateAddress?key=MAPS_API_KEY
  8. Geben Sie in den Authentifizierungseinstellungen den Nutzernamen als key und das Passwort als Ihren Maps API-Schlüssel ein.
  9. Klicken Sie auf Speichern.

Abgeschlossen

Ihr Agent und sein Webhook sollten jetzt eingerichtet und bereit für den Test sein.

Zurück
Kontobericht
Weiter
Alphanumerische Sammlung