Zum Hauptinhalt gehen

WhatsApp Geolokationsanfrage - Funktionsdokumentation

Ioana Nicolae
Aktualisiert

Übersicht

Dieser Leitfaden erklärt, wie Sie die Funktion WhatsApp Geolokationsanfrage in Urbantz konfigurieren. Diese Funktion ermöglicht es dem System, automatisch den genauen Standort eines Empfängers über WhatsApp anzufordern, wenn die Lieferadresse des Auftrags nicht präzise genug geokodiert werden kann.

Wann wird diese Funktion ausgelöst?

Wichtig: Die Geolokationsanfrage wird nicht für jeden Auftrag gesendet. Sie wird nur ausgelöst, wenn das System erkennt, dass die Lieferadresse des Auftrags nicht mit ausreichender Genauigkeit geokodiert ist.

Wenn diese Bedingung erfüllt ist, initiiert das System automatisch eine WhatsApp-Unterhaltung mit dem Empfänger, um seinen genauen Standort zu erfassen.

Nur WhatsApp, kein Fallback

Im Gegensatz zu Standard-Empfängerbenachrichtigungen (siehe WhatsApp-Funktionsdokumentation) unterstützt die Geolokationsanfrage keinen SMS-Fallback. Das System versucht, den Empfänger ausschließlich über WhatsApp zu erreichen. Wenn der Empfänger kein WhatsApp auf der mit dem Auftrag verknüpften Telefonnummer hat, wird die Anfrage schlicht nicht zugestellt.

Diese Einschränkung besteht, weil die Funktion auf der interaktiven Standortfreigabe-Funktion von WhatsApp basiert, die bei SMS nicht verfügbar ist.

Eine 3-Schritte-Unterhaltung. Warum?

Die WhatsApp-API von Meta erlaubt es Unternehmen nicht, interaktive Standortanfragen direkt an Empfänger zu senden, ohne eine aktive Unterhaltung zu führen. Sie können keine Vorlagennachricht mit einer Schaltfläche „Standort teilen" aus dem Nichts heraus senden.

Um dies zu umgehen, verwendet die Funktion eine 3-Schritte-Unterhaltung:

  1. Die Unterhaltung starten, indem eine Vorlagennachricht mit einer Schaltfläche „Weiter" gesendet wird
  2. Sobald der Empfänger auf die Schaltfläche klickt, öffnet sich ein 24-Stunden-Unterhaltungsfenster, das es ermöglicht, eine interaktive Standortanfrage zu senden. Wenn der Empfänger seinen Standort teilt, wird die Auftragsadresse mit den empfangenen Koordinaten aktualisiert.
  3. Eine Dankesnachricht senden, um zu bestätigen, dass der Standort empfangen wurde
Schritt Systemaktion Empfängeraktion Ergebnis
1. Initiierung Sendet eine Vorlagennachricht, die die Situation erklärt, mit einer Schaltfläche „Weiter" Tippt auf „Weiter" Öffnet 24-Stunden-Unterhaltungsfenster
2. Standortanfrage Sendet eine interaktive Standortanfragenachricht Tippt auf „Standort teilen", wählt oder passt die Markierung an, bestätigt Standort erhalten, Auftragsadresse aktualisiert
3. Dankeschön Sendet eine Bestätigungs-/Dankesnachricht — Unterhaltung beendet

Kosten

Nur Schritt 1 (die Vorlagennachricht) wird als unternehmensinitiierte Unterhaltung abgerechnet. Die Schritte 2 und 3 werden innerhalb des 24-Stunden-Fensters gesendet, das durch den Klick des Empfängers auf die Schaltfläche geöffnet wurde, und sind daher kostenlos.

Voraussetzungen

Bevor Sie Geolokationsanfragen konfigurieren, stellen Sie sicher, dass:

  1. Die WhatsApp-Integration bereits auf der Plattform eingerichtet ist
  2. Sie mit der Erstellung von Nachrichtenvorlagen in der Meta Business Suite vertraut sind

Schritt 1: Vorlagen in der Meta Business Suite erstellen

Sie müssen 3 Nachrichtenvorlagen in Ihrem WhatsApp-Geschäftskonto erstellen. Jede Vorlage dient einem bestimmten Schritt der Unterhaltung.

Hinweis: Für die Unterstützung mehrerer Sprachen verwenden Sie immer denselben Vorlagennamen für alle Sprachversionen. Nur die Spracheinstellung und der Inhalt sollten sich unterscheiden. Urbantz wählt automatisch die richtige Sprache basierend auf der bevorzugten Sprache des Empfängers.

Vorlage 1: Unterhaltungsinitiierung

Dies ist die erste Nachricht, die der Empfänger erhalten wird. Sie stellt den Kontext (die Lieferung) vor und lädt ein, durch Klicken auf eine Schaltfläche zu interagieren.

Konfiguration in der Meta Business Suite:

Einstellung Wert
Kategorie Utility
Name z. B. confirm_delivery_location_init
Sprache(n) Eine Version pro Sprache, die Sie unterstützen
Inhalt Eine kurze, freundliche Nachricht, die erklärt, dass Sie Hilfe bei der Bestätigung der Lieferadresse benötigen
Schaltflächen Fügen Sie eine Quick-Reply-Schaltfläche mit der Beschriftung „Weiter" (oder lokalem Äquivalent) hinzu

Beispieltext:

Hallo {{recipient}} !

Wir bereiten Ihre Lieferung von {{sender}} vor.

Um sicherzustellen, dass alles reibungslos verläuft, könnten Sie bitte einige Details mit uns bestätigen?

Vorlage 2: Standortanfrage

Diese Vorlage enthält den Textkörper für die Standortanfragenachricht. Sie müssen lediglich den Text schreiben, der den Empfänger bittet, seinen Standort zu teilen. Die Schaltfläche „Standort teilen" wird von Urbantz automatisch hinzugefügt, wenn diese Nachricht gesendet wird. Sie müssen diese Schaltfläche nicht im Meta-Vorlageneditor definieren, und Sie müssen sie auch nicht in Urbantz konfigurieren. Sie ist vollständig automatisch, wenn der Trigger TASK_LOCATION_REQUEST_ASK verwendet wird.

Konfiguration in der Meta Business Suite:

Einstellung Wert
Kategorie Utility
Name z. B. confirm_delivery_location_ask
Sprache(n) Eine Version pro Sprache, die Sie unterstützen
Inhalt Eine Nachricht, die den Empfänger bittet, seinen Lieferstandort zu teilen
Schaltflächen Keine (die Schaltfläche „Standort teilen" wird später automatisch von Urbantz hinzugefügt)

Beispieltext:

Bitte teilen Sie den Standort, an dem Ihre Lieferung ankommen soll. Tippen Sie auf die Schaltfläche unten, um Ihren Standort zu senden.

Vorlage 3: Bestätigung / Dankeschön

Diese Nachricht wird gesendet, nachdem der Empfänger seinen Standort geteilt hat. Sie bestätigt, dass der Standort empfangen und die Lieferadresse aktualisiert wurde.

Konfiguration in der Meta Business Suite:

Einstellung Wert
Kategorie Utility
Name z. B. confirm_delivery_location_thanks
Sprache(n) Eine Version pro Sprache, die Sie unterstützen
Inhalt Eine kurze Bestätigungs- und Dankesnachricht
Schaltflächen Keine

Beispieltext:

Vielen Dank! Wir haben Ihre Lieferadresse mit dem von Ihnen geteilten Standort aktualisiert. Ihr Paket wird an den richtigen Ort geliefert.

Schritt 2: Benachrichtigungen in Urbantz konfigurieren

Sobald Ihre Vorlagen in Meta genehmigt sind, müssen Sie 3 Benachrichtigungskonfigurationen in Urbantz erstellen, eine für jeden Schritt der Unterhaltung.

  1. Gehen Sie auf Ihrer Plattform zu Administration > Plattform > Messaging
  2. Erstellen Sie die folgenden 3 Benachrichtigungen:

Benachrichtigung 1: Unterhaltungsinitiierung

Einstellung Wert
Name z. B. „Geo – Standortanfrage Init"
Trigger „Verbraucher bitten, eine Unterhaltung zur Lieferadresse des Auftrags zu starten"
Versandmodus WhatsApp

Im Tab Inhalt:

Einstellung Wert
Vorlage Wählen Sie Ihre Vorlage confirm_delivery_location_init aus
(oder den Namen, den Sie zuvor gewählt haben)
Standardsprache Wählen Sie Ihre Standardsprache aus
Variablen-Zuordnung Ordnen Sie Vorlagenvariablen den Urbantz-Feldern zu (z. B. {{address}} → Auftragsadresse)

Benachrichtigung 2: Standortanfrage

Einstellung Wert
Name z. B. „Geo – Standortanfrage Ask"
Trigger „Verbraucher nach der Lieferadresse des Auftrags fragen"
Versandmodus WhatsApp

Im Tab Inhalt:

Einstellung Wert
Vorlage Wählen Sie Ihre Vorlage confirm_delivery_location_ask aus
(oder den Namen, den Sie zuvor gewählt haben)
Standardsprache Wählen Sie Ihre Standardsprache aus

Hinweis: Sie müssen die Schaltfläche „Standort teilen" nicht konfigurieren. Sie wird von Urbantz automatisch hinzugefügt, wenn dieser Trigger verwendet wird.

Benachrichtigung 3: Dankeschön

Einstellung Wert
Name z. B. „Geo – Standortanfrage Thanks"
Trigger „Verbraucher benachrichtigen, wenn die Standortanfrage für den Auftrag abgeschlossen ist"
Versandmodus WhatsApp

Im Tab Inhalt:

Einstellung Wert
Vorlage Wählen Sie Ihre Vorlage confirm_delivery_location_thanks aus
(oder den Namen, den Sie zuvor gewählt haben)
Standardsprache Wählen Sie Ihre Standardsprache aus

Wichtig: Konfigurieren Sie KEINE Fallback-Benachrichtigungen

Erstellen Sie KEINE SMS- oder E-Mail-Fallback-Benachrichtigungen für diese Trigger.

Im Gegensatz zu Standard-WhatsApp-Benachrichtigungen, bei denen Sie einen SMS-Fallback einrichten können, ist die Geolokationsanfrage WhatsApp-exklusiv.

Wenn der Empfänger kein WhatsApp hat:

  • Die erste Nachricht wird nicht zugestellt
  • Es wird kein Fallback versucht
  • Die Auftragsadresse bleibt unverändert (manuelle Eingriffe können erforderlich sein)

Überwachung

Überwachung auf Auftragsebene

  1. Öffnen Sie das Menü Aufträge auf Ihrer Plattform
  2. Wählen Sie den relevanten Auftrag aus
  3. Öffnen Sie den Tab Benachrichtigungen, um die Benachrichtigungsversuche für jeden Schritt der Unterhaltung zu sehen (bis zu 3 Einträge)
  4. Öffnen Sie den Tab Verlauf, um das Aktivitätsprotokoll des Auftrags zu sehen, einschließlich der Adress-/GPS-Aktualisierung, die aus der Standortfreigabe des Empfängers resultiert

Überwachung auf Plattformebene

Gehen Sie zu Administration > Systemmonitor und wählen Sie den Tab Benachrichtigungen. Diese Ansicht zeigt fehlgeschlagene Zustellungen auf der gesamten Plattform und ist nützlich, um Empfänger zu identifizieren, die nicht erreicht werden konnten (z. B. weil sie kein WhatsApp haben).

Empfängererlebnis

Schritt 1: Erste Nachricht

Der Empfänger erhält eine WhatsApp-Nachricht, die erklärt, dass seine Lieferadresse bestätigt werden muss. Die Nachricht enthält eine Schaltfläche „Weiter".

Schritt 2: Standortfreigabe

Nachdem der Empfänger auf „Weiter" getippt hat, erhält er eine Nachricht, die ihn bittet, seinen Standort zu teilen. Eine Schaltfläche „Standort teilen" erscheint automatisch (von Urbantz beim Senden der Nachricht hinzugefügt, nicht in Meta oder in den Urbantz-Benachrichtigungseinstellungen konfiguriert).

Wenn der Empfänger auf „Standort teilen" tippt, öffnet WhatsApp die integrierte Standortauswahl:

  • Der Empfänger kann seinen aktuellen Standort teilen

  • oder einen anderen Standort auf der Karte auswählen

    • Auf Android: Die Markierung kann frei an jeden beliebigen Ort gezogen werden. Öffentliche Orte werden als Markierungen auf der Karte angezeigt

    • Auf iOS: Die Standardansicht zeigt den aktuellen Standort. Um ihn anzupassen, muss der Empfänger das untere Panel nach unten ziehen, um die Karte einzublenden und die Markierung zu verschieben. Diese Geste wird nicht visuell angezeigt, was verwirrend sein kann

Sobald der Empfänger seinen Standort teilt, wird die Lieferadresse des Auftrags sofort mit den empfangenen Koordinaten aktualisiert.

Schritt 3: Dankeschön

Nachdem die Auftragsadresse aktualisiert wurde, erhält der Empfänger eine Dankesnachricht, die bestätigt, dass der Standort empfangen wurde.

Referenz: Benachrichtigungs-Trigger

Trigger (UI-Bezeichnung) Schritt Beschreibung
„Verbraucher bitten, eine Unterhaltung zur Lieferadresse des Auftrags zu starten" 1 Vorlagennachricht mit Schaltfläche „Weiter"
„Verbraucher nach der Lieferadresse des Auftrags fragen" 2 Interaktive Standortanfragenachricht (mit automatischer Schaltfläche „Standort teilen")
„Verbraucher benachrichtigen, wenn die Standortanfrage für den Auftrag abgeschlossen ist" 3 Dankes-/Bestätigungsnachricht

FAQ

Was passiert, wenn der Empfänger nicht auf „Weiter" klickt?

Die Unterhaltung bleibt offen, aber es werden keine weiteren Nachrichten gesendet. Der Empfänger kann die Schaltfläche jederzeit anklicken. Wenn er nie antwortet, bleibt die Auftragsadresse unverändert.

Kann der Empfänger einen anderen Standort als seinen aktuellen Standort teilen?

Ja, sowohl auf Android als auch auf iOS. Die Erfahrung ist jedoch auf Android deutlich besser, wo die Markierung frei verschoben werden kann. Auf iOS ist es nicht intuitiv, den Standort anzupassen (erfordert das Herunterziehen eines Panels ohne visuellen Hinweis).

Was ist, wenn der Empfänger kein WhatsApp hat?

Die Geolokationsanfrage wird nicht zugestellt. Es wird kein Fallback auf SMS oder E-Mail versucht. Die Auftragsadresse bleibt unverändert und erfordert möglicherweise eine manuelle Korrektur.

Ist das 24-Stunden-Fenster ein Problem?

In der Praxis nicht. Das 24-Stunden-Fenster beginnt, wenn der Empfänger auf „Weiter" klickt. Jede nachfolgende Interaktion des Empfängers (z. B. das Teilen seines Standorts) setzt das Fenster für weitere 24 Stunden zurück. Da Urbantz unmittelbar nach jeder Empfängeraktion reagiert, befindet sich das System immer im aktiven Fenster. Selbst wenn der Empfänger etwas Zeit zwischen den Schritten benötigt, verlängert jede Interaktion das Fenster.

Kann ich Variablen im Vorlagentext verwenden?

Ja, für Vorlage 1 (Initiierung) können Sie benannte Variablen verwenden (z. B. {{address}} für die Auftragsadresse, {{reference}} für eine Referenznummer) und sie in Urbantz zuordnen. Beachten Sie, dass Urbantz benannte Variablen erfordert (keine nummerierten wie {{1}}). Vorlagen 2 und 3 benötigen in der Regel keine dynamischen Variablen, können diese aber bei Bedarf enthalten.

Kommentare

0 Kommentare

Bitte melden Sie sich an, um einen Kommentar zu hinterlassen.