Zum Inhalt springen
REST API

Anrufergebnisse in Google Sheets speichern

Importieren Sie die n8n-Vorlage und schreiben Sie einen Beispielanruf in Google Sheets. Mit Ihrem Volai-Konto werden künftige abgeschlossene Anrufe automatisch erfasst.

1Workflow in n8n importieren

Speichern Sie die oben verlinkte JSON-Datei. Öffnen Sie im n8n-Editor das Workflow-Menü und wählen Sie Import from File. Die Vorlage nutzt integrierte Nodes und wurde mit n8n 2.48.5 getestet.

2Tabelle vorbereiten

Erstellen Sie in Google Sheets ein leeres Tabellenblatt namens Call results. Kopieren Sie die Kopfzeile unten und fügen Sie sie in A1 ein. Jeder Wert steht in einer eigenen Spalte der ersten Zeile.

text
Call ID	Event time (UTC)	Direction	Status	Duration (s)	Mode

3Eine Beispielzeile schreiben

Wählen Sie in Write call result to Google Sheets Ihre Google Sheets OAuth2-Zugangsdaten. Stellen Sie Document auf By ID und fügen Sie den Teil der Tabellen-URL zwischen /d/ und /edit ein. Lassen Sie Sheet auf Call results. Für einen Test ohne Volai-Konto deaktivieren Sie Confirm successful write. Starten Sie den Workflow über Test with a sample call. Suchen Sie nach DEMO-call-result-001 mit sample in der Spalte Mode. Ein erneuter Durchlauf aktualisiert dieselbe Zeile.

4Volai-Konto verbinden

Erstellen Sie ein Volai-Konto und erzeugen Sie in den API-Einstellungen einen Schlüssel. Legen Sie in n8n einen Zugang vom Typ Header Auth an. Tragen Sie unter Name Authorization und unter Value Bearer <API key> ein. Ersetzen Sie <API key> durch Ihren Schlüssel. Den Anzeigenamen können Sie frei wählen. Wählen Sie diesen Zugang in Read Volai call event und für die optionale Bestätigung auch in Confirm successful write. Aktivieren Sie diesen Node und starten Sie das Beispiel erneut, um die Bestätigung zu senden.

5Abgeschlossene Anrufe abonnieren

Kopieren Sie im Node Volai call completed die öffentliche HTTPS-Adresse Production URL. Ist der Webhook-Pfad schon belegt, ändern Sie ihn zuerst. Ersetzen Sie die Beispieladresse im Befehl unten und führen Sie ihn in Bash oder Zsh aus. Geben Sie bei der Aufforderung Ihren API-Schlüssel ein. Behandeln Sie die Antwort vertraulich und kopieren Sie deliveryToken daraus.

bash
(
  printf 'Volai API key> '
  IFS= read -rs VOLAI_API_KEY
  printf '\n'
  printf 'Authorization: Bearer %s\n' "$VOLAI_API_KEY" |
    curl --fail-with-body --silent --show-error \
      --header @- \
      --header 'Content-Type: application/json' \
      --data '{"url":"https://your-n8n.example/webhook/volai-call-result-to-sheets","events":["call.completed"]}' \
      https://volai.cz/v1/webhook-subscriptions
)

6Workflow veröffentlichen

Legen Sie einen zweiten Zugang vom Typ Header Auth an. Tragen Sie unter Name X-Volai-Webhook-Token und unter Value den Wert von deliveryToken aus der API-Antwort ein. Wählen Sie ihn in Volai call completed und veröffentlichen Sie den Workflow. Suchen Sie nach dem nächsten abgeschlossenen Anruf nach einer Zeile mit live. Der Workflow prüft vor dem Schreiben das Token und ruft das Ereignis von Volai ab.

Was Sie damit tun können

Tägliche Anrufstatistik

Zählen Sie abgeschlossene Anrufe pro Tag anhand der Ereigniszeit in UTC.

Auslastung des Teams

Vergleichen Sie Anzahl und Dauer eingehender und ausgehender Anrufe in einer Pivot-Tabelle.

Automatisierung prüfen

Gleichen Sie die Zeilen über die Anruf-ID mit dem Anrufverlauf in Volai ab.

Häufige Fragen

Welche Angaben stehen in der Tabelle?
Jede Zeile enthält Anruf-ID, Ereigniszeit in UTC, Richtung, Status, Dauer in Sekunden und den Modus sample oder live. Rufnummern, Transkripte und Aufzeichnungen werden ausgelassen.
Was misst der Workflow?
Nach erfolgreichem Schreiben kann Confirm successful write eine Bestätigung an Volai senden. Für Konten, die über diese Anleitung mit Einwilligung zur Messung erstellt wurden, zählt Volai in den ersten sieben Tagen den ersten bestätigten Beispiel- und Produktivlauf getrennt. Die Bestätigung enthält keine Tabellenzellen. Bei echten Anrufen prüft Volai anhand der Abo- und Ereignis-ID die Zuordnung und den Status. Deaktivieren Sie den Node, um den Versand auszuschalten.
Kann derselbe Anruf doppelt erscheinen?
Bei aufeinanderfolgenden Wiederholungen wird die Zeile mit derselben Call ID aktualisiert. Verwenden Sie einen Workflow pro Tabellenblatt. Bei gleichzeitigen Schreibvorgängen für dieselbe ID garantiert Google Sheets keine einzelne Zeile.
Was kann ich bei einer fehlenden Zeile prüfen?
Suchen Sie Fehler im Beispieldurchlauf direkt im n8n-Editor. Aktivieren Sie bei Problemen mit echten Anrufen vorübergehend Save failed production executions in den Workflow-Einstellungen. Stellen Sie den Fehler nach, prüfen Sie den fehlgeschlagenen Schritt im Verlauf und schalten Sie die Speicherung wieder aus. Prüfen Sie bei Schreibfehlern Google-Berechtigungen, Dokument-ID, Blattname und Kopfzeile. Prüfen Sie beim Webhook die Veröffentlichung, die öffentliche URL und das Token des Abos.

Probieren Sie es gleich aus

Registrieren Sie sich und die ersten € 2 gehen auf uns.