Messenger-Einstellungen

Einführung

LUCY Awareness unterstützt die Integration mit WhatsApp-Nachrichtendiensten, um Awareness-Nachrichten und Kampagnenbenachrichtigungen zuzustellen. Es stehen drei Integrationsoptionen zur Verfügung:

• WhatsApp (von Meta) – Direkte Integration über die offizielle WhatsApp Business Cloud API von Meta.

• WhatsApp (über Messente) – Integration über die Messaging-Plattform Messente eines Drittanbieters.

• Microsoft Teams - Integration über Entra ID (früher bekannt als Azure).

Navigieren Sie zu: Einstellungen > Allgemeine Systemeinstellungen > Messenger-Einstellungen

---

WhatsApp (von Meta)

Um WhatsApp mit Lucy zu nutzen, wenden Sie sich bitte an Ihren Solution Engineer per E-Mail.

Direkte API-Integration mit der WhatsApp-Business-Plattform von Meta.

Voraussetzungen

• Ein Meta-Entwicklerkonto mit einer registrierten App

• Eine verifizierte WhatsApp-Business-Nummer

• Admin-Zugriff, um Tokens zu generieren und Webhooks zu konfigurieren

Konfigurationsschritte

1. Ein permanentes Token erstellen

• Gehen Sie zum Meta App Dashboard

• Navigieren Sie zu Geschäftseinstellungen → Systembenutzer

• Generieren Sie ein Token und weisen Sie die folgenden Berechtigungen zu:

  • whatsapp_business_messaging

  • whatsapp_business_management

  • whatsapp_business_manage_events

2. Ermitteln Sie Ihre Sender-ID

• Im API-Setup Bereich suchen und kopieren Sie Ihre Telefonnummern-ID

3. In LUCY konfigurieren

• Gehen Sie zu Einstellungen → Allgemeine Systemeinstellungen → Messenger-Einstellungen

• Anbieter auswählen: WhatsApp (von Meta)

• Fügen Sie das Token in das Geheimschlüssel Feld ein

• Fügen Sie das Telefonnummern-ID in das Absender Feld ein

• Legen Sie ein Webhook-Token (beliebige sichere Zeichenfolge)

• Klicken Sie auf Speichern

4. Webhook-Setup in Meta

• Gehen Sie im Meta App Dashboard zu Webhooks

• Wählen Sie WhatsApp Business-Konto

• Setzen Sie die Callback-URL auf: https://update1.phishing-server.com

• Verwenden Sie denselben Webhook-Token wie in LUCY festgelegt

• Aktivieren Sie das Nachrichten Ereignis

---

WhatsApp (über Messente)

Integration über die cloudbasierten Messaging-Dienste von Messente.

Voraussetzungen

• Ein registriertes Messente-Konto

• Ein freigegebener Absendername

Konfigurationsschritte

1. Messente-Zugangsdaten abrufen

• Registrieren Sie sich oder melden Sie sich an unter messente.com

• Navigieren Sie zum API-Einstellungen Bereich

• Kopieren Sie Ihren Benutzernamen und API-Passwort

2. Einen Absendernamen genehmigen

• Im Messente-Dashboard gehen Sie zu Absendereinstellungen

• Klicken Sie auf Neuen Absendernamen hinzufügen

• Geben Sie Ihren Absendernamen ein (z. B. Firmenname)

• Zur Genehmigung einreichen (in der Regel 1–3 Werktage)

3. In LUCY konfigurieren

• Gehen Sie zu Messenger-Einstellungen (unter Vorlagen)

• Anbieter auswählen: WhatsApp (über Messente)

• Geben Sie Ihr Benutzernamen, Passwort, und freigegebenen Absender

• Klicken Sie auf Speichern

---

Benutzerdefinierte WhatsApp-Nachrichten

LUCY unterstützt das Senden von benutzerdefinierten WhatsApp-Nachrichten über die API von Meta. Diese Funktion erfordert zusätzliche Konfiguration und basiert auf Benutzerinteraktion.

Nachrichtenfluss

Benutzerdefinierte Nachrichten können nur zugestellt werden nachdem ein Empfänger geantwortet hat auf eine initiale, von Meta genehmigte Locknachricht. LUCY übernimmt dies automatisch, indem zuerst die vordefinierte Vorlage gesendet wird. Sobald der Empfänger antwortet, wird Ihre benutzerdefinierte Nachricht gesendet.

---

Einrichtungsschritte

1. Webhook im Meta Dashboard konfigurieren

• Gehen Sie zu Meta App Dashboard

• Wählen Sie Ihre LUCY-App aus

• Navigieren Sie zu Webhooks (in der Seitenleiste)

• Wählen Sie WhatsApp Business-Konto aus der Produktliste

• Legen Sie fest:

  • Callback-URL: https://update1.phishing-server.com

  • Verifizierungstoken: Gleicher Wert wie in LUCY verwendet

• Klicken Sie auf Speichern

• Aktivieren Sie das Nachrichten Ereignis-Umschalter

---

Eine benutzerdefinierte Nachricht verwenden

1. Erstellen Sie eine neue Kampagne mit Expertenmodus.

2. Gehen Sie zu Szenarioeinstellungen und klicken Sie auf „Neues Szenario“.

3. Im Nachrichtenvorlage Registerkarte den Typ auf „Messenger“.

4. Aktivieren Sie Benutzerdefinierte Nachricht und geben Sie Ihren Nachrichtentext ein.

5. Klicken Sie auf Speichern.

Benutzerdefinierte Nachrichten werden nur gesendet nachdem ein Empfänger auf die Anfangsnachricht antwortet. Zwischen der Antwort und der Zustellung der Nachricht kann es zu einer gewissen Verzögerung kommen.

---

WhatsApp-Vorlagen verwenden

Wenn Sie lieber eine Vorlage von Meta verwenden möchten, können Sie einfach den Namen der Vorlage in der Nachrichtenvorlage Einstellungen eingeben:

Microsoft Teams

Teams-Nachrichten befinden sich derzeit in der Beta-Phase und sind auf Anfrage verfügbar.

Für den Zugriff auf diese Beta-Funktion wenden Sie sich bitte an Ihren Account Manager.

Um Ihre Lucy-Workstation mit Ihrer MS-Teams-Anwendung zu verbinden, müssen Sie lediglich eine App-Registrierung in Entra ID einrichten und mit Lucy verbinden. Allgemeine Anweisungen dazu finden Sie hier. Lesen Sie weiter für die erforderlichen Einstellungen, um eine Anwendung für Microsoft Teams zu verbinden.

Wenn Sie bereits eine verbundene Anwendung haben, können Sie diese Schritte überspringen und einfach das Microsoft Teams Kontrollkästchen in den Einstellungen der Azure-Anwendung auswählen. Gehen Sie zu Einstellungen > Allgemeine Systemeinstellungen > Azure-Anwendungen und wählen Sie die Anwendung aus, um die Einstellungen anzuzeigen und zu konfigurieren.

App-Registrierung

Unterstützte Kontotypen

Konten nur in diesem Organisationsverzeichnis (Einzeltenant).

Umleitungs-URIs:

Verwenden Sie im Menü der App-Registrierung eine Web URI wie folgt: https://yourlucyURL.tld/oauth .

Anwendungs-ID, Mandanten-ID und Geheimnis

Erstellen Sie ein neues Geheimnis und kopieren Sie dann alle 3 Werte.

Mit Lucy verbinden

Hinweis dazu, wer Teams-Nachrichten senden kann

Es ist wichtig zu beachten, dass das einzige Konto, das zum Senden von Nachrichten in Ihrer Teams-Anwendung autorisiert ist, das Konto ist, das die App-Autorisierung durchführt.

Keine anderen Absender können Ihren Empfängern in Teams Nachrichten senden.

Gehen Sie zu Einstellungen > Allgemeine Systemeinstellungen > Azure-Anwendungen und erstellen Sie eine neue Anwendung. Geben Sie ihr einen Namen und einen Client, dann wählen Sie das Microsoft Teams Kontrollkästchen. Fügen Sie die Anwendungs-ID, Mandanten-ID und das Geheimnis ein und klicken Sie dann auf Speichern.

Hinweis dazu, wer Teams-Nachrichten senden kann

Es ist wichtig zu beachten, dass das einzige Konto, das zum Senden von Nachrichten in Ihrer Teams-Anwendung autorisiert ist, das Konto ist, das am Ende dieses Schritts die App-Autorisierung durchführt. Keine anderen Absender können Ihren Empfängern in Teams Nachrichten senden.

Hier ist ein kurzer Überblick über die von der Anwendung erforderlichen Berechtigungen:

Berechtigung	Typ	Beschreibung
User.Read	Delegiert	Ermöglicht der App, sich anzumelden und das Profil des angemeldeten Benutzers zu lesen.
Chat.Create	Delegiert	Ermöglicht der App, im Namen des angemeldeten Benutzers neue Einzel- oder Gruppenchats zu erstellen.
ChatMessage.Send	Delegiert	Ermöglicht der App, Nachrichten in jedem Chat zu senden, auf den der angemeldete Benutzer Zugriff hat.
Chat.ReadWrite	Delegiert	Ermöglicht der App, alle Chats, auf die der angemeldete Benutzer zugreifen kann, zu lesen und zu bearbeiten, einschließlich dem Senden, Bearbeiten und Löschen von Nachrichten.
openid	Delegiert	Erforderlich für die OpenID-Connect-Authentifizierung, um den angemeldeten Benutzer zu identifizieren.

Microsoft Teams als Ihren Nachrichtenanbieter festlegen

Nachdem Sie die App gespeichert und autorisiert haben, gehen Sie zu Einstellungen > Allgemeine Systemeinstellungen > Messenger-Einstellungen. Wählen Sie Microsoft Teams als Anbieter aus und wählen Sie die Azure-Anwendung aus, die Sie im letzten Schritt konfiguriert haben.

Klicken Sie auf Speichern und Sie können Microsoft Teams nun in Ihren Kampagnen verwenden. Für Unterstützung bei der Gestaltung und Durchführung von Teams-Kampagnen wenden Sie sich bitte an Ihren Solution Engineer.