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
- Öffne rechts oben das Benutzer-Menü und Settings.
- Wähle Extensions → Phone Configuration → Add Gateway.
- Setze Gateway auf Generic, Gateway Status auf Active und vergib ein Label, zum Beispiel callmetra.
- Default Gateway nur bewusst ändern. Für diese Einrichtung ist kein Wechsel eines bereits produktiven Standard-Gateways erforderlich.
- 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.
- 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.
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
- Melde dich als vorgesehener Nutzer in Vtiger an und prüfe Phone Popup Configuration und Telefonie-Rechte.
- Wähle Vtiger testen an der callmetra.-Verbindung, dann eine Mitarbeiterzuordnung.
- 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.
- 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.
- 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.
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.