pFlex

# 3cx CRM Extension für Proffix

Serverseitige Extension für die Verbindung zwischen Proffix Adressverwaltung und 3cx Telefonanlagen.

alt text

# Features

  • Ermöglicht das Anzeigen von Proffix Adressinformationen auf 3cx und sämtlichen mit der Anlage verbundenen Geräten
  • Eingehende Anrufer werden in Proffix Adressverwaltung nachgeschlagen und via 3cx Kontakte allen Geräten zur Verfügung gestellt
  • Einfache, unkomplizierte Installation (als Proffix REST-API Erweiterung)
  • Schnell und asynchron (beeinflusst PROFFIX und 3cx Betrieb nicht)
  • Plattformunabhängig. Siehe auch Installation

# Beispiel-Konfiguration

Sämtliche Konfiguration erfolgt über eine config.json welche sich im selben Verzeichnis wie das Tool befinden muss.

Beispiel:


{
  "apikeyextension": "633f1438c55ddff73e7207b22cb04d08",
  "database": "DEMODB",
  "debug": false,
  "host": "https://myrest.demo.ch",
  "password": "ec49fedeb66debf73249eb668b311908f646f4b2d7c5426ecf6ee2537f65594b",
  "port": 12122,
  "user": "USR",
  "vollizenz": false,
  "activation": "DEMO",
  "licence": "",
}
Parameter Typ Bemerkung
Apikeyextension string API-Key für die Extension: wird automatisch generiert und muss bei Installation auch in 3cx angegeben werden
Database string PROFFIX Datenbank
Host string Hostname der Proffix REST-API
Port int Port der Proffix REST-API
User string Benutzer der Proffix REST-API
Password string Passwort eines Proffix Benutzers als SHA256-Hash
Debug bool Aktiviert Debug-Modus
Activation int Aktivierungscode; Demo wird automatisch generiert
Lizenz string Lizenz: Demolizenz wird automatisch generiert

# Installation

Das Tool besteht aus einer einzigen, kompilierten Datei. Zum testen kann das Tool nur ausgeführt werden - für den produktiven Einstatz empfiehlt sich die Installation als Dienst.

Bei der erstmaligen Ausführung (per Doppelklick) generiert das Tool folgende Dateien im selben Verzeichnis:

  • Px5.xml
  • extension.zip

Diese Dateien werden bei Updates automatisch aktualisiert.

# Installation als Dienst

Das Tool kann mittels des Parameters install als Dienst installiert werden.

Empfohlen wird als Installationsort derselbe Server wo auch die Proffix REST-API liegt.

  1. Unter C:\ einen neuen Ordner erstellen; z.B. 3cxPx
  2. Das Tool in den entsprechenden Ordner kopieren
  3. Per Doppelklick das Tool ausführen - die erforderlichen Hilfsdateien werden automatisch im selben Ordner erstellt
  4. Das config.json anpassen. Wichtig hier v.a. die Auswahl eines freien Ports - dieser muss grundsätzlich nicht freigegeben werden, da der Dienst / Proffix REST-API nur lokal miteinander kommunizieren.
  5. Anschliessend das Tool mittels Doppelklick noch einmal ausführen. Die extension.zip wird automatisch an das config.json angepasst.
  6. Nun kann das Tool mittels Parameters install als Dienst installiert werden. Dazu einfach die Kommandozeile / CMD als Administrator öffnen, zum Pfad des Tools navigieren und dieses mit folgendem Befehl installieren: 3cxpx.exe install

Anschliessend unter Dienste prüfen ob der Dienst läuft bzw. erstmalig starten

# Konfiguration als Proffix REST-API Erweiterung

Den Proffix REST-API Manager und die gewünschte Instanz öffnen.

Dann mittels Klick auf den markierten Button das extension.zip aus dem oben erstellten Ordner auswählen und installieren.

alt text

Anschliessend die REST-API neu erstellen lassen.

# Konfiguration in 3cx

In 3cx unter Einstellungen --> Integrationen den Menüpunkt CRM aufrufen.

Hier kann mittels Button Hochladen das Erweiterungstemplate Px5.xml hochgeladen werden.

alt text

Mittels "Testen" kann die Extension getestet werden.

TIP

Die Anzeige auf mit 3cx verbundenen Geräten funktioniert erst beim zweiten Anruf einer Nummer. Diese Einschränkung ist 3cx-seitig gegeben und kann nicht geändert werden.

# Demoversion

Eine Demoversion dieses Tools kann einfach und unkompliziert automatisch bezogen werden. Details dazu finden Sie unter Demo

← Digitec Publisher Proffix →