3CX Anbindung

1. Voraussetzungen

• Sie benötigen Zugang zur 3CX-Verwaltung (Administratorrolle)
• Sie benötigen Zugang zur Labordatenbank mit Auswertungszugriffsrecht
• Sie benötigen eine 3CX Pro- oder Enterprise-Lizenz (für CRM-Integration notwendig)

2. API in der Labordatenbank vorbereiten

• Öffnen Sie das SQL-Auswertungssystem der Labordatenbank
• Erstellen Sie eine neue Auswertung oder bearbeiten Sie eine bestehende, die Kontaktdaten ausgibt
• Bauen Sie eine SQL-Abfrage, die anhand einer Telefonnummer die zugehörigen Kontaktdaten liefert (z.B. Name, Firma, Mobil- und Festnetznummer)
• Beispiel: Nutzung von LIKE mit % für verschiedene Nummernformate
• Stellen Sie sicher, dass die Auswertung als JSON antwortet
• Testen Sie die Antwort mit verschiedenen Telefonnummern

3. HTTP-Schnittstelle konfigurieren (HTTP Pull)

• Gehen Sie zur Auswertung → Anbindungen → HTTP Pull konfigurieren
• Aktivieren Sie HTTP PULL und richten Sie Benutzername und Passwort ein
• Notieren Sie sich Benutzername und Passwort sowie die generierte URL für die Auswertung, z.B.: https://labordatenbank.com/demo/stats/view/id/https_json/VAR0/
• Optional: Testen Sie die URL im Browser oder mit Tools wie Postman, indem Sie eine Beispiel-Telefonnummer anhängen

4. Formatierung der JSON-Antwort prüfen/anpassen

• Die Antwort muss ein JSON-Objekt im geforderten Format der 3CX bereitstellen (kein Array)
• Falls die Antwort ein Array ist, setzen Sie einen Transformationscode ein, um sie in ein Objekt zu überführen
• Beispiel-Format: { "contact": { "id": "123", "name": "Max Mustermann", "company": "Beispiel GmbH", "mobile": "+491701234567", "business": "+49221123456" } }

5. 3CX Integration Wizard nutzen

• https://www.3cx.com/docs/crm-integration/
• Starten Sie den Integration Wizard (Navigieren Sie zu: File → New → CRM Template Wizard)
• Geben Sie die HTTP Pull-URL der Labordatenbank ein und setzen Sie in der URL als Platzhalter: .../json/[Number]
• Legen Sie das gewünschte Datenmapping (Name, Firma usw.) im Wizard fest. Die Variablen müssen denen der SQL-Auswertung entsprechen.

6. 3CX CRM Anbindung

• Melden Sie sich in der 3CX-Verwaltung an
• Wechseln Sie zu Admin → Integrationen → CRM
• Klicken Sie auf Vorlage hinzufügen
• Laden Sie die XML-Datei aus dem Integration Wizard hoch
• Hinterlegen Sie die Zugangsdaten aus der Labordatenbank Auswertung (Benutzername und Passwort)
• Speichern Sie die Konfiguration in 3CX (Button Speichern oberhalb)

7. Tests & Troubleshooting

• Klicken Sie auf Test (neben dem Speichern Button oberhalb)
• Geben Sie eine Telefonnummer oder einen Teil einer Nummer ein und klicken Sie auf Test
• Überprüfen Sie, ob der Name und die Firma des Anrufers korrekt angezeigt werden
• Falls Fehler auftreten, prüfen Sie:
  • Stimmt das Antwortformat (JSON-Objekt, keine Liste)?
  • Ist die Telefonnummer korrekt und im richtigen Format?
  • Gibt es archivierte oder doppelte Kontakte, die bereinigt werden sollten?

8. Abschluss: Live Tests

• Rufen Sie mit einer der Labordatenbank bekannten Nummer auf Ihrem 3CX System an
• Prüfen Sie, ob der Name des Kontakts angezeigt wird
• Bei weiteren Formatierungs- oder technischen Fehlern steht Ihnen das Team der Labordatenbank kostenpflichtig zur Verfügung