Um die Aircall-Telefonie in Mavibot zu nutzen, müssen Sie in Ihrem Aircall-Konto ein Paar API-Schlüssel erstellen und diese in den Integrationseinstellungen eingeben.

Aircall ist ein cloudbasiertes Telefonsystem für Vertriebs- und Supportteams, das Telefonnummern in über 100 Ländern anbietet. Es ist für Unternehmen konzipiert, deren Mitarbeiter die Aircall-App bereits nutzen: Der Bot tätigt Anrufe im Namen eines Mitarbeiters und nicht über eine separate Bot-Nummer.

Der Bot kann einen Mitarbeiter mit einem Kunden verbinden, Anrufaufzeichnungen abrufen und Anrufereignisse an die Konversation senden.

Abrufen der erforderlichen Daten

  1. Registrieren Sie sich bei aircall.io, kaufen Sie eine Telefonnummer im gewünschten Land und erstellen Sie Aircall-Benutzer für Ihre Mitarbeiter.
  2. Öffnen Sie Dashboard → Einstellungen → Integrationen & API → API-Schlüssel und erstellen Sie ein Schlüsselpaar:
    • API-ID
    • API-Token
  3. Ermitteln Sie die Nummern-ID für die Nummer, die für ausgehende Anrufe verwendet wird, sowie die Benutzer-IDs für Ihre Mitarbeiter. Diese IDs werden in der Adressleiste angezeigt, wenn Sie die entsprechenden Seiten im Aircall-Dashboard öffnen.

API-Token wird nur einmal bei der Erstellung angezeigt. Wenn Sie ihn verlieren, erstellen Sie ein neues Paar API-Schlüssel und widerrufen Sie das alte.

Verbindung

Wählen Sie in den Telefonieeinstellungen Aircall und geben Sie Folgendes ein:

  • API-ID — die Kennung des API-Schlüssels.
  • API-Token — das geheime API-Token.
  • Nummern-ID — die numerische ID der Aircall-Leitung, die für ausgehende Anrufe verwendet wird.

Die Integration ist nun verbunden.


Um die Integration zu trennen, leeren Sie das Feld API-ID und speichern Sie die Einstellungen.

Mitarbeiter

Füllen Sie in den Mitarbeitereinstellungen das Feld Aircall-Benutzer-ID mit der numerischen ID des Aircall-Kontos des Mitarbeiters aus.

Geben Sie die Benutzer-ID ein, nicht die Telefonnummer des Mitarbeiters. Ohne diese ID funktioniert die Anrufschaltfläche in der Kundenkarte für diesen Mitarbeiter nicht.

Anruf von der Kundenkarte aus

Neben der Telefonnummer des Kunden in der Konversationskarte erscheint eine Anrufschaltfläche.

Aircall startet den Anruf zunächst in der Aircall-App des Mitarbeiters — auf dem Desktop oder Mobilgerät. Sobald der Mitarbeiter antwortet, ruft Aircall den Kunden an und verbindet beide Parteien.

Der Anruf wird nicht durchgestellt, wenn der Mitarbeiter offline ist, sich bereits in einem anderen Anruf befindet oder der ausgewählten Nummer in Aircall nicht zugewiesen ist. Dies ist eine Einschränkung von Aircall: Anrufe können nur über einen verfügbaren Benutzer getätigt werden.

Rechnerfunktionen

Mitarbeiter-zu-Kunde-Anruf

aircall_employee_call(client_phone, employee_user_id, number_id)

Parameter:

  • client_phone — die Telefonnummer des Kunden im internationalen E.164-Format. Erforderlich.
  • employee_user_id — die Aircall-Benutzer-ID des Mitarbeiters, der den Anruf in seiner Aircall-App empfängt. Erforderlich.
  • number_id — die ID der Aircall-Nummer, die für den Anruf verwendet wird. Optional. Wenn nicht angegeben, wird die in den Integrationseinstellungen konfigurierte Nummer verwendet.

aircall_get_record_link(call_id)

Fordert einen aktuellen Link zur Anrufaufzeichnung an.

Parameter:

  • call_id — die Aircall-Anruf-ID. Optional. Wenn nicht angegeben, wird der letzte Anruf des Kunden verwendet.

Rückrufe während eines Anrufs

Während des Anrufs werden Rückrufe im folgenden Format an die Konversation gesendet:

aircall_call_event call.answered

Mögliche Ereignisse:

Ereignis Wann es ausgelöst wird
call.created Der Anruf wurde erstellt
call.ringing_on_agent Der Mitarbeiter empfängt den Anruf
call.answered Der Anruf wurde beantwortet
call.hungup Eine der Parteien hat aufgelegt
call.ended Der Anruf ist vollständig beendet
call.voicemail_left Der Kunde hat eine Voicemail hinterlassen

Ein typisches Szenario "keine Antwort → Nachricht im Messenger senden" kann durch call.ended und die Überprüfung der Variable aircall_missed_reason ausgelöst werden.

Client-Variablen nach einem Anruf

Nach einem Anruf stehen für den Kunden folgende Variablen zur Verfügung:

Variable Wert
aircall_call_id Aircall-Anruf-ID
aircall_call_direction Anrufrichtung: inbound oder outbound
aircall_call_status Anrufstatus: initial, answered oder done
aircall_call_duration Anrufdauer in Sekunden
aircall_missed_reason Grund, warum der Anruf nicht abgeschlossen wurde
aircall_record_link Link zur Anrufaufzeichnung

Anrufaufzeichnungen

Die Anrufaufzeichnung muss in Ihren Aircall-Einstellungen aktiviert sein. Aufzeichnungen werden in Ihrem Aircall-Konto gespeichert.

⏳ Aircall-Aufzeichnungslinks sind nur für begrenzte Zeit verfügbar — in der Regel nur für einige Stunden nach dem Anruf. Danach funktionieren die Links nicht mehr. Dies ist eine Funktion von Aircall und keine Einschränkung von Mavibot.

Was das bedeutet:

  • Rufen Sie in einem Szenario, das eine Anrufaufzeichnung sendet, aircall_get_record_link() zum Zeitpunkt des Sendens der Aufzeichnung auf, anstatt einen zuvor gespeicherten Link zu verwenden.
  • Wenn Sie eine Aufzeichnung dauerhaft speichern müssen, speichern Sie die Datei sofort nach dem Anruf in Ihrem eigenen Speicher.
  • Das Aufzeichnungsarchiv bleibt im Aircall-Dashboard verfügbar, wo Aufzeichnungen später abgespielt und heruntergeladen werden können.

Die Anrufaufzeichnung ist gesetzlich geregelt. In Deutschland, Frankreich, Spanien und vielen US-Bundesstaaten kann die Zustimmung beider Parteien erforderlich sein, und in einigen Rechtsgebieten kann auch eine mündliche Benachrichtigung zu Beginn des Anrufs notwendig sein. Der Inhaber des Aircall-Kontos ist für die Einhaltung der geltenden Gesetze und Vorschriften verantwortlich.

Fehlerbehebung

Fehler Ursache / Lösung
Autorisierungsfehler beim Tätigen eines Anrufs Das Paar API-ID / API-Token ist falsch. Das Token wird nur einmal bei der Erstellung angezeigt. Wenn es verloren gegangen ist, erstellen Sie ein neues Paar unter API-Schlüssel und widerrufen Sie das alte.
Anruf wird nicht erstellt oder der Mitarbeiter empfängt den Anruf nicht Der Mitarbeiter ist in der Aircall-App offline, befindet sich bereits in einem anderen Anruf oder ist der ausgewählten Nummer in den Aircall-Einstellungen nicht zugewiesen.
"Aircall-Benutzer-ID ist nicht angegeben" Das Feld Aircall-Benutzer-ID in den Mitarbeitereinstellungen ist leer, oder es wurde eine Telefonnummer anstelle der numerischen Benutzer-ID eingegeben.
Anrufe funktionieren, aber es erscheinen keine Rückrufe in der Konversation Der Webhook wurde nicht registriert. Speichern Sie die Aircall-Integrationseinstellungen erneut, um ihn zu registrieren.
Aufzeichnungslink öffnet nicht Der Link ist abgelaufen. Fordern Sie einen aktuellen Link mit aircall_get_record_link() an oder öffnen Sie die Aufzeichnung direkt im Aircall-Dashboard.