Benutzerdefinierte CRM-Integration

Die Virtual-Call Cloud-Telefonanlage Custom CRM Integration bietet eine flexible Lösung für die Verbindung mit beliebigen Customer Relationship Management Systemen, die REST API unterstützen. Im Gegensatz zu vorkonfigurierten Integrationen ermöglicht die Custom CRM Integration die Definition der exakten API-Endpunkte, Authentifizierungsmethoden und Datenzuordnungen, die von Ihrer spezifischen CRM-Plattform benötigt werden. Dies gibt Ihrer Organisation vollständige Kontrolle darüber, wie Anrufdaten, Kontaktinformationen und Kundeninteraktionen zwischen Ihrer Telefonanlage und Ihrem CRM-System synchronisiert werden.

Übersicht

Custom CRM Integration funktioniert durch die Erstellung wiederverwendbarer Templates, die definieren, wie Ihre Virtual-Call Cloud-Telefonanlage mit der REST API Ihres CRM kommuniziert. Jedes Template spezifiziert:

• Authentifizierungsmethode wie sich die Telefonanlage bei Ihrem CRM authentifiziert (Basic Auth, OAuth 2.0, Bearer Token oder keine)
• Kontaktsuche-Konfiguration — API-Endpunkt und Feldzuordnungen zum Abrufen von Kontakten während Anrufen
• Kontakt-/Leaderstellung optionaler Endpunkt zum Erstellen neuer Kontakte oder Leads von der Telefonanlage
• Anrufprotokollierung optionaler Endpunkt zum Aufzeichnen von Anrufaktivitäten und Ergebnissen in Ihrem CRM

Nach der Erstellung eines Templates können Sie es bestimmten Benutzern oder Durchwahlen zuweisen und konfigurieren, wie es mit Ihren Telefonanlagen-Features wie Anruf-Popups, Kontaktsynchronisierung und Anrufprotokollierung integriert wird.

Voraussetzungen

Ein Integrations-Template erstellen

Integrations-Templates definieren die API-Konfiguration und Datenzuordnungen für Ihr benutzerdefiniertes CRM. Führen Sie die folgenden Schritte aus, um Ihr erstes Template zu erstellen:

Schritt 1: Zu Custom CRM navigieren

1. Melden Sie sich bei der Administrationskonsole Ihrer Virtual-Call Cloud-Telefonanlage an
2. Gehen Sie zu Integrations > CRM
3. Suchen Sie in der CRM-Integrationsliste nach Custom und klicken Sie darauf

Schritt 2: Ein neues Template erstellen

1. Klicken Sie auf die Schaltfläche Add, um ein neues benutzerdefiniertes CRM-Template zu erstellen
2. Ein Konfigurationsformular mit mehreren Abschnitten wird angezeigt

Schritt 3: Allgemeine Einstellungen konfigurieren

Geben Sie im Abschnitt General folgende Informationen ein:

• Template Name — Ein aussagekräftiger Name für diese Integration (z. B. „Salesforce Production" oder „HubSpot CRM")
• Logo optional. Die URL zu einem Logo-Bild, das Ihr CRM darstellt. Dieses Logo wird in der Telefonanlage Benutzeroberfläche angezeigt, wenn dieses Template ausgewählt wird
• Max Concurrent Requests — Die maximale Anzahl gleichzeitiger API-Anfragen, die die Telefonanlage an Ihr CRM sendet. Der empfohlene Wert liegt zwischen 5 und 20, abhängig von den API-Ratenlimits Ihres CRM. Beginnen Sie mit 10, falls Sie unsicher sind.

Schritt 4: Authentifizierung konfigurieren

Der Abschnitt „Authentifizierung“ definiert, wie sich Ihre Telefonanlage bei Ihrer CRM API authentifiziert. Wählen Sie die Methode, die den API-Anforderungen Ihres CRM entspricht:

• None — Keine Authentifizierung erforderlich. Verwenden Sie diese Option nur, wenn Ihre CRM API öffentlich ohne Anmeldedaten zugänglich ist (selten)
• Basic Authentication — Benutzername und Passwort. Geben Sie Ihren CRM API-Benutzernamen und Ihr Passwort ein
• OAuth 2.0 — Token-basierte Authentifizierung. Sie müssen Folgendes durchführen:
  • Autorisierung von Ihrem CRM über dessen OAuth 2.0-Endpunkte erhalten
  • Das von Ihrem CRM bereitgestellte Zugriffstoken und Aktualisierungstoken eingeben
  • Die Token-Aktualisierungs-URL angeben, damit die Telefonanlage abgelaufene Tokens automatisch aktualisiert
• Bearer Token — API-Schlüssel oder Zugriffstoken von Ihrem CRM. Geben Sie den Token-Wert direkt ein

Schritt 5: Kontaktsuche konfigurieren (erforderlich)

Die Kontaktsuche-Konfiguration ist erforderlich, damit alle anderen Integrations-Features funktionieren. Sie definiert, wie die Telefonanlage Ihr CRM abfragt, um während Anrufen Kontaktinformationen zu suchen.

API Endpoint URL: Geben Sie den REST API-Endpunkt aus Ihrem CRM ein, der die Kontaktsuche durchführt. Dies sieht normalerweise folgendermaßen aus:

• https://your-crm.com/api/v1/contacts/search
• https://api.salesforce.com/services/data/v57.0/sobjects/Contact
• https://api.hubapi.com/crm/v3/objects/contacts/search

Feldzuordnung für Kontaktsuche: Definieren Sie, welche Felder Ihr CRM zum Suchen verwendet und welche Felder die Telefonanlage aus der Antwort extrahieren soll:

• Search Field (CRM) — Der Feldname in Ihrem CRM, der durchsucht wird (normalerweise ein Telefonnummernfeld). Beispiel: phone, phoneNumber oder mobile_phone
• Match Field (PBX) — Welches Telefonnummernfeld des Anrufs zum Suchen verwendet werden soll: caller (eingehende Anrufer-ID), called (gewählte Nummer) oder both (beide durchsuchen)

• Result Field Mapping — Definieren Sie, welche Informationen aus der CRM-Antwort extrahiert werden sollen und wie diese in der Telefonanlage angezeigt werden:

  • contact_id — Eindeutige Kennung des Kontakts in Ihrem CRM
  • contact_name — Anzeigename des Kontakts
  • contact_phone — Anzuzeigende Telefonnummer
  • contact_email — E-Mail-Adresse (für Anruf-Popup oder Protokollierung)
  • contact_company — Unternehmensname
  • contact_department — Abteilung oder Geschäftsbereich
  • contact_notes — Zusätzliche Notizen oder Beschreibung

  Geben Sie für jedes Feld den genauen JSON-Pfad zum entsprechenden Wert in der API-Antwort Ihres CRM an

{
  "id": "12345",
  "fullName": "John Smith",
  "workPhone": "+1-555-0100",
  "email": "john@company.com",
  "company": "Acme Corp"
}

Schritt 6: Kontakt-/Leaderstellung konfigurieren (optional)

Wenn Ihre Organisation neue Kontakte oder Leads in Ihrem CRM von eingehenden Anrufen aus erstellt, aktivieren und konfigurieren Sie diesen Abschnitt:

• Enable Contact Creation — Umschalter zum Aktivieren dieser Funktion
• API Endpoint URL — Der REST API-Endpunkt zum Erstellen neuer Kontakte in Ihrem CRM. Beispiel: https://api.hubapi.com/crm/v3/objects/contacts

• Field Mapping for New Contacts — Definieren Sie, welche CRM-Felder beim Erstellen eines neuen Kontakts ausgefüllt werden sollen:

  • phone — Telefonnummer aus dem Anruf
  • firstName, lastName — Kontakt-Namenfelder
  • email — E-Mail-Adresse (falls verfügbar)
  • company — Unternehmensname (falls verfügbar)
  • source — Woher der Kontakt stammt (z. B. „PBX")
  • callDate, callDuration — Anruf-Metadaten

  Ordnen Sie diese Telefonanlagen-Felder den genauen Feldnamen Ihres CRM zu

Schritt 7: Anrufprotokoll konfigurieren (optional)

Das Anrufprotokoll zeichnet die Einzelheiten jedes Anrufs in Ihrem CRM auf, um einen vollständigen Kundeninteraktionsverlauf zu erhalten. Aktivieren Sie diesen Abschnitt, wenn Ihr CRM die Aktivitäts- oder Anrufprotokollierung unterstützt:

• Enable Call Journal — Umschalter zum Aktivieren der Anrufprotokollierung
• API Endpoint URL — Der REST API-Endpunkt zum Erstellen von Anrufdatensätzen oder Aktivitäten in Ihrem CRM. Beispiel: https://api.hubapi.com/crm/v3/objects/calls

• Field Mapping for Call Data — Definieren Sie, welche Anrufinformationen in Ihrem CRM protokolliert werden sollen:

  • contact_id — Die eindeutige Kontakt-ID, um den Anruf damit zu verknüpfen
  • call_direction — Richtung des Anrufs: eingehend oder ausgehend
  • call_type — Anruftyp: eingehend, ausgehend, verpasst oder Voicemail
  • duration — Anrufdauer in Sekunden
  • start_time — Wann der Anruf begonnen hat (Unix-Zeitstempel oder ISO-Format)
  • from_number — Telefonnummer der anrufenden Partei
  • to_number — Telefonnummer der angerufenen Partei
  • recording_url — URL zur Anrufaufzeichnung (falls zutreffend)
  • notes — Anrufnotizen oder Beschreibung

  Ordnen Sie diese den Aktivitätsfeldern Ihres CRM zu

Schritt 8: Template speichern und testen

1. Klicken Sie auf Save, um das Template zu erstellen
2. Das Template ist nun zur Zuweisung an Benutzer und Durchwahlen verfügbar
3. Nach der Zuweisung des Templates an Benutzer testen Sie die Integration durch einen Testanruf und überprüfen:
   • Kontaktinformationen werden im Anruf-Popup angezeigt (falls aktiviert)
   • Neue Kontakte können aus verpassten Anrufen erstellt werden (falls aktiviert)
   • Anrufdetails werden in Ihrem CRM protokolliert (falls aktiviert)

Verbinden und konfigurieren

Weisen Sie das Custom CRM Template Benutzern zu

Nach der Erstellung eines Templates müssen Sie es bestimmten Benutzern oder Durchwahlen zuweisen, damit die Integration funktioniert:

1. Gehen Sie zu Integrations > CRM
2. Wählen Sie Ihr benutzerdefiniertes CRM-Template aus der Liste
3. Klicken Sie im Abschnitt Associated Users/Extensions auf Add, um das Template zuzuweisen
4. Wählen Sie, welche Benutzer oder Durchwahlen diese CRM-Integration verwenden sollen
5. Klicken Sie auf Save

Verifizieren Sie Authentifizierungseinstellungen

Einige CRM-Integrationen erfordern periodische Neuzauthentifizierung oder Anmeldedaten-Aktualisierung. Überprüfen Sie, ob:

• Ihre Authentifizierungsanmeldedaten sind korrekt und aktiv in Ihrem CRM 
• API-Schlüssel oder Tokens nicht abgelaufen sind
• OAuth 2.0-Aktualisierungs-Tokens korrekt konfiguriert sind, falls Sie Token-basierte Authentifizierung verwenden

Konfigurieren Sie Integrations-Features

Kontaktsynchronisierung

Die Kontaktsynchronisierung hält Kontaktinformationen in Ihrem Virtual-Call UC Client mit Ihrem CRM synchronisiert. Diese Funktion ermöglicht:

• Automatische Kontaktsuche — Wenn ein Anruf ankommt, fragt die Telefonanlage automatisch Ihr CRM ab, um passende Kontaktinformationen zu finden
• Anruferinformationen anzeigen — Kontaktname, Unternehmen und andere Details werden während des Anrufs in Ihrem UC Client angezeigt
• Kontaktkennzeichnung — Kontakte aus Ihrem CRM werden mit der CRM-Quelle gekennzeichnet, um sie leicht zu identifizieren

So aktivieren Sie die Kontaktsynchronisierung:

1. Gehen Sie zu Integrations > CRM
2. Wählen Sie Ihr benutzerdefiniertes CRM-Template
3. Suchen Sie den Abschnitt Contact Synchronization und schalten Sie Enable
4. Überprüfen Sie, dass die Contact Search-Konfiguration korrekt eingerichtet ist (erforderlich für Synchronisierung)
5. Klicken Sie auf Save

Kontakt-/Leaderstellung

Das Kontakterstellungs-Feature ermöglicht Benutzern, neue Kontakte oder Leads direkt aus dem Virtual-Call UC Client in ihrem CRM zu erstellen, wenn sie einen neuen Anrufer treffen:

1. Gehen Sie zu Integrations > CRM
2. Wählen Sie Ihr benutzerdefiniertes CRM-Template
3. Überprüfen Sie im Abschnitt Contact Creation:
   • Enable Contact Creation ist umgeschaltet
   • Die API Endpoint URL ist korrekt konfiguriert
   • Die Feldzuordnung enthält mindestens die Telefonnummern- und Namenfelder
4. Klicken Sie auf Save

Nach der Aktivierung werden Benutzer eine „Create Contact"-Option im UC Client sehen, wenn sie Anrufe von unbekannten Kontakten anzeigen.

Anruf-Popup

Anruf-Popups zeigen Kundeninformationen auf dem Bildschirm an, wenn ein eingehender Anruf ankommt. Die Custom CRM Integration unterstützt zwei Anruf-Popup-Modi:

Modus 1: Popup mit Kontaktsuche-Ergebnissen

Dieser Modus verwendet die Kontaktsuche-Konfiguration, um Kontaktinformationen aus Ihrem CRM automatisch zu suchen und in einem Popup-Fenster anzuzeigen.

1. Gehen Sie zu Integrations > CRM
2. Wählen Sie Ihr benutzerdefiniertes CRM-Template
3. Aktivieren Sie im Abschnitt Call Popup die Option Enable Call Popup
4. Wählen Sie das Popup-Auslöseereignis:
   • When incoming call arrives — Popup wird sofort für eingehende Anrufe angezeigt
   • When answering call — Popup wird angezeigt, nachdem Sie den Anruf beantwortet haben
   • Always Query CRM kontinuierliche Aktualisierung der Kontaktinformationen während des Anrufs
5. Überprüfen Sie, dass die Contact Search-Konfiguration korrekt eingerichtet ist
6. Klicken Sie auf Save

Modus 2: Benutzerdefiniertes HTML-Popup mit URL-Formatstring

Für erweiterte Anpassung können Sie ein benutzerdefiniertes URL-Format definieren, das Ihr CRM für einen spezifischen Kundendatensatz öffnet, wenn ein Anruf ankommt:

1. Gehen Sie zu Integrations > CRM
2. Wählen Sie Ihr benutzerdefiniertes CRM-Template
3. Aktivieren Sie im Abschnitt Call Popup die Option Enable Custom URL Popup
4. Geben Sie das Popup URL Format ein. Dies sollte eine URL-Vorlage sein, die Platzhalter für Anrufinformationen enthält:
   • {caller_id} — Telefonnummer der anrufenden Partei
   • {contact_id} — CRM-Kontakt-ID (falls von der Kontaktsuche gefunden)
   • {contact_name} — Kontaktname (falls gefunden)
   • {company} — Unternehmensname (falls gefunden)
5. Beispiel-URL-Formate:
   • https://salesforce.com/lightning/r/Contact/{contact_id}/view
   • https://hubspot.com/contacts/{contact_id}
   • https://your-crm.com/search?phone={caller_id}
6. Klicken Sie auf Save

Anrufprotokoll

Das Anrufprotokoll zeichnet automatisch alle Anrufdetails in Ihrem CRM auf, um einen vollständigen Kundeninteraktionsverlauf zu erhalten:

1. Gehen Sie zu Integrations > CRM
2. Wählen Sie Ihr benutzerdefiniertes CRM-Template
3. Umschalten Sie im Abschnitt Call Journal die Option Enable Call Journal
4. Überprüfen Sie, dass die API Endpoint URL und Feldzuordnungen korrekt konfiguriert sind
5. Wählen Sie, welche Anruftypen protokolliert werden sollen:
   • Beantwortete Anrufe
   • Verpasste Anrufe
   • Voicemail-Nachrichten
6. Aktivieren Sie optional Include Call Recording, um Aufzeichnungs-URLs zu Anrufprotokolleinträgen hinzuzufügen
7. Klicken Sie auf Save

Nach der Protokollierung von Anrufen können Sie die Anrufaktivität in Ihrem CRM überprüfen, indem Sie zum Kontaktdatensatz navigieren. Das Anrufprotokoll bietet einen vollständigen Prüfpfad aller Kundeninteraktionen.

Templates bearbeiten und verwalten

Um ein vorhandenes benutzerdefiniertes CRM-Template nach der Erstellung zu ändern:

1. Gehen Sie zu Integrations > CRM
2. Suchen Sie Ihr benutzerdefiniertes CRM-Template in der Liste
3. Klicken Sie auf das Edit-Symbol (Bleistift) neben dem Template-Namen
4. Aktualisieren Sie beliebige Einstellungen wie API-Endpunkte, Feldzuordnungen oder Authentifizierungsanmeldedaten
5. Klicken Sie auf Save, um die Änderungen anzuwenden

Änderungen an Templates werden sofort für alle zugewiesenen Benutzer wirksam.

Fehlerbehebung

Kontaktsuche gibt keine Ergebnisse zurück

Problem: Anruf-Popups werden nicht angezeigt oder Kontaktinformationen werden während Anrufen nicht angezeigt.

Lösungen:

• Überprüfen Sie, dass die Kontaktsuche API Endpoint URL korrekt ist und von Ihrer Telefonanlage zugänglich ist
• Testen Sie den API-Endpunkt manuell mit einem Tool wie Postman oder curl, um sicherzustellen, dass er Kontaktdaten im erwarteten JSON-Format zurückgibt
• Überprüfen Sie, dass die Feldzuordnung korrekt ist — der JSON-Pfad sollte der tatsächlichen Struktur der API-Antwort Ihres CRM entsprechen
• Überprüfen Sie, dass die Telefonnummer in Ihrem CRM dem Anrufnummernformat entspricht (einige CRMs benötigen Nummern mit Landeskennzahlen wie +1-555-0100, andere verwenden 10-stelliges Format)
• Stellen Sie sicher, dass die Authentifizierung korrekt funktioniert, indem Sie überprüfen, dass Ihre Anmeldedaten gültig sind und das Token nicht abgelaufen ist
• Überprüfen Sie die Telefonanlage-Logs (Administration > System > Logs) auf API-Fehler oder Timeout-Meldungen

Authentifizierungsfehler

Problem: API-Aufrufe schlagen mit 401 (Unauthorized) oder 403 (Forbidden) Fehlern fehl.

Lösungen:

• Überprüfen Sie, dass Ihre Authentifizierungsanmeldedaten (Benutzername, Passwort, API-Schlüssel oder Token) korrekt sind und nicht abgelaufen sind
• Für OAuth 2.0-Integrationen stellen Sie sicher, dass das Zugriffstoken gültig ist. Falls abgelaufen, sollte das Aktualisierungstoken verwendet werden, um ein neues Zugriffstoken zu erhalten
• Überprüfen Sie die API-Dokumentation Ihres CRM, um das von Ihrem CRM benötigte Authentifizierungs-Header-Format zu bestätigen.
• Überprüfen Sie, dass das API-Benutzerkonto die erforderlichen Berechtigungen zum Durchführen von Kontaktsuche-, Erstellungs- und Anrufprotokollierungsvorgängen hat
• Einige CRMs erfordern IP-Whitelisting — bestätigen Sie, dass die IP-Adresse Ihrer Telefonanlage zum Zugriff auf die API autorisiert ist
• Testen Sie den API-Endpunkt mit den gleichen Anmeldedaten mit einem Tool wie Postman, um zu isolieren, ob das Problem bei der Telefonanlage-Konfiguration oder der CRM API liegt

Kontakterstellung funktioniert nicht

Problem: Neue Kontakte können nicht vom UC Client erstellt werden oder verpasste Anrufe werden nicht als neue Kontakte protokolliert.

Lösungen:

• Überprüfen Sie, dass die Kontakterstellung API Endpoint URL korrekt ist
• Überprüfen Sie, dass die Feldzuordnung die erforderlichen Felder für Ihr CRM enthält (mindestens das Telefonnummernfeld sollte zugeordnet sein)
• Stellen Sie sicher, dass das API-Benutzerkonto die Berechtigungen „Create Contact" oder „Create Lead" in Ihrem CRM hat
• Überprüfen Sie die API-Dokumentation Ihres CRM, um die erforderlichen und optionalen Felder für die Kontakterstellung zu bestätigen
• Testen Sie den Endpunkt manuell durch Senden einer POST-Anfrage mit beispielhaften Kontaktdaten, um zu überprüfen, dass er funktioniert
• Überprüfen Sie die Telefonanlage-Logs auf Fehlermeldungen im Zusammenhang mit Kontakterstellungsausfällen

Anrufprotokolleinträge werden nicht angezeigt

Problem: Anrufdetails werden nach der Anrufbeendigung nicht in Ihrem CRM aufgezeichnet.

Lösungen:

• Überprüfen Sie, dass die Anrufprotokollierung in den CRM-Integrationseinstellungen aktiviert ist
• Überprüfen Sie, dass die Anrufprotokoll API Endpoint URL korrekt und zugänglich ist
• Stellen Sie sicher, dass die Feldzuordnungen für Anrufdaten korrekt sind und den Aktivitätsfeldnamen Ihres CRM entsprechen
• Überprüfen Sie, dass die Kontaktsuche (Contact Search) korrekt funktioniert — das Anrufprotokoll erfordert normalerweise eine gültige contact_id zum Verknüpfen der Anrufaktivität mit einem Kontakt
• Überprüfen Sie die Berechtigungen Ihres CRM, um sicherzustellen, dass der API-Benutzer Aktivitäts- oder Anrufdatensätze erstellen kann
• Überprüfen Sie die Telefonanlage-Logs (Administration > System > Logs) auf API-Fehler oder Timeout-Fehler während der Anrufprotokollierung
• Einige CRMs haben unterschiedliche API-Endpunkte für verschiedene Aktivitätstypen — überprüfen Sie, dass Sie den korrekten Endpunkt für die Anrufprotokollierung verwenden

Popup-Fenster wird nicht geöffnet

Problem: Benutzerdefinierte URL-Popups werden beim Eintreffen von Anrufen nicht angezeigt.

Lösungen:

• Überprüfen Sie, ob Ihr Webbrowser Popup-Blockierung aktiviert hat. Fügen Sie Ihre CRM-Domain zur Popup-Whitelist des Browsers hinzu
• Überprüfen Sie, dass das Popup-URL-Format korrekt formatiert ist und die richtigen Platzhalter ({caller_id}, {contact_id} usw.) enthält
• Testen Sie das URL-Format, indem Sie manuell eine URL mit beispielhaften Daten konstruieren und diese in Ihrem Browser aufrufen
• Stellen Sie sicher, dass die CRM-Website das Öffnen in einem separaten Fenster unterstützt (einige Anwendungen blockieren Framing oder Popups aus Sicherheitsgründen)
• Überprüfen Sie, dass die URL keine Sonderzeichen oder Leerzeichen enthält, die sie fehlerhaft machen könnten
• Einige CRM-Plattformen haben iframe-Blockierung aktiviert — überprüfen Sie, dass Ihr CRM externe Popups erlaubt

API-Ratenlimit überschritten

Problem: Sie erhalten Ratelimit-Fehler (HTTP 429) von Ihrer CRM API.

Lösungen:

• Reduzieren Sie die Einstellung Max Concurrent Requests in den allgemeinen Einstellungen des Templates. Verringern Sie diesen Wert, wenn Ihr CRM strikte Ratelimits hat (versuchen Sie 5 statt 20)
• Überprüfen Sie die API-Dokumentation Ihres CRM auf Ratelimit-Richtlinien und Kontingente
• Kontaktieren Sie Ihren CRM-Anbieter, um ein höheres Ratelimit-Kontingent anzufordern, falls erforderlich
• Deaktivieren Sie Features, die nicht benötigt werden (wie „Always Query CRM" während des Anrufs), um die Häufigkeit von API-Aufrufen zu reduzieren
• Überprüfen Sie, ob Ihr CRM Batch-API-Endpunkte bietet, die das Abfragen mehrerer Kontakte in einer einzelnen Anfrage ermöglichen, was möglicherweise effizienter ist

Deaktivieren oder trennen

Integration vorübergehend für bestimmte Benutzer deaktivieren

Um die CRM-Integration für bestimmte Benutzer zu stoppen, während das Template konfiguriert bleibt:

1. Gehen Sie zu Integrations > CRM
2. Wählen Sie Ihr benutzerdefiniertes CRM-Template
3. Suchen Sie im Abschnitt Associated Users/Extensions die Benutzer, die Sie entfernen möchten
4. Klicken Sie neben jedem Benutzer oder jeder Durchwahl auf die Schaltfläche Remove
5. Klicken Sie auf Save

Das Template bleibt gespeichert und kann jederzeit Benutzern neu zugewiesen werden.

Ein Template löschen

Um ein benutzerdefiniertes CRM-Template dauerhaft zu entfernen:

1. Gehen Sie zu Integrations > CRM
2. Suchen Sie das Template, das Sie löschen möchten
3. Klicken Sie auf das Delete-Symbol (Papierkorb) neben dem Template-Namen
4. Bestätigen Sie das Löschen, wenn Sie aufgefordert werden

Die gesamte Custom CRM Integration deaktivieren

Um alle benutzerdefinierten CRM-Funktionen auf Ihrer Telefonanlage auszuschalten:

1. Gehen Sie zu Integrations > CRM
2. Suchen Sie den Abschnitt Custom CRM
3. Umschalten Sie Enable Custom CRM aus
4. Klicken Sie auf Save

Alle Kontaktsuche-, Anruf-Popup-, Kontakterstellungs- und Anrufprotokollierungsfunktionen werden deaktiviert. Templates und Konfigurationsdaten bleiben erhalten und können jederzeit wieder aktiviert werden.

Best Practices

• Testen Sie gründlich vor der Bereitstellung — richten Sie zuerst ein Test-Template mit einer nicht-produktiven CRM-Instanz ein, um zu überprüfen, dass alle API-Endpunkte und Feldzuordnungen korrekt funktionieren, bevor Sie für Endbenutzer bereitstellen.
• Dokumentieren Sie Ihre API-Endpunkte führen Sie detaillierte Notizen über die CRM-Endpunkte, die Sie verwenden, und wie Felder zugeordnet werden. Dies hilft bei der Fehlerbehebung und bei zukünftigen Aktualisierungen.
• Überwachen Sie API-Ratelimits — Beginnen Sie mit konservativen Max Concurrent Requests-Einstellungen und erhöhen Sie diese schrittweise bei Bedarf, während Sie nach Ratelimit-Fehlern überwachen
• OAuth-Tokens regelmäßig aktualisieren — Falls Sie OAuth 2.0 verwenden, überprüfen Sie, dass Aktualisierungs-Tokens ordnungsgemäß konfiguriert sind, und testen Sie regelmäßig, um sicherzustellen, dass Tokens nicht unerwartet ablaufen
• Verwenden Sie Kontaktsuche für alle Features — stellen Sie sicher, dass Kontaktsuche korrekt konfiguriert ist, bevor Sie Anruf-Popups oder Anrufprotokollierung aktivieren, da diese Features von erfolgreichen Kontaktsuchen abhängen
• Testen Sie mit echten Telefonnummern Überprüfen Sie, dass Telefonnummern in Ihrem CRM dem Format entsprechen, das von Ihrer Telefonanlage verwendet wird (einige Systeme verwenden internationales Format +1-555-0100, andere verwenden 10-stelliges Format 555-0100).
• Sichern Sie API-Anmeldedaten teilen Sie niemals API-Schlüssel, Tokens oder Passwörter. Behandeln Sie sie mit der gleichen Sicherheitsstufe wie Benutzerkennwörter
• Überprüfen Sie Anrufprotokoll-Daten**— Überprüfen Sie regelmäßig, dass Anrufe korrekt in Ihrem CRM aufgezeichnet werden, um Datenbeschaffenheit und Vollständigkeit sicherzustellen
• Halten Sie Templates aktualisiert — Falls Ihr CRM seine API-Endpunkte aktualisiert oder neue Features hinzufügt, aktualisieren Sie Ihre benutzerdefinierten CRM-Templates entsprechend.

Neue Authentifizierungsmethode ab Version 84.23.0.24

OAuth2 PKCE-Unterstützung

Für benutzerdefinierte CRM/Helpdesk-Integrationsvorlagen steht jetzt die Authentifizierungsmethode Authorization Code Flow with Proof Key for Code Exchange (PKCE) zur Verfügung. Diese Methode verwendet ein Challenge-Verifier-Paar anstelle eines Client-Secrets und erhöht dadurch die Sicherheit der OAuth 2.0-Authentifizierung.