Appearance
Dolibarr anbinden
MessengerHub verbindet sich mit Dolibarr über die REST API. Für die einfachste Einrichtung empfehlen wir unser kostenloses Dolibarr-Modul, das WhatsApp- und Telegram-Felder automatisch anlegt und einen direkten Link aus der Kundenkarte in die MessengerHub-Inbox bietet.
Option A – UMH Connector Modul (empfohlen)
Das Modul automatisiert die Einrichtung und fügt einen „UMH Messenger"-Tab in jede Kundenkarte ein.
Download
Das Modul ist kostenlos und quelloffen (GPL v3):
- GitHub (sofort verfügbar):
github.com/VH1972/umh-dolibarr-connector →Code → Download ZIP - Dolistore (Freigabe ausstehend):
Wird in Kürze direkt über den Dolibarr-Modul-Store verfügbar sein.
Installation
- ZIP herunterladen und den Ordner
umhconnectornachhtdocs/custom/umhconnector/entpacken - Dolibarr → Einrichtung → Module/Anwendungen → Kategorie CRM → UMH Connector aktivieren
- Dolibarr → Einrichtung → UMH Connector → URL Ihrer MessengerHub-Instanz eintragen
Was das Modul macht
- Legt die Felder WhatsApp-Nummer und Telegram Chat-ID automatisch bei allen Kunden an
- Fügt den Tab „UMH Messenger" in jede Kundenkarte ein
- Ein Klick auf „Konversation öffnen" öffnet die passende Unterhaltung direkt in MessengerHub
Option B – Manuelle Einrichtung (ohne Modul)
Nur falls Ihr Hosting-Anbieter keine eigenen Module erlaubt.
Schritt 1 – API-Schlüssel in Dolibarr erstellen
- Melden Sie sich als Administrator in Ihrer Dolibarr-Instanz an
- Navigieren Sie zu Startseite → Einstellungen → Sicherheit
- Aktivieren Sie die REST API falls noch nicht aktiv
- Klicken Sie auf API-Token generieren und kopieren Sie den Token
Alternativ: Benutzerprofil (oben rechts → Mein Profil → API/External access)
Schritt 2 – Connector in MessengerHub einrichten
- Öffnen Sie Einstellungen → ERP-Connector
- Klicken Sie auf die Karte Dolibarr
- Füllen Sie alle Felder aus:
| Feld | Beispiel |
|---|---|
| Dolibarr URL | https://dolibarr.meinfirma.de |
| API-Key | Der in Schritt 1 kopierte Token |
- Klicken Sie auf 🔌 Verbindung testen → bei Erfolg erscheint ✓ Verbindung erfolgreich
- Klicken Sie auf Speichern
Schritt 3 – Telegram-Feld einrichten (nur bei manueller Installation)
Da Telegram keine Telefonnummer übermittelt, muss einmalig ein Extrafeld angelegt werden:
sql
INSERT INTO llx_extrafields (
name, entity, elementtype, label, type, size, fieldunique, enabled, list, pos
) VALUES (
'telegram_chat_id', 1, 'societe', 'Telegram Chat-ID', 'varchar', '255', 1, '1', '-1', 100
);
ALTER TABLE llx_societe_extrafields
ADD COLUMN IF NOT EXISTS telegram_chat_id VARCHAR(255) DEFAULT NULL;Hinweis für gehostete Instanzen: Leiten Sie diese SQL-Befehle an Ihren Hosting-Anbieter weiter.
Kundenerkennung
| Kanal | Wie wird der Kunde erkannt? |
|---|---|
| Telefonnummer im Standard-Feld „Telefon" des Kunden | |
| Telegram | Chat-ID im Feld „Telegram Chat-ID" (Extrafeld) |
Die Telegram Chat-ID erhalten Sie aus dem MessengerHub-Kontaktprofil des Kunden und tragen sie einmalig in der Kundenkarte ein.
Häufige Fragen
Wo finde ich die Telegram Chat-ID?
In MessengerHub → Inbox → Konversation öffnen → Kontaktname anklicken. Die numerische ID (z. B. 5556677889) dort kopieren und im Dolibarr-Kundenstamm eintragen.
Funktioniert die Kundenerkennung bei neuen Kunden automatisch?
Für WhatsApp ja – die Telefonnummer wird automatisch abgeglichen. Für Telegram muss die Chat-ID einmalig manuell eingetragen werden.