MessengerHub

Appearance

Odoo Community anbinden ​

MessengerHub verbindet sich mit Odoo über die XML-RPC API. Für die einfachste Einrichtung empfehlen wir unser kostenloses Odoo-Modul, das WhatsApp- und Telegram-Felder automatisch anlegt und einen direkten Versand-Button aus der Kundenkarte bietet.

Option A – UMH Connector Modul (empfohlen) ​

Das Modul fügt zwei Smart-Buttons (WhatsApp, Telegram) direkt im Kopfbereich jeder Kontaktkarte ein.

Download ​

Das Modul ist kostenlos und quelloffen (GPL v3):

Installation ​

  1. ZIP herunterladen und den Ordner umh_connector in den Odoo-addons-Pfad Ihrer Instanz kopieren
  2. Entwicklermodus aktivieren, dann Apps → Apps-Liste aktualisieren
  3. Nach UMH Connector suchen → Aktivieren
  4. Einstellungen → Allgemeine Einstellungen → UMH Connector → URL Ihrer MessengerHub-Instanz eintragen

Was das Modul macht ​

  • Legt die Felder WhatsApp-Nummer und Telegram Chat-ID automatisch auf jedem Kontakt an
  • Fügt zwei Smart-Buttons (WhatsApp, Telegram) im Kopfbereich der Kontaktkarte ein
  • Ein Klick öffnet die passende Unterhaltung direkt in MessengerHub
  • Sicherheitshinweis: Der WhatsApp-Button sendet nur, wenn das WhatsApp-Nummer-Feld explizit gefüllt ist (auch wenn sie identisch mit Telefon/Mobil ist) — so wird verhindert, dass versehentlich eine kostenpflichtige Nachricht an eine Festnetznummer ohne WhatsApp verschickt wird

Option B – Manuelle Einrichtung (ohne Modul) ​

Nur falls Ihr Hosting-Anbieter keine eigenen Module erlaubt. Ohne das Modul gibt es nur die Felder für die Kundenerkennung, keinen Versand-Button in der Kontaktkarte.

Schritt 1 – API-Schlüssel in Odoo erstellen ​

  1. Melden Sie sich in Ihrer Odoo-Instanz an
  2. Klicken Sie oben rechts auf Ihren Benutzernamen → Mein Profil
  3. Öffnen Sie den Tab Konto-Sicherheit
  4. Im Abschnitt API-Schlüssel klicken Sie auf Neuen API-Schlüssel
  5. Vergeben Sie eine Bezeichnung (z. B. „MessengerHub")
  6. Bestätigen Sie mit Ihrem Passwort
  7. Kopieren Sie den angezeigten Schlüssel – er wird nur einmal angezeigt

Hinweis: In älteren Odoo-Versionen finden Sie API-Schlüssel unter Einstellungen → Technisch → API-Schlüssel.

Schritt 2 – Datenbankname herausfinden ​

Den Datenbanknamen sehen Sie entweder:

  • In der URL Ihrer Odoo-Instanz (z. B. https://odoo.meinfirma.de/web#db=**meinfirma**)
  • Oder beim Login-Bildschirm in der Datenbankauswahl

Schritt 3 – Connector in MessengerHub einrichten ​

  1. Öffnen Sie Einstellungen → ERP-Connector
  2. Klicken Sie auf die Karte Odoo Community
  3. Füllen Sie alle Felder aus:
FeldBeispielHinweis
Odoo URLhttps://odoo.meinfirma.deOhne abschließenden Schrägstrich
DatenbanknamemeinfirmaExakt wie in Odoo hinterlegt
BenutzernameadminDer Benutzer, dessen API-Schlüssel Sie in Schritt 1 erstellt haben
API-Keyd4f8a2...Der in Schritt 1 kopierte Schlüssel
  1. Klicken Sie auf 🔌 Verbindung testen – bei Erfolg erscheint ✓ Verbindung erfolgreich
  2. Klicken Sie auf Speichern

Schritt 4 – WhatsApp- und Telegram-Felder einrichten (nur bei manueller Installation) ​

  1. Öffnen Sie in Odoo Einstellungen → Technisch → Benutzerdefinierte Felder
  2. Klicken Sie auf Neu und legen Sie zwei Felder auf Modell res.partner an:
    • Telegram: Feldname (technisch) x_telegram_chat_id · Bezeichnung Telegram-ID · Typ Text
    • WhatsApp: Feldname (technisch) x_whatsapp_number · Bezeichnung WhatsApp-Nummer · Typ Text
  3. Speichern Sie

Danach erscheinen beide Felder in jedem Kontaktdatensatz. Tragen Sie beim ersten Kontakt die jeweilige Nummer/Chat-ID dort ein.

Kundenerkennung ​

MessengerHub gleicht eingehende WhatsApp-Nachrichten automatisch mit Odoo-Kontakten ab — zuerst über das Feld WhatsApp-Nummer (falls vorhanden), sonst über die Standardfelder Telefon und Mobil.

Telegram übermittelt keine Telefonnummer und wird ausschließlich über das Feld Telegram-ID erkannt.

Wichtig für den Versand: Läuft WhatsApp auf einer anderen Nummer als Telefon/Mobil, tragen Sie diese explizit im Feld WhatsApp-Nummer ein — auch wenn sie identisch mit Telefon/Mobil ist. Ohne dieses Feld verweigert der Versand-Button bewusst das Senden, damit nie versehentlich eine kostenpflichtige Nachricht an eine Nummer ohne WhatsApp geht.