--- title: "Referentie voor organisatie-instellingen" description: "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](/nl/guides/account-and-security) 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](/nl/guides/outbound-calling-laws). ### 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`. ```bash 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](/api-reference/blocked-callers) 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. | Rol | Gebruikelijke toegang | | --- | --- | | **Lid** | Spraakagenten bouwen en beheren en oproepen beoordelen. | | **Beheerder** | Toegang voor leden plus beheer van team, sleutels, portalen, verbindingen, waarschuwingen, facturering en beveiliging. | | **Eigenaar** | Beheerderstoegang plus organisatieacties op eigenaarniveau. | 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](/nl/guides/invite-your-team). 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](/nl/webhooks/endpoints). ### 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](/nl/guides/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](/nl/guides/api-keys). 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](/nl/guides/alerts). ## 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](/nl/guides/pricing) en [Facturering en opwaarderingen](/nl/guides/billing-and-topups). ## 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](/api-reference/billing) ondersteunt programmatische paginering.