> For the complete documentation index, see [llms.txt](https://wiki.lucysecurity.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wiki.lucysecurity.com/lucy-wiki-de/anwendungsreferenz/einstellungen/allgemeine-systemeinstellungen/messenger-einstellungen.md). # 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). {% hint style="info" %} Navigieren Sie zu: **Einstellungen > Allgemeine Systemeinstellungen > Messenger-Einstellungen** {% endhint %} *** ## WhatsApp (von Meta) {% hint style="success" %} Um WhatsApp mit Lucy zu nutzen, wenden Sie sich bitte an Ihren **Solution Engineer** per E-Mail. {% endhint %} 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](https://developers.facebook.com/) * 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](https://messente.com) * Ein freigegebener Absendername ### Konfigurationsschritte **1. Messente-Zugangsdaten abrufen** * Registrieren Sie sich oder melden Sie sich an unter [messente.com](https://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](https://developers.facebook.com/apps/) * 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](/lucy-wiki-de/anwendungsreferenz/kampagnen/expertenmodus.md). 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**. {% hint style="info" %} 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. {% endhint %} *** ### 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 {% hint style="info" %} 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. {% endhint %} 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](/lucy-wiki-de/anwendungsreferenz/einstellungen/allgemeine-systemeinstellungen/artikel-zu-azure-anwendungen.md). Lesen Sie weiter für die erforderlichen Einstellungen, um eine Anwendung für Microsoft Teams zu verbinden. {% hint style="info" %} 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. {% endhint %} ### 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 {% hint style="info" %} **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.** {% endhint %} 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**. {% hint style="info" %} **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.** {% endhint %} Hier ist ein kurzer Überblick über die von der Anwendung erforderlichen Berechtigungen:
BerechtigungTypBeschreibung
User.ReadDelegiertErmöglicht der App, sich anzumelden und das Profil des angemeldeten Benutzers zu lesen.
Chat.CreateDelegiertErmöglicht der App, im Namen des angemeldeten Benutzers neue Einzel- oder Gruppenchats zu erstellen.
ChatMessage.SendDelegiertErmöglicht der App, Nachrichten in jedem Chat zu senden, auf den der angemeldete Benutzer Zugriff hat.
Chat.ReadWriteDelegiertErmö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.
openidDelegiertErforderlich 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. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://wiki.lucysecurity.com/lucy-wiki-de/anwendungsreferenz/einstellungen/allgemeine-systemeinstellungen/messenger-einstellungen.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.