--- title: "Organisaatioasetusten viite" description: "Hallitse ThunderPhone-organisaatiota: profiilia, hallintapaneelin kieltä, jäseniä, lähtevien puhelujen vahvistusta, estettyjä soittajia, webhookeja, kertakirjautumista, API-avaimia, hälytyksiä, laskutusta, kulutusrajoja ja historiaa." --- Avaa **Organisaation asetukset** (`/dashboard/organization`) hallitaksesi aktiivista organisaatiota ja omaa tiliäsi. Asetukset on jaettu kuuteen välilehteen; roolisi määrittää, mitä hallintatoimintoja voit muuttaa. ## Oma tili **Oma tili** -välilehti sisältää kirjautuneen käyttäjän asetukset, ei koko organisaation asetuksia: - Etunimi, sukunimi, sähköpostiosoite ja avatarin URL-osoite. - Hallintapaneelin näyttökieli. - macOS-työpöytäsovelluksen lataus. - Lisää, vahvista, listaa ja poista salasana-avaimia. - Evästeasetukset. - Kirjaudu ulos nykyiseltä laitteelta. Kun kirjaudut sisään organisaation SSO:n kautta, identiteetintarjoaja hallitsee sähköpostiosoitettasi, ja sitä voi täällä vain tarkastella. Katso yksityiskohtainen salasana-avainten ja profiilin työnkulku kohdasta [Tili ja tietoturva](/fi/guides/account-and-security). ## Yleiset ### Lähtevien puhelujen vaatimustenmukaisuus Organisaatioissa, joihin vaatimus soveltuu, omistajan tai ylläpitäjän on tarkistettava ja kirjattava kertaluonteinen lähtevien puhelujen vahvistus, ennen kuin agentit voivat soittaa lähteviä puheluja. Jäsenet näkevät, että toimenpide vaaditaan, mutta eivät voi lähettää sitä. Katso [Lähteviä puheluja koskevat lait](/fi/guides/outbound-calling-laws). ### Raportointi Aikavyöhyke, viikoittaiset aukioloajat ja organisaation omat testinumerot. Aukioloajat määrittävät, mitkä puhelut lasketaan aukioloaikojen ulkopuolella tehdyiksi puheluiksi puheluraportin luvuissa etusivulla, kunkin agentin **Puhelut**-välilehdellä ja asiakasportaaleissa sekä Puheluhistorian **Aukioloajat**-suodattimessa. Jos yhtään päivää ei ole valittu, aukioloaikojen ulkopuolisia puheluita ei seurata, ja jokainen puhelu lasketaan aukioloaikaan kuuluvaksi. Testinumeroon tulevat tai siitä lähtevät puhelut jätetään pois kaikista raporttiluvuista sekä portaaliluetteloista, yleiskatsauksen luvuista ja CSV-vienneistä; niitä ei voi avata portaalissa. Agentilla voi olla oma aikavyöhyke ja omat aukioloajat agenttityökalun **Raportointi**-kohdassa, jolloin ne koskevat vain kyseisen agentin puheluita. Omistajat ja ylläpitäjät muuttavat näitä asetuksia kohdassa **Yleiset → Raportointi**. Valitse aikavyöhyke ja merkitse jokainen avoinna oleva päivä. Anna sitten sen avautumis- ja sulkemisajat. Lisää jokainen numero kohdassa **Testinumerot** ja valitse **Lisää**. Valitse sitten **Tallenna raportointiasetukset**. Kunnes aikavyöhyke on tallennettu, raportit käyttävät UTC:tä; sivu ehdottaa selaimesi aikavyöhykettä tallentamattomana muutoksena. Kun aukioloajat on määritetty, valitsemattomat päivät lasketaan aukioloaikojen ulkopuolelle kyseistä aikataulua käyttävissä puheluissa. #### Määritä raportointi API:n kautta Omistajat ja ylläpitäjät voivat käyttää `PATCH /v1/orgs/{id}/`-pyyntöä asetuksilla `timezone`, `business_hours` ja `excluded_numbers`: - `timezone`: IANA-aikavyöhykkeen nimi, kuten `America/Los_Angeles`, enintään 64 merkkiä. - `business_hours`: viikonpäiväavaimet `mon`–`sun`, joista kukin sisältää enintään neljän `{start, end}`-aikavälin luettelon 24 tunnin `HH:MM`-muodossa. Jokaisen lopetusajan on oltava aloitusaikaa myöhempi. `{}` tarkoittaa, ettei aukioloaikojen ulkopuolista jakoa ole. - `excluded_numbers`: enintään 50 puhelinnumeroa, jotka tallennetaan E.164-muodossa. Pelkkään 10-numeroiseen pohjoisamerikkalaiseen numeroon lisätään maakoodi `+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"] }' ``` ### Estetyt soittajat Tällä luettelolla olevat numerot eivät voi tavoittaa agenttejasi. Kun estetty numero soittaa mihin tahansa organisaatiosi puhelinnumeroon, ThunderPhone katkaisee puhelun ennen kuin agentti vastaa eikä veloita puhelusta. Puhelu näkyy silti Puheluhistoriassa epäonnistuneena saapuvana puheluna, jonka lopetussyy on **Estetty soittaja**. Piilotettua tai anonyymiä soittajatunnusta käyttäviä puheluita ei koskaan yhdistetä luetteloon, eivätkä estettyyn numeroon soitetut lähtevät puhelut muutu. Puhelun aikana estämääsi soittajaa ei katkaista; esto tulee voimaan hänen seuraavasta puhelustaan alkaen. Jokainen jäsen voi nähdä luettelon; omistajat ja ylläpitäjät muuttavat sitä kohdassa **Yleiset → Estetyt soittajat**: - Estä yksi numero antamalla se valinnaisen muistiinpanon kanssa ja valitsemalla **Estä numero**. Käytä merkkiä `+` ja maakoodia; myös kansallinen muoto, kuten `(415) 555-0123`, toimii, kun kaikki organisaatiosi puhelinnumerot ovat samassa maassa. - Estä useita numeroita kerralla valitsemalla **Liitä luettelo**, liittämällä enintään 500 numeroa (yksi riville tai pilkuilla eroteltuna) ja lähettämällä luettelo. Tuloksessa näkyy, kuinka monta numeroa lisättiin, oli jo estetty tai oli virheellisiä, ja siinä luetellaan virheelliset merkinnät. - Poista numeron esto valitsemalla sen riviltä **Poista** ja vahvistamalla. Voit myös avata saapuvan puhelun **Puheluhistoriassa** ja valita **Estä tämä soittaja**. Organisaatio voi estää enintään 10 000 numeroa. Lisätietoja luettelon hallinnasta API:n kautta on kohdassa [Estetyt soittajat](/api-reference/blocked-callers). ### Organisaation identiteetti ja jäsenyys Organisaatiokortti näyttää organisaation tunnisteen, jäsenyysroolisi ja muokattavan organisaation nimen. Tiimikortti yhdistää aktiiviset jäsenet ja odottavat kutsut. | Rooli | Tyypillinen käyttöoikeus | | --- | --- | | **Jäsen** | Rakenna ja käytä agentteja sekä tarkista puheluita. | | **Ylläpitäjä** | Jäsenen käyttöoikeudet sekä tiimin, avainten, portaalien, yhteyksien, hälytysten, laskutuksen ja tietoturvan hallinta. | | **Omistaja** | Ylläpitäjän käyttöoikeudet sekä omistajatason organisaatiotoiminnot. | Omistajat ja ylläpitäjät voivat kutsua **Jäsenen** tai **Ylläpitäjän**, peruuttaa odottavan kutsun, muuttaa kelpoisten jäsenten rooleja ja poistaa jäseniä. Kutsut ovat sidottuja sähköpostiosoitteeseen ja vanhenevat seitsemän päivän kuluttua. Katso [Kutsu tiimisi](/fi/guides/invite-your-team). Vaaravyöhykkeellä käyttäjä, jolla on tarvittavat oikeudet, voi poistua organisaatiosta tai poistaa sen pysyvästi. Poistaminen poistaa organisaation agentit, numerot, puheluhistorian ja laskutustiedot, eikä sitä voi kumota. Voit poistaa oman tilisi avaamalla **Tili**-välilehden ja valitsemalla **Poista tili**. Valintaikkunassa luetellaan organisaatiot, jotka poistetaan (ne, joissa olet ainoa jäsen), sekä organisaatiot, joista poistut. Organisaatiosta, josta poistut, luomasi API-avaimet mitätöidään. Poisto estetään, jos olet ainoa omistaja organisaatiossa, jossa on muita jäseniä (tee ensin jostakusta toisesta omistaja), jos olet luonut mukautettuja ääniä organisaatioon, joka säilyy, jos puhelu on käynnissä tai jos voimassa on oikeudellinen säilytysmääräys; valintaikkunassa luetellaan kaikki estävät tekijät. Toimintoa ei voi kumota. ### Oletuswebhook Määritä yksi vanha webhook-URL vastaanottamaan tapahtumia kaikista organisaation verkkowidgeteistä ja puhelinnumeroista. Käytä suositeltuja [webhook-päätepisteitä](/fi/webhooks/endpoints) päätepistekohtaisten salaisuuksien, tilausten, toimitushistorian ja uudelleenyritysten määrittämiseen. ### Enterprise SSO Määritä yksi tai useampi SSO-yhteys, sallitut sähköpostiverkkotunnukset, tarvittaessa tapahtuva käyttäjäprovisionointi, oletusrooli ja valinnaiset ryhmien ja roolien väliset määritykset. Tietoturvakäytäntö voi vaatia SSO:n, sallia ylläpitäjille hätäkäytön salasanalla ja vaatia salasana-avaimia organisaation käyttöön. Katso [SSO](/fi/guides/sso). ## Avaimet **Avaimet**-välilehdellä hallitaan salaisia `sk_live_`-palvelin-API-avaimia. Jokaisella rivillä näkyvät nimi, etuliite, aktiivinen/peruutettu-tila, luontiaika, viimeisin käyttö ja peruutusaika. Koko salainen avain näytetään vain kerran heti luomisen jälkeen. Kopioi se silloin ja tallenna salaisuuksien hallintaan. Peruutus on pysyvä ja pysäyttää kaikki avainta käyttävät integraatiot. Katso [API-avaimet](/fi/guides/api-keys). Julkaistavat `pk_live_`-avaimet kuuluvat **Verkkowidgeteihin**, koska ne ovat alkuperärajoitettuja selaintunnistetietoja eivätkä palvelinavaimia. ## Hälytykset Luo mittarisääntöjä onnistumisasteelle, epäonnistumisasteelle, keskimääräiselle pistemäärälle, puhelumäärälle tai testikokonaisuuden regressioille. Sääntö sisältää: - Vertailuoperaattorin ja numeerisen kynnysarvon. - Arviointi-ikkunan 1–720 tuntia. - Enintään 10 sähköpostivastaanottajaa. - Valinnaisen Slackin saapuvan webhookin URL-osoitteen. - Valinnaisen toimituksen kehittäjäwebhookiin. - Jäähdytysajan kokonaisina minuutteina ja käytössätilan. Samalla välilehdellä luetellaan viimeisimmät laukaisut. Katso [Hälytykset](/fi/guides/alerts). ## Laskutusasetukset Hallitse organisaation saldoa ja maksukäyttäytymistä: - Lisää tai vaihda oletusmaksukortti. - Lisää varoja manuaalisesti. - Ota automaattinen saldonlisäys käyttöön ja määritä sen kynnysarvo ja lisäyssumma. - Määritä tai poista kuukausittainen kulutusraja. Kuukausittainen raja keskeyttää uudet puhelut ja käytön 100 %:ssa, ja se pysyy voimassa, vaikka automaattinen saldonlisäys olisi pois käytöstä. Katso [Hinnoittelu](/fi/guides/pricing) ja [Laskutus ja saldonlisäykset](/fi/guides/billing-and-topups). ## Laskutushistoria Käytä **Laskutushistoriaa** tarkastellaksesi saldoa ja kulutusta tältä päivältä, 7 päivältä, 30 päivältä, 90 päivältä tai koko ajalta. Se sisältää: - Saldotrendin. - Laskutusjakauman puhelumaksuista, raporteista, puhelinnumeromaksuista ja saldojen lisäyksistä. - Agenttikohtaiset suurimmat kulut. - Tapahtumataulukon, jossa näkyvät päivämäärä, luokka, kuvaus, tyyppi, summa ja tapahtuman jälkeinen saldo. - Luokkasuodatuksen sekä näytetyn historian viennin CSV- tai JSON-muodossa. Hallintapaneeli ilmoittaa, kun näkyvissä ovat vain viimeisimmät tapahtumat; tätä rajaa vanhemmat rivit eivät sisälly myöskään vientiin. [Billing API](/api-reference/billing) tukee ohjelmallista sivutusta.