Die AIVA-Protokollierung erfasst automatisch jede Interaktion, die von einem Virtual Agent (VA), Aircalls KI-gestütztem Sprach-Bot, bearbeitet wird, direkt in Salesforce. So haben Agenten und Manager jederzeit vollständige Transparenz darüber, was während eines Anrufs passiert ist – unabhängig davon, ob er vom VA gelöst oder an einen menschlichen Agenten eskaliert wurde.

Für jeden VA-Anruf werden in Salesforce zwei Datensätze erstellt:

  • Aircall Log Object (ALO): Der Hauptdatensatz zum Anruf mit Details wie Zeitpunkt, Dauer, Ergebnis und Beteiligung eines Agenten
  • Task: Ein Aktivitätsdatensatz, der mit dem Kontakt verknüpft ist und in der Aktivitätszeitleiste sichtbar ist

Was die VA-Protokollierung auslöst

Die Protokollierung wird anhand von drei wichtigen Zeitpunkten während eines VA-Anrufs gestartet und aktualisiert:

ZeitpunktWas passiert istWas Salesforce sieht
VA nimmt den Anruf anDer VA beginnt mit der Bearbeitung des KundenEin neuer ALO und Task werden sofort erstellt
VA beendet den AnrufDer VA löst das AnliegenDer Datensatz wird mit Dauer, Endzeit und einer VA-Lösungskennzeichnung aktualisiert
VA übergibt an einen MenschenDer VA eskaliert den AnrufDer Datensatz wird aktualisiert, um die Übergabe an einen Agenten widerzuspiegeln

Was während eines VA-Anrufs passiert

Schritt 1: Kunde ruft an und VA antwortet

Sobald der VA antwortet:

  • Wird ein neuer ALO-Datensatz erstellt mit:
    • VA-Name
    • Nummer des Anrufers
    • Startzeit des Anrufs
    • Ein Kennzeichen für die Bearbeitung durch den VA
  • Ein Task wird erstellt und mit dem Kontakt verknüpft, falls in Salesforce einer vorhanden ist

Das Format der Betreffzeile:

  • „John Smith called from VA Support Bot“, wenn der Kontakt vorhanden ist
  • „+447911123456 called from VA Support Bot“, wenn der Kontakt nicht vorhanden ist

Schritt 2: Menschlicher Agent nimmt teil (falls zutreffend)

Wenn ein menschlicher Agent am Anruf teilnimmt:

  • Werden die Datensätze mit dem Namen des Agenten aktualisiert
  • Wird der Anrufstatus aktualisiert
  • Bleiben alle zuvor erfassten VA-Daten erhalten

Schritt 3(a): VA löst den Anruf

Wenn der VA die Interaktion ohne menschliche Hilfe abschließt:

  • Wird die Endzeit hinzugefügt
  • Wird die Anrufdauer berechnet
  • Wird die Ergebniskennzeichnung auf Handled by VA gesetzt

So können Teams vollständig automatisierte Lösungen nachverfolgen.

Schritt 3(b): VA übergibt den Anruf

Wenn der VA den Anruf eskaliert:

  • Wird die Ergebniskennzeichnung auf Transferred to Agent aktualisiert
  • Wird dem Datensatz ein Eskalationskennzeichen hinzugefügt

Das unterstützt die Berichterstattung zur Eskalationshäufigkeit.

Wie Anrufe gekennzeichnet werden

Jeder VA-Anruf enthält neben den standardmäßigen Anruf-Tags eine Ergebniskennzeichnung.

KennzeichnungBedeutung
  • Handled by VA
Der VA hat den Anruf ohne menschliche Beteiligung gelöst
  • Transferred to Agent
Der VA hat den Anruf an einen menschlichen Agenten eskaliert

Aktivierung der VA-Protokollierung

Die VA-Protokollierung wird durch zwei Einstellungen gesteuert, die vom Aircall-Integrations-Team verwaltet werden:

EinstellungWas sie steuert
  • VA Logging Enabled
Aktiviert oder deaktiviert die VA-Protokollierung vollständig
  • ALO Creation Enabled
Legt fest, ob ALO-Datensätze erstellt werden oder nur Tasks

Was Sie mit VA-Daten in Salesforce tun können

Nach der Aktivierung können Teams:

  • Vom VA bearbeitete Anrufe in der Aktivitätszeitleiste des Kontakts anzeigen
  • Berichte nach Handled by VA filtern, um die Self-Service-Quote zu messen
  • Nach Transferred to Agent filtern, um Eskalationen zu analysieren
  • Dauern zwischen rein vom VA bearbeiteten und eskalierten Anrufen vergleichen
  • Ermitteln, welcher VA jeden Anruf bearbeitet hat

Anforderung an Salesforce-Berechtigungssätze

Ein häufiger Grund dafür, dass keine ALO-Datensätze erstellt werden, sind fehlende Berechtigungen.

Achtung: Der Salesforce-Integrationsbenutzer muss den Aircall_PermissionSet zugewiesen haben. Ohne ihn können ALO-Datensätze nicht erstellt oder aktualisiert werden.
Name des BerechtigungssatzesGilt fürAuswirkung, wenn er fehlt
Aircall_PermissionSetSalesforce-IntegrationsbenutzerALO-Datensätze werden nicht erstellt, Tasks können weiterhin erstellt werden

Schritte zum Zuweisen des Berechtigungssatzes

  1. Gehen Sie in Salesforce zu Setup
  2. Suchen Sie nach Users und öffnen Sie den Integrationsbenutzer
  3. Scrollen Sie zu Permission Set Assignments und klicken Sie auf Edit Assignments
  4. Verschieben Sie Aircall_PermissionSet in die Liste der aktivierten Elemente
  5. Klicken Sie auf Save

Der nächste VA-Anruf sollte ALO-Datensätze korrekt erstellen. Ein Neustart ist nicht erforderlich.

Fehlerbehebung bei Problemen mit der VA-Protokollierung

Problem 1: In Salesforce werden keine Datensätze erstellt

Symptome: Nach einem VA-Anruf erscheint weder ein Task noch ein ALO.

UrsacheErklärungLösung
VA-Protokollierung nicht aktiviertDie Funktion ist standardmäßig deaktiviertKontaktieren Sie unseren Customer Support, um sie zu aktivieren
Verzögerung beim initialen EreignisDer Hintergrundprozess versucht es bis zu 15 Minuten lang erneutWarten und erneut prüfen
Fehlende BerechtigungenDer Integrationsbenutzer hat keinen ZugriffBerechtigungen prüfen und Aircall_PermissionSet zuweisen
ALO nicht installiertAircall-Paket fehltPaket installieren und bestätigen, dass das ALO-Objekt vorhanden ist

Problem 2: Task erstellt, aber kein ALO

Symptome: Task ist vorhanden, aber kein ALO-Datensatz.

UrsacheErklärungLösung
Fehlender BerechtigungssatzHäufigste UrsacheAircall_PermissionSet zuweisen
ALO-Erstellung deaktiviertNur Tasks sind konfiguriertALO-Erstellung aktivieren
Protokollierungsmodus nur für TasksIntegrationseinstellung begrenzt die ProtokollierungAuf Task und ALO setzen

Problem 3: Fehlende Dauer oder Endzeit

Symptome: Datensätze zeigen 0 Dauer oder keine Endzeit an.

UrsacheErklärungLösung
Endereignis nicht verarbeitetBefindet sich noch in der WarteschlangeWarten und aktualisieren
Endereignis fehlgeschlagenFehlende Verknüpfung zum ALOALO-Erstellung prüfen und bei Bedarf eskalieren

Problem 4: Felder werden nicht aktualisiert

Symptome: Felder wie Dauer, Ergebnis oder Name des Agenten werden nicht aktualisiert.

UrsacheErklärungLösung
Fehlende BearbeitungsberechtigungenKein Zugriff auf FeldebeneSichtbarkeit und Bearbeitungszugriff in Salesforce aktivieren
Datensatz gesperrtWorkflow oder Genehmigung verhindert AktualisierungenSalesforce-Automatisierung überprüfen
VerarbeitungsverzögerungEreignis noch in der WarteschlangeWarten und aktualisieren

Problem 5: Falsche Kennzeichnung des Anrufergebnisses

Symptome: Die Kennzeichnung stimmt nicht mit dem tatsächlichen Verhalten des Anrufs überein.

Erwartetes VerhaltenKorrekte Kennzeichnung
VA hat Anruf gelöstHandled by VA
VA hat Anruf übergebenTransferred to Agent
UrsacheErklärungLösung
Ereignisse in falscher ReihenfolgeVorübergehende AbweichungAuf automatische Korrektur warten
Fehlendes EreignisUnvollständige Daten empfangenIm Aircall Dashboard prüfen und bei Bedarf unseren Customer Support kontaktieren

Problem 6: Doppelte Datensätze

Symptome: Zwei Tasks oder ALOs für einen Anruf.

UrsacheErklärungLösung
Zeitkonflikt bei EreignissenMehrere Ereignisse haben die Erstellung ausgelöstDuplikat löschen und mit der Call ID eskalieren

Problem 7: Falsche Kontaktzuordnung

Symptome: Datensatz ist mit dem falschen oder mit keinem Kontakt verknüpft.

UrsacheErklärungLösung
Kein passender KontaktNummer in Salesforce nicht gefundenEinen Kontakt erstellen
Doppelte NummernMehrere Kontakte haben dieselbe NummerKontakte deduplizieren

FAQs

Warum wird mein ALO nicht erstellt, obwohl Tasks erscheinen?
Das liegt in der Regel am fehlenden Aircall_PermissionSet oder daran, dass die ALO-Erstellung deaktiviert ist.

Wie lange sollte ich warten, bevor ich einen fehlenden Datensatz eskaliere?
Warten Sie bis zu 15 Minuten, damit die Wiederholungsverarbeitung erfolgen kann, bevor Sie eskalieren.

Muss ich nach dem Aktivieren von Berechtigungen irgendetwas neu starten?
Nein, Änderungen werden für den nächsten Anruf sofort wirksam.

Können VA- und menschliche Agentendaten im selben Datensatz koexistieren?
Ja, VA-Daten bleiben erhalten und werden angereichert, wenn ein menschlicher Agent am Anruf teilnimmt.