Auf dieser Seite
callmetra.Dokumentation
Workspace ↗
Dokumentationsnavigation
callmetra./Dokumentation/Vtiger Cloud verbinden

Integrationen

Vtiger Cloud verbinden

Vtiger Cloud Generic Gateway anlegen, Office Phone zuordnen und Telefonie-Integration mit Statusanzeige testen.

Aktualisiert

CRM-Gateway einrichten

Du brauchst einen Organisationsadmin in callmetra., einen freien CRM-Verbindungsplatz und Administratorrechte in Vtiger Cloud. Die Integration nutzt die Generic Phone Calls API für Anrufereignisse und Popups.

Generic-Gateway in Vtiger Cloud anlegen

  1. Öffne rechts oben das Benutzer-Menü und Settings.
  2. Wähle Extensions → Phone Configuration → Add Gateway.
  3. Setze Gateway auf Generic, Gateway Status auf Active und vergib ein Label, zum Beispiel callmetra.
  4. Default Gateway nur bewusst ändern. Für diese Einrichtung ist kein Wechsel eines bereits produktiven Standard-Gateways erforderlich.
  5. Lasse Enable Outgoing Calls für diesen Ablauf deaktiviert. Der Adapter protokolliert auch ausgehende Anrufe, wählt aber keine Nummer per CRM-Click-to-Call.
  6. Speichere und kopiere den Vtiger Secret Key sicher. Das ist das Gateway-Secret für callmetra.

Alternativ führt der Weg je nach Oberfläche über Phone Calls → Settings/Customize → Phone Configuration/Provider Configuration. Fehlt das Modul, prüfe Edition, Installation und Rechte. Offizielle Telefonie-Anleitung.

Öffne danach Integrationen → Integration hinzufügen → Vtiger Cloud in callmetra. Trage die Mandantendomain, etwa firma.od2.vtiger.com, ohne Pfad ein und hinterlege das Gateway-Secret. Speichere. Unterstützt sind direkte Cloud-Subdomains sowie regionale odN-/odx-Hosts.

Vtiger-Formular der fiktiven Demo ohne sichtbare Geheimnisse.
Vtiger-Formular der fiktiven Demo ohne sichtbare Geheimnisse.

Vtiger-Formular der fiktiven Demo ohne sichtbare Geheimnisse.

Mitarbeiter zuordnen

Öffne in Vtiger Settings → User Management → Users und bearbeite jeden vorgesehenen CRM-Nutzer. Hinterlege dessen Office Phone; alternativ liegt das Feld im jeweiligen My Preferences-Profil.

Öffne in callmetra. Mitarbeiter zuordnen oder Zuordnungen verwalten. Ordne die Telefon-Nebenstelle genau diesem Office-Phone-Wert zu. Die Nebenstelle und Office Phone müssen nicht gleich sein. Ein beliebiger Kontakt-Telefonwert ersetzt das Nutzerfeld nicht. Suche und Seitennavigation helfen bei großen Teams.

Vtiger verwendet den Zielwert zur Nutzerzuordnung. Ohne passenden Office-Phone-Eintrag kann ein technischer Versand erfolgreich sein und das erwartete Popup trotzdem fehlen. Office Phone und Anrufereignisse.

Autorisierten Test durchführen

  1. Melde dich als vorgesehener Nutzer in Vtiger an und prüfe Phone Popup Configuration und Telefonie-Rechte.
  2. Wähle Vtiger testen an der callmetra.-Verbindung, dann eine Mitarbeiterzuordnung.
  3. Test starten erfordert außerhalb der Demo eine Bestätigung: Es entsteht ein echter CRM-Testdatensatz und vorhandene Workflows können ausgelöst werden. Es wird kein Telefon gewählt.
  4. Prüfe den angezeigten Zustellstatus und das Popup im CRM. Test beenden reiht das Abschlussereignis sofort ein; zusätzlich ist ein Abschluss nach 60 Sekunden geplant. Wiederholungen können ihn verzögern. Der Testdatensatz bleibt erhalten.
  5. Bestätige das Popup an der Verbindungskarte erst, wenn du es tatsächlich gesehen hast.

Der Dialog verfolgt Start und Abschluss getrennt. HTTP-Erfolg ist kein automatischer Popup-Nachweis. Die Demo simuliert den Versand. Prüfe anschließend einen echten eingehenden, angenommenen und beendeten Anruf sowie bei Bedarf ausgehende Anrufe und Transfers.

Fiktive Integrationen und Zustellaktivität in callmetra.
Fiktive Integrationen und Zustellaktivität in callmetra.

Fiktive Integrationen und Zustellaktivität in callmetra.

Generic Phone Calls API und REST-API unterscheiden

Der Telefonie-Adapter sendet Formular-POSTs an /modules/PhoneCalls/callbacks/Generic.php mit X-VTIGER-SECRET. Er überträgt initiated, connected, hangup und zuordenbare Transfers unter derselben Anruf-ID.

Die allgemeine Vtiger REST-API verwendet dagegen Login-Benutzername und persönlichen Access Key. Diese Zugangsdaten sind kein Gateway-Secret und werden für diesen Adapter nicht benötigt.

Wenn das Popup fehlt

Prüfe Gateway-Status und Secret, die exakte Office-Phone-Zuordnung, den angemeldeten Vtiger-Nutzer und Popup-Rechte. Unter Zustellaktivität stehen Wiederholungen und Fehler. Eine HTML-Loginseite wird nicht als erfolgreiche API-Zustellung gewertet. Danach Fehlerdiagnose nutzen; keine Secrets oder vollständigen Kundendaten in Supportnachrichten senden.

callmetra. · Every call. Measurable insights.Kontakt ↗