> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ouraicalling.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Audience Call QA

> Kontaktbezogene Call-QA-Durchschnitte in Audience, Segmenten, History, REST und MCP.

Audience repräsentiert einen Kontakt, History dagegen dessen einzelne Interaktionen über Calls, Messaging und E-Mail. Ein Kontakt kann deshalb viele History-Einträge, aber nur eine Audience-Zeile besitzen.

## Filter-Builder und gespeicherte Segmente

Über **Filter** oberhalb der Audience-Tabelle lassen sich Bedingungen in einem
visuellen Filter-Builder kombinieren. Bedingungen sind UND-verknüpft; mehrere
Werte innerhalb von Status, Kanal, Quelle, Tags oder AMD-Ergebnis sind
ODER-verknüpft. Verfügbar sind:

* Kontaktsuche, Anzeige-Status, Kampagne und DNC
* Kanal und Call QA
* Kontaktquelle und Tags
* Bereiche für Erstellungsdatum und Anrufversuche
* letztes AMD-Ergebnis
* Workspace-definierte Custom Attributes

Die Liste aktualisiert sich beim Ändern der Bedingungen. **Save as segment**
speichert die aktuelle Definition als dynamisches Segment. Gespeichert werden
die Filter, kein Kontakt-Snapshot; Kampagnenzuweisungen lösen deshalb stets die
aktuellen Treffer auf.

Für **DNC** schließt **is** nur Kontakte auf der Sperrliste ein; **is not**
schließt diese Kontakte aus. In REST- und MCP-Filtern entspricht das
`dnc: true` beziehungsweise `dnc: false`. Ohne `dnc` wird nicht nach diesem
Status gefiltert.

## Kontakt-Tags

Workspace-eigene Tags können direkt beim Anlegen eines Kontakts oder später über
**Manage Contact → Tags** bearbeitet werden. Tags lassen sich einzeln eingeben
oder kommasepariert einfügen. Sie werden in Kleinbuchstaben normalisiert,
dedupliziert und sind auf 32 Tags mit je 40 Zeichen begrenzt. Beim CSV-Import
kann eine komma- oder semikolongetrennte Spalte auf **Tags** abgebildet werden.
CRM Sync kann CRM-Labels/Tags auf dasselbe Ziel mappen; synchronisierte Tags
werden mit manuellen Tags zusammengeführt und ersetzen sie nicht.

Der Filter **Tags** findet Kontakte, die mindestens einen ausgewählten Tag
enthalten. Diese Definition kann als Segment gespeichert werden. API-Clients
legen einen unzugeordneten Kontakt mit `POST /leads` an; MCP-Clients verwenden
`create_audience_contact`.

## Call-QA-Durchschnitt

**Call QA** ist der Durchschnitt von `calls.qa_score` für Kontakt und Zeitraum:

* 7, 30 oder 90 Tage sowie gesamte Zeit
* Standard: 90 Tage
* jeder Call zählt einmal
* Calls ohne Score werden ausgeschlossen
* Messaging und E-Mail bleiben in der gemeinsamen Timeline, werden in dieser Phase aber nicht bewertet

Die Kennzahl misst die Assistant-Leistung im Call und ist kein Lead-Qualitätsscore. Neben dem Durchschnitt steht die Stichprobengröße (`n`); der Contact Drawer zeigt zusätzlich Pass-Rate und neuesten Score.

## Dynamische QA-Segmente

Aktiviere in Audience den **QA filter**, wähle den Zeitraum und optional Mindest-/Höchstdurchschnitt oder eine Mindestanzahl bewerteter Calls. Beim Speichern entsteht ein dynamisches Segment.

```json theme={null}
{
  "qa": {
    "window": 90,
    "average_score_min": 80,
    "min_scored_calls": 3
  }
}
```

Kontakte ohne bewertete Calls erfüllen ein QA-Segment nicht. Ohne `min_scored_calls` wird mindestens ein bewerteter Call verlangt. Die Mitgliedschaft wird bei jeder Auflösung neu berechnet, auch bei der Kampagnenzuweisung.

Neue oder geänderte QA-Segmente benötigen das Plan-Feature **AI QA Scorecards**. Bereits gespeicherte Segmente bleiben nach einem Downgrade lesbar und auflösbar.

## Dynamische Kanal-Segmente

Mit dem Filter **Channel** werden Kontakte ausgewählt, die verknüpfte Aktivität oder ein Kanalprofil besitzen. Unterstützt werden Calls, SMS, E-Mail, WhatsApp, Telegram, Messenger, Slack, Microsoft Teams, Discord, Google Chat und X.

```json theme={null}
{
  "channels": ["whatsapp", "messenger"]
}
```

Mehrere Kanalwerte sind ODER-verknüpft: Das Beispiel trifft Kontakte mit WhatsApp **oder** Messenger. Der Kanalfilter ist mit Suche, Status, Kampagne, DNC, Quelle, Tags, Datum, Versuchen, AMD, Attributen und Call QA UND-verknüpft. Die Mitgliedschaft wird beim Öffnen des Segments und bei der Kampagnenzuweisung dynamisch neu berechnet.

## Gemeinsame Kontakt-History

**View all history** im Contact Drawer öffnet History mit dem kanonischen `lead_id`-Filter. Calls, Messaging-Conversations und E-Mail-Threads werden einbezogen. E-Mail erscheint einmal pro Thread statt einmal pro Nachricht.

API-Clients verwenden `GET /leads`, `GET /history?lead_id=...` und die Segment-Endpunkte. MCP-Clients verwenden `list_audience_contacts`, `list_history` mit `lead_id` und die Segment-Tools.
