Lernen sie mokapen

3CX

3CX verbindet die Telefonanlage mit Mokapen für das Kontakt-Popup, das Anrufjournal und, wenn Sie es konfigurieren, Click-to-Call. Mokapen wird nicht zur Telefonanlage: es erzeugt einen API-Key und ein XML-Template, das Sie in der 3CX-Admin laden. Von dort fragt 3CX bei Mokapen, wer die Nummer ist, und Mokapen kann die Anrufnotiz auf Kontakt oder Unternehmen schreiben.

Überblick: Integrationen.

Voraussetzungen

• Eine 3CX-Installation, in der Sie Admin → Integrations → CRM öffnen und ein Template laden können.
• Mokapen-Plan Medium.
• Für Click-to-Call zusätzlich: 3CX-Plan mit Call Control / WebAPI (Enterprise), ein von Mokapen erreichbarer 3CX-Host und eine dem klickenden Benutzer zugeordnete Nebenstelle.

API-Key und Template

Benutzermenü → Integrationen → 3CX. Mokapen zeigt den API-Key für das CRM-Template: als Benutzername der Basic Auth oder im Header X-Api-Key. Laden Sie das XML-Template herunter. Der Key ist bereits als Standardwert eingefügt. Laden Sie es in 3CX Admin → Integrations → CRM.

Auf der Seite finden Sie auch die Basis-URL der CRM-APIs: das ist die Adresse, die das Template aufruft. Wenn 3CX hinter einem Netz steht, das Mokapen nicht erreicht, öffnet sich das Popup nicht, auch mit geladenem Template.

Sie können den Key beim Speichern neu erzeugen. Der vorherige gilt nicht mehr: das Template muss neu geladen oder der bereits in 3CX eingefügte Key aktualisiert werden. Den alten Key in der Anlage zu lassen erzeugt Authentifizierungsfehler, keine zweite Verbindung.

Anrufnotizen und Click-to-Call

Zwei Schalter steuern das Verhalten zum Adressbuch:

• Anrufnotizen auf Kontakten und Unternehmen speichern — am Ende des Anrufs schreibt Mokapen die Notiz auf die gefundene Karte.
• Kontaktanlage aus 3CX erlauben, wenn die Nummer unbekannt ist — fehlt die Nummer im Adressbuch, legt Mokapen den Kontakt an. Schalten Sie es aus, wenn die Anlage allgemeinen Verkehr empfängt (Standortzentrale, Höflichkeitsnummern): sonst wird jeder Unbekannte eine Karte.

Click-to-Call ist getrennt. Es braucht 3CX-Host (FQDN) und WebAPI-/Call-Control-Key. Ohne Key sagt Mokapen, dass der Call-Control-Key nicht konfiguriert ist. Ohne Host, dass der FQDN fehlt. Ohne Mapping weiß der Anruf nicht, welche Nebenstelle klingeln soll.

Das Mapping ist eine Zeile pro Person, in der Form nebenstelle=user_id (Beispiel 102=15). Es dient sowohl dazu, die Anrufnotiz dem richtigen Benutzer zuzuordnen, als auch für Click-to-Call. Fehlt Ihrem Benutzer eine Zeile, sagt Mokapen, dass keine Nebenstelle zugeordnet ist. Der normale Klick ruft mit 3CX an; Umschalt, Strg oder Alt zusammen mit dem Klick öffnet den Dialer des Geräts.

Wenn 3CX die Anfrage ablehnt, prüfen Sie der Reihe nach FQDN, Call-Control-Key und Nebenstelle. Die Meldung auf der Seite lautet, dass 3CX den Anruf nicht akzeptiert hat.

Wann das Popup nicht erscheint

• Das Template wurde nicht geladen, oder es wurde vor der Neuerzeugung des Keys geladen.
• Die eingehende Nummer stimmt mit keinem Telefon im Adressbuch überein und die automatische Anlage ist aus. Das Popup hat keine Karte zum Öffnen.
• Sie suchen den Videoanruf des Termins. 3CX legt Meet oder Teams nicht auf die Terminkarte.