Website Contact Webhook
Kontaktanfragen sammeln, nachverfolgen und automatisch weiterreichen.
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.
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.
"eq_website_contact_webhook")
Volltextsuche und Modulkarte stellt das Modul Help Docs (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.
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.
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.