Referenz zu Organisationseinstellungen

Verwalten Sie eine ThunderPhone-Organisation: Profil, Dashboard-Sprache, Mitglieder, Bestätigung ausgehender Anrufe, blockierte Anrufer, Webhooks, SSO, API-Schlüssel, Benachrichtigungen, Abrechnung, Ausgabenlimits und Verlauf.

Öffnen Sie Organisationseinstellungen (/dashboard/organization), um die aktive Organisation und Ihr eigenes Konto zu verwalten. Die Einstellungen sind in sechs Tabs unterteilt; Ihre Rolle bestimmt, welche Steuerelemente Sie ändern können.

Mein Konto#

Der Tab Mein Konto enthält Einstellungen für den angemeldeten Benutzer, nicht für die gesamte Organisation:

• Vorname, Nachname, E-Mail-Adresse und eine Avatar-URL.
• Anzeigesprache des Dashboards.
• Download der macOS-Desktop-App.
• Passkeys hinzufügen, verifizieren, auflisten und entfernen.
• Cookie-Einstellungen.
• Auf dem aktuellen Gerät abmelden.

Wenn Sie sich über Organisations-SSO anmelden, verwaltet der Identitätsanbieter Ihre E-Mail-Adresse, und sie ist hier schreibgeschützt. Den detaillierten Ablauf für Passkeys und Profile finden Sie unter Konto & Sicherheit.

Allgemein#

Compliance für ausgehende Anrufe#

Für Organisationen, für die die Anforderung gilt, muss ein Eigentümer oder Admin die einmalige Bestätigung für ausgehende Anrufe prüfen und dokumentieren, bevor Agenten ausgehende Anrufe tätigen können. Mitglieder können sehen, dass eine Aktion erforderlich ist, sie jedoch nicht einreichen. Siehe Gesetze für ausgehende Anrufe.

Berichterstellung#

Zeitzone, wöchentliche Geschäftszeiten und die eigenen Testnummern der Organisation. Die Geschäftszeiten bestimmen, welche Anrufe in den Berichtszahlen auf der Startseite, im Tab Anrufe jedes Agenten und in Kundenportalen sowie im Filter Geschäftszeiten im Anrufverlauf als außerhalb der Geschäftszeiten gelten. Wenn keine Tage ausgewählt sind, werden Anrufe außerhalb der Geschäftszeiten nicht erfasst und jeder Anruf zählt als Geschäftszeit. Anrufe von oder zu einer Testnummer werden aus allen Berichtszahlen sowie aus Portallisten, Übersichtskennzahlen und CSV-Exporten ausgeschlossen; sie können nicht in einem Portal geöffnet werden. Ein Agent kann im Agent-Builder unter Berichterstellung eine eigene Zeitzone und eigene Geschäftszeiten haben, die dann nur für die Anrufe dieses Agenten gelten.

Eigentümer und Administratoren ändern diese Einstellungen unter Allgemein → Berichterstellung. Wählen Sie die Zeitzone aus und markieren Sie jeden geöffneten Tag. Geben Sie dann die Öffnungs- und Schließzeiten ein. Geben Sie unter Testnummern jede Nummer ein und wählen Sie Hinzufügen. Wählen Sie anschließend Berichterstattungseinstellungen speichern. Bis eine Zeitzone gespeichert ist, verwenden Berichte UTC; die Seite schlägt die Zeitzone Ihres Browsers als ungespeicherte Änderung vor. Sobald Geschäftszeiten festgelegt sind, gelten nicht markierte Tage für Anrufe mit diesem Zeitplan als außerhalb der Geschäftszeiten.

Berichterstellung über die API konfigurieren#

Eigentümer und Administratoren können PATCH /v1/orgs/{id}/ mit timezone, business_hours und excluded_numbers verwenden:

• timezone: ein IANA-Zeitzonenname wie America/Los_Angeles mit bis zu 64 Zeichen.
• business_hours: Wochentagsschlüssel von mon bis sun, jeweils eine Liste mit höchstens vier {start, end}-Zeitfenstern im 24-Stunden-Format HH:MM, wobei jedes Ende nach seinem Beginn liegen muss. {} bedeutet keine Unterteilung in Zeiten außerhalb der Geschäftszeiten.
• excluded_numbers: bis zu 50 Telefonnummern, gespeichert im E.164-Format. Einer bloßen 10-stelligen nordamerikanischen Nummer wird der Ländercode +1 vorangestellt.

curl -X PATCH https://api.thunderphone.com/v1/orgs/42/ \
  -H "Authorization: Bearer sk_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "timezone": "America/Los_Angeles",
    "business_hours": {
      "mon": [{"start": "09:00", "end": "17:00"}],
      "sat": [{"start": "10:00", "end": "14:00"}]
    },
    "excluded_numbers": ["+14155550199"]
  }'

Blockierte Anrufer#

Nummern auf dieser Liste können Ihre Agenten nicht erreichen. Wenn eine blockierte Nummer eine der Telefonnummern Ihrer Organisation anruft, legt ThunderPhone auf, bevor ein Agent den Anruf entgegennimmt, und stellt den Anruf nicht in Rechnung. Er erscheint weiterhin im Anrufverlauf als fehlgeschlagener eingehender Anruf mit dem Endgrund Blockierter Anrufer. Anrufe mit unterdrückter oder anonymer Anrufer-ID werden niemals abgeglichen, und ausgehende Anrufe an eine blockierte Nummer sind nicht betroffen. Ein Anrufer, den Sie während eines Anrufs blockieren, wird nicht getrennt; die Blockierung gilt ab seinem nächsten Anruf.

Jedes Mitglied kann die Liste sehen; Eigentümer und Administratoren ändern sie unter Allgemein → Blockierte Anrufer:

• Um eine einzelne Nummer zu blockieren, geben Sie sie mit einer optionalen Notiz ein und wählen Sie Nummer blockieren. Verwenden Sie + und die Landesvorwahl; auch ein nationales Format wie (415) 555-0123 funktioniert, wenn sich alle Telefonnummern Ihrer Organisation in einem Land befinden.
• Um viele Nummern gleichzeitig zu blockieren, wählen Sie Liste einfügen, fügen Sie bis zu 500 Nummern ein (eine pro Zeile oder durch Kommas getrennt) und senden Sie die Liste ab. Das Ergebnis zeigt, wie viele hinzugefügt wurden, bereits blockiert oder ungültig sind, und listet die ungültigen Einträge auf.
• Um die Blockierung einer Nummer aufzuheben, wählen Sie in ihrer Zeile Entfernen und bestätigen Sie.

Sie können auch einen eingehenden Anruf im Anrufverlauf öffnen und Diesen Anrufer blockieren wählen. Eine Organisation kann bis zu 10.000 Nummern blockieren. Informationen zur Verwaltung der Liste über die API finden Sie unter Blockierte Anrufer.

Organisationsidentität und Mitgliedschaft#

Die Organisationskarte zeigt die Organisations-ID, Ihre Mitgliedschaftsrolle und den bearbeitbaren Organisationsnamen. Die Teamkarte kombiniert aktive Mitglieder und ausstehende Einladungen.

Eigentümer und Admins können ein Mitglied oder einen Admin einladen, eine ausstehende Einladung widerrufen, Rollen berechtigter Mitglieder ändern und Mitglieder entfernen. Einladungen gelten nur für die jeweilige E-Mail-Adresse und laufen nach sieben Tagen ab. Siehe Ihr Team einladen.

Der Gefahrenbereich ermöglicht es einem berechtigten Benutzer, eine Organisation zu verlassen oder sie dauerhaft zu löschen. Durch das Löschen werden die Sprachagenten, Nummern, der Anrufverlauf und die Abrechnungsdaten der Organisation entfernt und es kann nicht rückgängig gemacht werden.

Um Ihr eigenes Konto zu löschen, öffnen Sie den Tab Konto und wählen Sie Konto löschen. Im Dialog werden die Organisationen aufgeführt, die gelöscht werden (jene, in denen Sie das einzige Mitglied sind), sowie diejenigen, die Sie verlassen werden. API-Schlüssel, die Sie in einer Organisation erstellt haben, die Sie verlassen, werden widerrufen. Die Löschung ist nicht möglich, solange Sie der einzige Inhaber einer Organisation mit anderen Mitgliedern sind (machen Sie zuerst eine andere Person zum Inhaber), solange Sie benutzerdefinierte Stimmen in einer Organisation erstellt haben, die bestehen bleibt, solange ein Anruf läuft oder eine rechtliche Sperre gilt; im Dialog wird aufgeführt, was die Löschung verhindert. Sie kann nicht rückgängig gemacht werden.

Standard-Webhook#

Legen Sie eine Legacy-Webhook-URL fest, um Ereignisse von allen Web-Widgets und Telefonnummern der Organisation zu empfangen. Verwenden Sie für Secrets pro Endpunkt, Abonnements, Zustellverlauf und Wiederholungsversuche stattdessen die empfohlenen Webhook-Endpunkte.

Enterprise-SSO#

Konfigurieren Sie eine oder mehrere SSO-Verbindungen, zulässige E-Mail-Domains, Just-in-Time- Bereitstellung, die Standardrolle und optionale Gruppenzuordnungen zu Rollen. Die Sicherheitsrichtlinie kann SSO erfordern, Notfallzugriff per Passwort für Admins erlauben und Passkeys für den Organisationszugriff verlangen. Siehe SSO.

Schlüssel#

Der Tab Schlüssel verwaltet geheime Server-API-Schlüssel mit dem Präfix sk_live_. Jede Zeile zeigt den Namen, das Präfix, den aktiven/widerrufenen Status, die Erstellungszeit, die letzte Nutzung und die Widerrufszeit.

Das vollständige Secret wird nur einmal direkt nach der Erstellung angezeigt. Kopieren Sie es dann und speichern Sie es in einem Secret-Manager. Ein Widerruf ist dauerhaft und beendet jede Integration, die den Schlüssel verwendet. Siehe API-Schlüssel.

Veröffentlichbare Schlüssel mit dem Präfix pk_live_ gehören zu Web-Widgets, da sie an die Herkunft gebundene Browser-Anmeldedaten und keine Serverschlüssel sind.

Warnmeldungen#

Erstellen Sie Metrikregeln für Erfolgsrate, Fehlerrate, durchschnittliche Bewertung, Anrufvolumen oder Suite-Regressionen. Eine Regel umfasst:

• Vergleichsoperator und numerischen Schwellenwert.
• Auswertungsfenster von 1 bis 720 Stunden.
• Bis zu 10 E-Mail-Empfänger.
• Optionale Slack-Incoming-Webhook-URL.
• Optionale Zustellung an Entwickler-Webhooks.
• Cooldown in vollen Minuten und Aktivierungsstatus.

Derselbe Tab listet aktuelle Auslösungen auf. Siehe Warnmeldungen.

Abrechnungseinstellungen#

Verwalten Sie das Organisationsguthaben und das Zahlungsverhalten:

• Standard-Zahlungskarte hinzufügen oder ersetzen.
• Guthaben manuell hinzufügen.
• Automatische Aufladung aktivieren sowie Schwellenwert und Aufladebetrag festlegen.
• Monatliches Ausgabenlimit festlegen oder entfernen.

Das monatliche Limit pausiert neue Anrufe und die Nutzung bei 100 % und bleibt auch aktiv, wenn die automatische Aufladung deaktiviert ist. Siehe Preise und Abrechnung und Aufladungen.

Abrechnungsverlauf#

Verwenden Sie Abrechnungsverlauf, um Guthaben und Ausgaben für Heute, 7 Tage, 30 Tage, 90 Tage oder den gesamten Zeitraum zu prüfen. Enthalten sind:

• Guthabenverlauf.
• Abrechnungsmix über Gesprächsgebühren, Berichte, Telefonnummerngebühren und Aufladungen hinweg.
• Höchste Ausgaben nach Agent.
• Transaktionstabelle mit Datum, Kategorie, Beschreibung, Typ, Betrag und resultierendem Guthaben.
• Kategoriefilterung sowie CSV- oder JSON-Export des angezeigten Verlaufs.

Das Dashboard zeigt an, wenn nur die neuesten Transaktionen angezeigt werden; ältere Zeilen über dieses Limit hinaus fehlen auch im Export. Die Billing API unterstützt programmatische Paginierung.