# Website Contact Webhook für Odoo | Equitania Software GmbH ![Website Contact Webhook](https://www.ownerp.com/web/image/5178/eq_website_contact_webhook_banner.png) ## Website Contact Webhook license OPL-1 Version 16.0, 18.0, 19.0 ✓ Community ✓ Enterprise ✓ Odoo.sh author Equitania Software GmbH supportsupport@equitania.de - [Überblick](https://www.ownerp.com/#overview-de) - [Funktionen](https://www.ownerp.com/#features-de) - [FAQ](https://www.ownerp.com/#faq-de) ### Kontaktanfragen sammeln, nachverfolgen und automatisch weiterreichen. ![Website Contact Webhook](https://www.ownerp.com/web/image/5179/eq_website_contact_webhook_eyecatcher_de.png) Website Contact Webhook bringt konfigurierbare Kontaktformulare für Ihre Odoo-Websites und einen gesicherten Webhook-Eingang für externe Systeme zusammen, mit optionaler Weiterleitung an die LangDock-KI-Plattform. Jede Website erhält ihr eigenes Formular unter einem frei wählbaren Pfad und einen eigenen Schlüssel für den Webhook-Eingang. Jede eingehende Anfrage – aus dem Formular oder per Webhook – landet mit Absenderadresse, Zeitstempel und Status in einem durchsuchbaren Protokoll, ein geplanter Auftrag reicht sie automatisch an LangDock weiter. Eine CRM-Installation ist nicht nötig. Nur bei ownERP ### Die Hilfe zu diesem Modul ist auffindbar — für Menschen und für KI Durchsuchen Sie die Dokumentation selbst, oder lassen Sie eine KI die Modulkarte lesen — beide greifen auf dieselben Seiten zu. DER MENSCH SUCHT Webhook-Schlüssel Überblick Das Modul bringt zwei Dinge zusammen: ein im Backend konfigurierbares Kontaktformular und einen Endpunkt, über den fremde Systeme Anfragen einliefern. Überblick › Anfragen nachverfolgen Jeder Eintrag zeigt Status, LangDock-Antwortcode und die verbleibenden Versuche. DIE KI FRAGT NACH eq.helper.doc . get_capability_card ( "eq_website_contact_webhook" ) Liefert Modelle, Ansichten und Zugriffsregeln des Moduls als eine strukturierte Karte — eine KI beantwortet Fragen zum Modul, ohne den Quelltext zu öffnen. Wird von eq_helpers Chat-Werkzeugen und jedem MCP-verbundenen Assistenten genutzt. Volltextsuche und Modulkarte stellt das Modul [Help Docs](https://www.ownerp.com/apps/helper) (eq_helper) bereit. Die Inhalte liefert dieses Modul mit — ohne Zusatzkonfiguration. ## Funktionen ### Eine Installation, ein Formular je Website Jede Website bekommt ihr eigenes Kontaktformular unter einem frei wählbaren Pfad. Drei Pfade sind bereits vorbereitet — `/kontakt`, `/contact` und `/kontaktieren` —, dazu zwei Beispielformulare mit unterschiedlichen Interesse-Listen. - Formulartitel, Einleitungstext, Erfolgsmeldung, Datenschutzhinweis und Button-Beschriftung lassen sich pro Formular frei formulieren. - Anrede-, Kontaktweg- und Betrefffeld sowie die Pflicht zur Nachricht lassen sich pro Formular einzeln ein- oder ausblenden. ### Interesse-Optionen, passend zur Zielgruppe Radio-Buttons oder Checkboxen mit frei wählbaren Beschriftungen und eigener Reihenfolge — jedes Formular zeigt genau die Auswahlpunkte, die zu seinen Besuchern passen. - Die beiden Beispielformulare zeigen das an unterschiedlichen Interesse-Listen — eines für Odoo-Editionen, eines für Produktkategorien. - Eine ausgewählte Option landet als Teil des gespeicherten Datensatzes, nicht nur im gesendeten Formular. ### Änderungen wirken beim nächsten Seitenaufruf Ein Formular umbenennen, ein Feld ausblenden, eine Interesse-Option verschieben — jede Anpassung im Backend zeigt sich sofort auf der Website. Kein Neustart, kein zusätzlicher Schritt. ### Ein eigener Schlüssel pro Website Jede Website erhält ihren eigenen Zugang zum Webhook-Eingang. Laufen mehrere Websites in derselben Installation, bleiben deren Anfragen sauber getrennt — ein kompromittierter Schlüssel betrifft nie mehr als eine Website. ### Der vollständige Rohdatensatz bleibt erhalten Jede Anfrage — aus dem Formular oder per Webhook — zeigt im Protokoll Name, E-Mail, Telefon und Betreff auf einen Blick, dazu den vollständigen JSON-Payload mit Syntax-Highlighting, die Kopfzeilen und die Absender-IP. - „Als bearbeitet markieren“ schließt eine Anfrage ab, „Erneut senden“ stößt die LangDock-Weiterleitung erneut an — auch nach Erreichen der maximalen Versuchszahl. - Sensible Kopfzeilen werden vor dem Speichern automatisch entfernt. ### Automatische Weiterleitung an LangDock Ein geplanter Auftrag reicht neue Anfragen alle zwei Minuten an LangDock weiter und wiederholt einen fehlgeschlagenen Versuch bis zu fünfmal, bevor er ihn als gescheitert markiert. Ohne LangDock-Anbindung bleibt das Protokoll die alleinige Aufzeichnung — keine Anfrage geht verloren. ### Schutzmaßnahmen von Anfang an aktiv Der Webhook-Schlüssel ist ausschließlich für Administratoren sichtbar und wird zeitkonstant verglichen, damit ein Timing-Angriff ins Leere läuft. Die LangDock-Zieladresse wird gegen interne Netzwerkbereiche geprüft, sodass der Webhook nicht zum Einfallstor in die eigene Infrastruktur wird. - CSRF-Schutz bleibt für die Frontend-Formulare aktiv; der Webhook-Endpunkt authentifiziert sich stattdessen über den API-Schlüssel. - Das Modul funktioniert vollständig ohne CRM-Installation — wer darauf verzichtet, verliert trotzdem keine Anfrage. ## Häufige Fragen Welche Odoo-Editionen werden unterstützt? Das Modul läuft mit Odoo Community und Odoo Enterprise in der Version 19.0 — selbst gehostet oder auf Odoo.sh. Odoo Online, die gehostete SaaS-Variante, lässt keine Apps aus dem Store zu; dort läuft kein Drittanbieter-Modul. Welche Abhängigkeiten hat das Modul? Erfordert die Odoo-Module `base`, `web`, `website` und `eq_web_json_widget`, die Odoo automatisch installiert. Braucht das Modul zusätzliche Python-Pakete? Ja — `requests`, für den Aufruf des LangDock-Webhooks. Odoo installiert Modul-Abhängigkeiten selbst, Python-Pakete jedoch nicht: Die richtet Ihr Administrator einmalig auf dem Server ein. Ohne es lässt sich das Modul nicht installieren. Wie wird dieses Paket installiert? **Selbst gehostet (eigener Server, Docker):** Paket in dieselbe Python-Umgebung installieren, in der Odoo läuft, und den Dienst neu starten — `pip install requests`. In einem Docker-Setup dieselbe Zeile im Image ergänzen, damit sie einen Container-Rebuild überlebt. **Odoo.sh:** `requests` in eine `requirements.txt` im Repository eintragen — entweder im Branch-Wurzelverzeichnis oder in dem Ordner, der die Addons enthält. Odoo.sh installiert es beim nächsten Build; ein `pip install` in der Shell wäre mit dem nächsten Build wieder weg. Die Installation erscheint im Build-Log (`~/logs/pip.log`). Das Paket ist auf PyPI veröffentlicht und braucht keinen eigenen Lizenzschlüssel. Braucht das Modul ein CRM? Nein. Kontaktanfragen nutzen ein eigenes Datenmodell — `eq_website_contact_webhook` lässt sich unabhängig installieren, ganz ohne CRM-Abhängigkeit. Sind die gespeicherten Kontaktdaten personenbezogen? Ja. Das Protokoll speichert Namen, E-Mail-Adressen, Telefonnummern und IP-Adressen. Behandeln Sie sie entsprechend: Beschränken Sie den Zugriff und löschen Sie Einträge nach Ihren eigenen Aufbewahrungsregeln. Wie ist der Webhook abgesichert? Jede Website authentifiziert sich mit ihrem eigenen API-Schlüssel, der zeitkonstant verglichen wird. Sensible Kopfzeilen werden vor dem Speichern entfernt, und die LangDock-Zieladresse wird vor der Nutzung gegen private, lokale und Cloud-Metadaten-Adressbereiche geprüft. Was passiert, wenn LangDock nicht erreichbar ist? Der Auftrag wiederholt einen fehlgeschlagenen Weiterleitungsversuch bis zu fünfmal, bevor er ihn als gescheitert markiert. Die Anfrage selbst geht dabei nie verloren — sie bleibt im Protokoll, und „Erneut senden“ stößt jederzeit einen weiteren Versuch an. Muss ich selbst für Rate-Limiting sorgen? Ja. `/webhook/contact` ist öffentlich aus dem Internet erreichbar, und der API-Schlüssel wird erst nach Empfang des Requests geprüft — setzen Sie ein Rate-Limit davor. Ein anpassbares nginx-Beispiel liegt der Moduldokumentation bei. Bieten Sie Support? Ja, wenden Sie sich an [support@equitania.de](mailto:support@equitania.de). Funktioniert es nach Odoo-Updates weiter? Ja, innerhalb von 19.0.x. Ein Hauptversionswechsel erscheint als neue Modulversion. ### Support · Kontakt We are happy to support you · Wir unterstützen Sie gerne. ![Equitania Software GmbH](https://www.ownerp.com/web/image/5176/EquitaniaLogo.png) ![ownERP](https://www.ownerp.com/web/image/5187/ownERP_Logo.png) Equitania Software GmbH Weiherstraße 13 75173 Pforzheim Deutschland · Germany Telefon: +49 7231 16 604 0 Telefax: +49 7231 16 604 200 Homepage: www.ownerp.com Support: support.equitania.de E-Mail: support@equitania.de **DE** · Alle Angaben auf dieser Seite dienen der Produktbeschreibung und sind rechtlich unverbindlich. Sie stellen weder eine Beschaffenheitsgarantie noch eine Zusicherung eines bestimmten Funktionsumfangs, einer Eignung für einen bestimmten Zweck oder eines bestimmten Ergebnisses dar; maßgeblich sind allein die vertraglichen Vereinbarungen und der Lieferumfang der jeweils installierten Version. Abbildungen zeigen Beispielkonfigurationen. Genannte Produkt- und Firmennamen sind Marken oder eingetragene Marken der jeweiligen Inhaber; ihre Nennung begründet weder eine Verbindung zu diesen Inhabern noch eine Empfehlung durch sie. Diese Beschreibung wurde mit Unterstützung von KI erstellt sowie vor der Veröffentlichung inhaltlich geprüft und freigegeben; maßgeblich ist die deutsche Fassung.