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

1. ZIP herunterladen und den Ordner umhconnector nach htdocs/custom/umhconnector/ entpacken
2. Dolibarr → Einrichtung → Module/Anwendungen → Kategorie CRM → UMH Connector aktivieren
3. 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

1. Melden Sie sich als Administrator in Ihrer Dolibarr-Instanz an
2. Navigieren Sie zu Startseite → Einstellungen → Sicherheit
3. Aktivieren Sie die REST API falls noch nicht aktiv
4. 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

1. Öffnen Sie Einstellungen → ERP-Connector
2. Klicken Sie auf die Karte Dolibarr
3. Füllen Sie alle Felder aus:

Feld	Beispiel
Dolibarr URL	https://dolibarr.meinfirma.de
API-Key	Der in Schritt 1 kopierte Token

4. Klicken Sie auf 🔌 Verbindung testen → bei Erfolg erscheint ✓ Verbindung erfolgreich
5. Klicken Sie auf Speichern

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

Da Telegram keine Telefonnummer übermittelt und WhatsApp ggf. auf einer anderen Nummer als „Telefon" läuft, müssen einmalig zwei Extrafelder angelegt werden:

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
);

INSERT INTO llx_extrafields (
  name, entity, elementtype, label, type, size, fieldunique, enabled, list, pos
) VALUES (
  'umh_whatsapp', 1, 'societe', 'WhatsApp-Nummer', 'varchar', '255', 1, '1', '-1', 101
);

ALTER TABLE llx_societe_extrafields
  ADD COLUMN IF NOT EXISTS telegram_chat_id VARCHAR(255) DEFAULT NULL;

ALTER TABLE llx_societe_extrafields
  ADD COLUMN IF NOT EXISTS umh_whatsapp VARCHAR(255) DEFAULT NULL;

Hinweis für gehostete Instanzen: Leiten Sie diese SQL-Befehle an Ihren Hosting-Anbieter weiter.

Ohne das Modul gibt es nur die Felder für die Kundenerkennung, keinen Versand-Button in der Kundenkarte — zum Anschreiben müssten Sie direkt in der MessengerHub-Inbox nach der Nummer suchen.

---

Kundenerkennung

Kanal	Wie wird der Kunde erkannt?
WhatsApp	Zuerst Feld „WhatsApp-Nummer" (Extrafeld umh_whatsapp), sonst Standard-Feld „Telefon"
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.

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

---

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, sofern die Nummer im Feld „Telefon" oder „WhatsApp-Nummer" steht. Für Telegram muss die Chat-ID einmalig manuell eingetragen werden.

Warum sendet der WhatsApp-Button nichts, obwohl eine Telefonnummer hinterlegt ist?
Das Feld „WhatsApp-Nummer" ist leer. Bewusst kein automatischer Rückgriff auf „Telefon" — sonst könnte eine kostenpflichtige Nachricht an eine Nummer ohne WhatsApp gehen, deren Antwort nie kommt. Einfach die Nummer im Feld „WhatsApp-Nummer" eintragen (auch wenn identisch mit Telefon).