Nachverarbeitung
API Request (Webhook)

API Request (Webhook)

Nach einem Anruf kann NovaVoca automatisch einen HTTP-Request an eine beliebige URL senden — ideal um dein CRM zu aktualisieren, Tickets zu erstellen oder Benachrichtigungen in Slack zu senden.

Funktionsweise

  1. Der Anruf wird beendet
  2. NovaVoca wertet die Bedingungen aus
  3. Variablen im URL, Body und Headers werden ersetzt
  4. Der HTTP-Request wird gesendet
  5. Timeout: 10 Sekunden — nach Ablauf wird der Request abgebrochen

Webhook-Aktion erstellen

1

Nachverarbeitung öffnen

Öffne deinen Assistenten → Reiter Nachverarbeitung.

2

API-Request hinzufügen

Klicke auf Aktion hinzufügen → API Request.

3

HTTP-Methode und URL

Wähle die Methode und gib die Ziel-URL ein:

MethodeVerwendung
GETDaten abrufen
POSTDaten senden (häufigster Fall)
PUTDaten ersetzen
PATCHDaten teilweise aktualisieren
DELETEDaten löschen

Variablen in der URL sind möglich:

https://api.firma.de/calls?caller={{caller_number}}
4

Headers konfigurieren

Füge benötigte Headers hinzu, z.B.:

Authorization: Bearer dein-api-key
Content-Type: application/json
5

Body definieren

Schreibe den Request-Body als JSON mit Variablen:

{
  "caller_name": "{{name}}",
  "caller_phone": "{{caller_number}}",
  "reason": "{{reason}}",
  "summary": "{{summary}}",
  "appointment_date": "{{appointment_date}}"
}
6

Bedingungen definieren (optional)

Natürlichsprachige Bedingungen wie bei E-Mail und SMS.

Verfügbare Variablen

VariableBeschreibung
{{name}}Name des Anrufers
{{email}}E-Mail-Adresse
{{phone}}Telefonnummer
{{caller_number}}Rufnummer des Anrufers
{{callee_number}}Angerufene Nummer
{{reason}}Anliegen
{{appointment_date}}Termin
{{summary}}KI-Zusammenfassung
Alle ExtraktionsvariablenIndividuell definierte Variablen

Anwendungsbeispiele

CRM-Update (HubSpot, Salesforce)

POST https://api.hubspot.com/crm/v3/objects/contacts
 
{
  "properties": {
    "firstname": "{{name}}",
    "phone": "{{caller_number}}",
    "hs_lead_status": "NEW",
    "notes_last_contacted": "{{summary}}"
  }
}

Slack-Benachrichtigung

POST https://hooks.slack.com/services/T00/B00/xxx
 
{
  "text": "Neuer Anruf von {{name}} ({{caller_number}}): {{reason}}"
}

Ticket erstellen (Zendesk)

POST https://firma.zendesk.com/api/v2/tickets.json
 
{
  "ticket": {
    "subject": "Anruf von {{name}}",
    "description": "{{summary}}",
    "requester": {
      "name": "{{name}}",
      "email": "{{email}}"
    }
  }
}
⚠️

Der Timeout beträgt 10 Sekunden. Stelle sicher, dass dein Endpunkt innerhalb dieser Zeit antwortet. Bei einem Timeout wird der Request nicht erneut versucht.

💡

Teste den Webhook zuerst mit einem Dienst wie webhook.site (opens in a new tab), um den gesendeten Payload zu überprüfen, bevor du ihn an dein Produktivsystem anbindest.

SMS versendenAllgemeines