Referentie voor organisatie-instellingen

Beheer een ThunderPhone-organisatie: profiel, dashboardtaal, leden, uitgaande bevestiging, geblokkeerde bellers, webhooks, SSO, API-sleutels, waarschuwingen, facturering, bestedingslimieten en geschiedenis.

Open Organisatie-instellingen (/dashboard/organization) om de actieve organisatie en je eigen account te beheren. Instellingen zijn verdeeld over zes tabbladen; je rol bepaalt welke opties je kunt wijzigen.

Mijn account#

Het tabblad Mijn account bevat instellingen voor de ingelogde gebruiker, niet voor de hele organisatie:

• Voornaam, achternaam, e-mail en een avatar-URL.
• Weergavetaal van het dashboard.
• Download van de macOS-desktopapp.
• Toegangssleutels toevoegen, verifiëren, weergeven en verwijderen.
• Cookievoorkeuren.
• Uitloggen op het huidige apparaat.

Wanneer je inlogt via organisatie-SSO, beheert de identiteitsprovider je e-mailadres en is dit hier alleen-lezen. Zie Account en beveiliging voor de gedetailleerde workflow voor toegangssleutels en profielen.

Algemeen#

Naleving voor uitgaand bellen#

Voor organisaties waarvoor deze vereiste geldt, moet een eigenaar of beheerder de eenmalige bevestiging voor uitgaand bellen controleren en vastleggen voordat spraakagenten uitgaande oproepen kunnen plaatsen. Leden kunnen zien dat actie vereist is, maar kunnen deze niet indienen. Zie Wetgeving voor uitgaand bellen.

Rapportage#

Tijdzone, wekelijkse openingstijden en de eigen testnummers van de organisatie. Openingstijden bepalen welke oproepen als buiten openingstijden tellen in de oproepcijfers op Startpagina, op het tabblad Oproepen van elke agent en in Clientportalen, en in het filter Openingstijden in Oproepgeschiedenis. Als er geen dagen zijn aangevinkt, worden oproepen buiten openingstijden niet bijgehouden en telt elke oproep als binnen openingstijden. Oproepen van of naar een testnummer worden uit alle rapportagetellingen weggelaten, evenals uit portaallijsten, cijfers in Overzicht en CSV-exporten; ze kunnen niet in een portaal worden geopend. Een agent kan in de agentbuilder onder Rapportage een eigen tijdzone en openingstijden hebben, die dan alleen gelden voor de oproepen van die agent.

Eigenaren en beheerders wijzigen deze instellingen onder Algemeen → Rapportage. Kies de tijdzone en vink elke openingsdag aan. Voer vervolgens de openings- en sluitingstijden in. Voer onder Testnummers elk nummer in en kies Toevoegen. Kies daarna Rapportage-instellingen opslaan. Totdat een tijdzone is opgeslagen, gebruiken rapporten UTC; de pagina stelt de tijdzone van je browser voor als niet-opgeslagen wijziging. Zodra er openingstijden zijn ingesteld, tellen niet-aangevinkte dagen als buiten openingstijden voor oproepen die dat schema gebruiken.

Rapportage configureren via de API#

Eigenaren en beheerders kunnen PATCH /v1/orgs/{id}/ gebruiken met timezone, business_hours en excluded_numbers:

• timezone: een IANA-tijdzonenaam zoals America/Los_Angeles, met maximaal 64 tekens.
• business_hours: weekdagsleutels van mon tot en met sun, elk een lijst met maximaal vier {start, end}-vensters in 24-uursnotatie HH:MM, waarbij elk einde later ligt dan het begin. {} betekent geen uitsplitsing voor buiten openingstijden.
• excluded_numbers: maximaal 50 telefoonnummers, opgeslagen in E.164-notatie. Een los Noord-Amerikaans nummer van 10 cijfers krijgt de landcode +1.

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"]
  }'

Geblokkeerde bellers#

Nummers op deze lijst kunnen je agenten niet bereiken. Wanneer een geblokkeerd nummer een van de telefoonnummers van je organisatie belt, verbreekt ThunderPhone de verbinding voordat een agent antwoordt en worden er geen kosten voor de oproep in rekening gebracht. De oproep verschijnt nog steeds in Oproepgeschiedenis als een mislukte inkomende oproep met als eindreden Geblokkeerde beller. Oproepen met een onderdrukt of anoniem beller-ID worden nooit gekoppeld, en uitgaande oproepen naar een geblokkeerd nummer worden niet beïnvloed. Een beller die je tijdens een oproep blokkeert, wordt niet afgebroken; de blokkering geldt vanaf de volgende oproep.

Elk lid kan de lijst bekijken; eigenaren en beheerders wijzigen deze onder Algemeen → Geblokkeerde bellers:

• Voer een nummer met een optionele notitie in om één nummer te blokkeren en kies Nummer blokkeren. Gebruik + en de landcode; een nationale notatie zoals (415) 555-0123 werkt ook wanneer alle telefoonnummers van je organisatie zich in één land bevinden.
• Kies Een lijst plakken om meerdere nummers tegelijk te blokkeren, plak maximaal 500 nummers (één per regel of gescheiden door komma's) en dien ze in. Het resultaat toont hoeveel nummers zijn toegevoegd, al geblokkeerd of ongeldig zijn, en vermeldt de ongeldige invoer.
• Kies Verwijderen in de rij van een nummer en bevestig om de blokkering op te heffen.

Je kunt ook een inkomende oproep openen in Oproepgeschiedenis en Deze beller blokkeren kiezen. Een organisatie kan maximaal 10.000 nummers blokkeren. Zie Geblokkeerde bellers om de lijst via de API te beheren.

Organisatie-identiteit en lidmaatschap#

De organisatiekaart toont de organisatie-ID, je lidmaatschapsrol en de bewerkbare organisatienaam. De teamkaart combineert actieve leden en openstaande uitnodigingen.

Eigenaren en beheerders kunnen een Lid of Beheerder uitnodigen, een openstaande uitnodiging intrekken, rollen van in aanmerking komende leden wijzigen en leden verwijderen. Uitnodigingen zijn gekoppeld aan een specifiek e-mailadres en verlopen na zeven dagen. Zie Je team uitnodigen.

Met de gevarenzone kan een in aanmerking komende gebruiker een organisatie verlaten of deze permanent verwijderen. Verwijderen wist de spraakagenten, nummers, oproepgeschiedenis en factureringsgegevens van de organisatie en kan niet ongedaan worden gemaakt.

Open het tabblad Account en kies Account verwijderen om je eigen account te verwijderen. Het dialoogvenster toont de organisaties die worden verwijderd (waar je het enige lid bent) en de organisaties die je verlaat. API-sleutels die je hebt gemaakt in een organisatie die je verlaat, worden ingetrokken. Verwijdering wordt geblokkeerd zolang je de enige eigenaar bent van een organisatie met andere leden (maak eerst iemand anders eigenaar), zolang je aangepaste stemmen hebt gemaakt in een organisatie die blijft bestaan, zolang er een oproep bezig is of zolang er een juridische blokkade geldt; het dialoogvenster toont wat de verwijdering blokkeert. Dit kan niet ongedaan worden gemaakt.

Standaardwebhook#

Stel één verouderde webhook-URL in om gebeurtenissen te ontvangen van alle webwidgets en telefoon- nummers in de organisatie. Gebruik voor geheimen per eindpunt, abonnementen, afleverings- geschiedenis en nieuwe pogingen de aanbevolen webhook-eindpunten.

Enterprise SSO#

Configureer een of meer SSO-verbindingen, toegestane e-maildomeinen, just-in-time- provisioning, de standaardrol en optionele toewijzingen van groepen aan rollen. Het beveiligingsbeleid kan SSO vereisen, noodtoegang met een wachtwoord voor beheerders toestaan en toegangssleutels vereisen voor toegang tot de organisatie. Zie SSO.

Sleutels#

Het tabblad Sleutels beheert geheime sk_live_ server-API-sleutels. Elke rij toont de naam, het voorvoegsel, de actieve/ingetrokken status, het aanmaaktijdstip, het laatste gebruik en het intrekkings- tijdstip.

Het volledige geheim wordt slechts één keer weergegeven, direct na het aanmaken. Kopieer het dan en sla het op in een geheimenbeheerder. Intrekking is permanent en stopt elke integratie die de sleutel gebruikt. Zie API-sleutels.

Publiceerbare pk_live_-sleutels horen bij Webwidgets, omdat ze oorsprongsbeperkte browserreferenties zijn in plaats van serversleutels.

Waarschuwingen#

Maak metriekregels voor slagingspercentage, foutenpercentage, gemiddelde score, oproepvolume of regressies in suites. Een regel bevat:

• Vergelijkingsoperator en numerieke drempelwaarde.
• Evaluatievenster van 1 tot 720 uur.
• Maximaal 10 e-mailontvangers.
• Optionele URL voor een inkomende Slack-webhook.
• Optionele aflevering via een ontwikkelaarswebhook.
• Cooldown in hele minuten en ingeschakelde status.

Hetzelfde tabblad toont recente activeringen. Zie Waarschuwingen.

Factureringsinstellingen#

Beheer het organisatiesaldo en betalingsgedrag:

• De standaardbetaalkaart toevoegen of vervangen.
• Handmatig saldo toevoegen.
• Automatisch opwaarderen inschakelen en de drempelwaarde en het opwaardeerbedrag instellen.
• Een maandelijkse bestedingslimiet instellen of verwijderen.

De maandelijkse limiet pauzeert nieuwe oproepen en verbruik bij 100% en blijft actief, zelfs wanneer automatisch opwaarderen is uitgeschakeld. Zie Prijzen en Facturering en opwaarderingen.

Factureringsgeschiedenis#

Gebruik Factureringsgeschiedenis om het saldo en de uitgaven voor vandaag, 7 dagen, 30 dagen, 90 dagen of alle tijd te bekijken. Dit omvat:

• Saldoverloop.
• Factureringsverdeling over gesprekskosten, rapporten, telefoonnummerskosten en opwaarderingen.
• Hoogste uitgaven per agent.
• Transactietabel met datum, categorie, beschrijving, type, bedrag en resulterend saldo.
• Categoriefiltering en CSV- of JSON-export van de weergegeven geschiedenis.

Het dashboard meldt wanneer alleen de meest recente transacties worden weergegeven; oudere rijen buiten die limiet ontbreken ook in de export. De Billing API ondersteunt programmatische paginering.