Käynnistäminen

BitVoice on täydellinen puhelinjärjestelmä yhdessä ohjelmassa: puhelinvaihto, johon puhelimet kirjaantuvat, valikot ja jonot, joiden läpi soittajat siirtyvät, ääniviestit, tallennus, konferenssisalit, faksit ja yhteydet puhelinoperaattoreihin. Kaikki asetukset tehdään selaimessa, tämän käyttöohjeen kuvaamilla näytöillä. Konfiguraatiotiedostoa ei tarvitse muokata, eikä mitään muuta asennusta tarvita.

Mitä tarvitset

• Tietokone ajuriksi: pieni toimistopalvelin, virtuaalikone, pilvivirtuaalikone tai ensimmäiseen katseluun oma kannettava tietokone. Linux, macOS ja Windows toimivat kaikki. Raspberry Pi 4 ajaa pienen toimiston.
• Puhelimet: pöytäpuhelimet Yealinkilta, Poly:ltä, Grandstreamilta tai Snomilta asetetaan automaattisesti; muut SIP-puhelimet tai pehmeät puhelimet toimivat omilla asetuksilla; ja jokainen selain on myös puhelin.
• Trunkki (tili puhelinoperaattorilla) soittaa ulkopuolisiin numeroihin ja vastaanottaa puheluita. Voit aloittaa ilman sitä: laajennukset soittavat toisilleen ja echo-testi toimii.

Ensimmäinen käynnistys

Käynnistä BitVoice ja avaa osoite, jonka se tulostaa (työpöytä avaa selaimen itse). Web-liittymä on vain HTTPS, myös tämän tietokoneen kanssa. Ennen kuin asennat oman varmenne (Asetukset, Varmente), BitVoice käyttää itse luomaansa varmennetta, joten selain varoittaa kerran: valitse jatkaa sivustolle. Asetusvelho kysyy neljä asiaa: organisaation nimen ja maan, ensimmäisen ylläpitäjän salasanan, ensimmäiset laajennukset ja puhelinoperaattorin, jos sellainen on. Maa asettaa hätänumerot, soittajien kuulemat äänet ja puhelinnumeroiden kirjoitustavan.

Ensimmäinen tunti

1. Laajennukset: yksi henkilöä tai pöytää kohden. Jokaisella on numero ja SIP-salasana. Avaa laajennukset (luku 3)
2. Puhelimet: yhdistä pöytäpuhelin, pehmeä puhelin tai selainpuhelin kuhunkin laajennukseen. Avaa puhelimet (luku 4)
3. Trunkki: puhelinoperaattorin tili, jotta voit soittaa ulkopuolisiin numeroihin ja vastaanottaa puheluita. Avaa trunkit (luku 7)
4. Soittorouting: mihin ulkopuoliset puhelut menevät (henkilö, ryhmä, valikko) ja mikä trunkki ulkopuoliset puhelut käyttävät. Avaa soittorouting (luku 8)
5. Terveys kertoo, mitä puuttuu, hätäpuhelut ensin. Avaa terveys (luku 13)

Tee sitten testipuhelu: miltä tahansa puhelimesta soita *43, echo-testi. Kuulet itsesi takaisin, mikä osoittaa, että ääni toimii molempiin suuntiin.

Asentaminen yhdellä käskyllä

Linux-palvelimella (Ubuntu, Debian, RHEL, Fedora, Alpine systemd):llä tai Mac:llä:

curl -fsSL https://raw.githubusercontent.com/BioDream-LLC/bitvoice/main/deploy/install.sh | sh

Windowsissa, PowerShellissä:

irm https://raw.githubusercontent.com/BioDream-LLC/bitvoice/main/deploy/install.ps1 | iex

It downloads the latest release for the computer, checks it against the release's SHA-256 sums and BioDream's release signature (with OpenSSL 3, or else with OpenSSH's ssh-keygen, which Windows 10 and 11, macOS and Ubuntu 20.04 have; ssh-keygen checks releases from v0.1.14 on), and installs it as a service that starts by itself:

• Linux: /usr/local/bin/bitvoice, a bitvoice system user, data in /var/lib/bitvoice, the systemd service bitvoice with the web interface on port 443. When ufw or firewalld is on, it opens 443, SIP (5060, 5061) and the calls' audio ports (10000 to 20000 UDP). It prints the address to open and the setup code the wizard asks for from another computer.
• macOS: BitVoice in your Applications folder (~/Applications/BitVoice.app), started when you sign in, the web interface on port 8443, data in ~/Library/Application Support/BitVoice (open to you alone) and logs in ~/Library/Logs/BitVoice (bitvoice.log, kept under 10 MB). Open BitVoice from Launchpad or Spotlight to reach the web interface; when it was stopped, that starts it again. It runs under caffeinate, so the Mac does not go to sleep while BitVoice runs: a sleeping Mac answers no calls, and even its short maintenance sleeps stop everything for many seconds. The screen may still turn off. Run by hand, use caffeinate -i -s ./bitvoice for the same. For a Mac that answers calls while nobody is signed in, install with sudo (curl -fsSL https://raw.githubusercontent.com/BioDream-LLC/bitvoice/main/deploy/install.sh | sudo sh): then BitVoice is in /Applications, starts with the Mac, runs as a hidden user of its own (_bitvoice), serves the web interface on port 443, keeps its data in /Library/Application Support/BitVoice and its logs in /Library/Logs/BitVoice, and the Mac's firewall, when on, lets it accept connections. One of the two per Mac: the installer refuses the other while one is there. When the Mac's firewall is on, a BitVoice installed for you asks once whether it may accept incoming connections: allow it, so phones can connect. If something already uses the port, the installer names it and stops (choose another with BITVOICE_HTTPS=:8444). sh install.sh --uninstall (with sudo for the Mac's own) removes it and keeps the data; --purge removes the data and logs too. Tried on macOS 26 (Apple silicon), installed for one person: installed, signature checked with the Mac's own ssh-keygen, a second start on the same data refused, back after the program was killed, started again from the app, upgraded in place, a tampered program refused, a port in use refused, uninstalled keeping the data, reinstalled on it, and purged with nothing left. The install for the whole Mac (sudo) is tried on every change on GitHub's macOS machines (Apple silicon): running as _bitvoice on port 443, a user install beside it refused, back after the program was killed, upgraded, purged with nothing left (the hidden user too). Intel Macs are not tried yet.
• Windows: as administrator, C:\Program Files\BitVoice, started with Windows, data in C:\ProgramData\BitVoice, and a firewall rule for private and domain networks; otherwise for you alone, started when you sign in. It works in Windows PowerShell 5.1 (what Windows Server has) and in PowerShell 7, and in 5.1 started from inside 7. BitVoice writes its log to bitvoice.log in the data folder (kept under 10 MB, the older part in bitvoice.log.1), and the installer prints the setup code the wizard asks for from another computer. Windows calls a new Wi-Fi or network Public until told otherwise, and the firewall rule lets nothing in there: for a home or office network the installer says how to make it Private (Settings, Network & internet, the network's Properties); for a cloud server it prints the rule to add (open the ports in the provider's firewall too). Installed as administrator, the data folder is readable by administrators only (it holds the database and the keys), and the Start menu's BitVoice opens the web interface; installed for you, the Start menu starts BitVoice, or opens it when it is already running. Either way it is in Settings, Apps, Installed apps, which removes it and asks whether to remove its data too. Tried on Windows 11 (as administrator and not) and on Windows Server 2022 on Amazon EC2: installed, reached from outside, running again after a restart.
• Tried on: Ubuntu 24.04 and 20.04, Debian 12 and Fedora 42 (each with systemd): installed, signature checked, a second start on the same data refused, back after the program was killed, upgraded in place, a tampered program refused, uninstalled keeping the data, reinstalled on it, and purged with nothing left.
• Linux on a cloud server: the address it prints is the machine's own, private one; the installer says so. Open the server by its public address or name, with 443, SIP and the audio ports open in the provider's firewall.

Suorita sama komento uudelleen päivittääksesi (tai käytä Päivitykset (luku 62)). sh -s -- --version v0.1.5 (putken jälkeen) valitsee julkaisun; --uninstall poistaa ohjelman ja palvelun ja säilyttää tiedot, --purge poistaa tiedot myös. Windowsissa tallenna skripti ja suorita .\install.ps1 -Version v0.1.5, -Uninstall tai -Purge, tai poista se Asennetut sovellukset -valinnasta. Palvelimelle, jota ei pidetä internetissä, kopioi julkaisun arkisto ja SHA256SUMS kansioon ja aseta BITVOICE_FROM siihen.

Missä se toimii

BitVoice toimii Linuxilla, macOS:llä ja Windowsilla.

Windowsilla pidä auki ikkuna, jonka se avaa, kunnes käytät BitVoicea (sulkemalla se lopettaa BitVoice-palvelun), ja kun Windows kysyy, saako se käyttää verkkoyhteyttä, salli yksityiset verkkoyhteydet, jotta puhelimet voivat muodostaa yhteyden. -data asettaa tiedot muualle; -https ja -sip valitsevat osoitteet ja portit; -log FILE kirjoittaa myös kaiken, mitä se tulostaa, tiedostoon, tietokoneelle, jolla kukaan ei ole katselemassa sen ikkunaa.

Portit, joita se käyttää

Jos toinen puhelinjärjestelmä jo käyttää porttia 5060, BitVoice ottaa seuraavan vapaan portin ja Terveys ilmoittaa siitä.

Everything in the web interface

Every setting has a screen, and every screen has a chapter here. Nothing needs a configuration file, a command line or a second tool. For automation, the same screens are a REST API, and the configuration can follow a file in Git (Configuration as code (luku 69)), but neither is ever required.

Mikä BitVoice on

BitVoice on ensisijaisesti puhelinjärjestelmä toimistoille ja asiakaspalvelukeskuksille, ja isännöity puhelinpalvelu tarjoajille: kaikki ensimmäisen viiden osan tässä käsikirjassa. 911-vastaanottoprofiili, radiolähetyskonsoli ja NG911 Core Services ovat erillinen lab- ja suunnittelukumppaniraita (Julkinen turvallisuus (luku 77)): ne ovat poissa valikosta, kunnes ne on käynnistetty Asetuksissa, eivätkä ne ole sertifioituja livenä käytettäväksi. Hälytyspuhelut omista puhelimista eivät kuulu tähän raitaan; ne toimivat jokaisella puhelinjärjestelmällä ensimmäisestä käynnistyksestä lähtien.

Tienviittoja

• Paina ⌘K (Ctrl+K) missä tahansa hyppiäksesi näytölle, tai kirjoita laajennuksen nimi tai numero avataksesi sen.
• Puhelimella valikko on ☰-painikkeen takana ylänurkassa vasemmalla (ja haku sen vieressä oikealla); valitse sivu sulkeaksesi sen uudelleen.
• Jokaisella näytöllä on Ohje-linkki oikeassa ylänurkassa, joka avaa sen luvun tästä käsikirjasta.
• Muutokset pitää jokaisen konfiguraation version: voit nähdä, mitä on muutettu, ja peruuttaa sen.
• Kolme teemaa (Midnight, Dark ja Light) on valikön alaosassa.

Kuinka kypsä kunkin osan on

Kuinka pitkälle kunkin osan on todistettu yksinkertaisesti. Kenttätestattu: suoritettu todellisia järjestelmiä vastaan todellisessa verkossa (Amazon EC2, internet, todellisten tarjoajien palvelut). Tarkistettu viiteen: testattu riippumattoman toteutuksen tai standardin omien tietojen vastaisesti. Ohjelmistotestattu: BitVoice omat testit ja selain testit vain, ei vielä todellista laitteistoa tai tilitä. Lab: julkinen turvallisuus -osat, eivät sertifioituja.

Laajennukset

Laajennus on numero henkilölle tai työpisteelle. Puhelimet kirjaudutaan laajennuksen numerolla ja sen SIP-salasanalla; soitto numeroon soi kaikissa puhelimissa, jotka ovat kirjauduttuina siihen, yhtä aikaa.

Laajennuksen lisääminen

1. Avaa Laajennukset (luku 3) ja paina Lisää laajennus. Seuraava vapaana oleva numero ja voimakas SIP-salasana täytetään automaattisesti.
2. Kirjoita henkilön nimi (näytetään muissa puhelimissa, kun he soittavat) ja sähköposti (viestien vastaanottamiseen sähköpostitse).
3. Täytä 113-sijainti: sivusto, kerros ja huone. Se lähetetään hätäsoittojen yhteydessä.
4. Valitse, mitä tapahtuu Jos kukaan ei vastaa: oletuksena viestien vastaanottaminen, tai toinen laajennus, ryhmä tai valikko.
5. Tallenna. Laajennus voidaan kirjautua välittömästi.

Kentät

Seuraa minua, nouda ja sisäpuhelin

Jokaisen henkilön oma puheluiden käsittely on omassa laatikossaan laajennuksessa:

• Seuraa minua soi useampi numero, kun puhelimet täällä eivät vastaa: matkapuhelin, toinen työpiste. Ne soivat yksitellen tai kaikki yhtä aikaa, omalla soittimisajallaan. Ulkopuoliset numerot paina 1 vastataksesi käyttämisellä, kuka tahansa vastaa matkapuhelimella, painaa ensin 1, jotta matkapuhelimen oma viestien vastaanotto ei koskaan ottaisi puhelua. Katso Ominaisuuskoodit (luku 32).
• Noutoryhmä: kuka tahansa samassa ryhmässä vastaa tämän laajennuksen soivia puheluita näppäimellä *8.
• Salli sisäpuhelin: *80 ja tämä numero vastaa itsestään puhujasta. Kytke se pois henkilöiltä, jotka eivät koskaan halua sitä.
• Oma nopeusnäppäin: lyhyet koodit vain tälle henkilölle, näppäilty *0 jälkeen.

Uudelleenohjaus tällä hetkellä

Asetusten alapuolella Uudelleenohjaus tällä hetkellä näyttää ja muuttaa, mitä henkilö on asettanut puhelimesta tai henkilöstöportaalista: älä häiritse, ja kaikkien puheluiden, puheluiden ollessa kiireisiä ja puheluiden vastaamattomien uudelleenohjaus. Nämä ovat live-tilaa, ei konfiguraatiota: muuttaminen ei tee muistiinpanoa.

Mitä on kytketty

• Puhelin: työpöytäpuhelin, pehmeä puhelin tai sovellus.
• Oven asema: ovien välissä oleva sisäpuhelin. Kuka tahansa vastaa, painaa avainkoodin tai Avaa ovi Live-puhelussa. Oven ohjausosoitteen kanssa BitVoice soittaa osoitteeseen (2N, Axis, Akuvox, releylätkät); ilman sitä koodi lähetetään asemaan, joka avaa oven itse.
• Kaiutin: puhelut siihen vastataan heti ja kuullaan kaiuttimesta.
• Analogisen sovittimen portti: vanha puhelin, faksi tai hälytyspaneeli sovittimella. Puhelut käyttävät vain G.711: ää, jota faksit tarvitsevat.

Kytketyt laitteet

Avoin laajennus näyttää jokaisen laitteiston, joka on kirjautunut siihen: puhelimen valmistaja ja malli, miten se yhdistää (UDP, TCP, TLS tai selain) ja koska. Osoite ja portti, jonka antaa puhelimelle, näytetään siellä myös.

Puhelinten yhdistäminen

Mikä tahansa SIP-puhelin tai sovellus toimii: osoita se tähän palvelimen osoitteeseen ja porttiin 5060, laajennuksen numeron kanssa käyttäjänä ja sen SIP-salasanana. Pöytäpuhelimet neljältä suurelta valmistajalta määritetään automaattisesti sen sijaan, että kukaan kirjoittaisi salasanan puhelimen näppäimistöön.

Automaattinen asetukset (määritys)

1. Puhelimet (luku 4) -sivulla paina Lisää puhelin ja anna puhelimen MAC-osoite (tarra alla) ja laajennus, johon se kuuluu.
2. Valitse valmistaja: Yealink, Poly, Grandstream (mukaan lukien HT-analogiatkaimet), Snom, Fanvil, Cisco, Mitel, Sangoma, Algo tai CyberData.
3. Kerro puhelimelle, missä BitVoice on: DHCP-palvelimessasi aseta vaihtoehto 66 näytön näyttämään määritysosoitteeseen, jotta jokainen puhelin verkkoon löytää sen itse; tai kirjoita sama osoite puhelimen omalla verkkosivulla, automaattisen määrityksen alla.
4. Käynnistä puhelin uudelleen. Se hakee tiedostonsa HTTPS: n yli, kirjautuu sisään, ja sen linjanäppäimet näyttävät, kuka on puhelimessa.

HTTPS tai selkeä HTTP. Puhelimet hakevat tiedostonsa HTTPS: n yli, kun he voivat. Jotkut vanhemmat puhelimet eivät voi käyttää HTTPS: ää ollenkaan, ja monet eivät luota BitVoicen itse luomaan varmenteeseen; niille näytön näyttää myös selkeän http://-osoitteen samalla portilla. Selkeä HTTP on vain näille tiedostoille: jokainen muu sivu menee edelleen HTTPS: ään. Selkeän HTTP: n yli puhelimen SIP-salasana siirtyy verkon yli salaamattomana, joten pidä se luotettavassa toimistoverkossa tai asenna varmenne viranomaiselta ja käytä Vain HTTPS puhelimille.

Tiedosto sisältää laajennuksen, sen salasanan, aikavyöhykkeen, koodekit, kiireen valot ja tämän palvelimen osoitteen. Määritys on suojattu käyttäjänimellä ja salasanalla, jotka puhelimille annetaan kerran.

Nämä valmistajat määritetään myös, tiedostot kirjoitetaan kunkin valmistajan dokumentoidusta muodosta, mutta ei vielä kokeiltu heidän laitteillaan (Puhelimet-näyttö merkitsee ne testaamattomiksi):

Jokaiselle laitteelle annetaan oma tili, palvelin (ja varapalvelin, useita palvelimia), kuljetus ja salaaminen, sekä vastaajanumero, jos sellainen on. Aseta Algo- ja CyberData-kuuluttimien laajennukset Kaikki kuuluttimet, jotta puhelut niiden luokse vastataan heti.

Phones without provisioning

Softphones and other makes take the same three things: server (this computer's address, port 5060, or 5061 with TLS), user (the extension number) and password (its SIP password). Health lists phones that tried a wrong password; after a few tries the address is banned for a while (see Security (luku 60)).

Selainpuhelin

Puhelinkuvake jokaisen näytön alareunassa tekee tästä selaimesta puhelimen laajennukselle, mikrofonilla ja kaiuttimilla. Se käyttää WebRTC:ää: ääni on salattu päästä päähän, ja se toimii useimmissa palomuureissa ilman asetuksia.

Other WebRTC softphones (SIP over WebSocket)

Softphones and web apps built on JsSIP, SIP.js and similar libraries speak SIP over WebSocket (RFC 7118). Switch on SIP over WebSocket in Settings (luku 14) and point them at wss://<this server's name>:<web port>/ws, with the extension number as the user and its SIP password. BitVoice ends their WebRTC sound itself (ICE, DTLS-SRTP, Opus or G.711), so they reach every phone, trunk and feature as desk phones do: calls both ways, keys pressed, hold, transfers by the other party, busy lamps and message-waiting. Settings shows how many are connected.

WebSockets ei tarvitse omaa kirjautumista: pehmeä puhelin kirjautuu SIP:llä, ja epäonnistuneet kirjautumiset ja liian monta pyyntöä lasketaan sen osoitteelle, kuten minkä tahansa puhelimen kohdalla. Sivu, jota palvelee toinen sivusto, on luotettava tälle palvelimelle (käytä Let's Encrypt), ja nykyinen Chrome kysyy käyttäjältä, ennen kuin julkinen verkkosivu voi tavoittaa paikallisen verkon palvelimen.

Testattu kahden itsenäisen kirjaston, JsSIP 3.13 ja SIP.js 0.21, kanssa: kaksi pehmeää puhelinta kummastakin rekisteröityy, soittaa toisilleen ja kuulee toisiaan BitVoicen kautta. Muiden pehmeiden puhelimien (Linphonen web-asiakas, Zoiperin) kanssa puhutaan samaa protokollaa, mutta niitä ei ole kokeiltu.

TURN, verkkoihin, jotka estävät UDP:n

Jotkin verkkoyhteydet (hotellit, vieras Wi-Fi, tiukat yrityksien palomuurit) eivät päästä UDP-liikennettä läpi, tai piilottavat tietokoneet NATin taakse, jonka WebRTC ei voi kiertää. Näille verkoille, käytä TURN-palvelinta Asetuksissa (luku 14): BitVoice käynnistää silloin oman TURN-palvelimen (RFC 8656) portissa 3478 (UDP ja TCP) ja tämän palvelimen varmenne, portissa 5349 yli TLS:in. Selaimeen perustuvat puhelimet, henkilöstön puhelin ja puhelulinkit saavat lyhytaikaiset tunnistetiedot siihen, ja käyttävät sitä, kun ne eivät pääse suoraan media-portteihin; ääni on edelleen salattu päiden välillä, ja BitVoice välittää sitä vain omiin osoitteisiinsa, joten kukaan ei voi käyttää sitä muiden asioiden saavuttamiseen.

Avaa TURN-portti, TLS-portti ja välitysportit (49152-49407, ellet muuta niitä) palomuurissa. TURN TLS:än tarvitsee selaimille luotettavan varmenteen käyttämälleen nimelle, kuten esimerkiksi Let's Encrypt (luku 14): kunnes varmenne on saatavilla, BitVoice ei tarjoa sitä selaimille (ne yrittävät, epäonnistuvat ja odottavat), ja tarjoaa sitä heti varmenteen saavuttua; aseta sen portiksi 443 palvelimella, jolla on vapaana osoite, jotta pääset palomuureiden läpi, jotka sallivat vain HTTPS-liikenteen.

Verkon vaihtaminen puhelun aikana

Puhelin, joka siirtyy toiseen verkkoon puhelun aikana (esim. toimiston Wi-Fi:stä matkaverkkoon tai kannettavan tietokoneen Wi-Fi:stä toiseen), saa uuden osoitteen, ja vanha reitti lopettaa äänen kuljettamisen. Selainpuhelimet ja BitVoice-sovellukset huomaavat tämän itsestään: kun selain ilmoittaa verkon muutoksesta tai puhelun reitti lopettaa vastaamisen kahden sekunnin ajaksi, puhelin käynnistää uudelleen ICE:n (RFC 8445 9). Se tarjoaa uudet ICE-tunnisteet käynnissä olevalle puhelulle, BitVoice vastaa uusilla omillaan ja tarkistaa uuden reitin, ja puhelu siirtyy siihen ilman uudelleenvalintaa. Salaus jatkuu samojen avaimien kanssa. Tämä tapahtuu, kun puhelu näkyy Yhdistetään...; toimivalla reitillä ei ole katkoa, koska vanha reitti kuljettaa puhelua, kunnes ääni tulee uudelle reitille. SIP-softpuhelimet WebSocketin (JsSIP, SIP.js) yli tekevät samoin uudelleen-kutsulla uusilla ICE-tunnisteilla. Mitään ei tarvitse kytkeä päälle, kun BitVoice toimii ICE-lite-na tai NATin takana.

BitVoice NATin takana

Yllä oleva TURN-palvelin auttaa selaimia tiukkojen verkkorajoitusten takana tavoittamaan BitVoice-palvelimen, jolla on julkinen osoite. Kun BitVoice-palvelimella itsellään ei ole julkinen osoite (esim. toimistoverkossa reitittimellä, jolla ei ole porttien uudelleenohjausta, tai pilvipalvelussa, jossa palvelimella ei ole julkinen osoite), käytä Tämä palvelin on NATin takana -vaihtoehtoa BitVoice NATin takana -osiossa Asetukset (luku 14). BitVoice osallistuu täysimääräisesti ICE:hen (RFC 8445) eikä vastaa ainoastaan yhdellä osoitteella (ICE-lite):

• Se tarjoaa selaimille omat osoitteensa, julkinen osoitteensa, jonka STUN-palvelimet näkevät, ja välittää TURN-palvelimien kautta, joihin se kirjautuu (UDP; käyttäjänimi ja salasana kullekin), ja tarkistaa kunkin osoiteparin selaimen kanssa, kuten selain tekee.
• Välitä kaikki puhelut TURNin kautta lähettää kaiken selainmedian TURN-palvelimien kautta, verkkojen, jotka vaativat sitä.
• Etsi osoitteeni pyytää palvelimilta puhelun tapaan ja listaa, mitä BitVoice tarjoaa: omat osoitteensa, julkinen osoite, jonka STUN-palvelin näkee (STUN-palvelin, joka ei vastaa, ilmoitetaan), ja välittää.
• Se toimii selainpuhelimen, puhelulinkkien, echo-testin ja SIP-yli-WebSocket-softapuhelinten kanssa, kummassakin roolissa: BitVoice vastaa selaimen tarjoukseen ja tarjoaa softapuhelimelle, jota se soittaa. Selaimet, jotka piilottavat osoitteensa mDNS-nimien (esim. name.local) taakse, ratkaistaan paikallisverkossa, ja selaimen osoite, jonka web-palvelin näki, päästetään välittämään välittäjien kautta alusta alkaen.
• Oletuksena pois; se lisää hetken kunkin puhelun aikana, kun palvelimet vastaavat (enintään puolitoista sekuntia). Soittajan video käyttää ICE-litetyyppiä kummassakin tapauksessa.

Henkilöstön puhelin

Avaa #/phone millä tahansa tietokoneella tai mobiiliselaimella: henkilöstö kirjautuu sisään omalla laajennuksellaan ja SIP-salasanallaan, ilman ylläpitäjän tilia. Se on täysi puhelin: näppäimistö, vastaa, pidä ja siirrä. Omien uudelleenohjausten ja ääniviestien hallintaan he käyttävät henkilöstöportaalia osoitteessa #/me (ks. Henkilöstöportaali (luku 33)).

Mobiilisovellukset

BitVoice-sovellukset iPhoneen ja Androidiin voidaan kytkeä laajennuksen sivulta QR-koodin avulla. Puhelut herättävät sovelluksen Apple:n ja Google:n push-palvelujen kautta, joten se soi, vaikka se on suljettu (kun push on asetettu päälle; ks. alla).

Skinny-puhelimet ja MGCP-portit

Puhelimet ja portit, jotka eivät puhu SIP: iä, voidaan silti käyttää. Skinny-puhelimet ja MGCP-portit (Puheluiden alla) ottaa kaksi vanhempaa protokollaa:

• Skinny (SCCP): Cisco-työpöytäpuhelimet, jotka suorittavat SCCP-firmwarea (79xx, 69xx, 89xx). Lisää kunkin puhelimen MAC-osoitteen mukaan ja valitse sen laajennus; kytke Hyväksy Skinny-puhelimet päälle ja osoita puhelin BitVoiceen (TCP-portti 2000) sen TFTP-asetustiedostossa tai valikossa.
• MGCP (RFC 3435): portit, joiden portit BitVoice ohjaa yksitellen, kuten analogiset puhelimen sovittimet ja linjakortit. Lisää portti sen domain-nimen mukaan, jota se käyttää päätepisteen nimissä (aaln/1@name), sen osoitteen mukaan ja kunkin linjan laajennuksen mukaan; aseta portin puheluiden agentiksi BitVoice (UDP-portti 2727).

Jokainen Skinny-puhelin tai MGCP-linja on yksi laajennuksen laitteisto: se soi laajennuksen muiden puhelimien kanssa, soittaa ulospäin laajennuksena ja näytetään laajennuksen laitteistossa. Sivu näyttää kunkin tilan.

Mitä toimii

• Skinny: rekisteröinti, linja ja sen numero näytöllä, valintanumero, numeron syöttäminen (numero menee paukauksen tai #-merkin jälkeen, tai kerran puhelimen numeronäppäimistöltä, kun se nostetaan numeron syöttämisen jälkeen), soitto, soiton vastaanotto ja lopettaminen käsittelyllä, puhujan tunnistus, vastaus ja lopetus käsillä, puhelimella tai pehmeillä näppäimillä (NewCall, Redial, Answer, EndCall), kiireiset ja uudelleenjärjestelyäänet.
• MGCP: valintanumero, numeroiden kerääminen portilla numerokartan avulla, soitto puhujan tunnistuksella (soi ilman sitä, kun portti kieltäytyy puhujan tunnistamisesta), soitto, kiireiset ja uudelleenjärjestelyäänet, ja ääniliikenneyhteys (CRCX, DLCX). Portti, joka käynnistyy uudelleen (RSIP), asettaa portit uudelleen.
• Ääni on G.711 µ-law kummassakin; BitVoice muuttaa sen mihin tahansa toisella osapuolella käytettävään muotoon.

Pidä, siirrä ja konferenssi tehdään toistaiseksi laajennuksen muiden puhelimien kautta, ja Skinny-puhelimen toinen linja ei ole käytössä.

Turvallisuus

Kummassakaan protokollassa ei ole salasanoja. Skinny-puhelimet hyväksytään vain paikallisverkosta ja vain, kun ne on lueteltu; MGCP-komennot noudatetaan vain portin osoitteesta (tai ilman sitä, paikallisverkosta). Pitäkää molemmat portit pois internetistä.

Yhdistelmä, joka vielä käsittelee käskyä, voi vastata ensin "100 Trying": BitVoice odottaa sitten kauemmin ennen kuin se lähettää käskyn uudelleen ja vahvistaa lopullisen vastauksen (000), kuten RFC 3435 pyytää. Portti, jota yhdistelmä ei tarkkaile, näyttää yhdistelmän oman kieltäytymisen sivulla, kuten yhdistelmä kieltäytyi tarkkailemasta porttia: 507 Unsupported Functionality media-yhdistelmältä, jolla ei ole analogisia portteja.

Kuinka ne testataan

• Skinny: kaksi puhelinta, jotka on rakennettu erillisestä Skinny-toteutuksesta (avoin mwicat/sccp-kirjasto), rekisteröityvät, soittavat toisilleen, vastaavat ja lopettavat; luettelossa olematon puhelin evätään. Wiresharkin Skinny-dissektorilukee jokaisen BitVoicen lähettämän viestin virheettä, ja viestit ovat täysikokoisia, kuten Asteriskin chan_skinny lähettää Cisco-puhelimille.
• MGCP: Yaten MGCP-yhdistelmää (uudelleenkäynnistys, väliaikaiset vastaukset, vahvistukset, evätykset) ja BitVoicen omaa testiyhdistelmää koko puhelun ajan. Yaten yhdistelmällä ei ole analogisia portteja, joten sitä kautta ei tehty puhelua.

Puhelinlaitteet

Puhelinlaitteet BitVoicen tietokoneessa (Digium, Sangoma, OpenVox ja muut laitteet, joissa on Linux DAHDI-ajurit) voivat käsitellä analogisia puhelimia ja puhelinverkkoyhteyksiä. Erillinen ohjelma, bitvoice-dahdi, ohjaa laitteita ja liittää niiden portit BitVoiceen tietokoneen omassa verkkoyhteydessä, joten BitVoice itse ei koske koskaan ydinajuria, eikä laitteiston ongelma voi estää puhelinjärjestelmää.

Asetukset

1. Asenna DAHDI-ajurit ja määritä portit /etc/dahdi/system.conf-tiedostossa (fxoks=1-4 porteille, joissa on puhelimia, fxsks=5-8 porteille, joissa on puhelinverkkoyhteyksiä, ja maan äänet loadzone- ja defaultzone-kohtaan), ja suorita dahdi_cfg.
2. Puhelinlaitteet (Puhelut-välilehdessä) käyttöön Käytä puhelinlaitteita. Luodaan tunniste; kopioi se tiedostoon, jota vain root voi lukea, kuten /etc/bitvoice/cards.token.
3. Lisää jokainen portti DAHDI-kanavanumeronsa mukaan: puhelin-portti (FXS, puhelin, faksi tai ovipuhelin, joka on liitetty) sen laajennuksella, tai linja-portti (FXO, puhelinverkkoyhteys) linjan numerolla. Valitse A-law Euroopan ja suurimman osan maailmasta, µ-law Pohjois-Amerikkaa ja Japania varten.
4. Linjoille, lisää trunkki Puhelinlaitteiden linjat-protokollalla Trunkkeja-välilehdessä, ja reititä numerot siihen kuten mihin tahansa trunkkiin; saapuvat reitit vastaavat kunkin linjan numeroa.
5. Käynnistä bitvoice-dahdi -server https://127.0.0.1:8443 -token-file /etc/bitvoice/cards.token palvelukäyttäjänä, joka voi avata /dev/dahdi. Se on Linux-latauksessa bitvoicen vieressä. Sivu näyttää, onko se käynnissä ja kunkin portin tilan; muutokset tavoittavat sen kymmenen sekunnin kuluessa. Kanava, jota toinen ohjelma vielä pitää (tai jonka dahdi_cfg ei ole vielä määritellyt), yritetään uudelleen joka kaksi sekuntia, joten asioiden käynnistysjärjestys ei ole väliä.

Mitä toimii

• Puhelimet: valintanumero, numeron syöttäminen (numerot kuullaan BitVoicen oman äänitunnistimen avulla; numero menee paukauksen tai #-merkin jälkeen), soitto, kiireiset ja ruuhkaäänet laitteen äänivyöhykkeeltä, soitto saapuville puheluille, ja näppäimistön painallukset puhelun aikana (lähetetään myös RFC 4733-tapahtumina).
• Linjat: soittava linja kutsuu numeroa täällä ja vastataan, kun puhelu on; puhelut ulos ottavat vapaan linjan, odottavat puhelinverkon valintanumeroa ja syöttävät numeron ääninä. Kaukaisen pään riippuminen huomataan, kun linja ilmoittaa siitä (silmukkavirta tai polariteetti, riippuen linjasta). Analogiset linjat eivät kerro, kun kaukainen pää vastaa, joten puhelu ulos lasketaan vastatulleksi, kun numero on syötetty.
• Ääni on G.711 laitteeseen ja siitä; BitVoice muuttaa sen mihin tahansa toisella osapuolella käytettävään muotoon.

Digitaaliset linjat: T1 ja E1 PRI

T1 (23 puhelua kerran) tai E1 (30) -linja toimii pääasiallisena ISDN-yhteytenä digitaalikortissa (Digium/Sangoma TE-sarja, OpenVox D-sarja ja vastaavat). BitVoice puhuu PRI:ä itse (Q.921 D-kanavalla ja Q.931-puhelunhallintana), joten jokainen puhelu tulee numeron ja puhujan tunnistuksella, menee ulos laajennuksen puhujan tunnistuksella, ja puhelinverkko kertoo, kun kaukainen pää vastaa, soi tai on kiireinen.

1. Määritä span /etc/dahdi/system.conf-tiedostossa PRI:lle (esim. span=1,1,0,esf,b8zs, bchan=1-23, hardhdlc=24 T1:lle; span=1,1,0,ccs,hdb3,crc4, bchan=1-15,17-31, hardhdlc=16 E1:lle), ja suorita dahdi_cfg.
2. Digitaaliset linjat Puhelinlaitteet (luku 6)-välilehdessä, lisää span: T1 tai E1, sen ensimmäinen DAHDI-kanava, onko BitVoice puhelinverkon PBX (yleensä) vai verkko (toinen PBX yhdistää BitVoiceen kuin puhelinverkkoon), ja puhelinverkon antama kytkentätyyppi.
3. Lisää kortin trunkki Trunkkeja-välilehdessä, jos sitä ei ole vielä, ja saapuvat reitit numeroille (DID), jotka puhelinverkko lähettää.

Puhelut ulos ottavat PRI:n ensin, analogiset linjat sen jälkeen; kiireinen numero, väärä numero tai ei vapaa kanava tulee takaisin kiireisenä, ei löydy tai ei saatavilla, kuten verkko sanoo. Sivu näyttää, onko kunkin spanin D-kanava ylös ja kuinka monta kanavaa on puheluissa. T1-kanavat, jotka on määritelty robbed-bit-signaaleilla (fxsks, fxoks), toimivat kuten yllä mainitut analogiset portit.

Nimet, siirtäminen ja välittäminen. Soittajan nimi tulee mukana puhelussa (Display-elementistä tai kansallisen ISDN-2:n kautta, jossa verkko lähettää nimen ominaisuutena) ja puhelimet näyttävät sen; lähtevät puhelut lähettävät laajennuksen nimen samalla tavalla. Numero, josta puhelu on siirtynyt, tulee redirecting-numerona (BitVoice välittää sen SIP:n Diversionina, jonka syy on: kiireinen, ei vastaa, ehdoton), ja kun laajennuksen siirto lähettää puhelun takaisin PRI:lle, laajennuksen numero menee mukana redirecting-numerona, jotta kaukaisella puolella ja puhelinverkkoyhtiöllä on tieto, kenen puhelu on kyseessä. Kun ulkopuolinen puhelu vastaanotetaan, BitVoice kertoo verkolle vastaanottaneen numeron (yhteyden numero).

Käytä Puhelinverkon kautta tapahtuvat siirrot valintaa spanilla (käyttäjän puolella, kansallinen ISDN-2, 5ESS, DMS-100 tai EuroISDN) ja kun joku siirtää puhelun samalla linjalla olevaan toiseen numeroon, BitVoice pyytää verkkoa yhdistämään kaksi puhelua itse: National ISDN-2- ja 5ESS-linjoilla tapahtuu Two B-Channel Transfer, Nortel DMS-100:llä Release Link Trunk -siirto ja EuroISDN:llä eksplisiittinen puhelusiirto (puhelu pidetään jonkin aikaa ja sitten yhdistetään). DMS-100 antaa siirtotunnisteen vain BitVoicen asettamille puheluille, joten siellä yksi kahdesta puhelusta on ulospäin menevä puhelu (yleinen tapaus: eteenpäin siirtynyt tai siirretty puhelu ulkopuolelle). Molemmat kanavat vapautuvat, kun verkko on yhdistänyt ne. Linjalla on oltava palvelu (pyydä puhelinverkolta "kaksi B-kanavan siirtoa" tai "ECT"); jos verkko kieltäytyy, siirto toimii silti, BitVoicen kautta, käyttäen molempia kanavia kuten ennen. Spanilla, jossa BitVoice on verkon puolella, toinen PBX voi pyytää BitVoicea yhdistämään kaksi puhelua; BitVoice kieltäytyy (se ei ole vaihteen), ja PBX pitää puhelut itse.

Kokeile ilman korttia

DAHDI:n omat dynaamiset spanit voivat korvata kortin: kaksi spania yhdistetään sisäpuolella, BitVoice toisella ja toinen PBX (Asteriskin chan_dahdi, esim.) puhelinverkkona toisella. Lataa dahdi, dahdi_dynamic ja dahdi_dynamic_loc, ja /etc/dahdi/system.conf-tiedostossa:

dynamic=loc,1:0,24,0
dynamic=loc,1:1,24,0
bchan=1-23
dchan=24
bchan=25-47
dchan=48

Jätä viimeinen numero (aikakatkaisu) 0:ksi molemmilla: DAHDI:n oma ajastin ohjaa niitä sitten. Spanit, jotka ovat toistensa aikakatkaisulähteitä, tikittävät vain, kun toinen lähettää, ja D-kanava tulee ja menee. Lisää span 1 tähän T1:ksi (ensimmäinen kanava 1), ja aseta toinen PBX verkon puolelle kanaville 25-48.

Basic rate ISDN (BRI)

BRI kuljettaa kaksi puhelua kerrallaan (B1 ja B2) ja on yleinen Euroopassa pienille toimistoille; se myös yhdistää ISDN-pöytäpuhelimet. BRI-kortit (Digium B410P, OpenVoxin, Junghannsin ja muiden HFC-pohjaiset kortit) toimivat DAHDI:n kautta kuten PRI-kortit: /etc/dahdi/system.conf-tiedostossa span on span=1,1,0,ccs,ami bchan=1-2 ja hardhdlc=3 kanssa. Lisää se Digitaaliset linjat alle BRI-linjatyypillä; sen kanavat ovat B1, B2 ja sitten D-kanava.

• BitVoice on PBX (käyttäjän puolella), pisteestä-pisteeseen: puhelinverkon PBX-linja (Saksan *Anlagenanschluss*): saapuvat puhelut sisältävät numeron, jota soitettiin, lähtevät puhelut laajennuksen numeron.
• Käyttäjän puolella, monipiste: jaettu linja muiden laitteiden kanssa (*Mehrgeräteanschluss*): BitVoice pyytää verkkoa omalta TEI:ltä (terminaattorin tunniste) ja vastaa puheluita linjalle muiden laitteiden rinnalla; puhelinverkko lähettää numeron, jota soitettiin (MSN), jonka saapuvat reitit vastaavat.
• BitVoice on verkko, monipiste: ISDN-puhelimet liittyvät kortin S-bussiin kuin puhelinverkkoon. Kunkin puhelimen on pyydettävä BitVoicelta TEI; puhelu bussille soittaa jokaisen puhelimen, joka on sen päällä, ja ensimmäinen, joka vastaa, ottaa sen ja muut lopettavat soiden. Numerot, jotka soitetaan yksitellen (kuten ISDN-puhelimet soittavat), kerätään, kunnes puhelin ilmoittaa, että se on valmis, # on painettu tai mikäli numeroa ei tule neljään sekuntiin. Reititä numerot bussille ja bussilta trunkin kautta kuten minkä tahansa linjan kohdalla.

Nimet, siirtäminen ja välittäminen EuroISDN:llä (eksplisiittinen puhelusiirto) ja maksun neuvonta toimivat BRI:llä kuten PRI:llä.

E&M-trunkit T1:llä

T1, jonka kanavat on asetettu E&M:ksi (robbed-bit-signaali: e&m=1-24 /etc/dahdi/system.conf-tiedostossa) antaa 24 trunkkia, joista kunkin signaali on oma: yhteys toiseen PBX:ään, kanavapankit ja etäisyysoperaattorien Feature Group D -trunkit. Digitaaliset linjat alle lisätään T1 ja asetetaan Signaali E&M:ksi, sitten:

• Käynnistysmerkki: Wink-käynnistys (yleinen: kaukaisella puolella on wink-merkki, kun se on valmis numerolle, ja BitVoice vastaa wink-merkillä saapuvaan puheluun), Välittömästi (numero seuraa heti), Viivekuulutus (kaukaisella puolella on hook-off, kun se valmistautuu, ja sitten hook-on), tai Feature Group D (wink-käynnistys MF-numeroilla, soittajan numero lähetetään ensin: KP 00 ANI ST, sitten KP numero ST; ANI:sta tulee soittajan ID).
• Lähetettävät numerot: DTMF tai MF (MF R1, KP numero ST) kuten useimmat operaattorin trunkit haluavat.
• Numero, kun ei lähetetä: mihin puhelu saapuu, jos kaukaisella puolella on trunkin valtaus ilman numeron soittoa (esim. suora yhteys eteen)

Puhelun ulosmenoon valitaan vapaa trunk, joka varataan, odotetaan käynnistysmerkkiä (jos wink-merkkiä ei tule viiden sekunnin kuluessa, puhelu epäonnistuu), lähetetään numero ja puhelu vastaanotetaan, kun kaukoäänen pääty laskee luurin (vastausvalvonta). Sisääntulevaan puheluun vastataan nostamalla luuri, kun laajakaista vastaa.

CAMA-trunkit (911, laboratoriotesti). PSAP, joka on edelleen CAMA-trunkin kautta 911-valitsimen kautta, asettaa Käynnistysmerkin CAMA (911-trunkkiin). Reititin varaa, BitVoice winkkaa ja reititin lähettää soittajan numeron (ANI) MF-muodossa: laajennettu CAMA KP, kaksi tietoa ja kymmenen numeroa, ST; perinteinen CAMA KP, yksi numerointisuunnitelman numero ja seitsemän numeroa, ST. Perinteisessä CAMA-tapauksessa luetteloi Puhelinalueet NPD 0-3 puhelinaluekoodi, joka kunkin numerointisuunnitelman numeron edustaa (reitittimen asetussivulla on ne); numero, joka on suurempi kuin 3, tarkoittaa, että reititin ei voinut tunnistaa linjaa. Kunkin puhelun menee 911-sisääntuloreittiin 911-puheluna, jonka paluunumero on ANI, ja BitVoice etsii sijaintinsa tämän numeron avulla (ks. 911-puhelut (luku 77), Sijaintitarkistus (ALI)). Tietonumerot näkyvät puhelussa CAMA (II 00).

MFC-R2 E1:llä

Latinalaisessa Amerikassa, Aasian ja Afrikan osissa E1-linjoja käytetään usein MFC-R2:na eikä ISDN:änä: 30 piiriä, joista jokaisella on omat linjamerkkinsä A- ja B-biteissä aikaraossa 16 (ITU-T Q.421) ja numeronsa, soittajan kategoria ja soittajan numero vaihdetaan pakotulla monotaajuisilla sävelillä (Q.441), eteen- ja taaksepäin. Määritä jakso CAS:na /etc/dahdi/system.conf-tiedostossa (span=1,1,0,cas,hdb3, cas=1-15:1101, cas=17-31:1101, dchan poistettu), sitten Digitaaliset linjat -osiossa lisää E1, aseta Merkinanto MFC-R2:ksi ja valitse Maa-variantti: ITU-T, Argentiina, Brasilia, Kiina, Kolumbia, Tšekki, Ecuador, Meksiko, Filippiinit tai Venezuela. Jokainen maa määrittää joitakin merkkejä eri tavoin (mitä tarkoittaa varattu, miten numeron loppu ilmoitetaan, Meksikon ryhmä C); variantti sisältää ne. Kiinan No. 1 pyytää soittajan luokkaa (KA) ja numeroa valittuna numerona, lähettää puhelutyypin (KD: 3, paikallinen puhelu) viimeiseksi, lukee varatun ja vapaan tilan lähettämästä KD:stä ja asettaa C- ja D-bidit molemmat 1:ksi: siellä kirjoita cas=1-15:1111 ja cas=17-31:1111.

Jokainen piiri välittää puheluita molempiin suuntiin. Sisääntulossa oleva puhelu saapuu sisääntuloreiteille valittuna numerona ja soittajan numerona (salatut numerot tulevat anonyymina); varattu laajennus tai väärä numero ilmoitetaan takaisin varattuna tai epäkäytössä, kuten variantti sanoo. Ulospäin menevä puhelu lähettää numeron ja laajennuksen soittajan tunnisteen tai "numero salattu" -signaalin, kun soittaja piilottaa sen.

MFC-R2-merkinantotesti tehdään OpenR2:ta (R2-kirjastoa, jonka chan_dahdi Asteriskissa käyttää) vastaan jokaisessa tarjotussa variantissa ja molempiin suuntiin, myös puhelun kieltäminen varattuna; E&M BitVoicen omia simuloituja kanavia vastaan.

SS7

Toimittaja voi luovuttaa T1- tai E1-kaistoja, jotka ohjataan SS7:llä eikä ISDN:llä: äänipiirit välittävät puheluita, ja kunkin piirin nimi on piirin tunniste (CIC), ja yksi aikaosuus välittää merkinantoliittymän toimittajan signaalisirontapisteeseen tai kytkimeen ISUP:n kautta. BitVoice on silloin itsenäinen merkinantopiste, jolla on toimittajan määrittämä pisteiden koodi. Määritä jakso /etc/dahdi/system.conf-tiedostossa puhdas kanava merkinantoliittymän aikaosuutena mtp2 tai hardhdlc (aikaosuus 16 E1:llä, 24 T1:llä). Digitaaliset linjat -kohdassa lisää jakso, aseta Merkinanto SS7 (ISUP):ksi ja anna:

• SS7-variantti: ANSI (Pohjois-Amerikka; pisteiden koodit verkko-klusteri-jäsen, kuten 245-16-1) tai ITU-T (suurin osa maailmasta; pisteiden koodit vyöhyke-alue-piste, kuten 1-10-2, tai pelkästään numero).
• Meidän pisteiden koodi ja Viereisen pisteiden koodi, Verkko (kansallinen, yleensä, tai kansainvälinen), merkinantoliittymän Linkin koodi (SLC, 0, ellei toisin ilmoiteta), ja Ensimmäinen CIC: jakson ensimmäisen äänipiirin koodi, muut seuraavat järjestyksessä. Nämä tulevat toimittajalta.

Useiden linkkien linkkisarjat. Jakso, joilla on sama variantti, pisteiden koodit ja verkko, muodostavat yhden linkkisarjan (jopa 16 linkkiä): kunkin jakson merkinantoliittymä on yksi sen linkkejä, ja tarvitsee oman Linkin koodin, ja kunkin jakson piirit kuuluvat siihen (niiden CIC:t eivät saa olla päällekkäin). Liikenne jaetaan linkkien välillä palvelussa viestien SLS:n mukaan, joten yhden puhelun viestit pysyvät yhdellä linkillä. Kun linkki epäonnistuu (linkin testi ei saa vastausta, tai viestit eivät saa vahvistusta), sen liikenne siirtyy muihin (Q.704: COO ja COA, viestit, joita kaukoääni ei ole lähettänyt toiselle linkille; tai, ilman vastausta ajalla, ajan mukaan), puhelut jokaisella jaksolla jatkuvat, ja Puhelinlaitteet kertoo, kuinka monta linkkiä on palvelussa ja miten tämän jakson linkki on. Kun linkki on takaisin ja testattu, sen liikenne siirtyy takaisin (CBD ja CBA). Vain silloin, kun kaikki linkit ovat poissa, linkkisarja on poissa. Testattu libss7:ää vastaan kahdella linkillä, joista toinen katkaistiin puhelun keskellä: libss7 ottaa verkkojohtamisviestit vain linkiltä, jonka SLS mainitsee, joten linkin vaihtoviesti (lähetetty toisella linkillä, kuten Q.704:ssä on) hylätään siellä, ja molemmat päät siirtyvät ajan mukaan, mikä toimii; kahden BitVoice-pään välillä se tapahtuu COO:n ja COA:n kautta.

Kun linkki tulee käyttöön, BitVoice kohdistaa sen (MTP-taso 2, hätätilanteen osoittamisjakson kanssa yksittäisen linkin linkkiryhmänä), testaa sitä linkkitestillä (SLTM/SLTA), vaihtaa liikenteen uudelleen sallimisen ja nollaa jokaisen piirin (GRS). Saapuvat puhelut saapuvat sisääntuloreiteille numeron, soittajan numeron (piilotetut numerot nimettöminä), numeron, josta puhelu on ohjattu, ja ANSI: n mukaan soittajan nimen kanssa; lähtevät puhelut sisältävät laajennuksen soittajan ID: n ja nimen. Toimittajan esto- tai nollauspiirit noudatetaan. Kaksinkertaisessa takavarikossa pää, jolla on korkeampi pisteellinen koodi, pitää parilliset piirit, kuten Q.764 sanoo, ja BitVoice ottaa ensin piirit, jotka se pitää.

SS7 testataan libss7: ää (SS7-kirjasto, jonka Asteriskin chan_dahdi käyttää), ITU ja ANSI: kohdistus, linkkitesti, liikenteen uudelleen käynnistäminen, piirin nollaus, puhelut molempiin suuntiin numeroilla ja nimillä, vapauttaminen, kiire ja esto; ja BitVoice itsensä vastaan kadonneilla kehyksillä (uudelleen lähetetty MTP2: n virheenkorjaus) ja kaksinkertaisella takavarikolla. Signaalin siirto (toimien muiden STP: nä) ja SCCP/TCAP (numeroiden siirtoluettelo, maksuttoman käännöksen) eivät ole tarjolla: PBX on päätepiste, ja ne ovat toimittajan.

Signaali-ohjauspiste (STP). bitvoice-dahdi voi myös toimia STP:na ITU SS7-yhdistelmänsä kanssa: käytä Signaali-ohjauspiste (SS7) Digitaaliset linjat -osion alapuolella. Sen STP-pistekoodi on jaksojen oma. Välitä viestit muiden pistekoodien puolesta -valinnalla viesti toisesta yhdistelmästä toisen yhdistelmän vieressä olevaan pisteeseen menee sinne, ja muuhun pistekoodiin menevä viesti menee IP STP:hen (M3UA): IP STP:hen tai merkinantoliittymään, joka on isäntänimi:portti, ja johon pääsee M3UA:n (RFC 4666) kautta TCP:n yli, jonka viestit yhdistelmien pisteille tulevat saman tien (BitVoice rekisteröi oman pistekoodinsa ja sen takana olevat, ellei Reitityskonteksti ole annettu). Globaali otsikko lähettää SCCP-viestit, jotka on osoitettu STP:lle globaaliotsakkeella, pistekoodiin ja aljärjestelmään, joka on pisimmän vastaavan etuliitteen mukainen, kuten SCCP-välitys tekee. Viesti, jota ei voida toimittaa, palautuu lähettäjälle UDTS- tai XUDTS-viestinä, kun se pyysi sitä: ei käännöstä, ei reittiä (MTP-epäonnistuminen), ei alijärjestelmää täällä tai sen hyppylaskuri on loppunut. STP:n tila näyttää M3UA-yhteyden ja montako viestiä se on välittänyt, kääntänyt ja palauttanut. Sen SCCP (UDT, XUDT, UDTS, XUDTS) ja TCAP (Aloita, Jatka, Lopeta, Keskeytä, dialogit ja komponentit) on tarkistettu Osmocomia vastaan: OsmoSTP M3UA:n yli, libosmo-sigtranin SCCP-echo-käyttäjä sen takana ja libosmo-asn1-tcapin oma TCAP-koodaus molempiin suuntiin. SCTP:ä ei tarjota (Go:lla ei ole): M3UA menee TCP:n yli, jota OsmoSTP ja monet IP STP:t hyväksyvät. Yhteydenvaraista SCCP:ä, ANSI-yhdistelmäjä ja SCCP-hallintaa (SST, SSA) ei tarjota.

Maksun neuvonta. EuroISDN-linjalla käytä Maksun neuvontaa ja BitVoice pyytää puhelinverkkoyhtiötä kertomaan kunkin puhelun hinnan: puhelun aikana (AOC-D) ja puhelun päätyttyä (AOC-E), rahassa tai laskuyksiköissä. Viimeinen luku siirretään puhelun tiedoston laskettu EUR 1,50 Historiaan ja kustannuksiin; kun se on omassa valuuttassasi (asennettu Kustannuksiin), se on puhelun kustannus, sen sijaan, että käytettäisiin käyttöliittymän hintoja. Puhelinverkkoyhtiön on tarjottava palvelu linjalla. SIP-liittymät voivat lähettää saman neuvonnan 3GPP AOC XML: nä INFO- tai BYE-viestinä, ja BitVoice tallentaa sen samalla tavalla.

PRI-koodi testataan libpri: ää (ISDN-kirjasto, jonka Asterisk käyttää) vastaan, sekä käyttäjän puolella että verkon puolella, kansallisten ISDN-2- ja EuroISDN-puheluiden, nimien, uudelleenohjattujen ja yhdistettyjen numeroiden, eksplisiittisen puhelun siirron, kahden B-kanavan siirron ja DMS-100 Release Link Trunk -pyynnön bittien mukaan (libprin PBX: n kanssa, johon BitVoice liittyy DMS-100: na), sekä maksun neuvontaa molempiin suuntiin; ja BRI: llä, pisteestä pisteeseen ja monipisteeseen, sekä terminaali- että verkkopuolella (TEI-osoitteen määrittäminen, puheluiden lähettäminen linjalle, numeroiden näppäily yksitellen).

Ei vielä: soittajan ID-näyttö analogisissa puhelimissa tai lukeminen analogisilta linjoilta, hook flash ja kaikuhyvitys siitä, mitä kortti itse tekee.

Trunkit

Trunkki on tilisi puhelinpalveluntarjoajalla. Se välittää puheluita ulkopuolisten numeroiden kanssa. Useimmat ovat SIP-trunkkeja; Asterisk- tai FreePBX-palvelin tai IAX2-palveluntarjoaja voidaan tavoittaa IAX2:n kautta.

SIP-trunkin lisääminen

1. Trunkit (luku 7) -sivulla paina Lisää trunkki.
2. Anna Palveluntarjoajan palvelin, jonka puhelinpalveluntarjoaja on antanut (sip.provider.com), ja portti, jos se ei ole 5060.
3. Anna Käyttäjänimi ja Salasana, ja käytä Rekisteröi -vaihtoehtoa, jos tarjoaja sanoo tehdä niin (useimmat tekevät).
4. Tallenna. Muutaman sekunnin kuluttua trunkki näkyy rekisteröitynä; jos ei, syy näkyy sen vieressä.

Reitinten terveyden arviointi

Kun lähtöreitillä on kaksi tai useampi reitti, BitVoice arvioi joka 15 sekunti, onko kunkin reitin käyttö kohdallaan vai yritetäänkö sitä toisten reittien jälkeen. Reitti siirtyy muiden reittien taakse, kun sen tarjoaja lopettaa vastaamasta ylläpitotarkastuksiin tai kun sen viimeiset ulospäin suuntautuneet puhelut epäonnistuivat peräkkäin tarjoajan puolella (Peräkkäiset epäonnistuneet puhelut Minuutteina, Asetukset, Reitinten terveyden arviointi), ja toinen reitti toimii. Se ei siirry epäonnistuneen ylläpitotarkastuksen vuoksi, jos puhelut sen kautta edelleen pääsevät läpi; ja kun kaikki reitit epäonnistuvat kerran, todennäköisin syy on tämän järjestelmän oma internet-yhteys, joten mitään ei siirretä. Muutokseen vaaditaan kaksi peräkkäistä arviointia (30 sekuntia), jotta reitti ei vaihdu liian nopeasti. Reittiä ei poisteta kokonaan: sitä yritetään edelleen, kun muut reitit epäonnistuvat, joten hälytyspuheluilla on aina kaikki mahdolliset tiet. Reitin sivu näyttää arvioinnin ja sen syyt; puhelu, joka meni toista reittiä, sanoo sen myös sen merkinnässä.

1. Lisää saapuvan reitin numerollesi ja lähtevän reitin, joka käyttää tätä reittiä (Puhelujen reititys (luku 8))

Pilvitietokoneiden tarjoajat

Aloita täyttää Microsoft Teams Direct Routing, Amazon Chime SDK Voice Connector tai Azure Communication Services, ja huomautuksella siitä, mitä on asetettava heidän puolellaan. Teams on kuvattu omassa luvussaan (Microsoft Teams (luku 67)).

IAX2-reitit Asteriskiin ja FreePBX:ään

Valitse IAX2 protokollaksi liittyäksesi toiseen Asterisk-palvelimeen tai FreePBX-palvelimeen tai IAX2-tarjoajaan. IAX2 kuljettaa merkinnan ja äänen yhdellä UDP-portilla, 4569, mikä tekee siitä helpon palomuurien läpi.

• Palvelimen osoite: toinen palvelin. Jätä se tyhjäksi, kun toinen palvelin rekisteröityy BitVoiceen sen sijaan (sivuliike, jolla on muuttuva osoite); silloin käyttäjänimi ja salasana ovat ne, joilla se rekisteröityy.
• Käyttäjänimi ja salasana: samat molemmissa puolissa. BitVoice vastaa ja käsittelee MD5-haasteita ja puhelutunnisteita.
• Rekisteröinti: kirjaudu toiseen palvelimeen, jotta se voi lähettää puheluita tänne.

Asterisk-puolella riittää tällainen vertainen:

[bitvoice]
type=friend
host=dynamic
secret=the shared password
context=from-bitvoice

IAX2-portti 4569 avautuu vasta, kun ensimmäinen IAX2-reitti lisätään, joten Asterisk, joka ajaa samassa tietokoneessa, pitää sen auki siihen asti.

H.323-reitit

Valitse H.323 protokollaksi vanhemmille portille, PBX-järjestelmille ja videoneuvotteluille, jotka puhuvat H.323:aa, mutta eivät SIP:ää. Anna portin osoite (portti 1720); puheluita hyväksytään ainoastaan siitä. Puhelut määritellään Pika-yhteys ja G.711 (µ-laki tai A-laki; reitin koodekkilista voi rajoittaa yhteen). Ääni menee suoraan portin ja BitVoicein media-porttien välillä. BitVoice muuttaa sen mihin tahansa toisella osapuolella käytetään.

H.323 tässä on tarkoituksella pieni: ei porttia (RAS), ei H.245:ää (joten portti, joka ei voi käyttää Pika-yhteyttä, ei saa puhelua, ja se kerrotaan sille), ei videota, ei H.235-turvalaitetta. Soittajan tunniste tulee Q.931-soittajan numerosta tai soittajan numeron aliasista, ja nimi tulee näytöstä tai sen H.323-tunnisteesta. BitVoicein H.225.0- ja H.245-koodaus on tarkistettu itsenäisen ASN.1-kooderin kanssa, mutta ei vielä portin laitteiston kanssa.

Ohjatut puhelut

Kun puhelu tulee sinulle jo ohjattuna (joku on ohjannut numeronsa sinulle tai Teams-käyttäjä), tarjoaja ilmoittaa siitä History-Info (RFC 7044) tai Diversion (RFC 5806) -tietona. BitVoice lukee kumpaan: Puheluhistoria (luku 47) näyttää ohjattu numeron, joka lähetti sen eteenpäin, alkuperäisen numeron ja syyn sen vihjeessä, puhelun syy polku kertoo sen sanoin ja puhelun tallenne säilyttää sen (forwardedFrom, original, forwardReason). Kun tarjoaja pyytää historian olevan yksityinen, numeroita ei säilytetä.

Kun laajennus ohjaa puhelun ulospäin trunkin kautta (ohjaa kaikki, kun kiireinen, kun kukaan ei vastaa), tarjoajalle ilmoitetaan, kuka laajennus ohjasi sen ja miksi, jotta se voi näyttää numerosi ja laskuttaa oikean tilin: oletusarvoisesti molemmilla otsikoilla, ja säilyttää puhelun historian, joka tuli sisään ja lisää ohjauksen. Tarjoaja, joka on hämmästynyt yhdestä niistä, voidaan asettaa toiseen trunkin Lisäasetukset -välilehdessä Ohjatut puhelut sanovat, keiden ne ovat. T1/E1-telefonipuhelinluettaessa jompikumpi otsikko tulee verkon uudelleenohjausnumeroksi.

Mitä tila tarkoittaa

Puheluiden reititys

Puheluiden reititys päättää kaksi asiaa: minne ulkopuolelta tulevat puhelut menevät, soitetun numeron mukaan, ja minkä trunkin ulkopuolelle menevät puhelut käyttävät.

Saapuvat reitit

Jokainen saapuva reitti vastaa numeroa, jota soitettiin (tai mitä tahansa numeroa), ja lähettää puhelun määränpäähän: laajennukseen, soittoryhmään, jonoon, valikkoon, aikatauluun, skriptiin, konferenssisaliin, tekoälyvirkailijaan tai vastaajaan. Numerot vastaavat missä tahansa muodossa: +1 212 555 0100, 2125550100 ja 12125550100 ovat samat.

• Yksi numero voittaa yleisen numeron reitin.
• Reitti voidaan rajoittaa yhteen trunkkiin, numeroille, joita kaksi palveluntarjoajaa lähettää.
• Hätätila (Asetukset) käytössä, jokainen saapuva soittopyyntö menee yhteen paikkaan, riippumatta reiteistä: evakuointi, sulkeminen, tapahtuma.

Lähtevät reitit

Lähtevät reitit vastaavat mitä ihmiset soittavat, kaavalla, ja lähettävät sen trunkkeihin järjestyksessä: jos ensimmäinen on alas tai täynnä, seuraavaa yritetään.

• Poista poistaa numerot etupäästä (9 soitettu ulkopuhelimen linjalle); Lisää eteen lisää niitä (maakoodi).
• Järjestys on tärkeä: ensimmäinen reitti, jonka kaava vastaa, käytetään. Vedä reittejä muuttaaksesi sitä.
• Premium-numerot (900 ja vastaavat) hylätään, ellei reitti mainitse niitä.

Hälytysnumerot

Hälytysnumerot toimivat aina. Reitti, joka mainitsee numeron tarkasti, käytetään ensin; ilman reittiä, jokainen toimiva trunkki yritetään vuorotellen. Hälytysnumeroa ei koskaan hylätä laajennuksen rajoitusten, isännöidyn organisaation rajoitusten tai puuttuvan reitin vuoksi. Terveydenhuolto varoittaa, kun mikään trunkki ei voi käsitellä niitä.

PIN-ryhmät

PIN-kokoonpano (PIN-kokoonpanot (luku 9)) on luettelo PIN-koodista, jota ulospäin menevän reitin tulee pyytää ennen kuin se tekee puhelun: kansainvälisten tai paikallispuheluiden rajoittamiseksi niille, joilla on PIN-koodi, tai laskuttamiseksi asiakkaille ja projekteille heidän koodinsa perusteella.

1. Lisää PIN-ryhmä ja luo luettelo PIN-koodeista (4-10 numeroa kussakin).
2. Käytä Säilytä PIN puhelun tiedoissa kirjoittaaksesi käytetyn PIN-koodin kunkin puhelun tietoihin sen tilinumerona (tilinumerosarake CSV-, syslog- ja PostgreSQL-puhelutietojen tulosteissa ja account-kenttä API:ssa).
3. Valitse Puhelureititys (luku 8), avaa ulospäin menevä reitti ja valitse ryhmä Kysy PIN -kohdasta.

Soittajat, jotka soittavat numeroa, jota reitti ottaa, kuulevat "Anna PIN-koodi, sitten paina risuaita", syöttävät sen ja puhelu menee ulos. Kolme väärää PIN-koodia lopettavat puhelun, ja yritys kirjataan turvallisuustapahtumaksi. Hälytysnumerot eivät koskaan kysy PIN-koodia, riippumatta siitä, minkä reitin ne ottavat, eivätkä eteenpäin siirretyt puhelut ja seuraa-minulle-numerot kysy sitä: vain henkilöt, jotka soittavat puhelimesta.

Soittajan tunnistus

Monet puhelinoperaattorit lähettävät soittajan numeron, mutta ei nimeä. BitVoice etsii ensin yrityksen osoitteista (luku 38); sen jälkeen saapuvan reitin voi kysyä soittajan tunnistus (luku 10):

• A web address: your CRM or any service that answers with the name. Put {number} where the number goes (https://crm.example.com/api/callers?phone={number}). A plain-text answer gives the name on its first line; for JSON, give the name field as a dotted path (data.contact.name; a number steps into a list, as in results.0.name). Basic authentication is optional.
• OpenCNAM: the North American caller-name database, with your account SID and auth token.

Valitse tunnistus saapuvan reitin Puhelureititys (luku 8) (Soittajan tunnistus). Puhelimet näyttävät nimen, kun ne ovat soittona, ja se menee puhelutietoihin.

Tunnistus ei koskaan pidä puhelua pois: BitVoice odottaa enintään odotusaikaa (1,5 sekuntia, ellei sitä muuteta, 5 sekuntia enintään) ja sitten soittaa ilman nimeä. Vastaukset säilytetään päivän ajan (tai niin kauan kuin asetetaan, tai ei koskaan -1:llä), joten säännöllinen soittaja ei haeta joka kerta; numerot, joita palvelu ei tunne, kysytään uudelleen tunnin kuluttua. Kokeile tunnistuksen sivulla kysyy numeroa kerran, asetuksilla, jotka on tallennettu.

Hälytyspuhelut

Hälytysnumerot menevät aina ulos, jokaisesta laajennuksesta, jopa niistä, jotka eivät voi soittaa ulkopuolisia numeroita. Tämä luku kertoo hälytyspuheluista, jotka tehdään BitVoice-puhelimilla: toimisto soittaa 911. Vastaus 911-puheluihin on 911-profiili (luku 77).

Mitä BitVoice tekee jokaisessa hälytyspuhelussa

1. Reitittää sen, aina: reitti, joka mainitsee numeron ensin; ilman sitä, jokainen toimiva trunki vuorotellen. Rajoitukset eivät koskaan estä sitä: laajennus, joka ei ole sallittu ulkopuolisiin puheluihin, isäntäorganisaatio, joka on kutsuvierasrajoituksessa tai keskeytetty, trunki, joka on kanavarajoituksessa.
2. Lähettää, missä soittaja on: Lähetä soittajan osoite -asetuksella (Asetukset), puhelu sisältää kohteen siviiliosoitteen, kerroksen ja huoneen operaattorille PIDF-LO -muodossa.
3. Kertoo ihmisille paikalla (Karin laki Yhdysvalloissa): laajennukset Ilmoita -kohtaan saavat viestin puhelimilleen, jokainen avoin BitVoice-näyttö näyttää hälytyksen, ja osoitteet Lähetä myös sähköpostiin -kohtaan saavat sähköpostin soittajan nimen, laajennuksen, kohteen, kerroksen ja huoneen, jotta joku voi tavata vastaajat ovella.
4. Antaa puhelun tulla takaisin: tunnin ajan hälytyspuhelun jälkeen, saapuvat puhelut eivät koskaan hylätä, jotta vastauspiste voi aina soittaa takaisin.

Asetusten määrittäminen

1. Tarkista hälytysnumerot Asetukset (luku 14) (maakohtaiset: 911 ja 933 Yhdysvalloissa).
2. Lisää jokainen rakennus Kohteet (luku 12) -kohtaan, jossa on katuosoite ja verkkot, joita puhelimet käyttävät.
3. Anna jokaiselle laajennukselle kohteen, kerroksen ja huoneen.
4. Varmista, että ulospäin menevä reitti ja trunki vievät hälytyspuhelut; Terveys (luku 13) varoittaa, jos mikään ei voi.
5. Täytä Ilmoita ja Lähetä myös sähköpostiin.
6. Soita 933 (Yhdysvalloissa) kuullaksesi osoitteen, jonka operaattori on.

Etätyöntekijät

Puhelin, joka rekisteröityy ulkopuolelta kohteen verkkoa, on etätyöntekijä: heidän puhelin sivu kysyy, missä he ovat, ja se osoite käytetään sen sijaan. Hälytykset kertovat, kun sitä ei vahvistettu.

Hälytysmode

Erilainen asia: yksi kytkin, joka lähettää kaikki saapuvat puhelut yhteen paikkaan (evakuointi, sulkeminen, tapahtuma). Määritä, mihin puhelut menevät, valinnainen koodi, kuten *55 ja siihen pääsevät laajennukset Asetukset (luku 14) -valikossa; kytke se päälle Pääsivu-valikossa (Dashboard (luku 1)), tai näppäile koodi (nousevat sävelet päälle, matala sävel pois päältä). Punainen palkki näkyy jokaisella sivulla, kun se on päällä.

Toimipisteet ja virka-apu 911

Toimipiste on rakennus: sen katuosoite ja verkkot, joita sen puhelimet käyttävät. Toimipisteet ovat tapa, jolla hätäpuhelu kertoo, missä soittaja on, aina kerrokseen ja huoneeseen asti. Yhdysvalloissa Kari's Law ja RAY BAUM'S Act vaativat täsmälleen tätä yritysten puhelinjärjestelmiltä.

Sivuston lisääminen

Sivustot (luku 12) -sivulla paina Lisää:

Sitten kunkin laajennuksen antaa sivustonsa, kerroksen ja huoneen. Terveydentila (luku 13) listaa laajennukset, joilla ei ole sijaintia.

Miten puhelimen sijainti löydetään

1. Puhelin, joka rekisteröityy yhden toimipisteen verkkoon, on kyseisessä toimipisteessä, sen laajennuksen kerroksella ja huoneessa.
2. Hot desk -työasema kantaa työaseman oman toimipisteen, kerroksen ja huoneen, ei kirjautuneen henkilön (Hot desking (luku 36)).
3. Puhelin, joka rekisteröityy ulkopuolelle jokaisen toimipisteen verkkoon, on etätyöntekijä. Sen ensimmäisellä hätäpuheluun kykenevällä rekisteröinnillä uudesta paikasta pyydetään vahvistamaan osoitetta puhelimen sivulla; hätäpuhelut siirtävät sitten kyseisen osoitteen.
4. Jos etätyöntekijä ei koskaan vahvistanut, puhelu siirtyy silti, laajennuksen tavallisen toimipisteen kanssa, ja hälytykset ilmoittavat, että osoite ei ollut vahvistettu.

Paikan varoitus

Jos Sähköposti kun joku soittaa 911 on asetettu Asetuksiin, mainituille henkilöille lähetetään soittajan nimi, laajennus, sijainti, kerros ja huone, kun hätäpuhelu alkaa, jotta joku voi vastaanottaa vastaanottajat ovella. Ilmoita -laajennukset saavat viestin puhelimilleen, ja jokainen avoin BitVoice-ruutu näyttää hälytyksen. Katso Hätäpuhelut (luku 11).

Terveys

Terveys kertoo, onko järjestelmä valmis puheluihin, ja jos ei, mitä tehdä. Jokainen rivi kertoo, mikä on vikana yksinkertaisin sanoin ja linkittää sivulle, jossa se korjataan. Tarkista se jokaisen muutoksen jälkeen.

Mitä se tarkistaa

Ongelmat on värjätty: punainen estää puhelut (ei hälytysreittiä), keltainen tulee tarkastaa (puhelin ei ole kytketty), ja harmaa on tietoa varten.

Asetukset

Asetukset sisältää kaiken järjestelmästä kokonaisuutena. Jokainen osio tallennetaan erikseen, ja jokainen tallennus on muutos Muutoksissa (luku 61).

Salasanoja ja avaimia ei koskaan näytetä uudelleen, kun ne on tallennettu; jätä ne tyhjäksi, jos haluat säilyttää ne. Katselijat näkevät Asetukset, joista kaikki salaisuudet on poistettu.

Varmenteen ja Let's Encryptin käyttäminen

BitVoice alkaa itse luomallaan varmenteella, josta selaimet ja puhelimet varoittavat. Julkisesti nimetylle palvelimelle vaihda Let's Encrypt -varmenteeseen: anna nimet (pbx.example.com), valinnaisesti sähköpostiosoite, ja sovellu. BitVoice hakee ilmaisen varmenteen Let's Encryptista, käyttää sitä välittömästi web-käyttöliittymässä, SIP yli TLS:än ja Teamsin kanssa, ja uusii sen noin 30 päivää ennen sen vanhentumista (Let's Encrypt -varmenteet kestävät 90 päivää tai vähemmän). Tilausrivillä näkyy, milloin se on myönnetty, milloin se uusitaan ja, jos se epäonnistuu, miksi; se yrittää uudelleen tunnin kuluttua, sitten harvemmin, Let's Encryptin rajoitusten puitteissa. Tarkista nyt yrittää heti.

Let's Encryptin on pitää pystyä tavoittamaan palvelin jokaisella nimellä internetistä, jotta se voi todistaa, että se on sinun:

• http-01 (oletusvalinta, ellei web-käyttöliittymä ole portissa 443): pyyntö porttiin 80. BitVoice vastaa itse portissa 80 (Linuxissa sille on annettava oikeus avata alhaisia porteja, kuten setcap cap_net_bind_service=+ep bitvoice), tai reitittimen portti 80 voidaan ohjata web-käyttöliittymän porttiin, joka myös vastaa. Muu saapuva liikenne portissa 80 ohjataan HTTPS:lle vain sertifikaatin nimien osalta. Kun BitVoice ei pysty avaamaan porttia 80, Let's Encrypt -ruutu kertoo keltaisella, miksi ja mitä sallii (tarkka setcap-rivi tälle ohjelmalle, tai systemd:n AmbientCapabilities=CAP_NET_BIND_SERVICE; tai toinen ohjelma pitää porttia jo kiinni). Testaa nimet pyytää sitten kunkin nimen testitiedostoa internetistä, kuten Let's Encrypt tekisi, ja kertoo kunkin nimen kohdalla, onko se saavuttanut BitVoice-palvelimen, saavuttanut jonkin muun, tai ei ole DNS:ssä. Jotkut reitittimet eivät tee hairpin NAT:ia (ei lupea omaa julkista osoitetta takaisin sisäverkkoon): siellä testi epäonnistuu sisäverkon sisällä, vaikka Let's Encrypt onnistuu ulkoapäin.
• tls-alpn-01: TLS-yhteys porttiin 443, jota web-käyttöliittymän oma portti vastaa: palvelimelle, jonka web-käyttöliittymä on portissa 443.

Muut ACME-viranomaiset, jotka eivät vaadi tiliin sitoutumista (oman step-ca, Let's Encryptin testauspalvelu), valitaan Authority -kohtaa käyttämällä. Wildcard-nimet vaativat DNS-todisteita, joita BitVoice ei tee: asenna nämä sertifikaatit käsin. Kunkin klusterin palvelin saa oman sertifikaatin.

Näytöt kielelläsi

BitVoicen näytöt ovat saatavilla englanniksi ja kolmetoista muulla kielellä: Deutsch, Français, Español, Italiano, Português, Nederlands, Polski, Svenska, Dansk, Norsk bokmål, Suomi, 日本語 ja 简体中文.

Valinta

Kunkin selaimen kieli on oma: valitse se valikosta (kielen luettelossa teemojen vieressä), kirjautumissivulla tai asennusvelhoen ensimmäisellä sivulla. Ennen kuin valitset, BitVoice käyttää selaimen kieltä, jos se on yksi näistä, muuten englantia. Valinta säilyy vain tässä selaimessa: kaksi henkilöä samalla palvelimella voivat työskennellä kummallakin kielellä.

Kaikki näytöillä oleva teksti on käännetty: valikko, otsikot, painikkeet, vihjeet, palvelimen viestit ja nimet, joita näytön lukijat ilmoittavat. Haku (⌘K) löytää sivun sen nimen perusteella kielelläsi tai englanniksi. Jätetään sellaisenaan: mitä ihmiset kirjoittavat (nimet, numerot, muistiinpanot), osoitteet, koodit, editoreissa olevat skriptit ja tuotteiden ja protokollien nimet. Päivämäärät ja numerot noudattavat selaimen asetuksia.

Käännöksen laatu

Käännökset on tehty koneella (suurella kielimallilla), jokaiselle näytöillä näkyvälle tekstilehdelle, noin 5 000 kappaletta; mikään niistä ei ole tarkistettu ihmisen toimesta. Jotkut lauseet, joita näytöt rakentavat osista (numero ja sana), voivat olla epätyydyttäviä, ja termi voi olla käännetty kahtena eri tavoin kahdessa eri kohdassa. Mitään ilman käännöstä, kuten uusi näyttö, joka on uudempi kuin käännökset, pysyy englanniksi.

Ohje pitää tämän käsikirjan englanniksi, sellaisena kuin se on kirjoitettu, ylänavigaatiopalkin yläreunassa olevalla linkillä kunkin luvun käännökseen (myös koneella käännetyksi) bitvoice.org-sivustolla.

Puhelinpuoli on erillinen: mitä soittajat kuulevat (ohjeistukset, ääniviestin valikko) on oletusäänenkielellä (Äänet (luku 20)), ellei laajennus tai jonotusjonossa ole omaa kieltä.

Puheluvirta

Tarkista jokainen tilanne

Tarkista jokainen tilanne, Puheluvirran (luku 16) yläosassa, kokee koko puhelusuunnitelman jokaisessa tilanteessa, jossa se voi olla, ei otos:

• jokainen yhdistelmä auki ja kiinni, jonka aikataulut todella saavuttavat tulevan vuoden aikana (jokainen juhlapäivä mukaan lukien), löydetty 15 minuutin askelissa;
• jokainen yhdistelmä päivä/yö -vaihtoehtoja (tai, jos yli kuusi, kunkin vaihdettuna yksin);
• jokainen saapuva reitti ja jokainen näppäin, jonka soittaja voi painaa jokaisessa valikossa, jokaisessa "jos kukaan ei vastaa" ja jokaisessa jonotusajassa matkan varrella;
• jokainen laajennus soittaa jokaisen hätänumeron.

It lists what it finds, the worst first: a call goes nowhere (a group with nobody to ring and nowhere to go next), a loop, works, but look at it (a queue with no agents), nothing routes to it (a menu or schedule no call reaches), a branch no situation takes (a schedule that is never closed, so its closed side is never used), and emergency calls rest on one trunk (if it fails, they cannot get out). Each finding names the situations that show it: the time and which schedules were open, the toggles switched over, and the path (a call to +12125550100 → Press 2 (Billing) → No answer). Try this call fills Try a call below with that exact situation and traces it.

Sama tarkistus suoritetaan muutoksilla ennen kuin ne tehdään: ehdotus Kysy yksinkertaisilla sanoilla - ja Palauta tämä -katse vanhaan revision näyttää, mitä muutos rikkoisi, mitä toimii tänään.

Kokeile puhelua

Syötä, kuka soittaa (laajennus tai ulkoinen numero), mitä he valitsevat ja koska, ja paina Kokeile. BitVoice seuraa puhelua täsmälleen samalla tavalla kuin se olisi oikea puhelu, ilman soittamista: saapuvan reitin, aikataulut kyseisellä ajalla, reititysskriptit (ne suoritetaan niiden omassa sandbox- ympäristössä), valikot, ryhmät ja jonot, ja mitä tapahtuu, jos kukaan ei vastaa. Puhelun polku on merkitty; muut tiet (valikon näppäimet, aikataulun toinen puoli) voidaan avata. Vihreä tarkoittaa, että se toimii, keltainen tarkoittaa, että sitä tulee tarkastella (puhelimen ei ole kytketty, skripti epäonnistuu), punainen tarkoittaa, että puhelu epäonnistuu siinä. Valitse Oletetaan, että jokainen puhelin on kytketty nähdäksesi suunnitelman suunnitellussa muodossa sen sijaan, että se on nykyinen; Saapuu valitsee reitin, joka ottaa vain yhden.

Kaavio

Kaavio näyttää, minne ulkopuolelta tulevat puhelut menevät, laatikko laatikolta: jokainen saapuvan reitti, sitten valikot, ryhmät, jonot, aikataulut, skriptit ja henkilöt, joille ne johtavat.

Klikkaa laatikkoa (tai siirry siihen Tab-näppäimellä ja paina Enter) muuttaaksesi, minne puhelut menevät siitä: reitin kohde, laajennuksen tai ryhmän Jos kukaan ei vastaa, aikataulun avoimet ja suljetut kohteet, valikon näppäimet (lisää tai poista näppäimiä siellä), skriptin fallback tai vastaanottajan henkilö. Tallentaminen tarkistaa muutoksen kuten muutkin ja luo revision. Avaa täysi muokkain siirtyy kohteen omalle sivulle. Lisää saapuva reitti lisää reitin ilman poistumista kaaviosta.

Soittoyhmät

Soittoyhmä on yksi numero, joka soittaa useita laajennuksia: myyntitiimi, eteenpäin ja sen varalle, jokainen työpajassa.

Soittorajat

• Kaikki kerran: jokaisen jäsenen puhelimet soittavat yhtä aikaa, ja ensimmäinen, joka vastaa, ottaa puhelun. Muut lopettavat soiden.
• Toinen toisensa jälkeen: kunkin jäsenen puhelin soi ryhmän soittoaika, listatun järjestyksessä. Siirrä jäseniä nuolien avulla tai Alt+↑ ja Alt+↓.

Jäsenet, jotka ovat poissa (kokouksessa kalenterissaan tai äänetön tilassa), hypätään yli; ryhmä soittaa muille. Jäsenet, joilla on mobiili sovellus, herätetään push-ilmoituksella ja soitetaan myös.

Jos kukaan ei vastaa

Kun kukaan ei vastaa soittoajan kuluessa, puhelu menee Jos kukaan ei vastaa: jäsenen vastaajaan, jonoon, valikkoon, toiseen ryhmään. Ilman asetusta se soi, kunnes soittaja antaa periksi.

Ryhmät, jonot tai poiminta?

Jonot

Jono pitää soittajia järjestyksessä, musiikin kanssa, ja soittaa seuraavaa vapaata agenttia. Se on asiakaspalvelukeskuksen sydän, ja se on hyödyllinen missä tahansa toimistossa, jossa puhelut tulevat nopeammin kuin ihmiset voivat ottaa niitä vastaan.

Kuinka puhelut tarjotaan

• Järjestys: agenttien luettelo on järjestyksessä; siirrä heitä ylös ja alas. Järjestyksessä ja kiertäen seuraavat sen.
• Rangaistukset luokittelevat agenteja (0-100, 0 tyhjä): puhelut tarjotaan vapaille agenteille, joilla on alin rangaistus, ja agentti, jolla on korkeampi rangaistus, soitetaan vain, kun kukaan alemman rangaistuksen omaava agentti ei ole vapaana. Käytä niitä ensisijaiselle ja täyteen linjalle samassa jonossa.
• Paino luokittelee jonot, jotka jakavat agenteja: kun jonossa, jolla on korkeampi paino, on jonossa odottavia, sen agentit ottaa ensin sen soittajat.
• Päätösaika antaa agentille aikaa puhelun jälkeen ennen seuraavaa.
• Pitkä odotus: odottajat, jotka odottavat kauemmin, menevät jonon aikakatkaisuun. 0 odottaa ikuisesti.
• Taustamusiikki: soittajat kuulevat jonon musiikin (mikä tahansa luokka Äänet (luku 20) -sivulta), järjestelmän musiikin tai jonon äänen.
• Ilmoita odottaville soittajille heidän paikkansa jonossa ja odotusajan (vastattujen soittajien keskimääräinen odotusaika tänään minuutteina), joka tahansa usein, jonon kielellä. Sanontaa tulee jonon ohjeista Äänet (luku 20) -sivulta; kunnes ne on tallennettu, mitään ei sanota.

Näytössä Jonot on live-seinä: kuka odottaa, kuinka kauan, ja kunkin edustajan tila.

Edustajat

Edustajat valitsevat *45 kirjautuakseen kaikkiin jonoihin tai *46 tauolle ja jatkamaan; tauolla olevat ja kirjautuneet edustajat eivät saa puheluita. Seinällä on samat napit, ja se näyttää, miksi edustaja taukosilla.

Valvojat

Livetapahtumissa (luku 46), Valvo soittaa valvojan puhelimeen; kun he vastaavat, he kuuntelevat (kukaan ei kuule), kuiskivat (vain asiakaspalvelija kuulee) tai ryhmittävät (molemmat kuulevat), ja he voivat vaihdella näiden välillä puhelun aikana.

Liimautuvat jonot ja VIP:t

Käytä Liimautuvaa jonossa ja palauttava soittaja (joka on vastaanotettu viimeksi 30 päivänä, tai niin monta kuin olet asettanut) tarjotaan ensin edustajalle, joka vastaanotti heidät viimeksi, jos se edustaja on vapaa; jos he eivät vastaa, jono jatkuu normaalisti. VIP-soittajat, jonon alaosassa, menevät jonon eteen, jonka he soittavat, jonka jälkeen VIP, joka odottaa, ja ne on merkitty VIP:ksi näytöllä.

Ulossoittaja

Ulossoittaja (luku 19) soittaa yhteydenottoja jonon (luku 18) asiamiesten luetteloille: uusimiset, tapaamisen muistutukset, keräämiset, kyselyt. Kussakin kampanjassa on oma jono, oma luettelo ja oma tapa soittaa:

1. Lisää kampanja: sen jono, soittajan tunniste (numero, jonka kontaktit näkevät), soittopäivät aikavyöhykkeessä, kuinka kauan kontaktin puhelin soi, montako kertaa ja kuinka pitkän välin päästä.
2. Avaa Yhteystiedot ja Lisää luettelo: CSV-tiedosto, jossa on otsarivi ja sarake nimeltä number (tai phone); name ja muut sarakkeet näytetään esikatselussa agentille. Monistetut ja vialliset numerot ohitetaan.
3. Talleta viesti (kampanjassa): kuka soittaa ja miksi, ja "paina 9, jos et halua näitä puheluita". Se toistetaan, kun henkilö vastaa ja ei ole vapaa agentti, ja valinnaisesti vastaajan jälkeen.
4. Käynnistä se. Se soittaa vain sen aikana, ja lopettaa soittamisen, kun se on keskeytetty tai ei ole mitään tehtävissä.

Ihmiset ja koneet. BitVoice kuuntelee ensimmäiset sekunnit vastauksen jälkeen: pitkä, keskeytymätön tervehdys on vastaaja; lyhyt "haloo?" ja tauko on ihminen. Konetta voidaan lopettaa (ja yrittää uudelleen), jättää viesti tai siirtää edelleen agentille kuten kuka tahansa. Epävarmuuden sattuessa se ottaa vastauksen ihmiseksi.

Hylätyt puhelut. Henkilö, joka vastaa, kun ei ole vapaa agentti kahdessa sekunnissa, kuulee viestin ja luetaan hylätyksi. Voimalla ja ennustavalla näppäilyllä, jos hylättyjen puheluiden osuus viime sadasta vastauksesta ylittää kampanjan rajan (3%, ellet muuta sitä, Yhdysvaltain sääntö), kampanja soittaa yhden puhelun jokaista vapaa agenttia kohden, kunnes se on jälleen alle. Kampanja näyttää hylkäysprosenttinsa, soittavat puhelut ja vapaat agentit livenä.

Älä-soita-luettelot. Mikään kampanja ei soita numeroa älä-soita-luettelossa, mikä tahansa luettelo siitä tuli; kuka tahansa, joka painaa 9 viestin aikana, lisätään heti. Lisää numeroita käsin tai API:n kautta (POST /api/dnc). Kansallisen rekisterin (Yhdysvalloissa FTC:n National Do Not Call Registry: lataa aluekoodit, joita soitat, tasaisena tiedostona), valitse tiedosto Kansallinen rekisteri ja Tuo: jokainen rivi, jossa on numero, lasketaan (212,5550100 kuten FTC kirjoittaa ne, tai yksi numero rivi), otsikot ja rikkinäiset rivit ohitetaan ja lasketaan. Korvaa edellinen tuonti käytössä, edellisen latauksen numerot poistetaan ensin, joten numero, joka poistui rekisteristä, on soittaa uudelleen; numerot, jotka on lisätty käsin tai painamalla 9, pysyvät aina. Rekisteriä on päivitettävä vähintään joka 31 päivänä (Yhdysvaltain säännöt); sivu laskee luettelon ja sen, kuinka paljon siitä tuli rekisteristä. API on POST /api/dnc/import?replace=1 tiedostolla ruumiina.

Äänet: ääniklipit, kielet ja musiikki

Äänet (luku 20) sisältää kaiken, mitä BitVoice sanoo tai toistaa soittajille, poislukien tervehdykset ja valikkokutsut, jotka tallennetaan siellä, missä niitä käytetään.

Ääniklipit, jokaisessa kielellä

Ääniklippi on yksi asia, jonka BitVoice sanoo: "Anna PIN-koodi", "Paikkasi jonossa on", numerot, jotka se lukee ääneen. Nimi-hakemisto, sisäänsoittaminen (DISA), herätyskutsut ja jonon ilmoitukset puhuvat niiden kanssa. BitVoice sisältää jokaisen ääniklipin sanat englanniksi, espanjaksi, ranskaksi, saksaksi, italiaksi, portugaliksi, hollanniksi ja puolaksi; numerot luetaan yksitellen, mikä kuulostaa samalta jokaisessa kielellä.

• Soittajat kuulevat asettaa kielen kaikille. Jono, sisäänsoittaminen, hakemisto tai laajennus voi valita toisen.
• Jokainen ääniklippi voidaan tallentaa selaimessa, ladata (mikä tahansa äänitiedosto; se muunnetaan puhelimen ääneksi) tai tehdä puhetilapalvelulla: puhetilamallin asetuksilla, yksi nappi tekee jokaisen kielen ääniklipin sanasta. Tallennetut ääniklipit säilytetään, ellei pyydä korvaamaan niitä.
• Lisää kieli mille tahansa muulle kielelle (koodi, kuten sv, ja tai pt-BR); sen ääniklipit tallennetaan tai ladataan, englanninkieliset sanat näytetään ohjeena.
• Ääniklippi, joka puuttuu kielestä, toistetaan oletuskielenä, sitten englanniksi; ilman tallennettuja ääniklippejä, soittajat kuulevat lyhyen sävelen, jotta jokainen ominaisuus toimii ennen kuin yksikin ääniklippi on tallennettu.

Taustamusiikki

Taustamusiikki on ryhmitelty luokkiin (Rauhallinen, Jazz, Myyntitarjoukset…), joista kunkin luokan kappaleet toistetaan toistensa jälkeen, joko alusta tai sekoitettuna. Voit ladata kappaleita, joita kestää enintään 15 minuuttia, millä tahansa formaatilla, jonka selain osaa lukea; MP3- ja WAV-tiedostot voidaan myös lähettää suoraan API:lle (PUT /api/music/{class}/{name}), ja BitVoice dekoodaa MP3-tiedostot itse (MPEG-1, 2 ja 2.5 Layer III, joka antaa samat näytteet kuin minimp3).

Internet-radiotoisto. Luokka voi toistaa virran sijaan omia kappaleitaan: kirjoita MP3-virran osoite (Icecast, Shoutcast, useimmat internet-radiot) Internet-radiotoiston alle. BitVoice yhdistää, kun ensimmäinen soittaja asetetaan odottamaan kyseisessä luokassa, toistaa saman virran kaikille odottaville ja katkaisee yhteyden puoli minuuttia viimeisen lähdön jälkeen. Virran ollessa esteettä, luokan omat kappaleet toistetaan (tai odotusääni ilman kappaleita), ja luokka näyttää syyn.

Jokaisen oletus voi olla odotusääni, jolloin mitään ei muutu, kunnes valitset musiikin. Valitseminen odotusääni jonossa tai puhelimessa pitää äänen siellä.

Valikot (ääniavustaja)

Valikko (ääniavustaja) vastaa, toistaa äänipromptin ja ohjaa soittajan, mihin hän painaa: 1 myyntiin, 2 tukiin, 0 vastaanottoon.

Setting up a menu

1. On Menus (luku 21) press Add menu and give it a name (and a number, if staff should be able to dial it).
2. Add options: a key, a label, and where the key goes.
3. Record the prompt in the browser, or upload a recording in any format (it is converted to telephone sound). Say every option: "For sales press 1, for support press 2."
4. Choose what happens when the caller presses nothing: the timeout destination, after the prompt has played the number of repeats you set.
5. Point an incoming route (or a schedule) at the menu.

Valinnat

• Soittajat voivat näppäillä laajennuksen: soittajat, jotka tietävät numeron, voivat syöttää sen äänipromptin aikana.
• Odotetaan näppäintä: sekunteja äänipromptin jälkeen, ennen kuin se toistuu.
• Näppäin voi johtaa toiseen valikkoon, toiselle tasolle ("laskutusasioissa paina 1").

Äänet muilla äänillä

Kun tekoäly on käytössä (Asetukset), äänipromptti voidaan kirjoittaa tekstinä ja lukea tekoälyäänellä sen sijaan, että se tallennetaan.

Nimihakemisto

Nimihakemisto (luku 22) sallii soittajien tavoittaa jonkun ilman hänen numeronsa: he kirjoittavat ensimmäiset kirjaimet nimeä näppäimistöllä (2 ABC:lle, 3 DEF:lle, jne. 9 WXYZ:lle) ja ohjataan läpi.

1. Lisää hakemisto, anna sille nimi ja anna sille numero (411, esim.) tai jätä numero tyhjäksi ja käytä sitä valikkovaihtoehtona.
2. Valitse, mitä soittajat kirjoittavat: sukunimi (yleensä), etunimi tai molemmat.
3. Valitse, kuka on lueteltu, tai ei kukaan, jolloin kaikki puhelimella varustetut henkilöt luetellaan.

Soittajat kuulevat "Anna henkilön nimen ensimmäiset kolme kirjainta". Yksi vastaavuus ohjataan välittömästi. Useita vastaavuuksia luetaan, kahdeksan kerrallaan: kunkin henkilön nimi, sitten "soita tähän henkilöön, paina 1", 2 jne., 9 enemmän nimiä. Ei vastaavuutta: "Kukaan ei vastaa", ja he yrittävät uudelleen (kolme yrittmistä).

Äänitetty nimi: äänitä kunkin henkilön nimi heidän puhelimellaan (Äänitetty nimi: äänitä selaimessa tai lataa tiedosto), ja hakemisto sanoo sen; kunnes silloin se lukee puhelinnumeron. Hakemiston omat sanat tulevat Äänet (luku 20) -hakemistosta, sen kielellä.

Sisäänsoitto (DISA)

Sisäänsoitto (luku 23) (DISA, "suora sisäänmenoyhteys") sallii jonkun soittaa sisään ulkoa, todistaa kuka he ovat, ja soittaa ulos uudelleen toimiston kautta: puhelu menee ulos toimiston soittajan numerolla, sen reiteillä ja sen hinnoilla, niin kuin he olisivat pöytänsä ääressä.

1. Lisää sisäänsoitto, ja aseta PIN (4-10 numeroa), sallitut numerot, joista käsin sitä voidaan käyttää (Vain näistä numeroista), tai molemmat. Yksi näistä kahdesta on vaadittu.
2. Valitse puhelin, jolta puhelut tehdään: sen ulospuhelulupa, soittajan numero ja ulosmenoreitit ovat voimassa. Se on oltava sallittu ulospuheluihin.
3. Anna sille numero, jota soitetaan sisällä, ja lähetä puhelinnumero sille Puhelureititys (luku 8) -sivulla (valitse sisäänsoitto kohde).

Soittajat kuulevat "Anna PIN-koodisi, sitten paina risuaita", sitten "Anna numero, jota soitat, sitten paina risuaita", ja heidät ohjataan läpi. Sanottavat sanat tulevat sisäänsoiton ohjeista Äänet (luku 20) -hakemistosta.

Äänibotit (AudioSocket)

Äänirobotti (voice bot) (luku 24) on omatekojainen ohjelma (AI-välikappale, puheentunnistin-IVR, nauhoittaja), joka vastaanottaa puheluita AudioSocket:n kautta, Asteriskin käyttämän yksinkertaisen protokollan. BitVoice vastaanottaa puhelun, avaa TCP-yhteyden robottiin ja lähettää puhelun UUID:n, sitten soittajan äänen 20 ms kestoisina kehyksinä 8 kHz 16-bittisenä lineaarisena äänenä ja jokaisen painetun näppäimen; mikä tahansa ääni, jonka robotti lähettää takaisin, toistetaan soittajalle. Asteriskin AudioSocketille kirjoitetut robotit ja puhepalvelun liitännäiset toimivat BitVoicen kanssa muuttumattomina.

1. Lisää äänibotti: sen nimi, botin osoite (10.0.0.9:9092) ja valinnaisesti numero, jota soitetaan siihen.
2. Valitse, mihin soittaja menee jos botti ei voi ottaa puhelua tai katkaista (ihminen, jonka luokka, vastaa): vaadittu, jotta kukaan soittaja ei koskaan jää pois, koska botti on alhaalla.
3. Lähetä puhelut siihen Puhelureititys (luku 8) -vaihtoehdon, valikon vaihtoehdon, aikataulun tai vipuvaihtoehdon kautta.

Kun botti lähettää AudioSocketin lopettamisen, puhelu päättyy; kun soittaja lopettaa, botti saa yhden. Botti, jota ei voida tavoittaa kolmessa sekunnissa tai jonka yhteys katkeaa ilman lopettamista, antaa soittajan vaihtoehdon, ja epäonnistuminen kirjataan.

Tuo ohjelma mukaan puheluun, joka on jo meneillään (kuunteleva transkriboija, avustaja, joka kuiskaa kenellekään), käytä ARI:n ulkoista mediaa: katso Asterisk-yhteensopivuus (luku 70).

Päivä/yö-viput

Päivä/yö-vaihtoehto (day/night toggle (luku 25)) on kytkin soittoliikenteen hallintaan (FreePBX kutsuu tätä soittoliikenteen hallinnaksi). Sille ohjatut puhelut menevät sen normaaliin kohteeseen tai toiseen, kun joku on kytkinyt sen ylitys: toimisto sulkeutuu aikaisin myrskyn takia, joku soittaa *281 poistuessaan, ja puhelut menevät vastaajaan, kunnes se kytketään takaisin aamulla. Se säilyy sellaisena, kuin se on jätetty, jopa käynnistyksen yli.

1. Lisää vipu, anna sille koodi (1-3 numeroa: soitetaan *28 jälkeen) ja valitse, mihin puhelut menevät normaalisti ja kun ne vaihdetaan yli. Kumpi tahansa puoli voi olla aikataulu, joten vipu voi istua aukioloaikojen edessä ja ohittaa ne.
2. Valitse, kuka voi vaihtaa sitä puhelimesta (kukaan valittu sallii minkä tahansa laajennuksen).
3. Lähetä puhelut siihen Puhelureititys (luku 8) -vaihtoehdon, valikon vaihtoehdon tai aikataulun kautta, kuten mihin tahansa muuhun määränpäähän.

Vaihda se soittamalla *28 ja sen koodi (nouseva sävel: vaihdettu yli; laskeva sävel: takaisin normaaliin), sen vieressä oleva vipu Viput-sivulla tai API:n kautta (POST /api/toggles/{id}/state). Busy-lamp-näppäin, joka valvoo *281:aa, on syttynyt, kun tuo vipu on vaihdettu yli, joten se, joka sulkee toimiston, voi nähdä sen työpöydältään. Itse vipukoodi on Toimintokoodit (luku 32) -sivulla.

Aikataulut

Aikataulu ohjaa puhelut toiseen reittiin, kun olet auki, ja toiseen, kun olet suljettu. Osoita saapuva reitti aikatauluun, ja aikataulu valikkoon (avoin) ja vastaajaan (suljettu).

Aukioloajat

Jokainen aikataulun rivi on joukko päiviä ja aika alkaen ja loppuen. Useita rivejä on sallittu: maanantai-perjantai 9:00-17:00 ja lauantai 10:00-13:00. Aukioloajat voivat ylittää keskiyön (22:00-06:00) yövuoroon.

Pyhäpäivät

Pyhäpäivät lasketaan suljettuina koko päivänä, riippumatta aukioloajoista. Lisää kunkin päivämäärän nimi; nimi näytetään Puheluvirran (luku 16) -sivulla, kun yrität puhelua kyseisenä päivänä.

Aikavyöhyke

Aikavyöhyke on Asetuksissa määritetty. Kun kellot muuttuvat, aikataulut seuraavat paikallista aikaa.

Skriptit (JavaScript ja Lua)

Skripti päättää, mihin puhelu menee, kun valikot, aikataulut ja ryhmät eivät riitä: soittajat tietyltä alueelta tietylle toimistolle, tärkeät numerot suoraan henkilölle, päätös tehdään omista tietojen perusteella. Tai, asetettuna Suorittaa koko puhelu, se vastaa puheluun ja suorittaa sen, kuten Asteriskin dialplan tai AGI-skripti: äänet, puhe, näppäimet, tallenteet, soittaminen, siirtäminen (alla). Skriptit kirjoitetaan JavaScriptillä tai Lualla Skriptit (luku 27)-sivulla.

Turvallinen suunnittelulla

• Reititysskripti suoritetaan enintään 200 ms. Jos se epäonnistuu tai kestää liian kauan, puhelu menee skriptin varajärjestelmään, joten virhe ei koskaan hävitä puhelua. (Puheluskripteillä on omat rajoituksensa alla.)
• Se suoritetaan hiekkalaatikossa: se ei pääse verkkoon tai levyyn. Reititysskripti valitsee vain; puheluskripti voi tehdä vain alla luetellut vaiheet, omalle puhelulleen.
• Hätäpuhelut eivät koskaan suorita skriptejä.

Mitä skripti näkee

call sisältää:

What it returns

A destination, {type, target}: type is extension, ringgroup, queue, menu, schedule, voicemail or hangup, and target is its number. Returning nothing uses the fallback. log("text") writes to the script's run list.

JavaScript

if (call.from.startsWith("212")) {
  log("New York caller")
  return { type: "ringgroup", target: "600" }
}
if (call.weekday === 0 || call.weekday === 6) return { type: "voicemail", target: "100" }

Lua

if string.sub(call.from, 1, 3) == "212" then
  log("New York caller")
  return { type = "ringgroup", target = "600" }
end
if call.weekday == 0 or call.weekday == 6 then
  return { type = "voicemail", target = "100" }
end

Skriptin käyttäminen

Osoita saapuva reitti, valikkonäppäin tai aikataulu skriptiin, kuten mihin tahansa kohteeseen. Testi suorittaa sen soittopyynnöllä, jota kuvaat, ilman soiton tekoa; suoritusluettelo näyttää jokaisen todellisen suorituksen päätöksen, käytetyn ajan ja mahdollisen virheen. Soittoyhteys (luku 16) suorittaa skriptejä myös, kun yrität soittaa.

Skriptit, jotka suorittavat koko soiton

Valitse Suorittaa koko soiton. Skripti vastaa sitten soittoon ja suorittaa jokaisen vaiheen ylhäältä alaspäin, odottaen, kunnes se on valmis:

Kohde on numero (laajennus, ringiryhmä tai jono täällä, muuten ulkoinen numero ulosmenoteiden kautta; ei koskaan hätänumero) tai {type, target} edellä. Näppäin, jota painetaan äänen aikana, lopettaa sen; play ja say palauttavat sen ja seuraava collect alkaa siitä. Palauttaminen lähettää soiton sinne.

const k = collect({ max: 1, timeout: 5, say: "Press 1 for sales, 2 for support." })
if (k === "1") return { type: "ringgroup", target: "600" }
if (k === "2") {
  if (dial("101", 20)) return
  say("Nobody is free. Leave a message after the tone.")
  record({ box: "101" })
  hangup()
}

Lualla on samat vaiheet (collect{max = 1}). Anna skriptille Numero, jolla se voidaan soittaa, jotta se voidaan soittaa laajennuksesta.

Rajoitukset pitävät soiton turvallisena: skriptin oma koodi saa suorittaa enintään neljännes sekuntia kahden vaiheen välillä; soitto saa kestää enintään 1 000 vaihetta; ja koko skripti loppuu Pisin suoritus (10 minuuttia, ellet sano toisin, 60 enintään). Kun se epäonnistuu, se pysäytetään tai loppuu ilman, että soitto lopetetaan tai siirretään, soitto menee sen Oletusarvoon; soittaja, joka lopettaa soiton, lopettaa sen välittömästi. Kokeile suorittaa skriptin näppäimillä, jotka sanot soittajan painavan, ja listaa jokaisen vaiheen ilman soiton tekoa.

Älykkään vastaanottajan, ääniviestien ja kysymisen luokittelu

AI-ominaisuudet käyttävät AI-palvelua, joka on asetettu Asetukset (luku 14) -valikossa: OpenAI-yhteensopiva palvelu (OpenRouter oletuksena) tai yksi, jonka itse ajat. Mitä niille tarvitaan, lähetetään sinne, joten valitse palvelu, johon luotatte puheluiden kanssa; 911-keskukselle sen oma hallituksen pilvi lasketaan paikalliseksi.

Älypuhelin vastaanottaja

Valitse vastaanottaja, johon puhelut menevät: reitti, valikkovaihtoehto tai laajennuksen Jos kukaan ei vastaa. Se sanoo, että se on automaattinen, vastaa vain Hyväksytystä tiedosta ja ottaa viestin, varaa palautepuhelun (ks. Palautepuhelut (luku 30)) tai siirtää Ihminen on. Painamalla 0 tai pyytämällä ihmistä aina tavoittaa jonkun, ja sama koskee AI-palvelun tai puhemallin ongelmaa: soittajat eivät koskaan jää kiinni siinä.

Mallit

Malli tekee tekstityön: yhteenvedot, vastaanottajan vastaukset ja kysymiset yksinkertaisilla sanoilla. Puheen muuttaminen tekstiksi vaatii mallin, joka ottaa äänen; aseta se Puhe-teksti-mallina (esim. google/gemini-2.5-flash OpenRouterilla) käyttääksesi tekstiä vain mallia, kuten meta-llama/llama-3.3-70b-instruct.

Speech to text in the building

Speech can be written down without any language model: a speech recogniser (whisper) hears the audio and writes what was said, nothing more. Who writes speech down, in the AI settings, has three choices:

• The model above: the audio goes to the AI service, whose model must take audio.
• This server: BitVoice runs whisper itself. Choose a Whisper model and save: BitVoice fetches it once from the whisper.cpp project (base is 60 MB; small, medium and large-v3-turbo are more accurate and slower; all understand about 100 languages), checks it against its published SHA-256, and starts whisper.cpp's whisper-server on 127.0.0.1 beside it, restarting it if it stops. Callers' audio never leaves the computer and nothing is paid per call. whisper-server (MIT licence) comes in BitVoice's downloads next to the program, and the installers put it beside BitVoice; BitVoice also finds one installed on its own (brew install whisper.cpp). The settings show where it stands (fetching the model, starting, running, or why it is not), and so does Health (luku 13). While it is not running, transcripts fail and say why: they are never sent anywhere else instead.
• A speech-to-text service: whisper.cpp's whisper-server on another computer in the building (http://192.168.1.20:8178/inference), for one machine with a GPU serving several BitVoice servers, or any OpenAI-compatible …/audio/transcriptions (with Its model, such as whisper-1, and Its key). Plain http is accepted only to this computer or a private network address; anything else must be https. To run one: whisper-server -m ggml-base-q5_1.bin --host 0.0.0.0 --port 8178 -l auto.

Whichever writes it down, every transcript goes there: voicemail, recorded calls, live 911 calls and receptionists hearing callers. Without the model, the Model may be left empty: transcripts are written, summaries are written from the facts the call said (below), and what needs a language model (action items, voicemail triage, call insight, receptionists' replies, asking in plain words) is left out. Notes a recogniser makes about what it heard, such as [BLANK_AUDIO] or (silence), are dropped, so a quiet stretch never reads as though something was said.

Tosiasioiden puhelu (ei kielimallia)

Jokainen käännös luetaan myös säännöillä, ilman kielimallia, tosiasioiden puolesta, mitä puhelunottaja huomioi: mitä tapahtui, missä, kuinka moni on loukkaantunut (tai että kukaan ei ole), olosuhteet (hengitys, hereillä, verenvuoto...), vaarat (tuli, savu, kaasu, aseet, kemikaalit, polttoaine), ajoneuvot, kuka soittaja on henkilölle, joka tarvitsee apua, ja paluuosoite. Jokainen tosiasia näytetään lauseen kanssa, josta se tuli, ja puolen, joka sanoi sen, käännöksen Tosiasioiden puhelu. Ilman mallia yhteenvedon kirjoittaminen perustuu näihin tosiasioihin yksin, ja sanoo sen.

• Mitään ei lisätä, mitä kukaan ei ole sanonut. "Kukaan ei ole loukkaantunut" on tosiasia itsessään; soittajan välittäessä jonkun toisen sanomisia ("hän sanoo, ettei hän hengitä") on merkitty ilmoitettu; "24 Pine Lane. Ei, anteeksi, 42" pitää 42; paljas "ei" vastaa edellä kysyttyä kysymystä.
• Se on uskollinen, ei täydellinen: se ei tiedä sanoja, joita se ei tunne. Kolmella keksityllä 911 puhelulla (ei oikean soittajan sanoja) se löytää:

Sinetöity pisteytys on se, mitä voidaan odottaa puheluista, joita se ei ole nähnyt, ja kolme joukkoa kirjoitettiin samojen ihmisten toimesta kuin säännöt, joten todelliset puhelut todennäköisesti tekevät huonommin. Lue tosiasioiden vieressä käännöstä, älä sen sijaan.

Suuremmat mallit tarvitsevat enemmän prosessoria: palvelin, joka kirjoittaa useita puheluita kerran, tulisi aloittaa base:lla tai käyttää yhtä konetta GPU:na puheen-teksti-palveluna rakennukselle. Apple-tietokoneissa whisper käyttää GPU:ta.

Vastaajan triage

Käännä ja yhteenvedä vastaaja käytössä, jokainen viesti on myös merkitty kiireelliseksi, normaaliksi tai matalaksi prioriteetiksi, sen tyypin mukaan (myynti, tuki, laskutus...). Kiireelliset viestit nostavat hälytyksen jokaisen ylläpitäjän näytöllä.

Kysy yksinkertaisilla sanoilla

Muutoksissa (luku 61) kuvaa muutosta ("lähetä myyntipuhelut vastapuheluun kello 17 jälkeen"). AI ehdottaa sitä, BitVoice tarkistaa sen kuten minkä tahansa muun muutoksen ja näyttää tarkalleen, mitä muuttuisi. Mitään ei muuteta, kunnes painat Tallenna, ja se tulee revisiona, jonka voit palauttaa. Salasanoja ei koskaan lähetetä AI:lle.

Viestilaatikko

Jokaisella laajennuksella voi olla postilaatikko. Soittajat, joita ei vastata, kuulevat sen tervehdyksen ja jättävät viestin; henkilö kuulee sen puhelimessaan, lukee sen näytöltä tai saa sen sähköpostiin.

Sen käyttäminen

Laajennuksessa käytä Viestilaatikkoa. Jos kukaan ei vastaa asetetaan sitten postilaatikkoon. Anna sille PIN (4-10 numeroa): se avaa postilaatikon toisesta puhelimesta ja kirjaa henkilön sisään henkilökunnan portaalissa ja kuumaan pöytään.

Kuunteleminen

• Laajennuksen omasta puhelimesta, soita *97: viestit toistetaan uusimman ensin; näppäimet toistavat, poistavat tai pitävät jokaisen.
• Mistä tahansa muusta puhelimesta, soita *97, syötä postilaatikon numero ja sen PIN.
• Viestilaatikko (luku 29) (järjestelmänvalvojat) tai henkilökunnan portaalissa (henkilö): toista, merkitse kuulluksi, poista.
• Puhelimen viestivalo on päällä, kun on uusia viestejä.

Älykkäiden laitteiden kanssa

Älykkäiden laitteiden kanssa Transkriboi ja tiivistä viestit (Asetukset, AI), jokainen viesti kirjoitetaan, tiivistetään yhteen riviin ja merkitty kiireelliseksi, normaaliksi tai matalaksi prioriteetiksi sen tyypin mukaan (myynti, tuki, laskutus). Kiireelliset viestit nostavat hälytyksen jokaisen järjestelmänvalvojan näytöllä. Katso AI (luku 28).

Äänen puhdistus

Äänen puhdistus (Asetukset) poistaa tasaisen taustamelinan ja tasoittaa tasot, kun viestit tallennetaan, jotta viesti autosta tai kiireiseltä kadulta on helpompi kuulla.

Puheluiden palautus

Ihmiset, jotka ovat pyytäneet puhelun palautusta. Tekoälyvastaanottaja varaa yhden, kun soittaja pyytää: se kerää heidän nimensä, puhelinnumeron (tarjoten numeron, josta he soittavat), hyvän ajan ja mitä se on, lukee ne heille ja varaa sen vasta, kun soittaja hyväksyy. Se ei koskaan luvaa tarkkaa aikaa. Ylläpitäjät voivat myös lisätä puheluiden palautuksia käsin.

Uusi puhelun palautus näyttää ilmoituksen jokaisella avoimella näytöllä ja lähetetään sähköpostitse receptionistin Vastaanota viestit -postilaatikon omistajalle, kun laajennus on sähköpostiosoite ja sähköposti on määritetty asetuksissa.

Soittaa takaisin, valitse laajennuksesi ja paina Soita takaisin: puhelimesi soi ensin, ja kun vastaat, BitVoice soittaa numeron puolestasi normaaleilla reiteillä ja soittajan tunnistuksella. Lisää huomautus, jos haluat, ja paina Valmis (tai Peruuta). Valmiit puheluiden palautukset säilytetään avoimien alla ja voidaan avata uudelleen.

Puhelulinkit ja verkkopuhelut

Puhelulinkki on verkkosoite, joka soittaa yrityksesi mistä tahansa selaimesta: ei puhelinnumeroa, ei sovellusta. Laita se sähköpostin allekirjoitukseen, tulosta sen QR-koodi lentolehtiseen tai myymälän ikkunaan, tai liitä verkkonappi sivustolle.

Puheluliitoksissa Puheluliitokset (luku 31) lisätään linkki, valitaan mihin puhelut menevät (laajennus, ryhmä, jono, valikko, tekoälyvirkailija, aikataulu tai vastaaja), ja tallennetaan: sivu näyttää osoitteen ja QR-koodin. Puhuja näkee otsikko- ja valitsemasi sanat, antaa nimensä, jos sitä pyydät, sallii mikrofonin ja painaa Soita nyt; näppäimistö toimii valikoissa. Vastaaja näkee Web: ja puhujan nimen.

Kytke Avoin pois, jotta linja sulkeutuu (sivu kertoo siitä). Samanaikaiset puhelut rajoittaa, kuinka monta ihmistä voi soittaa yhden linkin kautta (5, ellei ole asetettu). Osoite sisältää pitkän satunnaisen osan, joten sitä ei voida arvata; toistuvat väärät osoitteet estetään, kuten epäonnistuneet kirjautumiset. Soittajien mikrofonit tarvitsevat sivun, joka on palveltu HTTPS: n kautta, joten jaa HTTPS-osoite.

Ominaisuuskoodit, eteenpäinohjaus ja nopeusnäppäimet

Ominaisuuskoodit ovat ne, mitä ihmiset valitsevat puhelimillaan muuttaakseen omia asetuksiaan ja päästäkseen ominaisuuksiin. Ne toimivat jokaisessa puhelimessa, pöytäpuhelimessa tai pehmeässä puhelimessa, ilman mitään asetuksia puhelimessa itsessään. Nouseva säveli merkitsee valmiin; laskeva säveli merkitsee evätyn.

Koodit yhdellä silmäyksellä

Eteenpäinohjaus

• *72 ohjaa jokaisen puhelun eteenpäin. Valitse se, kuule säveli, sitten valitse numero ja #. Tai valitse numero suoraan koodin jälkeen.
• *90 ohjaa puheluita, jotka tulevat, kun olet puhelussa. *52 ohjaa puheluita, joita et vastaa aikanaan.
• *73, *91 ja *53 lopettavat ne.

Eteenpäinohjaus toiseen laajennukseen käyttää kyseisen laajennuksen omia asetuksia (sen viestilaatikkoa, sen seuraamista), jopa neljä hyppää, joten kaksi henkilöä, jotka ohjaavat toisiaan, eivät voi muodostaa silmukkaa. Eteenpäinohjaus ulkopuolelle menee ulosmenorakenteiden kautta, aivan kuin henkilö olisi itse soittanut, ja tarvitsee laajennuksen, joka on sallittu ulospäin soittamaan.

Forwarding is live state, not configuration: setting it makes no revision, and it is kept across restarts. Extensions (luku 3) and the staff portal show and change it too.

Älä häiritse

*78 päälle, *79 pois, *76 vaihtaa. Älä häiritse -toiminnon ollessa päällä, puhelut ohjataan vastaajaan tai laajennuksen ei-vastauskohde. Käsinkäyttöisesti asetettu älä häiritse -tila voittaa kalenterin (Kalenterit (luku 39)). Hätäpuhelujen paluusoittimet soivat silti.

Seuraaminen

*21 vaihtaa seuraamisen päälle ja pois, laajennuksille, joilla on määritetty seuraamisnumerot (laajennuksessa tai henkilöstöportaalissa). Pöytä soi ensin sen sointiajansa, sitten seuraamisnumerot yksi kerrallaan tai kaikki yhtä aikaa. Ulkoisella numerolla, jolla painamalla 1 on päällä, henkilö kuulee äänen ja painaa 1 vastaanottamaan puhelun; vastaaja tai hiljaisuus ei tee sitä, ja 15 sekunnin jälkeen puhelu siirtyy eteenpäin.

Vastaa joku toisen puhelu

• *8 vastaa vanhinta puhelua, joka soi jollekin ryhmäsi poimintaryhmässä (määritetty kunkin laajennuksen kohdalla; nimet vertaillaan kirjaimien koosta riippumatta).
• ** ja laajennus vastaa puhelua, joka soi kyseiselle laajennukselle: **101.

Sisäpuhelin

*80 ja laajennus kutsuu sitä automaattisella vastauksella: puhelin vastaa kaiuttimella, ja molemmat osapuolet puhuvat. Yealink, Grandstream ja Snom lukevat BitVoicen Call-Info-otsikkeen, Poly lukee Alert-Info-otsikkeen; joillakin puhelimilla intercom on sallittava omassa asetuksessa. Laajennus voi kieltäytyä intercomista; silloin puhelu soi normaalisti. Ovistot eivät koskaan vastaanota intercomia.

Nopeusnäppäimet

*0 ja koodi soittaa tallennetun numeron: *05. Yrityksen nopeusnäppäimet ovat täällä; kunkin henkilön omat näppäimet ovat laajennuksessa tai henkilöstöportaalissa, ja ne voittavat yrityksen näppäimet samalla koodilla. Koodit ovat 1-3 numeroa.

Koodien muuttaminen

Jokainen koodi voidaan muuttaa Toimintokoodit (luku 32)-sivulla tai poistaa sanalla off. Kaksi toimintoa ei voi jakaa koodia, eikä koodi voi olla laajennuksen tai ryhmän numero: BitVoice kertoo, mikä niistä on ristiriidassa. Kaiku-, viestin- ja pysäköintinumerot ovat Asetukset (luku 14)-sivulla.

Henkilöstöportaali

Henkilöstöportaali sallii jokaisen huolehtia omista puheluistaan ilman ylläpitäjää: älä häiritse, uudelleenohjaus, seuraa minua, nopeanumerot, vastaajan viestit ja tervehdys, heidän PIN-koodinsa ja luettelo heidän omista puheluistaan. Se on osoitteessa #/me tämän palvelimen osoitteessa ja linkitetty kirjautumissivulta.

Kirjautuminen

Ihmiset kirjaavat sisään laajennusnumeron ja vastaajan viestin PIN-koodin: sama PIN-koodi, joka avaa heidän vastaajan viestinsä puhelimesta ja kirjaa heidät sisään hot-pöydissä. Laajennus ilman PIN-koodia ei voi kirjautua sisään; ylläpitäjä asettaa sen laajennukselle.

Toistuvat väärät yritykset yhdestä osoitteesta estävät sen kymmenen minuutin ajaksi. Portaalisessio ulottuu ainoastaan henkilön omiin asetuksiin: ei toiseen laajennukseen, määrityksiin tai kenenkään tallenteisiin.

Mitä ihmiset voivat tehdä

Uudelleenohjaus ja äänetön tila, jotka asetetaan täällä, ovat samat kuin ne, jotka asetetaan puhelimesta *toimintokoodien* (Toimintokoodit (luku 32)) avulla: kumpi tahansa myöhemmin asetettu on voimassa. Seuraa-minä-laitteet ja nopeusnäppäimet ovat osa laajennuksen määritystä, joten niiden muuttaminen tekee revision Muutokset (luku 61):ksi, joka on kirjattu henkilön omaksi.

Uudelleenohjaus ulkopuolelle toimii vain laajennuksille, joille on sallittu soittaa ulkopuolisiin numeroihin. Portaali kertoo sen sijaan, että se tallentaa uudelleenohjauksen, joka ei voi soittaa.

Chat ja läsnäolo

Portaalissa Chat -välilehti listaa kollegat ja heidän tilansa: saatavilla, puhelussa, soi, poissa (älä häiritse, kokous tai poissa kalenterista, syyn kanssa) tai poissa (ei puhelinta), sekä tila, jonka he ovat kirjoittaneet ("Lounaalla, takaisin klo 14"). Valitse joku viestittääksesi heille; viestit saapuvat heti, ja luvun vieressä oleva numero laskee lukemattomat viestit. Tiimihuoneet (Asetukset, Henkilökunnan chat) ovat ryhmäkeskusteluja tai kaikille, kun huoneessa ei ole jäseniä.

Viestit nähdään aina vain keskustelussa mukana olevilla ihmisillä: ylläpitäjät hallinnoivat huoneita, mutta eivät koskaan lue niitä. Asetukset, Henkilökunnan chat -välilehti sammuttaa chatin ja asettaa, kuinka kauan viestejä säilytetään (0 säilyttää tuhannen uusimman kunkin keskustelun).

Konferenssisalit

Konferenssisali on numero, jota ihmiset soittavat puhuakseen kaikki yhdessä. Henkilökunta soittaa siihen työpöydistään; ulkopuoliset soittajat pääsevät siihen tuloradan tai valikon kautta, joka osoittaa huoneeseen.

Huoneen asettaminen

1. Avaa Konferenssisalit (luku 34) ja paina Lisää konferenssisali.
2. Anna sille numero (mikä tahansa vapaa numero, oletuksena 500) ja nimi.
3. Vapaaehtoisesti aseta PIN. Soittajat kuulevat äänen, syöttävät PIN-koodin ja painavat #. Kolme väärää PIN-koodia ja puhelu loppuu.
4. Vapaaehtoisesti aseta johtajan PIN, joka on erilainen kuin PIN. Kuka tahansa, joka syöttää sen, liittyy johtajana.
5. Ulkopuolisten soittajien sallimiseksi osoita tulorata (tai valikkonäppäin) huoneeseen.

Valinnat

Näppäimet puhelun aikana

• 1 mykistää ja poistaa mykistystilan itseltäsi (huoneessa, jossa jäsenet ovat mykistettyinä, se pyytää puhua).
• 2, johtajalle, lukitsee huoneen, jotta kukaan uusi ei voi liittyä, ja lukitsee sen.

Huoneen käytön aikana

Sivu näyttää kunkin käytössä olevan huoneen: kuka on sisällä, kuka puhuu (vihreä valo), kuka on mykistetty, kuka on pyytänyt puhua ja kuka odottaa johtajaa. Ylläpitäjä voi mykistää tai poistaa mykistystilan keltä tahansa, poistaa jonkun ja lukita tai avata huoneen.

Jokainen huoneessa kuulee kaikki muut, jotka eivät ole mykistettyinä, BitVoicen sekoittamana; kunkin puhelimen voi käyttää omaa koodekiaan. Puhelun tallenne pidetään kunkin puhelun ja huoneen itsensä osalta sen kestolla ja tallenteella.

HD-ääni

Käytä HD-ääntä huoneessa (uudet huoneet ovat oletuksena päällä) ja se sekoitetaan 16 kHz:lla sen sijaan 8 kHz:lla: ihmiset laajakaistapuhelimissa (G.722, Opus, selainpuhelin) kuulevat toisensa HD-laadulla, modernin puhelun terävyydellä, kun taas ihmiset tavallisissa puhelimissa (G.711, matkapuhelimet operaattorin kautta) kuulevat saman huoneen tavallisella laadulla. Live-näkymä merkitsee huoneen ja kunkin jäsenen, joka on HD-laadussa. HD vaatii G.722:n koodekin puhelimien käyttämien koodekien joukossa (se on järjestelmän koodekkilistassa, Asetukset, Koodekit). Huoneen tallenteet pysyvät puhelimen laadussa.

Videohuoneet

Aseta Video huoneeseen ja videopuhelimet (ja pehmeät puhelimet) lähettävät kamerakuvan ja näkevät yhden kuvan, joka vaihtuu, kun ihmiset puhuvat, kuten Asteriskin ConfBridge:ssä:

• Seuraa puhujaa: jokainen näkee, kuka on puhunut toiseksi, kun edellinen on ollut hiljaa toiseksi; henkilö näytöllä näkee edellisen.
• Näytä johtaja: jokainen näkee johtajan (joka liittyy johtajan PIN-koodilla); johtaja näkee, kuka on puhunut viimeksi.
• Ruutu: jokainen näkee kaikki kerran, rinnakkain (yksi kuva täyttää näytön, kaksi rinnakkain, sitten 2 x 2 ja 3 x 3, jopa yhdeksän), kunkin omassa paikassaan liittymisjärjestyksessä, mukaan lukien itsensä.

BitVoice vaihtaa kuvat ilman niiden purkamista, joten se maksaa lähes mitään, ja se pyytää jokaiselta uudelta puhelimen täydellistä kehystä (RTCP PLI ja FIR, ja SIP INFO picture-fast-update, johon useimmat työpöydän puhelimet vastaavat) joten vaihto näkyy heti. Kunkin jäsenen video käyttää huoneen video-koodekia (H.264, ellei toisin valita VP8); puhelin ilman sitä liittyy äänellä. Kunkin katsojan saa yhden vakaan virran (yksi lähde, oma payload-tyyppi), kuka tahansa näytöllä.

Ruudukko tehdään eri tavoin: BitVoice antaa jokaisen kuvan ffmpeg:lle palvelimella, joka purkaa ne, asettaa ne 1280 x 720 kuvaksi 15 kehyksellä sekunnissa ja koodaa sen kerran kaikille. Asenna ffmpeg (Asetukset, Videomuunnos, kertoo, löytyykö se); ilman sitä ruudukko seuraa puhujaa, ja huoneen näyttö kertoo siitä. Jokainen kuva maksaa prosessoriaikaa: pienellä palvelimella pidä ruudukot muutamassa huoneessa kerrallaan. Vain ne jäsenet, joiden kamera lähettää kuvaa, näkyvät: joku, joka liittyy ilman videota tai jonka kamera loppuu, poistuu ruudukosta (se ei jäädy koskaan paikalleen kameran ollessa samalla), ja ruudukko muodostetaan uudelleen muutamassa sekunnissa, kun tilanne muuttuu, lyhyen tauon kera kuvassa. Kymmenes jäsen ja myöhemmät kuullaan, mutta heitä ei näytetä. Live-näkymä merkitsee ruudukon koon ja sen, kuka on ruudukossa.

Jokaisen videokuva (selaimet)

Valitse Jokaisen videokuva ja huone saa oman sivun (Konferenssisalit, Avaa videahuone, tai #/video-room/NUMBER). Jokainen siellä painaa Liity kamerani kanssa: selain lähettää kameransa kerran, kolmessa koossa (simulcast), ja vastaanottaa jokaisen muun kameran omana kuvanaan. BitVoice välittää kuvat sellaisenaan, ilman purkamista (valikoivasti eteenpäin välittävä yksikkö, SFU), joten se maksaa vain vähän prosessoriaikaa; jokaisen selaimen lataus ja jokaisen katsojan lataus rajoittavat huonetta, joten se voi ottaa jopa 16 kameraa.

• Suuri kuva saa kameran täyden koon, pienet kuvat saavat pienen koon; Tee suureksi vaihtaa niitä, ja vaihto tapahtuu seuraavassa täydellisessä kuvassa, jonka BitVoice pyytää heti (RTCP PLI).
• Selain, joka on lataukseltaan vajavaista, lopettaa suurimman koon lähetyksen; katsojat saavat sitten suurimman koon, joka on edelleen tulossa.
• Ääni on huoneen konferenssin ääni aina: liittyminen soittaa huoneen selainpuhelimeen, ja jokainen, joka soittaa huonetta puhelimesta, kuulee ja kuullaan kaikkien kanssa. Videopuhelimet, jotka soittavat sisään, näkevät puhujan.
• Huone, jolla on PIN, pyytää sitä sivulla. Sivu tarvitsee kirjautumisen BitVoiceen.

Näytä ruutu: paina Jaa ruutuni ja valitse ruutu, ikkuna tai selaimen välilehti selaimen omassa valitsimessa. Kaikki huoneessa näkevät sen suurena kuvana nimenne alapuolella, ja teksti säilyy terävänä (kuvan nopeus hidastuu sen sijaan, kun verkko on lyhyt). Et tarvitse liittyä kameran kanssa ensin. Lopeta jakaminen tai selaimen oma Lopeta jakaminen -palkki lopettaa sen.

• Huone näyttää yhden jaetun ruudun kerrallaan: kun joku jakaa, muut odottavat, ja sanoo, kuka jakaa. Jaettu ruutu ei lasketa 16 kameran joukkoon.
• Joku toinen voidaan tehdä suureksi kuvaksi Tee suureksi -toiminnolla; ruutu säilyy huoneessa.
• Ruudun kuva ainoastaan, ei sen ääni: huoneen ääni säilyy konferenssina.
• Puhelimet, jotka eivät voi jakaa ruutua (useimmat selainpuhelimet), näyttävät painikkeen harmaana. Pöytäpuhelimet ja muut videopuhelimet, jotka soittavat huoneeseen, eivät näe jaettuja ruutuja; he näkevät puhujan.

Sisäkuulutus ja kaiuttimet

Sisäkuulutus puhuu useiden puhelinten kautta yhtä aikaa: soita sisäkuulutusnumero, ja jokainen puhelin ryhmässä vastaa itse kaiuttimellaan. Käytä sitä ilmoituksiin varastoon, kouluun, myyntilattiaan.

Ryhmän äänestysasetusten määrittäminen

1. Valitse Äänestys (luku 35) ja paina Lisää äänestysryhmä ja anna sille numero (800 oletuksena) ja nimi.
2. Valitse puhelimet. Overhead-kaiuttimet, jotka on määritetty laajennuksiksi (tyyppi Overhead-kaiutin), voivat olla myös jäseniä.
3. Vaihtoehtoisesti, monisäätö -osoite ja portti.

Monisäätö

Monisäätö lähettää myös äänen monisäätöosoitteeseen ja porttiin (239.0.1.10:5000), G.711 µ-law -muodossa, jota overhead-kaiuttimet ja monet pöytäpuhelimet voivat kuunnella ilman yhteyttä. Ryhmällä voi olla vain monisäätöosoite. Se toimii vain yhdellä verkkolla: reitittimet eivät välitä monisäätöä, ellei niitä ole määritetty siihen.

Äänestys ja vuoropuhelu

Puhelimet, jotka eivät vastaa äänestykseen itse muutamassa sekunnissa, jätetään pois, joten yksi puhelin ilman automaattista vastaamista ei koskaan pidä äänestystä pois. Jotkut puhelimet tarvitsevat automaattisen vastaamisen (vuoropuhelu) sallimisen omassa asetuksissaan.

Hot desking

Hot desk on jaettu puhelin, josta tulee kuka tahansa, joka kirjautuu siihen: toimistoille, joissa ihmiset eivät ole kiinni tiettyyn työpöytään. Tee yksi ottamalla käyttöön Hot desk -laajennuksen puhelimessa (pöydän oma laajennus, kuten 900 Pöytä 3).

Kirjautuminen ja uloskirjautuminen

1. Puhelimessa, valitse *33 ja odota sävelääntä.
2. Syötä laajennuksesi ja #, ja odota sävelääntä.
3. Syötä viestirajapinnan PIN-koodi ja #. Nouseva sävelääni tarkoittaa, että olet kirjautunut sisään; laskeva sävelääni tarkoittaa, että se evättiin.

Siitä lähtien, puhelut laajennukseesi soittavat tätä pöytää sekä muita puhelimiisi, ja puhelut, jotka teet siitä, näyttävät numerosi ja nimesi ja lasketaan kuuluvaksi Kustannuksiisi. Kirjautuminen toiseen pöytään siirtää sinut sinne. *34 kirjaa sinut ulos. Viisi väärää yritystä lukitsee pöydän kymmeneksi minuutiksi.

Hot-pöytien hallinta

Puhelimissa (luku 4), Hot pöydät näyttää, kuka on kirjautunut missä; ylläpitäjät voivat kirjautua joku sisään (ilman heidän PIN-koodiaan) tai ulos. Koodit ja aika, jolloin kaikki kirjautuvat ulos, ovat Asetuksissa. Kirjautumiset säilytetään käynnistysten yli.

Hotellin ja herätyspuhelut

Herätyspuhelut

Kuka tahansa voi varata herätyspuhelun: hotellivieraat, yövuorot, päivystäjät. Omasta puhelimesta he soittavat *62: BitVoice sanoo asetetun (jos sellainen on), sitten he syöttävät ajan neljällä numerolla (0630) tai painavat tähden peruuttamaan sen. Hotellin (luku 37) hallinnollisella sivulla hallinnoija varaa herätyspuhelun mille tahansa laajennukselle, kerran tai joka päivä.

Puhelin soi järjestelmän nimen kanssa; vastattuna kuullaan "Hyvää huomenta. Tämä on herätyskutsu." (herätysääni Äänet (luku 20) -sivulla, vierailijan tai laajennuksen kielellä). Vastamattomana yritetään uudelleen (3 yritettä, 5 minuutin välein, molemmat asetettuina Asetukset-sivulla), ja viimeisen jälkeen vastaanotto-laajennus voidaan soittaa. Useiden palvelinten kanssa vain yksi tekee herätyskutsuja.

Hotellihuoneet

Käytä Hotellihuone-vaihtoehtoa kunkin huoneen puhelimen laajennuksella. Hotel-sivulla jokainen huone näyttää vieraan, herätyskutsun ja huoneen tilan, Kirjaudu sisään- ja Kirjaudu ulos-painikkeineen.

• Baariton tyhjät huoneet: huoneet, joissa kukaan ei ole kirjautunut, soittavat vain laajennuksia ja hätänumeroita. Hätäpuhelut toimivat aina.
• Tyhjennä kirjautumisen jälkeen: poistaa huoneen vastaajan ja peruuttaa sen herätyskutsun, eteenpäin ja äänetön tilan, valmiina seuraavalle vieraalle.
• Vieraan kieli (kirjautumisen yhteydessä) on kieli, jolla huoneen ohjeet lausutaan.
• Huoneen tila: huoneen siivooja valitsee *68 ja yhden numeron huoneen puhelimesta (*683); hotellijärjestelmä päättää, mitä kunkin numeron arvo tarkoittaa.

Hotellijärjestelmä (PMS)

• FIAS: BitVoice muodostaa yhteyden hotellijärjestelmän (Oracle Opera ja monet muut järjestelmät, jotka puhuvat FIAS:ia) FIAS-liittymään osoitteessa ja portissa. Se vastaanottaa sisäänkirjautumiset, huoneen muutokset, uloskirjautumiset ja herätysvaraukset, ja lähettää herätys tulokset, huoneen tilan ja puhelumaksut. Kun yhteys on poikki, mitä se lähettäisi, odottaa ja menee, kun se on taas käytössä; sivu kertoo, onko yhteys muodostunut. Tiedot noudattavat Oracen FIAS 2.20.23 -määritystä: BitVoice kuvaa itsensä puhelinjärjestelmäksi (IF PB), puhelumaksut ovat suorat maksut (PT C) valuutan pienimmässä yksikössä ja näppäiltyjen numeroiden ilman + tai välilyöntejä, ja herätystulos toistaa varatun ajan sekunteihin asti, jotta hotellijärjestelmä voi vastata siihen.
• REST API: hotellijärjestelmä kutsuu POST /api/hotel/rooms/<room>/checkin (nimi, tili, kieli), /checkout ja PUT /api/wakeups/<room>, automaatioasetusten API-avaimella. Maksut lähetetään JSON-muodossa antamaasi osoitteeseen.
• Maksulliset puhelut: vastatut ulkopuhelut, jotka tulevat varattuista huoneista, lisätään vierailijan laskuun, trunkin hinnoittelun (kustannukset Kustannukset (luku 54)) mukaan, lisähyvityksen kanssa.

Yhteystiedot jokaisessa puhelimessa

Yhteystiedot on yrityksen hakemisto: toimittajat, asiakkaat ja muut toimistot, joita ihmiset soittavat. Jokainen puhelin listaa sen laajennusten vieressä, ja kun yksi näistä numeroista soi sisään, puhelimet ja soittohenkilön kortti näyttävät yhteystiedon nimen (kun tarjoaja ei lähettänyt mitään). Numero vastaa riippumatta siitä, miten se on kirjoitettu: +1 212 555 0100 ja 2125550100 ovat samaa linjaa.

Yhteystietojen lisääminen

Lisää yhteystieto yhdelle kerrallaan, niin monta numeroa (työ, matkapuhelin, koti, muu), kuin heillä on. Tuo ottaa taulukon, joka on tallennettu CSV-muodossa, jonka ensimmäinen rivi nimeää sarakkeet: nimi, yritys, työ (tai puhelin), matkapuhelin, koti, muu, sähköposti, muistiinpanot. BitVoice tarkistaa koko tiedoston ensin ja kertoo, mitkä rivit ovat väärin; yhteystieto, jolla on sama nimi kuin jo olemassa olevalla, päivitetään sen sijaan, että se lisätään uudelleen, ja Korvaa jokainen yhteystieto aloittaa listan alusta. Vie lataa listan CSV-muodossa.

Pöytäpuhelimissa

Puhelimet, jotka on määritelty Puhelimissa (luku 4) (määritys), saavat hakemiston ilman lisäasetuksia:

• Yealink: etäluettelo nimeltä Yritys, joka päivitetään joka tunti.
• Grandstream: puhelinluettelon lataus, joka päivitetään joka tunti.
• Polycom: hakemistotiedosto, joka luetaan, kun puhelin käynnistyy.
• Snom: luettelo kirjoitetaan puhelimen asetuksiin, joten se päivitetään, kun puhelin tarkistaa asetuksensa seuraavan kerran.

Selaimen puhelimessa

Yhteystiedot näppäimistön alla löytää nimen tai numeron ja asettaa sen valmiiksi soitettavaksi.

Microsoft 365:sta tai Google Workspacesta

BitVoice voi pitää yhteyden organisaatiosi kanssa: jokainen, jolla on puhelinnumero, ja jaettu yhteystiedot (Exchange-organisaatiotiedot tai Google-jaetut domain-yhteystiedot). Asetuksissa (luku 14), Microsoft 365 ja Google Workspace, valitse palvelu, anna tarvittavat tiedot ja paina Tarkista nyt: se kirjautuu sisään, laskee henkilöt ja sanoo, mitkä laajakaistat vastaavat henkilöä sähköpostin perusteella. Tallenna, ja yhteystiedot täytetään puolen minuutin kuluessa; sitten joka puoli tunti, tai heti Synkronoi yhteystiedot nyt.

Microsoft 365 (sovellusrekisteröinti; sinun on oltava hallinnollinen hyväksyntä):

1. Entra-hallintakeskuksessa, Sovellusrekisteröinnit, Uusi rekisteröinti: nimeä se BitVoice, yksittäinen vuokraaja, ei uudelleenohjauksen osoitetta.
2. API-luvat, Lisää lupa, Microsoft Graph, Sovelluksen luvat: User.Read.All, OrgContact.Read.All ja Calendars.ReadBasic. Sitten Myönnä hallinnollinen hyväksyntä.
3. Varmenne ja salaisuudet, Uusi asiakkaan salaisuus: kopioi sen arvo (näytetään kerran).
4. BitVoicessa: hakemiston (vuokraajan) tunnus, sovelluksen (asiakkaan) tunnus ja salaisuus. Salaisuus vanhenee (Microsoft tarjoaa jopa kaksi vuotta): kun se vanhenee, kortti sanoo, että salaisuus hylättiin; tee uusi ja liitä se.

Google Workspace (palvelutili; sinun on oltava yleinen järjestelmänvalvoja):

1. Google-pilvessä, yhdessä projekteista: käytä People API- ja Google Calendar API-palveluja, luo palvelutili ja lisää avain (JSON) siihen.
2. Google-hallintakonsolissa, Turvallisuus, Pääsy- ja tietojen hallinta, API-ohjaus, Toimialuekohtainen valtuutus, Lisää uusi: palvelutilin asiakkaan tunnus, jossa on laajuudet https://www.googleapis.com/auth/directory.readonly,https://www.googleapis.com/auth/calendar.freebusy.
3. BitVoicessa: avaintiedosto ja yleisen järjestelmänvalvojan sähköpostiosoite palvelutilille toimia.

Mitä tulee:

• Henkilön työ- ja matkapuhelinnumerot, nimi, sähköposti ja työnimike ja osasto yhteystiedon muistiinpanoina; organisaation nimi yhteystiedon yrityksenä. Henkilöt ilman numeroa jätetään pois (yhteystiedolle tarvitaan numero); tilit, jotka on poistettu, jätetään pois.
• Palvelun yhteystiedot on merkitty sen nimeämällä, ja ne muutetaan siellä: muuttaminen tai poistaminen yhteystietoa täällä evätään, koska seuraava synkronointi peruuttaa sen. Täällä tehtyjä yhteystietoja tai taulukosta tuoduista yhteystiedoista ei koskaan muuteta.
• BitVoice lukee vain. Sen pääsy on yllä mainittujen luvien lukuoikeudet, ja salaisuus tai avain säilytetään muiden salaisuuksien kanssa: katselijat eivät koskaan näe sitä, ja Git-vienti jättää sen pois.

Kalenterit ja älä häiritse

Laajennus voi seurata henkilön kalenteria: kokousten ja lomien aikana sen soittoja ohjataan vastaajaan, tai ne ohjataan eteenpäin (toiseen laajennukseen tai matkapuhelimeen), sen sijaan, että ne soittavat puhelimeen, jota kukaan ei vastaa. Soittoryhmät soittavat muille sillä aikaa, ja jonossa edustaja näkyy Poissa-tilassa.

Laajennuksessa Kalenteri ja älä häiritse, liitä kalenterin yksityinen osoite:

• Outlook: Asetukset, Kalenteri, Jaetut kalenterit, Julkaise kalenteri; valitse kalenteri ja "Voit nähdä kaikki yksityiskohdat", ja kopioi ICS-linkki.
• Google Calendar: Asetukset, kalenteri vasemmalla, ja sitten Salainen osoite iCal-muodossa.

Tarkista lukee sen heti ja listaa seuraavat kiireiset ajat. BitVoice lukee jokaisen kalenterin joka viisi minuuttia. Loma (kaikki päivän tapahtumat ja Outlookin "poissa toimistosta") lasketaan aina; kokoukset lasketaan, kun Kokoukset lasketaan kiireisiksi on käytössä; tapahtumat, jotka on merkitty vapaiksi, eivät koskaan lasketa, eivätkä peruutetut tapahtumat. Toistuvat kokoukset, joissa on hypättyjä ja siirrettyjä ilmoittautumisia, ymmärretään. Jos kalenteria ei voida lukea, Health ilmoittaa siitä.

Älä häiritse nyt estää laajennuksen soittamisen, kunnes se käännetään pois, riippumatta kalenterista. Laajennuslistassa näkyy, kuka on poissa ja milloin.

Yksityinen osoite toimii salasanana: kuka tahansa, jolla on se, voi lukea kyseistä kalenteria, joten se säilytetään muiden salaisuuksien kanssa.

Jokainen kalenteri kerran: Microsoft 365 ja Google Workspace

BitVoice voi lukea jokaisen henkilön kalenterin Microsoft 365:stä tai Google Workspacesta, sen sijaan, että olisi yksityinen osoite kullekin laajennukselle: määritä se kerran Asetukset (luku 14) -osiossa, Microsoft 365 ja Google Workspace (ks. Yhteystiedot (luku 38) vaiheista), Kalenterit kertovat, kuka on poissa -valintaruudin ollessa käytössä. Kunkin laajennuksen sähköpostiosoite vastaa henkilöä; laajennus, jolla on oma yksityinen osoite, käyttää sitä sen sijaan. Laajennuksen asetukset täällä (Kokoukset ovat kiireisiä, Kiireisenä, puhelut) ovat voimassa kuten yksityisellä osoitteella.

• Microsoft 365 kertoo kokouksista poissaolosta: kokous, joka on merkitty pois, lasketaan poissaoloksi; epävarmat kokoukset ja ajat, jotka on merkitty vapaaksi tai työskentelemiseksi muualla, eivät koskaan estä puhelimen soittoa. Yksityinen kokous näkyy nimellä "Kokouksessa", ilman otsikkoa.
• Google Workspace antaa kiireiset ajat ilman syytä, joten ne aina lasketaan kokouksiksi.
• Kalenterit luetaan joka viisi minuuttia, ja heti, kun asetukset muuttuvat. Laajennus, jonka sähköpostiosoitetta palvelu ei tunnusta, kertoo siitä kalenteriosiossaan.

Mobiiliset sovellukset

BitVoice-sovellukset iPhoneen ja Androidiin tekevät matkapuhelimesta yhden laajennuksen puhelimista. Se soi, kuten pöytäpuhelin, puhelimen omalla puhelunäytöllä, vaikka sovellus on suljettu.

Push-asetusten määrittäminen

Suljettu sovellus herätetään puheluiden aikana push-viestillä. Asetukset (luku 14) -osiossa Mobiiliset sovellukset, valitse yksi:

Aseta Osoite, jota sovellukset käyttävät tähän palvelimen https-osoitteeseen, joka on saatavilla kaikkialta, ei ainoastaan toimistosta.

Puhelimen parittaminen

1. Avaa laajennus ja paina Lisää puhelin.
2. Skannaa QR-koodi sovelluksessa. Koodi toimii kerran, kymmenen minuutin ajan.

Kun puhelu tulee

BitVoice herättää sovelluksen; se yhdistää, soi puhelimen omalla puhelunäytöllä ja vastataan kuin mikä tahansa muu laajennuksen puhelin: ryhmä- ja jonopuhelut soittavat sitä laajennuksen muiden puhelimien kanssa. Laajennuksen sivu listaa sen paritut puhelimet, voivatko ne Herättää puheluiden aikana, milloin ne on viimeksi nähty ja milloin ne on viimeksi herätetty, ja mahdolliset push-ongelmat. Poista pari lopettaa puhelimen soiton välittömästi, kadonneelle puhelimelle.

Puhelun aikana

Sovellus on täysi laajennus, ei vain numeronvalitsin:

• Siirrä puhuja toiseen laajennukseen tai ulkopuoliseen numeroon (puhelunäytön oma Siirrä tai sovelluksen painike). Pysäköintinumeroon se pysäköi puhelun.
• Pidä ja ota takaisin, puhelunäytöltä tai sovelluksesta; pidätetyt puhujat kuulevat pidätyksen aikana soittimen musiikkia, missä se on asetettu.
• Toinen puhelu: numeroida, kun ensimmäinen on pidossa, ja vaihdella niiden välillä.
• Näppäimistön äänet (DTMF) puhelun aikana ja Mykistä.

The other tabs

• Recents: calls to and from this extension, newest first, tap to call back (missed calls stand out).
• Voicemail: each message with its transcript (luku 29) where the AI writes one, play it, call back or delete.
• Team: who is free, on a call, ringing or away (a busy lamp), to call them or transfer the current call to them.
• Contacts: the company directory, to find a name and call it.
• Chat: the staff chat (Chat and presence), colleagues with their presence and direct messages, and team rooms, inside the phone. A new message while the app is in the background shows as a notification, and tapping it opens Chat; when the app is closed, it comes through the same push as calls.
• Join a video room: pick one of the video rooms (luku 34) (it lists them, with how many are in each now). It opens over the phone, which keeps running underneath, and you join as your extension: no administrator sign-in. The first time, the phone asks for the camera. Leave, or Back on Android, returns to the phone; the room's sound stays a call on it until you hang up. The phone shows the room as a video call on its own call screen while you are in it.
• Calls you make go on the phone's own call system too (CallKit on iPhone, Android's Telecom), so Bluetooth, a car or a watch show them, and a mobile call arriving meanwhile knows of them.

Live-transkripti puhelun aikana

Kirjoita puhelut live -valinnan ollessa päällä (Asetukset (luku 14), tekoäly), kummankin puolen puhelua kirjoitetaan ylös, kun se puhutaan, ja se näytetään puhelimella puhelun aikana. Ääni menee puhujan kirjoittamispalveluun (omalla tietokoneellasi, missä se on asetettu) tai tekoälypalveluun puhelun kestoaikana. Se on sama kirjoittaminen kuin 911 live-transkriptit (luku 13) tavallisille puheluille.

Videopuhelut

Kun molemmat puhelimen puhelussa lähettävät videota (videopuhelimet, ohjelmistopuhelimet, videopuhelinsoittimet), kuva kulkee heidän välillään BitVoice:n kautta. Ei mitään asetettavaa: se on käytössä, ellei Asetukset → Videopuhelut ole pois kytketty.

• BitVoice välittää videon sellaisenaan, omalla portillaan kullekin puhelimelle, joten puhelimet eivät koskaan opi toistensa osoitteita. Yhteisellä koodekillä (lähes jokaisella videopuhelimella on H.264) se ei koskaan dekoodaa videota; ilman yhteistä koodekia se voi kääntää (alla). Kun ne numeroidaan saman koodekin eri numerolla, BitVoice uudelleennumeroi sen matkalla.
• Kuva on salattu (SRTP) kullekin puhelimelle, joka salaa äänensä.
• Puhelimen pyyntö uudesta kuvasta (kadonneiden pakettien jälkeen) saapuu toiselle puhelimelle, joten kuva palautuu hetkessä.
• Kameran käyttöönotto kesken puhelun (softapuhelimen videopainike) toimii myös: toinen puhelin pyydetään ensin, ja kuva alkaa, kun se sanoo kyllä.
• Puhelin ilman videota tai puhelu ulkopuoliselle numerolle saa vain äänen. Pidätettynä tai pysäköitynä kuva pysähtyy, ja palaa, kun puhelu jatkuu. Siirron jälkeen se jatkuu vain, kun uusi osapuoli lähettää myös videota.
• Video käyttää paljon enemmän verkkoa kuin ääni (noin 0,5-2 Mbit/s kumpaankin suuntaan per puhelu): salli se hitailla linkeillä ja mediaportin alueella.

Videon muuntaminen

Puhelimet ja sovellukset, jotka jakavat videokoodekin (useimmat käyttävät H.264), saavat toisensa videon sellaisenaan. Kun kaksi osapuolta eivät ole yhteisiä videokoodekkeja (pöytäpuhelin, jolla on vain H.264, ja selain, jolla on vain VP8), käytä Muunna video H.264:ksi ja VP8:ksi Asetuksissa: BitVoice tarjoaa molemmat koodekit, vastaa kullekin osapuolelle omalla koodekillään ja muuntaa kummallakin tavoin ffmpeg:n avulla, joka on asennettava palvelimelle (apt install ffmpeg, brew install ffmpeg; tai anna polku). Muuntaminen maksaa noin prosessoriydin puhelua kohden ja lisää hieman viivettä, joten se on pois oletuksena ja käytetään vain, kun se on tarpeen. Asetukset kertoo, löytyykö ffmpeg.

Faksi: lähetys ja vastaanotto, faksilaitteet ja analogiset puhelimet

Faksi, analogiset puhelimet, ovipuhelimet ja vanhat linjat liittyvät SIP-yhdyskäytävän (tai puhelinluettelon kortin BitVoice-tietokoneessa: ks. Puhelinluettelon kortit (luku 6)) kautta: ATA (Grandstream HT -sarja, yhdelle tai kahdelle analogiselle puhelimelle tai faksille), tai isompi yhdyskäytävä (Patton SmartNode, AudioCodes MediaPack ja Mediant) useille analogisille porteille, ISDN-linjalle (BRI/PRI) tai vanhoille analogisille linjoille (FXO). Jokainen portti rekisteröityy BitVoice-järjestelmään laajennuksena, kuten puhelin.

Vastaanottaminen ilman faksilaitetta. Faksit-sivulla lisää faksinumero (esim. 300), ja määritä sähköpostiosoitteet, joihin faksit lähetetään. Sitten Puheluiden reititys (luku 8) -sivulla lähetä puhelinnumeron puhelut faksinumeroon. BitVoice vastaanottaa puhelun faksilaitteena, vaihtaa puhelun T.38-tilaan ja vastaanottaa faksin; kunkin faksin muuttuu PDF-muotoon, joka säilytetään Faksit-sivulla (Näytä, PDF) ja lähetetään sähköpostitse. Faksi, joka katkeaa osittain, säilyttää saapuneet sivut ja ilmoittaa siitä. Kunkin faksin luettelossa näkyy lähettävän tai vastaanottavan laitteen oma tunniste, jos se eroaa numerosta, sekä sivujen siirtotaajuus (14 400 bittiä sekunnissa on nopein; laitteet, joiden faksit usein epäonnistuvat alhaisella nopeudella, ovat yleensä heikkolaatuisia). Tämä vaatii T.38-tukea (useimmat tarjoajat tukevat sitä); äänenä lähetetty faksi ei voida vastaanottaa tällä tavoin. Kokeiltu T38Fax-palvelun kanssa: rekisteröi käyttäjätunnus ja salasana sip.t38fax.com:5080 (UDP) -osoitteeseen; salli UDP-liikenne sen verkoista (8.34.182.0/24 ja 8.20.91.0/24) BitVoicen eteen.

Faksin lähettäminen. Faksit-sivulla Lähetä faksi: valitse faksinumero, josta faksi lähetetään, kirjoita numero, johon faksi lähetetään, kirjoita viesti, jos haluat (se tulee ensimmäiseksi sivuksi) ja lisää asiakirjoja. Tekstitiedostot ja kuvat (PNG, JPEG, GIF) toimivat kaikkialla. PDF tarvitsee poppler-palvelimen (apt install poppler-utils, apk add poppler-utils, brew install poppler); Word, Excel, OpenDocument ja RTF tarvitsevat myös LibreOfficea. Sivu kertoo, mitä palvelin voi tehdä. Jokaiselle sivulle tulee otsikkorivi, kuten faksilaitteet tulostavat sen: aika, faksinumeron nimi, sen tunniste ja sivulaskuri. Puhelu lähtee faksinumerosta, jonka numerot (+1 212 555 0300 soittaa +12125550300), tai itse faksinumerosta, kun tunniste ei ole numero. Sivut ovat US-kirjekoko Pohjois-Amerikassa ja A4 muualla, maan mukaan, jonka Asetukset määrittää.

BitVoice soittaa numeron ulospäin menevien reittien kautta, kuten laajennus tekisi, ja lähettää nopeuden, jonka linja mahdollistaa (14 400 bittiä sekunnissa, hitaammin, jos linja on huono). Faksit yhdestä faksinumerosta lähetetään yksi kerrallaan. Varattu numero tai numero, joka ei vastaa, yritetään uudelleen viiden minuutin kuluttua, kaikkiaan kolme kertaa. Lähetetyt faksit ovat luettelossa vastaanotettujen faksien kanssa: Lähetetty, Odottaa lähettämistä, Epäonnistui (jonka kanssa on Yritä uudelleen), tai Osittain lähetetty, kun linja katkeaa jonkin sivun jälkeen.

Email to fax. Below the list, set up a mailbox for BitVoice to read (IMAP over TLS, port 993; for Google and Microsoft mailboxes use an app password), then Test and Save. Anyone allowed to send writes to that mailbox with the fax number in the subject (Fax 212 555 0199), or to a plus address (fax+2125550199@example.com) if the mail server takes them. Attachments become the pages and the email's own words the cover note (the signature and quoted mail are left out). It goes from the fax number that lists the sender: its Email each fax to addresses may always send, and May also send faxes by email adds others (whole addresses, or @example.com for a domain). The sender gets an email when the fax has gone through, or why it could not.

Sähköpostia on helppo väärentää, joten BitVoice lähettää faksin vain, kun sähköpostipalvelimesi on todennut, että se tuli todella lähettäjän domainista (DKIM, SPF tai DMARC, todennus-tuloksessa, jonka se lisää). Muut viestit hylätään ilman vastausta. Kytke Hyväksy sähköposti, jonka lähettäjän domain ei ole vakuuttanut vain, jos postilaatikko on sellainen, johon ulkopuolinen sähköposti ei voi tulla.

Faksi-laitteet porteilla. BitVoice välittää faksin T.38-standardeilla, internetin faksi-standardeilla: kun portti kuulee faksi-äänen, se vaihtaa puhelun T.38-tilaan, BitVoice pyytää toista puolta (palveluntarjoajaa tai toista porttia) vaihtamaan myös, ja välittää faksin heidän välillään. Jos toinen puoli ei voi tehdä T.38:aa, puhelu pysyy G.711-tilassa ja faksi menee äänenä, mikä toimii hyvällä verkolla. Aktiiviset puhelut näyttävät faksi (T.38), kun faksi on meneillään.

Luotettavien faksien toimittamiseksi:

• Käytä T.38:aa portilla ja valitse palveluntarjoaja, joka tukee sitä.
• Tee portin laajennuksen Analoginen sovittimen portti (Laajennukset, Tyyppi): BitVoice tarjoaa sille vain G.711:ä, jota faksit, jotka lähetetään äänenä, tarvitsevat.
• Portin faksiportissa: Faksi-tila T.38, vain PCMU tai PCMA, linjan echo-puhdistin pois, odottaminen pois ja kiinteä, korkea jitter-puskuri.

Vastaanotin: web-keskustelu, WhatsApp ja Messenger

Postilaatikko Inbox (luku 43) sisältää kaikki kirjoitetut keskustelut yhdessä listassa: chat-ikkuna verkkosivustollasi, WhatsApp, Facebook Messenger ja tekstit (luku 44). Kuka tahansa, joka on kirjautunut verkkorajapintaan, voi vastata; ensimmäinen, joka vastaa, ottaa keskustelun (kuka tahansa voi luovuttaa sen Vastattu -kohdalla), ja Sulje poistaa sen, kunnes henkilö kirjoittaa uudelleen. Lukemattomat keskustelut lasketaan, ja lista päivittyy itsestään.

Verkkosivun chat-ruutu

Kanavat-valikossa, käytä Web-keskustelua, valitse sen otsikko, väri ja ensimmäinen rivi, ja laita se sivustosi sivuille:

<script src="https://pbx.example.com:8443/webchat.js" async></script>

Se piirtää chat-painiken kulmaan jokaiselle sivulle; vierailijat kirjoittavat (nimellään, jos he haluavat) ja näkevät vastauksesi, kun ne tulevat. Keskustelu säilyy heidän selaimessaan, joten se jatkuu, kun he siirtävät sivuja. Luettele sivut Vain näillä sivuilla, jotta ruutu ei suorita muualla. Vierailijoiden on oltava kyseisessä palvelimen osoitteessa internetistä, sertifikaatilla, jota selaimet luottavat (Let's Encrypt (luku 14)). Kymmenen uutta chat-keskustelua yhdestä osoitteesta kymmenessä minuutissa on enimmillään, mitä BitVoice hyväksyy.

WhatsApp

WhatsApp Business -numerot Metan Cloud API:lla. Metan kehittäjäsivustolla, luo sovellus WhatsAppilla, lisää numerosi ja luo järjestelmän käyttäjä, jolla on pysyvä pääsytokeni. Kanavat-valikossa, käytä WhatsAppia ja anna puhelinnumeron tunniste ja liiketoimintatunniste (molemmat API-asetuksista), pääsytoken ja sovelluksen sovelluksen salaisuus, säästä. Sovelluksen WhatsApp-konfiguraatiossa, määritä webhook: BitVoice näyttää callback-osoitteen ja vahvistusmerkin, johon on tilattu *viestit*.

WhatsApp sallii vastaamisen vapaasti 24 tuntia asiakkaan viimeisen viestin jälkeen; sen jälkeen se hyväksyy vain viestimallit, jotka on hyväksytty WhatsApp Managerissa. Vastausruutu muuttuu sitten mallivaliksi: valitse malli (se listaa tilin mallit, kielillä ja tyypeillä), täytä arvot ({{1}}, {{2}} ...), tarkista esikatselu, joka on se, mitä asiakas lukee, ja Lähetä malli. Mallit, joita vastaanotin ei voi täyttää, on listattu harmaalla taustalla ja syynä: yksi, jossa on kuva-, video- tai asiakirjatunniste, muuttuja otsikossa tai painikkeen linkki, nimetyt parametri ja koodipainike; ja ne, jotka eivät ole vielä hyväksytty. Luo mallit WhatsApp Managerissa; Meta tarkistaa kunkin mallin yleensä muutamassa minuutissa.

Facebook Messenger

Facebook-sivulle: Metan sovelluksessa, lisää Messenger, yhdistä sivu ja luo sivun pääsytoken. Kanavat-valikossa, anna sivun tunniste, sivun pääsytoken ja sovelluksen salaisuus; säästä. Määritä webhook (osoite ja vahvistusmerkki, jonka BitVoice näyttää), johon on tilattu *viestit* ja *messaging_postbacks*. Vastaukset sallitaan 24 tuntia henkilön viimeisen viestin jälkeen. Sen jälkeen, kunnes 7 päivää, Messenger ottaa vastaukset, jotka on kirjoitettu henkilöllä (lähetetty Metan *ihmisen agentti* -tunnisteella: sovelluksen on pyydettävä Metan Human Agent -lupaa, joka pyydetään sovelluksen tarkastelussa); automaattinen tervehdys ei lähetä silloin. 7 päivän jälkeen vastaanotin ei ota vastausta, kunnes he kirjoittavat uudelleen.

Jokainen webhook tarkistetaan sovelluksen salaisuudella (Metan allekirjoituksella) ennen kuin BitVoice uskoo siihen, ja viesti, jonka Meta lähettää kahdesti, säilytetään kerran. Kuvat, äänimuistiinpanot ja muut liitteet näkyvät sellaisinaan ("[kuva]"); avaa ne Metan omilla sovelluksilla.

Automaattinen tervehdys, kun se on asetettu, vastaa uuden keskustelun ensimmäiseen viestiin heti.

Liiketoimintatekstaus (SMS)

Lähetä ja vastaanota tekstiviestejä liiketoimintanumeroillasi Tekstien kautta. Tekstit kulkevat tekstauspalvelun kautta. Valmiina: TextMagic, Twilio, SignalWire, Telnyx, Bandwidth, Vonage, Plivo, Flowroute ja VoIP.ms, sekä Oma webhook minkä tahansa muun palvelun tai oman portin käyttöön. Useita palveluntarjoajien tilejä voidaan käyttää samanaikaisesti: kunkin numeron kohdalla ilmoitetaan, kuka niitä välittää.

Asetukset

1. Palveluntarjoajan portaalissa, etsi tilin API-tiedot. Lomake kysyy tarkalleen sitä, mitä palveluntarjoaja niille antaa (Twilio: Account SID ja auth token; Telnyx: API-avain; Bandwidth: API-käyttäjä, salasana, tilinumero ja viestisovelluksen tunniste; SignalWire: myös tilan osoite) ja kertoo, mistä ne löytyvät.
2. Tekstien kohdalla, Tekstausasetukset, lisää palveluntarjoaja niillä ja säästä. BitVoice näyttää osoitteen, johon saapuneet tekstit lähetetään: aseta se palveluntarjoajassa, jonne saapuneet viestit lähetetään (sen callback, webhook tai viestin URL). VoIP.ms:lle lisää ?from={FROM}&to={TO}&message={MESSAGE}&id={ID} loppuun. Toimitusvahvistukset, jotka lähetetään samaan osoitteeseen, hylätään. BitVoice on oltava saatavilla internetistä siellä.
3. Lisää kunkin numeron, josta tekstaat (maakoodilla), palveluntarjoaja, joka välittää sitä, ja laajennukset, joille ilmoitetaan, kun teksti saapuu sähköpostitse.

US 10DLC

Yhdysvaltain operaattorit estävät tekstiviestit tavallisilta liiketoimintanumeroilta, jotka eivät ole rekisteröity. Rekisteröi brändisi ja sitten kampanja tekstiviestintipalveluntarjoajasi kautta; luettelo Texts-seurannassa kertoo, missä ne ovat, ja varoittaa, kun näyteviestisi puuttuu operaattorin odottamista opt-out-sanoista.

Keskustelut

Kunkin keskustelun näkyvissä on, kuka se on (Otsikosta), lukemattomat tekstiviestit ja viestiketju. Syötä lähettää; laskuri näyttää, montako tekstiviestiä pitkä viesti vaatii. Kun joku vastaa STOP, mitään enempää ei voida lähettää heille tästä numerosta, kunnes he vastaavat START. Saapuneet tekstiviestit näkyvät myös ilmoituksena BitVoicessa.

Siirtokertomukset

Jotta soittaja ei koskaan tarvitse toistaa itseään: Tiivista kukaan, jolle puhelu siirretään (Asetukset, AI), kun puhelu siirretään, BitVoice kirjoittaa kaksijäsenisen yhteenvedon puhelusta tähän asti (kuka soittaa, mitä he haluavat, mitä on jo luvattu) henkilölle, jolle se menee. Se näkyy heidän selaimen puhelimessa soivan puhelun kanssa, Live-puhelut (luku 46) -sivulla ja tekstiviestinä heidän työpöytäpuhelimen näytöllä (puhelimille, jotka näyttävät SIP-viestejä).

Se toimii samalla tavalla, kun AI-vastaanottaja antaa soittajan henkilölle: kertomus tulee siitä, mitä soittaja kertoi avustajalle.

Sille tarvitaan AI-palvelu ja puhe-teksti-malli (Asetukset, AI), ja puhelun ääni tähän asti (enintään viisi minuuttia) lähetetään siihen palveluun kirjoitettavaksi. Yhteenveto kestää muutaman sekunnin, joten se voi ilmestyä vasta, kun puhelin alkaa soida.

Aktiiviset puhelut

Aktiiviset puhelut näyttää jokaisen meneillään olevan puhelun, joka päivitetään, kun se tapahtuu: kuka soittaa kenelle, kuinka kauan se on kestänyt, sen koodaukset ja sen laatu.

What administrators can do

Kuunnellaksesi, kuiskaamalla tai bargeamalla, paina Valvo, valitse puhelin, josta haluat soittaa Puhelimesta ja paina Soita minulle: puhelimesi soi, ja kun vastaat, liityt puheluun. Voit vaihdella kuuntelemisen, kuiskaamisen ja bargeamisen, kun olet siinä.

Mitä muuta näytetään

• Soittajan kortti ulkopuolisen puhelun soidessa (CRM:stä tai aiemmista puheluista, ks. CRM (luku 49)).
• Siirrettävän puhelun vastaanottajalle kirjoitettu katsaus (Siirto katsaukset (luku 45)).
• Soittajan tunnistusväite: Varmistettu, Osittain varmistettu tai Varmistamaton (Roskapuhelunsuojelu (luku 56)).
• Useiden palvelimien kanssa, myös muilla palvelimilla olevat puhelut, vain luku: lopeta tai kuuntele palvelimelta, jolla puhelu on.

Kun puhelu päättyy, se siirtyy Puheluhistoriaan (luku 47).

Puheluhistoria

Jokainen valmis puhelu: kuka soitti kenelle, milloin, kuinka kauan ja miten se päättyi. Voit järjestää sarakkeita, toistaa tallenteita (katko korttinumeroille on merkitty) ja ladata luettelon CSV-muodossa. Tallenteiden säilytysaika määritetään Asetuksissa, *Puheluiden tallennus* -kohdassa; oikeudellinen pidäke (luku 73) pitää niitä pidempään.

Reititys

Jokaisen puhelun tuloksen alla Reititys listaa yksinkertaisin sanoin ja järjestyksessä, mitä päätti, mihin puhelu meni: saapuvan reitin, joka otti sen, onko aikataulu avoinna tai suljettu ja aika, toggle-valitsimen puoli, mitä reititysskripti valitsi (tai että sen fallback otti puhelun), näppäimistä painetut näppäimet valikossa, kuka oli poissa, kuka ei ollut puhelimella, kuka ei vastannut, lähtevän reitin ja käytetyn trunkin (ja trunkin, jonka terveysarvio siirsi muiden taakse), huijausvartijan tuomion, ja tallennetun puhelun kohdalla, jonka osapuolet ovat eri suostumussääntöjen alaisia, mikä sääntö soveltuu.

Laatu, ääni ja salaaminen

Laatu-sarakkeessa näkyy kunkin vastatun puhelun pisteytys (MOS, maksimissaan 5) ja kaksi merkintää, kun ne ovat sovellettavissa:

• Ei ääntä puolelta: puhelu yhdistettiin, mutta mitään ääntä ei koskaan saapunut kyseiseltä puhelimelta tai tarjoajalta (puhelut, jotka kestävät alle 5 sekuntia, faksit, pidätetyt puhelut ja sivutelefonit jätetään pois). Katso Puhelun laatu (luku 53) tarkistuskohteista.
• Ei salattu: BitVoice pyysi salaamista (SRTP) ja vastapuoli vastasi ilman sitä. Salattu tarkoittaa, että ääni salattiin jokaisen puolen kanssa, joka lähetti ääntä. Jos haluat estää salaamattomien puhelujen vastaanottamisen tarjoajalta, käytä Vaadi salaaminen -vaihtoehtoa sen trunkissa.

Tekstitykset ja haku

Kun AI on päällä ja Tekstitys tallennetuille puheluille on käytössä (Asetukset, AI), jokainen tallennettu puhelu kirjoitetaan ylös, lyhyen yhteenvedon ja sen toimintakohteiden kanssa: mitä joku sopi tai pyydettiin tekemään. Jokainen puhelun puoli kirjoitetaan erikseen tallenteesta, joten tekstitys näyttää, kuka sanoi mitä ja milloin. Tekstitysnappi tallenteen vieressä avaa sen; ylläpitäjät voivat myös tekstitys yhden puhelun tai tekstitys uudelleen.

Hae mitä sanottiin löytää puhelut sanoista niiden tekstityksistä, yhteenvedoista ja toimintakohteista. Vain tallennetut puhelut tekstitys. Tekstitys poistetaan tallenteen kanssa, ja tekstitysten lukeminen tai hakeminen merkitään tapahtumalokiin, kuten tallenteen toistaminen.

Asiakkaan aikajana

Asiakkaan aikajana näyttää kaiken yhden puhelinnumeron kanssa viimeisen vuoden ajan, uusimmat ensin, jotta kuka tahansa, joka vastaa, tietää koko tarinan.

Mitä se näyttää

Numero vastaa riippumatta siitä, miten se on kirjoitettu: +1 212 555 0100 ja 2125550100 ovat sama.

Opening it

From a caller card (Timeline), from Contacts, from an incoming call in Call history, from a text conversation, or type a number at the top of Timeline (luku 48).

Muistiinpanot

Ylläpitäjät voivat Lisätä muistiinpanon tiimille: se näkyy aikajanalla kaikille, kuka sen kirjoitti ja milloin, ja sitä voidaan poistaa.

CRM: soittajakortit ja puheluloki

Yhdistä asiakasjärjestelmä Asetuksissa (luku 14), CRM. Se toimii kaikkien järjestelmien kanssa, joilla on verkkotunnus, ilman koodin kirjoittamista kullekin tuotteelle.

Soittajakortit

Kun ulkopuolinen puhelu soi, Reaaliajassa näkyy kortti: kuka se on (CRM:stä tai laajakaistan nimestä), kuinka usein he ovat soittaneet 90 päivän aikana, odottavat paluupuhelut (luku 30) ja edellisen transkriboituneen puhelun yhteenveto. Selainpuhelimessa näkyy lyhyempi kortti vastaajalle: kuka se on, aiemmat puhelut ja odottavat paluupuhelut, mutta ei muiden puheluiden yhteenvetoja.

Nimen asettamiseksi määritä Hae osoite: BitVoice kysyy sitä (GET) soittajan numerolla {number} tilalla, lähettäen Hae-otsikko arvonsa kanssa (holvitunniste toimii), ja odottaa JSON-vastauksen nimestä, yrityksestä, url:sta ja muistiinpanoista; 404 tarkoittaa tuntematonta. Vastaukset säilytetään viisi minuuttia. Avaa CRM-linkki asettaa linkin soittajaan kortille. Käytä Etsi kokeilemaan numeroa ennen tallentamista.

A CRM's own answer

Most CRMs answer a search in their own shape, usually a list of matches, not BitVoice's {"name": ...}. Open Answer fields and say where each part is, as a dotted path: a name steps into an object and a number into a list, so list.0.name is the first match's name. Link to the contact may be a path to a link the CRM gives, or a web address with paths in braces, such as https://crm.example.com/#Contact/view/{list.0.id}. An empty field reads BitVoice's own name for it. A search that finds nobody is the same as 404: the card says the caller is not known. Try a number with Look it up before saving.

Esimerkiksi EspoCRM (testattu oikeaa EspoCRM:ää vastaan): luo API-käyttäjä (Hallinta, API-käyttäjät, todennus API-avaimella) roolilla, joka voi lukea yhteyshenkilöitä ja tilejä, ja aseta sitten:

• Hae osoite: https://crm.example.com/api/v1/Contact?select=name,accountName,description&maxSize=1&where%5B0%5D%5Btype%5D=equals&where%5B0%5D%5Battribute%5D=phoneNumber&where%5B0%5D%5Bvalue%5D={number}
• Hae otsikko X-Api-Key, sen arvo on API-käyttäjän avain
• Vastauskentät: nimi list.0.name, yritys list.0.accountName, muistiinpanot list.0.description, linkki https://crm.example.com/#Contact/view/{list.0.id}

EspoCRM tallentaa numerot kansainvälisessä muodossa (+15405550117), kuten BitVoice ne välittää. Muut CRM-järjestelmät toimivat samalla tavalla omilla hakuoosoitteillaan ja kenttinimillään; tarkista vastauksen muoto heidän API-dokumentaatiostaan tai Etsi-toiminnolla, jonka viesti kertoo, mitä se löysi.

Puheluiden lokitus

Määritä Puhelulokin osoite ja Allekirjoitus salaisuus, ja jokainen puhelu lähetetään sinne, kun se päättyy (tapahtuma call.ended), uudelleen yhteenvetonsa, toimenpidet ja käännös, kun se on transkriboitu (call.summarized), ja jokainen varattu palaute (callback.new). Jokainen POST-lähetys sisältää X-BitVoice-Event, X-BitVoice-Timestamp ja X-BitVoice-Signature: sha256= seuraa HMAC-SHA256: n salaisuuden, aikaleiman, pisteen ja pyynnön ruumin. Epäonnistunut toimitus yritetään neljä kertaa noin minuutin ajan; jos se edelleen epäonnistuu, Health ilmoittaa siitä. Lähetä testitapahtuma tarkistaa osoitteen ja salaisuuden.

Puhelun analyysi esimiehille

Ota yhteyttä-keskuksille: näyttö siitä, miten puhelut menivät, esimiehelle kuunneltavaksi, ei koskaan automaattinen arvosana.

Puhelun Transkriptissa, Miten se meni näytetään, mitattuna tallenteen äänen perusteella: miten paljon kumpikin osapuoli puhui, kummankin puheen pituus, kuinka usein kumpikin aloitti puhumisen toista osapuolta, kuinka kauan molemmat puhuivat samaan aikaan, ja hiljaisuus (pitkä hiljaisuus on usein pidäke tai kuollut ilma)

Kun Tallenna, miten käännetyt puhelut menivät on käytössä (Asetukset, Tekoäly), tekoäly myös lukee transkriptin ja kertoo, miten soittaja vaikutti alussa ja lopussa, ja listaa jopa kuusi hetkeä: Menti hyvin, Tarkastele (puhumista soittajan yli, pitkä pidäke, epäselvä vastaus), Ei vastattu (kysymys, jota soittaja ei saanut vastausta) ja Lupailtu (jotain, mitä joku lupasi tehdä), kunkin kohdalla on aika ja sanat, joten voit mennä suoraan siihen. Hallinnoija voi pyytää sitä miltä tahansa käännetyltä puhelulta Tarkastele tätä puhelua.

Puhelun laadussa (Call quality (luku 50)), Keskustelut, joka otti ne lasketaan transkriboitujen puheluiden määrä ajanjaksolla henkilökohtaisesti: heidän puhumisensa osuus, heidän pisin puhumisensa, kuinka usein he puhuivat puhujan yli, hiljaisuuden aika, puhelut jotka päättyivät puhujan ollessa loukkaantunut, ja merkityt hetket. Käytä sitä valitsemaan puheluita kuunneltaviksi, älä käytä sitä ihmisten rankkaukseen.

Valmennusmuistiinpanot ovat omat sanat puhelusta, hetkellä, josta ne ovat: Miten se meni - alla, kirjoita Hetki (1:05, tai jätä se tyhjäksi alusta varten) ja Valmennusmuistiinpano, ja paina Lisää muistiinpano. Muistiinpanot on lueteltu puhelun mukaisessa järjestyksessä, joka on kirjoittanut ne ja milloin; hallinnoijat kirjoittavat ja poistavat ne, katselijat lukevat ne transkriptin kanssa, ja muistiinpanon lisääminen tai poistaminen on merkitty tapahtumalokiin. Ne menevät tallenteen mukana, joten sen säilytys ja oikeudelliset pidäkkeet koskevat niitä myös. Valmennusmuistiinpanot Puhelun laatu laskee ne henkilökohtaisesti.

Soittotallennus ja korttimaksut

Tallennus on asetettu Asetuksiin (luku 14), Soittotallennus: pois, jokainen soitto tai vain laajennusten soittotallennukset, jotka on merkitty Tallenna soittotallennukset. Tallenteet toistetaan Soittohistoriasta (luku 47), ja älykkäiden laitteiden kanssa ne kirjoitetaan ja tiivistetään.

Ilmoittaminen

Jotkut paikat vaativat, että kaikki puhelussa olevat henkilöt ilmoitetaan siitä, että puhelu tallennetaan: Ilmoitus, Äänimerkki ja aluekohtaiset säännöt löytyvät Tallennuksen hyväksyntä (luku 52) -osiossa.

Korttimaksut (PCI DSS)

Korttinumeroita ei saa tallentaa nauhoituksiin. Ennen kuin soittaja lukee numeron, laajakaistan päässä oleva henkilö painaa *7; *8 jatkaa tallennusta. Tallennuksen keskeytys Reaaliajassa (luku 46) tekee saman. Keskeytys on hiljainen nauhoituksessa ja luetellaan puheluhistoriassa, jotta tarkastaja voi nähdä, missä ja kuinka kauan.

Konferenssisalit

Huone, jossa Tallenna huone on käytössä, tallennetaan yhtenä tallenteena koko huoneesta (Konferenssisalit (luku 34)).

Kuinka kauan asiat säilytetään

Asetukset määrittävät, kuinka monta päivää nauhoitukset, puheluhistoria ja ääniviestit säilytetään; vanhemmat poistetaan tunnin kuluessa. Mitään oikeudellista pidäkemistä (luku 73) alaista ei poisteta sen ikästä riippumatta. Arkisto (luku 72) voi säilyttää kopiot muualla.

Ylläpitäjät ja katselijat voivat toistaa nauhoituksia ja lukea transkriptioita; vain ylläpitäjät voivat transkriptioida puhelun tai transkriptioida sen uudelleen. Nauhoituksen toistaminen tai sen transkriptin lukeminen merkitään tapahtumalokiin.

Tallennuksen hyväksyntä

Jotkut paikat sallivat puhelun tallentamisen, kun yksi henkilö siinä osaa; toiset tarvitsevat, että kaikki on kerrottu, tai että he ovat sopineet. Asetuksissa, Puhelun tallennus, valitse, miten ihmiset tallennetussa puhelussa ovat kerrottu:

• Ei ilmoitusta.
• Ilmoita: kun puhelu vastaanotetaan, molemmat kuulevat ilmoituksen (tallenna se samassa paikassa, esimerkiksi "Tämä puhelu tallennetaan koulutusta ja laatua varten"), ja tallennus alkaa vasta, kun se on soinut. Kunnes yksi on tallennettu, soi kolme sävellystä, ja Terveys kertoo siitä.
• Sävel: lyhyt ääni molemmille puolille joka 15 sekuntia tallennetun puhelun aikana.

Säännöt valitsevat ulkopuolelta tulevan numeron mukaan (soittaja saapuville puheluille, numerolle, jota soitetaan lähteville puheluille), pituuden mukaan: esimerkiksi numerot, jotka alkavat 1415 (Kalifornia) Ilmoita, 49 (Saksa) Älä koskaan tallenna, kaikki muu edellä mainittu. Säännön Ei ilmoitusta tallentaa ilman ilmoitusta; Älä koskaan tallenna jättää nämä puhelut kokonaan tallentamatta. Laajakaistojen väliset puhelut noudattavat pääasiallista asetusta.

Oma numerosi lasketaan myös: säännöt verrataan sekä ulkopuoliseen numeroon että omaan numeroon (numero, jota soitetaan sisään, ja soittohenkilön tunniste ulospäin), ja suojakelpoisin niistä voittaa (Älä koskaan tee nauhoitusta ennen kuin ilmoitus, äänimerkki ennen ilmoitusta, eikä ilmoitusta ennen mitään). Niinpä toimisto, joka sijaitsee paikassa, jossa tarvitaan kaikkien osapuolten suostumus, ilmoittaa kenelle tahansa se soittaa, missä tahansa he ovat. Kun osapuolet kuuluvat eri sääntöihin, puhelun tallennus Puheluhistoria (luku 47) kertoo, mikä sääntö sovellettiin ja miksi.

Tallennusta voidaan myös keskeyttää puhelun aikana käyttämällä keskeytyskoodia (korttimaksut). Tämä ei ole lakineuvontaa: tarkista lait, jotka koskevat sinua ja sinun soittajia.

Puhelun laatu

Kuinka puhelut kuulostivat viimeisen päivän, viikon, kuukauden tai 90 päivän aikana, äänen mukaan, jonka BitVoice itse vastaanotti kummallakin puolella jokaisessa puhelussa. Puhelimet on ryhmitelty niiden sijainnin (luku 12) (tai "ei sijaintia") mukaan, ja puhelut ulkoa tarjoajan linjan mukaan, jolta ne tulivat.

Jokainen paikka näyttää omat puhelunsa, keskiarvon sijainti (MOS, 5: yli 4 on hyvä, alle 3.6 kuulostaa huonolta), äänipakettien osuuden, joka ei koskaan saapunut, ja jitterin (epätasaisen viiveen). Sen alapuolella BitVoice kertoo, mitä on vialla yksinkertaisilla sanoilla, esimerkiksi "Pakettihävikki pääkonttorin verkkoon: 3,2 % äänestä ei saapunut, pääosin klo 14:00 ja 16:00 välisenä aikana", ja mitä tarkastaa. Palkkikaavio näyttää hävikin äänen tunnin mukaan.

The diagnosis compares the two halves of the same calls: the sound from the site's phones and the sound from the provider the same calls went through. When the other half arrived clean, the loss is on this place's side, and it says so; when both halves lost sound, the place is not to blame alone and it points at what the calls share, this system's own internet link. If every place loses sound at once, the cause is likewise what they share. How this was worked out lists the reasons, step by step (the call-quality rulebook, see Security (luku 60), "How BitVoice decides"). Places with fewer than three calls are not judged. Per-call quality is also in Call history (luku 47) (the Quality column) and, while calls are live, on Live calls (luku 46).

Puhelu, joka yhdistyi, mutta ei saanut mitään ääntä toisesta puolesta, lasketaan erikseen ilman ääntä ja asetetaan ensin: se ei ole huono ääni, vaan ääni, joka ei koskaan saapunut, lähes aina palomuuri tai NAT-reititin, joka päästää SIP:n läpi ja pitää median ulkopuolella. Paikan neuvonta kertoo, mitä tarkastaa (tarjoajan media-osoitealueet).

Kustannukset ja budjetit

BitVoice hinnoittelee jokaisen puhelun sen mukaan, mitä tarjoajasi veloittaa, ja näyttää kuun kulut toimialoittain, henkilökohtaisesti ja trunkoittain, kalleimmat puhelut mukaan lukien.

Hinnat

Puhelureitit (luku 7), avaa puhelureitti ja sen Puheluhinnat. Jokainen hinta kattaa numeroita, jotka alkavat tiettyjen numeroiden kanssa, kuten numero lähetetään tarjoajalle (vain numeroita, joten 44 Iso-Britanniaa varten, 1900 US:n premium-hintaa varten); pisimmän vastineen voittaa, ja hinta ilman numeroita kattaa jokaisen muun numeron. Anna hinta minuutille, mahdollinen vastattu puhelumaksu, laskutusaskel (60 sekuntia kokonaisille minuuteille, 6 tai 1 hienommalle) ja mahdollinen vähimmäismäärä. Saapuvat puhelut, minuutti on toll-free-numeroille, joita maksat vastaanottaa. Mikä olisi kustannus tarkistaa numeron ennen kuin kukaan soittaa sitä. Valuutta asetetaan Kustannuksissa.

Puhelun kustannus on kiinteä, kun se päättyy, ajan hintojen mukaan; hinnan muuttaminen ei muuta aiempia puheluita. Kustannukset kertoo, kuinka monta vastattua puhelua ulospäin ei ollut hinnalla.

Toimialat ja budjetit

Anna laajennuksille Toimiala (laajennuksessa). Kustannuksissa, lisää budjetti jokaiselle puhelulle tai yhdelle toimialalle: hälytys ilmestyy BitVoiceen ja lähetetään budjetin osoitteeseen ja hälytysosoitteeseen 80 %:ssa ja uudelleen 100 %:ssa kuukauden aikana.

Hälytys

Puheluiden ulospäin kustannus ylittää tämän tunnissa aiheuttaa hälytyksen, kun puhelut ulospäin ylittävät kyseisen määrän tunnissa. Äkillinen kallisten puheluiden sarja on tyypillisesti merkki huijauspuheluista (varastetusta puhelin salasanasta): tarkista Puheluhistoria, sitten poista laajennus tai puhelureitti.

Soittajan tunnisteen maine ja brändättyjä puheluita

Puhelinoperaattorit pyörittävät roskapostisuodattimia, jotka voivat merkitä yrityksen numeron "Roskaposti todennäköisesti", tai estää sen, ja silloin harva vastaa. Soittajan tunnisteen maine seuraa jokaista numeroa, josta soitat ulospäin, omista puheluistasi, ja kertoo yksinkertaisilla sanoilla, miten se sujuu:

• Vastattu: vastattujen puheluiden osuus ja mitä se oli edellisellä kaudella. Lasku puoleen tai alle 20% on yleensä merkki uudesta merkinnästä.
• Lopetettu heti: vastatut puhelut, jotka loppuivat 10 sekunnin kuluessa.
• Hylätty roskapostina: puhelut, joita operaattorin suodatin hylkäsi (SIP 608) tai jotka henkilö merkitsi ei-toivottaviksi (607). Yksi 608 tarkoittaa, että numero on merkitty.
• Raskas käyttö: yli 150 puhelua päivässä yhdestä numerosta on sitä, mitä robokutsujat tekevät, ja suodattimet huomaavat.

Numerot, joilla on vähemmän kuin 20 puhelua, näytetään liian vähäisiksi arvioitaviksi.

Lähtevien numeroiden asetukset antaa jokaiselle numerolle nimen (joka lähetetään soittajan nimenä), syy soittamiselle ja logon (https://-kuva). Trunkissa, jossa on Lähetä brändätty soittajan ID käytössä, logo ja syy lähetetään rikkaana soittotietona (RFC 9796 Call-Info); operaattorit, jotka tukevat brändättyä soittamista, näyttävät ne vastaanotetussa puhelimessa. Useimmat puhelimet näyttävät nimen caller-name (CNAM) -tietokannasta, jonka tarjoajasi asettaa: pyydä heiltä. Valvonta asettaa varoituksen Health-terveyteen, kun valvottu numero alkaa näyttää olevan merkitty.

Sivu kertoo myös, mitä tehdä, kun numero on merkitty.

Roskapuheluiden suojaus ja STIR/SHAKEN

Yhdysvalloissa ja Kanadassa puhelun aloittava operaattori allekirjoittaa soittajan numeron (STIR/SHAKEN): A, kun se tietää, että soittaja voi käyttää numeroa, B, kun se tietää soittajan, mutta ei numeroa, C, kun se vain välitti puhelun. Puhelinoperaattorisi kertoo joko BitVoicelle sen tuloksen (verstat) tai välittää allekirjoitetun Identity-otsikkoa, jonka BitVoice tarkistaa itse: allekirjoituksen, sen, että se on alle minuutin vanha, ja sen, että se mainitsee tämän puhelun numerot. Tuloksen näkyy Varmistettu, Osittain varmistettu, Varmistamaton tai Ei varmistettu Live-puhelut-sivulla ja Puheluhistoriassa.

Asetuksissa, Roskapuheluiden suojaus, valitse, mitä tapahtuu, kun soittajan numero epäonnistuu verifioinnissa (soida, soida merkitty, tai hylätä), kun se ei ole verifioitu lainkaan, ja kun numero on salattu. Merkitty puhelu soi Roskapuhelu? (tai omalla merkinnälläsi) ennen soittajan nimeä. Estetyt numerot hylätään; merkintä, joka päättyy *, estää numeroluokan (+1900* on jokainen Yhdysvaltain premium-maksullinen numero). Aina sallitut numerot eivät koskaan hylätä tai merkitä. Puheluhistoriassa estopainike soittajan vieressä lisää heidät luetteloon; hylätyt puhelut on listattu Estetty-merkillä.

Tunnin kuluessa hätäpuhelun saapumisesta miltä tahansa laajennuksesta, ei yhtään puhelua hylätä (hylätyt puhelut soittavat merkittyinä), sillä se voi olla hätäpalvelun puhelu takaisin.

Callers BitVoice does not know

A caller is known when the number is always allowed, in the contacts (luku 38), was called from here in the last year, or passed the robot test in the last 90 days. Numbers are matched however they are written (with or without the country code, 1, 0 or +). Under Callers BitVoice does not know, choose what happens to everyone else:

Robottitestin tarvitsee äänet: Äänet (luku 20) -valikossa, äänitä tai tee (puhepalvelun avulla) suodatus -ohjeet ja numerot 1-9 soittajien kielellä. Niitä ei ole äänitetty, ne tulevat normaalisti (soittaja ei voi läpäistä testiä, jota hän ei kuule), ja Terveys ilmoittaa siitä. Soittaja, joka läpäisee testin, luetaan tunnetuksi 90 päiväksi. Testi vastaa puheluun, joten soittajan operaattori alkaa laskuttaa heiltä siitä hetkestä lähtien, kuten mihin tahansa vastattuun puheluun. Puheluhistoria näyttää kunkin puhelun tuloksen (läpäissyt, epäonnistunut, lähetetty) ja miksi -polku kertoo, mitä tapahtui.

Roskapuheluiden tietokanta

BitVoice voi kysyä mainetietopalvelulta arvio unknown-soittajasta ennen kuin puhelu kuuluu. Käytä Nomorobo Twilion kautta täyttää Twilio Lookupin Nomorobo-rospakuorauksella (asenna Nomorobo-liitännäinen Twilio-tiliisi, sitten syötä sen tilinumero ja vahvistusmerkki); mikä tahansa muu palvelu, joka vastaa JSON-muodossa, toimii myös: anna sen osoite muodossa {e164} (+12125550142) tai {number} (kuten palveluntarjoaja on lähettänyt), jossa on sen arvio (Arvio-kenttä, pisteen erottama polku), ja kun se tarkoittaa roskapuhelua (arvosana Roskapuhelu arvosanalla, tosi, tai teksti Tai roskapuhelu, kun teksti on, kuten BLOCK). Valitse, mitä tapahtuu soittajalle, jonka se pitää roskapuheluna: soita merkitty, robotti-testi tai hylätty.

• Nämä palvelut laskuttavat kunkin tiedonhaun. Tunnetut soittajat eivät koskaan haeta, ja jokainen vastaus säilytetään päivän ajan (Säilytä vastaukset).
• Hidas tai rikkinäinen palvelu ei koskaan pidä puhelua: Odota enintään (1,5 sekuntia, ellet muuta sitä) puhelu kuuluu kuin vastaus olisi "ei roskaa".
• Testi kysyy siitä numeroa nyt (ja laskutetaan kuin mikä tahansa tiedonhaku).

Estä viimeisin soittaja

Vastaa halutun puhelun jälkeen näppäile *32* (Toimintokoodit (luku 32)) puhelimesta, jota se soitti: viimeisin ulkopuolinen numero, joka soitti kyseiselle laajakaistalle viimeisen vuorokauden aikana, menee estolistaan, ja puhelin lukee numeron uudelleen. Aina sallittu numero ei estetä, ja puhelin sanoo sen. Kukin on Audit-lokissa, jossa on mainittu, kuka esti sen.

Ehdotettu soittajista

BitVoice lukee viimeksi 30 päivän ulkopuolisia puheluita, joissa numerot soittavat usein ja hylätään heti: kolme puhelua tai enemmän, lähes kaikki niistä kestävät 10 sekuntia tai vähemmän, tai kaksi robotti-testiä epäonnistui, ja koskaan ei ollut oikeaa keskustelua (joku puhuu 30 sekuntia tai kauemmin). Tunnetut numerot jätetään pois. Kukin tulee syyn kanssa; Estä asettaa sen estolistaan, ja Ei roskaa tarkoittaa, että sitä ei koskaan ehdoteta uudelleen. Mitään ei estetä, ennen kuin henkilö sanoo niin.

Todistusten tarkistamiseksi STI-viranomaisia vastaan, liitä heidän todistuksensa STI-viranomaisen todistukset alle; ilman niitä BitVoice tarkistaa, että puhelu allekirjoitettiin todistuksella, jonka se mainitsee, mutta ei sitä, kuka antoi kyseisen todistuksen.

Allekirjoita omat puhelut

Useimmat tarjoajat allekirjoittavat asiakkaidensa puhelut itse. Jos tarjoajasi sallii allekirjoittamisen (tai olet tarjoaja, joka käyttää BitVoicea), käytä Allekirjoita soittajan tunnus -välilehteä trunkissa (Trunkit (luku 7)) ja anna sille STI-varmenne (STI-sertifioinnin myöntäjältä, jossa on palveluntarjoajan kooditunniste) ja sen yksityinen avain (P-256). Jokainen puhelu, joka menee trunkin kautta, sisältää allekirjoitetun Identity-otsikkeen (ES256, kuten SHAKEN vaatii).

• Varmenteen osoite (x5u) on, missä kutsuttu puoli hakee varmenteen. Jätä se tyhjäksi, ja BitVoice julkaisee sen osoitteessa /stir/<trunk>.pem sen julkisella osoitteella (Asetukset), joka on sitten saatavilla internetistä HTTPS:n kautta.
• Todistus: automaattinen antaa A, kun laajennus soittaa yhden tämän järjestelmän numerosta (numero, joka on reititetty sisään, tai soittajan tunnus, joka on asetettu trunkiin tai laajennukseen), B, kun laajennus soittaa jonkin toisen numeron, ja C puheluille, jotka välitetään ulkopuolelta (välitetty soittaja). Tai kiinnitä se A: han, B: han tai C: han.
• Puheluhistoria merkitsee jokaisen allekirjoitetun puhelun allekirjoitettu A, B tai C. Puhelua ei koskaan estetä, koska sitä ei voitu allekirjoittaa; syy on lokissa.

Järjestelmänvalvojat

Järjestelmänvalvojat ovat henkilöt, jotka kirjaavat sisään tähän web-käyttöliittymään. Henkilöstö, joka vain huolehtii omista puheluistaan, käyttää henkilöstöportaalia sen sijaan ja tarvitsee siten ei tiliä täällä (Henkilöstöportaali (luku 33)).

Roolit

Roolin tai salasanan muutos kirjaa henkilön ulos kaikkialta kerran.

Kaksivaiheinen kirjautuminen

Jokainen henkilö ottaa kaksivaiheisen kirjautumisen käyttöön itse: Määritä näyttää avaimen autentikaattoriosoittimeen; avaimen syöttäminen ottaa sen käyttöön. Sen jälkeen kirjautuminen pyytää koodia salasanan lisäksi. Sen poistaminen vaatii salasanan.

Yksinkertainen kirjautuminen

Yksinkertaisella kirjautumisella (Asetukset) henkilöt kirjaavat sisään organisaation tilillä (Microsoft Entra, Google, Okta, mikä tahansa OpenID Connect -palveluntarjoaja), ja tilin luominen tapahtuu ensimmäisellä kerralla. Katso Yksinkertainen kirjautuminen (luku 58).

API-tunnisteet

Ohjelmat (Terraform, skriptit) käyttävät API-tunnisteita salasanan sijaan: ne luodaan täällä, neuvotaan kerran, ja ne voidaan peruuttaa milloin tahansa. Jokainen tunniste on joko järjestelmänvalvoja tai katselija. Tunniste, joka on tehty Nimeää henkilö, jonka puolesta se toimii (CAD:lle), voi lähettää X-BitVoice-On-Behalf-Of -henkilön nimen, ja tallenteet mainitsevat sen henkilön nimen tunnisteen vieressä (112-puhelut (luku 77)).

Yksinkertainen kirjautuminen

Yksinkertainen kirjautuminen sallii henkilöiden kirjautua BitVoiceen heidän työtilillään kautta minkä tahansa OpenID Connect -tarjoajan kautta: Microsoft Entra ID, Google, Okta, Keycloak ja muut. Organisaatiosta poistuminen poistaa heidän pääsynsä myös täältä.

Asetukset

Settings (luku 14) -valikossa Yksinkertainen kirjautuminen:

1. Rekisteröi sovellus tarjoajalle ja anna Ohjaa osoite, joka näkyy täällä.
2. Täytä tarjoajan tiedot asettaa Myöntäjän yleisimmille; kopioi Asiakas-tunnus ja Asiakas-salaus tarjoajalta.
3. Nimeä tarjoajan Ylläpitäjäryhmät ja Katsojaryhmät. Ryhmävaatimus on, mihin tarjoaja asettaa ne (groups, ellet muuta).
4. Vaihtoehtoisesti muuta Painikkeen teksti kirjautumissivulla.
5. Käytä Yksinkertaista kirjautumista.

Toimintaperiaate

• Täällä luodaan tili ensimmäisellä kirjautumiskerralla; ryhmät määrittävät roolin jokaisella kirjautumiskerralla, joten siirtäminen ryhmästä toiseen muuttaa roolia täällä.
• Joku, joka ei kuulu kumpaankaan ryhmään, evätään, ja eväätys on kirjausloissa.
• Myös salasanat sallitaan pois, salasanat toimivat vain tässä tietokoneessa, joten tarjoajan katkos ei koskaan lukitse sinut ulos.

Yrityshanakirja (Active Directory ja LDAP)

BitVoice voi lukea yrityksesi hakemistoa, Active Directorya tai toista LDAP-palvelinta (OpenLDAP, Samba, 389 Directory Server, FreeIPA): ihmiset, joilla on puhelinnumero, muuttuvat laajennuksiksi, hakemiston ryhmät täyttävät soittoalueet, ja ihmiset kirjauduvaat verkkorajapinnan kanssa hakemistosalasanalla. BitVoice vain lukee hakemistoa; se ei koskaan kirjoita siihen.

Yhdistäminen

Settings (luku 14) -valikossa Yrityshanakirja:

1. Valitse Active Directory tai OpenLDAP tai toinen LDAP-palvelin: se asettaa, mitä attribuutteja luetaan (sAMAccountName tai uid kirjautumisnimeksi, displayName tai cn, mail, telephoneNumber). Muuta niitä tarpeen mukaan.
2. Palvelin: ldaps://dc1.example.com (portti 636) tai ldap://... Käynnistä TLS -valinnalla. Selkeä LDAP kieltäytyy, ellei palvelin ole tämä tietokone, koska salasana siirtyy verkon yli salaamattomana. Kun palvelimen varmenne tulee omasta varmennevirastosta, liitä virasto Yrityksen varmennevirasto -kohtaan.
3. Lukutili ja Sen salasana: tili, joka saa lukea henkilöitä ja ryhmiä (reader@example.com Active Directoryssa). Salasana voi olla viittaus salausavainhuoneeseen (Asetukset, Salauseet).
4. Perus-DN: missä henkilöt ja ryhmät ovat (dc=example,dc=com). Mikä henkilöt rajoittaa niitä LDAP-suodattimella; Active Directoryssa poistetut tilit jätetään aina pois.
5. Testi kirjautuu lukutilillä ja lukee kaikki ilman muutoksia: se näyttää, montako henkilöä se löysi, montako niistä on numero ja minkä numeron kunkin saisi.

Puhelinnumerot ja soittoryhmät

• Luo ja päivitä puhelinnumerot -valinnalla jokaiselle numerolliselle henkilölle luodaan puhelinnumero: numeron viimeiset Säilytettävät numerot (4 +1 212 555 0123:n lopusta on 0123; 0 säilyttää kaikki numerot, jotka on silloin oltava 2–8). Uudet puhelinnumerot saavat SIP-salasanan ja vastaajan satunnaisen PIN-koodin; henkilön nimi ja sähköposti tulevat hakemistosta.
• Hakemisto omistaa puhelinnumeron, jonka se loi: numeron, nimen ja sähköpostin seurataan hakemistoa kunkin synkronoinnin yhteydessä. Kaikki muu (laitteet, uudelleenohjaus, vastaajan asetukset) on teidän.
• Käsin luotu puhelinnumero ei koskaan oteta haltuun, ellet se ole kyseisen henkilön nimi tai sähköposti. Kaksi henkilöä samalla numerolla, numero, jota toisen henkilön puhelinnumero jo käyttää, tai väärän pituinen numero näytetään kohtaan Tarkista, eikä niille tehdä muutoksia.
• Sammuta puhelinnumerot, joiden omistajat lähtevät -valinnalla hakemiston luoma puhelinnumero sammutetaan, kun henkilö lähtee, tili poistetaan tai numero menetetään, ja se palautuu, kun henkilö palaa.
• Soittoryhmät täytetään hakemiston ryhmistä: kunkin rivin henkilöryhmän jäsenten puhelinnumerot asetetaan soittoryhmään (Active Directoryssa sisäkkäiset ryhmät lasketaan mukaan). Ryhmä, jolla ei ole ketään puhelinnumeroa, jättää soittoryhmän entiselleen.
• Hakemistoa luetaan joka Lue joka minuutti (60 oletuksena), ja heti Synkronoi nyt -valinnalla. Kunkin synkronoinnin muutokset ovat yksi muutos (luku 61) nimeltä "Yrityshanakirjan synkronointi", joten ne voidaan peruuttaa; viimeisimmän synkronoinnin raportti näkyy painikkeen alla.

Kirjautuminen

Ihmiset kirjautuvat täällä hakemistollaan ja salasanalla -valinnalla kirjautumissivu hyväksyy hakemiston nimet ja salasanat sekä BitVoicen omat tilit:

• Ylläpitäjäryhmien jäsenet kirjautuvat ylläpitäjiksi, Katsojaryhmien jäsenet katsojiksi (ilman katsojaryhmiä kuka tahansa muu hakemistossa). Ryhmät nimetään niiden nimellä (cn) tai DN:llä; Active Directoryssa sisäkkäiset ryhmät lasketaan. Joku, joka ei kuulu mihinkään tällaiseen ryhmään, evätään.
• Tili luodaan täällä ensimmäisellä kirjautumiskerralla, ja sen rooli seuraa ryhmiä jokaisella kirjautumiskerralla. Se ei koskaan ottaa haltuun BitVoice-tiliä, jolla on sama nimi.
• Tyhjä salasana evätään aina (LDAP ottaisi sen muuten anonyyminä kirjautumisena), poistettu tili ei voi kirjautua, ja nimet pakollaan ennen kuin ne pääsevät hakemistoon.
• Kaksivaiheinen kirjautuminen voidaan lisätä näihin tileihin kuten mihin tahansa muuhun tileihin.

Turvallisuus

Internet-puhelinjärjestelmä hyökätään tunneissa: skannausyrittää salasanoja jokaisella SIP-portilla, ja murtunut järjestelmä aiheuttaa maksullisia puheluita. BitVoice on suunniteltu kestämään tätä oletuksena, kerroksittain.

Arvaamisen estäminen

• Osoitteet, jotka epäonnistuvat jatkuvasti kirjautumisessa, estetään jonkin aikaa (Asetukset, Suojaus): oletuksena kymmenen epäonnistumista minuutissa estää osoitteen tunniksi. Estetyt osoitteet on lueteltu Turvallisuus (luku 60) -valikossa ja ne voidaan poistaa estosta.
• Luotetut verkkot eivät koskaan estetä: toimiston verkkot.
• SIP-salasanat generoidaan, vähintään 12 merkkiä, yksi kunkin laajennuksen määrä. Puhelin, joka kirjautuu yhtenä laajennuksena, ei voi koskaan rekisteröityä toisena.
• Estetty skannaus ei saa vastausta, joten se ei opi mitään.

Petosten estäminen

• Laajennukset voivat soittaa ulkopuolisiin numeroihin vain, kun sallitaan.
• Maksulliset numerot hylätään, ellei reitti mainitse niitä.
• Maksupetosvartija (alla) arvioi jokaisen maanulkopuolisen puhelun ennen sen tekoa.
• Kustannukset (luku 54) hälyttää budjeteista ja karkaavasta kulutuksesta: useita puheluita yhteen maahan tunnissa.
• Kunkin laajennuksen enimmäismäärä samanaikaisia puheluita on neljä (Asetukset, Suojaus).

Maksupetosvartija

Kytke se päälle Asetukset-valikossa, Maksupetosvartija. Jokainen maanulkopuolinen puhelu (merkinnällä +, 00 tai 011, ja paikat, jotka jakavat +1 Pohjois-Amerikan kanssa, mutta ovat eri maissa, kuten Jamaika, klassinen maksupetoskohde) arvioidaan sitten ennen sen tekoa:

Aina sallitut maat (esim. 44) ja Poikkeukset (laajennus, joka on vapautettu päiväksi, matkalle) poistavat "ensimmäisen puhelun" ja "ulkopuolisen"; ne eivät koskaan vapauta useita puheluita lyhyessä ajassa tai hyökkäystä, koska varastettu salasana näyttää hyväksytyltä. Jos puheluhistoriaa ei voida lukea, vartija ei tiedä, onko puhelu ensimmäinen, ja mitä ei mitata, ei koskaan pidetä turvallisena: se pyytää PIN-koodia. Jokainen arviointi on lueteltu Turvallisuus (luku 60) -valikossa syillään, ja se on puhelun tiedoissa Puheluhistoria (luku 47) -valikossa.

Miten BitVoice päättää

BitVoicen tuomarit (maksupetosvartija, trunkin terveyden tuomari, puhelulaadun diagnosointi ja 911-soittajan sijainnin tarkistus) noudattavat jokaista sääntökirjaa: mitattavia tosiasioita, niiden tukemia johtopäätöksiä, poikkeuksia, jotka kumoavat johtopäätöksen, ja valintoja. Miten BitVoice päättää, Turvallisuus (luku 60) -valikossa, näyttää jokaisen sääntökirjan. Säännöt, joita tuomarit noudattavat:

• Jokainen vastaus tulee syineen: mitä pidettiin, mitä vastustettiin ja mitä kumoitti sen.
• Tuntematon asia on tuntematon, ei koskaan "ei". Kun tuntematon asia voisi muuttaa vastausta, tuomari tekee varovaisen valintansa ja sanoo, mitä se ei voinut mitata.
• "Ei voida määrittää" on vastaus: kun säännöt jättävät tilanteen avoimeksi, tuomari tekee varovaisen valintansa ja sanoo niin.
• Jokainen sääntökirja tarkistetaan jokaisessa yhdistelmässä ennen sen käyttöä (kun BitVoice käynnistyy ja sen testien kautta): ei koskaan kahta valintaa kerran, ja jokainen sääntö on saatavilla. Näyttö näyttää, montako tilannetta kussakin tarkistettiin.

Salaus

• TLS salaa merkinnan (portti 5061), joten salasanat ja numerot eivät ole luettavissa verkkoon.
• SRTP salaa puheluiden äänen; selainpuhelin ja sovellukset käyttävät sitä aina.
• Web-käyttöliittymässä on HTTPS portissa 8443 omalla varmenteella tai asennettavalla varmenteella.

Kuka voi tehdä mitä

• Ylläpitäjät muuttavat kaikkea; katselijat näkevät kaiken, mutta eivät muuta mitään; henkilöstö käyttää portaalissa omia puheluitaan vain.
• Kytke kaksivaiheinen kirjautuminen päälle jokaiselle ylläpitäjälle (Ylläpitäjät (luku 57)): koodi authenticator-sovelluksesta.
• Yksinkertainen kirjautuminen (luku 58) kirjauttaa henkilöt sisään BitVoiceen heidän työtilillään kautta.
• Tarkastusloki merkitsee jokaisen ylläpidollisen toiminnon ja sen tekijän, eikä sitä voida muuttaa.

Muutokset, varmuuskopiot ja tuonti

Jokainen tallennettu muutos on versio: numeroiden, kuka teki sen, milloin, ja yhden rivin yhteenveto. Mitään konfiguraatiosta ei koskaan menetetä.

Vertailu ja palauttaminen

• Mitä muuttui näyttää eron revision ja edellisen revision välillä, kenttä kerrallaan.
• Palauta näyttää, mitä palauttaminen muuttaa ja kysyy ensin. Palauttaminen on itse uusi versio, joten se voidaan myös peruuttaa.

Vie ja tuo

• Vie lataa koko konfiguraation yhtenä tiedostona (salaisuudet pois, ellet pyydä niitä).
• Tuo esikatseli tiedoston muutoksia ennen niiden soveltamista.
• Tuo (luku 68) lukee myös FreePBX- ja Asterisk-konfiguraatiot, 3CX-käyttäjäluettelot ja Ciscon Unified CM, Avayan ja Mitelin CSV-vientit.
• Arkistoi (luku 72) kopioi varmuuskopiot, tallenteet ja vastaajat Amazon S3:en tai Azureen.

Samanaikaiset muutokset

Kaksi ylläpitäjää ei voi yhtaikaa muokata samaa asiaa: toinen tallennus evätään viestillä, joka kehottaa lataamaan uudelleen, ja mitään ei menetetä.

Päivitykset

BitVoice'n päivittäminen on yksi napsautus, ja se on turvallista: se tarkistaa uuden version, asentaa sen vanhan vieressä ja palaa itse vanhaan, jos uusi ei jää käynnissä.

Päivityksen asentaminen

1. Lataa uusi julkaisu ja pura se. Ohjelman vieressä on BioDreamin allekirjoitus: bitvoice.sig tai bitvoice.exe.sig Windowsilla.
2. Päivityksissä (luku 62) lataa ohjelma ja sen .sig -tiedosto.
3. Paina Asenna. Oletusarvoisesti BitVoice odottaa, kunnes ei ole puheluita käynnissä; voit myös asentaa heti.
4. BitVoice käynnistyy uudelleen uudella versiolla. Useiden palvelimien kanssa puhelut, jotka ovat käynnissä, siirretään toiselle palvelimelle ja jatkavat.

Paluu

Edellinen versio säilytetään: Palaa palauttaa siihen yhdellä napsautuksella. Uusi versio, joka ei käynnisty kahdesti tai ei jää käynnissä minuutin ajan, korvataan edellisellä itsestään.

Allekirjoitukset

Jokainen julkaisu v0.1.3:sta lähtien kantaa BioDreamin julkaisuavaimen. Tällainen kokoelma asentaa vain ohjelmia, jotka on allekirjoitettu sillä avaimella: allekirjoittamaton tiedosto, toisen allekirjoittama tai yhdellä byyllä muutettu tiedosto hylätään allekirjoitus ei vastaa -virheellä. Sivu kertoo, onko tämä kokoelma tarkistettu (Vaadittu) tai ei.

Useita palvelimia yhtenä puhelinjärjestelmänä

Kaksi tai useampi BitVoice-palvelin, jotka jakavat yhden PostgreSQL-tietokannan, toimivat yhtenä puhelinjärjestelmänä:

• Puhelu saapuu puhelimeen riippumatta siitä, kummalla palvelimella se on rekisteröity: soitto ryhmiin, jonoihin, siirtoja laajakaistaan ja puhelut tarjoajalinjoilta soittavat puhelimia jokaisella palvelimella.
• Asetukset, jotka on muutettu yhdellä palvelimella, ovat voimassa kaikilla palvelimilla viiden sekunnin kuluessa; käyttäjät, yhteystiedot, puheluhistoria, tallenteiden transkriptiot ja tekstit jaetaan.
• Kiireelliset valot (BLF) näyttävät puhelimia jokaisella palvelimella soittamassa ja kiireellisessä tilassa; pysäköinti -paikat jaetaan, joten puhelu, joka on pysäköity yhdellä palvelimella, voidaan ottaa vastaan toisella palvelimella; kuulutukset tavoittavat puhelimia jokaisella palvelimella; tekstit tavoittavat pöytäpuhelimia, riippumatta siitä, missä ne ovat rekisteröity.
• Jonon agentti, joka on puhelussa yhdellä palvelimella, lasketaan kiireelliseksi muilla palvelimilla, ja tarjoajan linjan kanavien raja-arvo lasketaan kaikilla palvelimilla.
• Aktiiviset puhelut kussakin palvelimessa luetellaan myös muissa palvelimissa olevat puhelut (vain lukuoikeus: lopeta puhelu tai kuuntele sitä palvelimelta, jolla puhelu on).
• Puhelun tallenne kirjoitetaan kerran, palvelimella, jolla soittaja on, ja puhelu tallennetaan myös sinne.

Asetusten määrittäminen

1. Siirrä ensimmäisen palvelimen tiedot PostgreSQL: n tietokantaan: Asetukset, Tietokanta.
2. Käynnistä jokainen muu palvelin samalla tietokannalla: bitvoice -database postgres://… (tai BITVOICE_DATABASE-ympäristömuuttuja). Se liittyy heti; Palvelimet -luettelossa näkyy se.
3. Palvelimet -sivulla tarkista, miten kussakin palvelimessa tavoitetaan (sen osoite ja SIP-portti jaettavassa verkossa), ja anna kullekin palvelimelle nimi. Palvelimet, joilla on jokaisella oma julkisen verkon osoite (pilvipalvelimet, joilla on julkinen IP-osoite, ei jaettu osoite), saavat myös Oman julkisen osoitteen: tarjoajat ja puhelimet ulkopuolella kerrotaan siitä, jotta kun palvelin ottaa puhelun haltuun, tarjoajan ääni seuraa sitä. Jos jätetään tyhjäksi, palvelin käyttää julkista osoitetta Asetuksissa.
4. Kerro puhelimille, miten ne löytävät palvelimet (alla).
5. Tarjoajan linjat (alla).

Miten puhelimet löytävät palvelimet. Puhelimet, jotka BitVoice asettaa (Yealink, Polycom, Grandstream), saavat toimivan palvelimen varalle itsenään. Muille, kuten Snomille ja käsin määritetyille puhelimille, käytetään yhtä seuraavista Palvelimet -sivulla:

• DNS-nimi jokaiselle palvelimelle: nimi, kuten pbx.example.com, jolla on SRV-tietueita (_sip._udp, _sip._tcp, _sips._tcp), jotka luetellaan jokainen palvelin. BitVoice asettaa puhelimille nimen, ja Palvelimet tarkistaa tietueet suorittavien palvelimien vastaan ja luetellaan, mitä puuttuu, ja antaa tietueet luoda valmiiksi, valmiina kopioitavaksi.
• Jaettu osoite: käyttämätön osoite palvelimien verkossa, kuten 192.168.1.50/24. Yksi suorittava palvelin pitää sitä kerran ja kertoo verkolle heti (gratuitous ARP); jos se loppuu, seuraava palvelin ottaa osoitteen haltuunsa sekunnin kuluessa, jatkaa puheluita ja vastaa puheluihin samalla osoitteella ilman, että ne rekisteröityvät uudelleen. Se vaatii Linuxin ja NET_ADMIN- ja NET_RAW-oikeudet (säiliössä: --cap-add NET_ADMIN --cap-add NET_RAW), ja palvelimet samassa verkossa. Käynnistä jokainen palvelin uudelleen asetusten määrittämisen jälkeen.

Tarjoajan linjat. Jokaisessa trunkissa Jaettu palvelimien välillä kertoo, miten:

• Jokainen palvelin käyttää sitä: jokainen palvelin rekisteröityy ja tekee omat puhelunsa. Tarjoajille, jotka sallivat useita rekisteröintejä yhdellä tilillä, tai ei mitään.
• Yksi palvelin kerran: yksi palvelin rekisteröityy ja hallitsee linjan; muut palvelimet näyttävät sen Varalla, pidetään kyseisellä palvelimella ja lähettävät puhelunsa sen kautta. Jos se loppuu, seuraava palvelin rekisteröityy sekunnin kuluessa. Tarjoajille, jotka sallivat yhden rekisteröinnin tilillä.

Kun palvelin loppuu

• Puhelut jatkuvat. Jokainen palvelin pitää muistissaan puhelunsa tietokannassa; kun yksi loppuu, toimiva palvelin ottaa jokaisen puhelun haltuunsa sekunnin kuluessa, siirtää äänen itselleen ja kertoo molemmille osapuolille (uudelleen kutsu). Äänessä on muutaman sekunnin tauko. Suunniteltu lopetus (päivitys, uudelleenkäynnistys) luovuttaa puhelut heti, ilman taukoa.
• Puhelu, jonka puhelin on rekisteröity palvelimella, joka ottaa sen haltuunsa, jatkuu siellä ilman, että se häiritsee puhelinta: vain toinen osapuoli siirretään.
• Sen puhelimet jatkavat toimintaa varapalvelimen, DNS-nimen tai jaetun osoitteen kautta.
• Palvelin, joka vain uudelleenkäynnistyy (päivitys, uudelleenkäynnistys), muistaa edelleen, missä sen omat puhelimet ovat rekisteröity: se pitää ne tiedostossaan (registrations.json), joten puhelut tavoittavat ne ennen kuin ne rekisteröityvät uudelleen.
• Health ja Palvelimet näyttävät sen loppuneena; kun se palaa, se ei ota mitään takaisin palvelimelta, joka otti sen haltuunsa.

Palvelimien välillä. Palvelimet tavoittavat toisensa SIP-portin kautta TCP:llä tai TLS:llä, jos niillä on varmenne (kumpikin hyväksyy vain toisen julkaiseman varmenne, ja ääni niiden välillä salataan SRTP:llä), ja lähettävät äänen toistensa media-portteihin (UDP, asetukset). Palvelimien väliset puhelut allekirjoitetaan jaettavalla salasanalla, ja ne hyväksytään vain käynnissä olevilta jäseniltä omilla osoitteillaan. Palomuurin on sallittava näiden porttien läpikulkeminen.

Kokeile ensin: laboratorio. BitVoice sisältää laboratorion, jossa kaksi palvelinta, tietokanta ja testipuhelimet toimivat yhdellä tietokoneella Dockerin avulla, kunkin omalla osoitteellaan: deploy/lab/run.sh up kokoaa ja käynnistää sen ja asettaa jaetun osoitteen; run.sh call soittaa puhelimien välillä eri palvelimilla; run.sh failover tappaa palvelimen, joka välittää puhelun jaetun osoitteen kautta, ja tarkistaa, jatkuuko puhelu (ääni palaa noin viiden sekunnin kuluttua); run.sh impaired soittaa puhelimen huonosta yhteydestä (viive, jitter ja 5% tappio) ja tarkistaa puhelun laadun, jonka BitVoice raportoi; run.sh down poistaa sen. Palvelinten sivut ovat osoitteessa https://127.0.0.1:18501 ja :18502 (käyttäjä admin).

Missä dataa säilytetään (SQLite tai PostgreSQL)

BitVoice tallentaa asetuksensa ja niiden tallennetut versiot, käyttäjät, yhteystiedot, puheluennätykset, audit-lokin, tekstit, muistiinpanot ja transkriptiot tietokantaan. Tallenteet ja ääniviestit säilytetään äänitiedostoina data-kansiossa.

Tämän palvelimen oma tiedosto (SQLite, oletus): yksittäinen tiedosto, bitvoice.db data-kansiossa, johon ei tarvitse asentaa mitään. Varmuuskopioi data-kansion ja sinulla on kaikki.

PostgreSQL: useille BitVoice-palvelimille, jotka jakavat yhden tietojoukon, tai raportteja varten työkaluissa kuten Power BI, Grafana tai Metabase. Asetuksissa, Tietokanta, Siirrä data PostgreSQL:hen: luo tyhjä tietokanta ja käyttäjä, joka omistaa sen, syötä osoite (postgres://käyttäjä:salasana@isäntä:5432/tietokanta), paina Testi, sitten Kopioi data ja käynnistä uudelleen PostgreSQL:llä. Kaikki data siirretään kerran (kaikki tai ei mitään) ja BitVoice käynnistyy uudelleen siitä; vanha tiedosto säilyy, missä se oli. Siirtäminen takaisin palvelimen omaan tiedostoon toimii samalla tavalla. Siirrot evätään, kun puheluita on kesken.

Palvelimet, jotka jakavat PostgreSQL-tietokannan, näkevät toistensa asetusten muutokset viiden sekunnin kuluessa. Kunkin palvelimen puhelimet ja puhelut toimivat edelleen; toisen palvelimen ottaminen ensimmäisen palvelimen puhelimien haltuun vaatii, että puhelimet tuntevat kummankin osoitteen (tai yhden osoitteen, joka siirtyy).

Tietokanta voidaan myös nimeää, kun BitVoice käynnistyy, -database postgres://… tai BITVOICE_DATABASE-ympäristömuuttuja; se muutetaan siellä, ei Asetuksissa.

Vanhat asennukset: ensimmäisellä käynnistyskerralla BitVoice kopioi vanhat JSON-tiedostonsa tietokantaan ja siirtää ne pre-database-kansioon data-kansiossa.

Muiden organisaatioiden isäntä

Yksi BitVoice voi isännöidä useita organisaatioita. Kunkin organisaation puhelinjärjestelmä on itsenäinen: omat laajennukset, numerot, trunkit, reitit, ylläpitäjät, viestinjärjestelmä, tallenteet ja puheluhistoria. Mikään organisaatio ei voi nähdä toista.

Milloin sitä käytetään

• Palveluntarjoaja tai IT-yritys, joka pyörittää puhelinjärjestelmiä monille pienille asiakkaille yhdellä palvelimella.
• Ryhmä toimistoja tai klinikoita, jotka haluavat erilliset järjestelmät, joita hallinnoidaan erikseen, jaettuun laitteistoon.
• Useat vastaanottopisteet, jotka jakavat yhden järjestelmän, kunkin säilyttäen oman vastaanottajansa ja tallenteensa.

Pääjärjestelmä on myös organisaatio: se, jona tämä palvelin asennettiin.

Organisaation lisääminen

1. Avaa Organisaatiot (luku 65) ja paina Lisää organisaatio.
2. Anna sen nimi ja lyhyt nimi (vain pienet kirjaimet, numerot ja viivat). Lyhyt nimi on osa sen verkkotunnusta, /t/acme/, ja sen puhelinten kirjautumistunnusta, acme.100. Sitä ei voi muuttaa myöhemmin.
3. Anna valinnaisesti sen oma verkkotunnus, kuten pbx.acme.example, joka osoittaa tähän palvelimeen. Puhelimet rekisteröityvät siihen verkkotunnukseen, ja sen ylläpitäjät avaa sen selaimessa.
4. Määritä sen ensimmäinen ylläpitäjä: käyttäjänimi ja salasana, joka on vähintään 12 merkkiä, ja sen maa.
5. Määritä valinnaisesti rajoitukset.

Organisaatio alkaa heti tyhjällä puhelinjärjestelmällä, valmiina sen ylläpitäjän asettamaan käyttöön, kuten kuvattu Käynnistäminen (luku 1).

Miten puhelut löytävät oikean organisaation

Joten kaksi organisaatiota voi molemmat käyttää laajennusta 100, ja useat voivat jakaa yhden tarjoajan tilin eri numeroin.

Missä sen tiedot ovat

SQLite-tietokannassa kunkin organisaation tiedot ovat omassa kansiossa tenants/-kansiosta, omalla tietokantatiedostollaan. PostgreSQL-tietokannassa kunkin organisaation tiedot ovat omassa skeemassa samassa tietokannassa (tenant_acme). Varakopiot, arkistot ja viennit ovat kunkin organisaation mukaan.

Rajoitukset

Rajoituksen arvo 0 tarkoittaa, että rajoitusta ei ole. Hälytyspuhelut eivät koskaan epäonnistu: organisaatio, joka on puhelurajoituksensa täyttänyt tai joka on keskeytetty, voi silti soittaa 911 ja vastaanottaa puhelun.

Organisaation avaaminen

Avaa kirjaa sinut sisään sen verkkorajapintaan tarjoajana, ilman omaa tiliä; se näkyy sen audit-lokissa tarjoajana. Sen ylläpitäjät kirjaavat sisään sen osoitteeseen omilla tileillään. Kunkin organisaation kirjautumistunniste on oma, joten kirjautuminen yhteen organisaatioon ei kirjaa ketään toiseen.

Organisaatiot eivät koskaan näe tätä palvelimen omia näkymiä: päivityksiä, tietokantaa, muiden palvelimien näkymää, varmenne, SIP-jäljitystä (joka näyttää jokaisen organisaation viestit), puhelugeneraattoria tai tätä luetteloa.

Keskittäminen ja poistaminen

Keskittäminen estää kirjautumiset ja kaikki puhelut paitsi hätäpuhelut; mitään ei poisteta. Poista lopettaa organisaation ja siirtää sen kansion sivuun (tenants/.removed-<name>-<time>), joten virhe voidaan korjata käsin.

Koodaukset ja ääni

Koodaus on tapa, jolla ääni muunnetaan tietokoneen tiedoksi puhelussa. Puhelimet, selaimet ja operaattorit tukkivat kunkin koodauksista; BitVoice muuntaa koodauksia, kun kaksi osapuolta eroaa, joten jokainen voi puhua toisilleen. Kun molemmat osapuolet käyttävät samaa koodausta, ääni kulkee muuttumattomana.

Koodaukset

Asetukset listaa koodaukset, joita puhelimet voivat käyttää, parhaat ensin; jokaisella trunkilla voi olla oma lista. Analogisen sovittimen portit käyttävät aina G.711:ää, jota faksit, modeemit ja hälytyspaneeleiden tarvitsevat.

G.722.1, G.722.1C, G.719 ja Codec2 välitetään muuttumattomana kahden osapuolen välillä, jotka molemmat käyttävät niitä, niiden bittinopeuden tai tilan säilyttäen tarjouksessa (BitVoice ei muunna niitä, joten puhelu yhden näistä ja puhelimen välillä, jolla ei ole sitä, käyttää toista koodausta, jonka molemmat osapuolet osaavat). Laita ne listaan G.711:n yläpuolelle, jossa kokousjärjestelmien ja konferenssipuhelimien äänialan tulisi säilyä, kun ne puhuvat toisilleen. Listat nimittävät G.722.1:ä 32 kHz G7221C:ksi, vaikka SDP kutsuu molempia G7221:ksi.

G.723.1 välitetään muuttumattomana kahden osapuolen välillä, jotka molemmat käyttävät sitä. Anna G.723.1-laite puhua minkä tahansa muun laitteen kanssa, käytä Muunna G.723.1 ffmpeg:llä -vaihtoehtoa Asetuksissa ja asenna ffmpeg (apt install ffmpeg, brew install ffmpeg): BitVoice suorittaa ffmpeg:n erillisenä ohjelmana kullekin suunnalle, joka tarvitsee muunnosta (kuullaan kummassakin nopeudessa, lähetetään 6,3 kbit/s:n nopeudella, jonka ffmpeg:n kooderi tekee), noin 60 ms myöhemmin kuin muut koodaukset, ja lopettaa sen muutaman sekunnin kuluttua puhelun päättymisen jälkeen. BitVoice ei sisällä G.723.1-koodia: ITU:n viitekoodi ei sisällä lupaa, joka sallisi sen sisällyttämisen, ja ffmpeg asennetaan ja suoritetaan erikseen.

Mitä muunnos maksaa

Muunnos vie prosessoriaikaa vain puheluilla, joilla kaksi puolta poikkeavat. Puhelua kohden noin 0,3 ms yhden ydin 20 ms:lle Opusille ja 0,12 ms G.729:lle (jotkut 60 ja 170 muunnettuja puhelua yhtä ydintä kohden); G.726 ja GSM maksavat vähemmän kuin G.729; G.711 ja G.722 melkein mitään. G.729 lähetetään ilman liitettä B (ei hiljaisuuskehyksiä).

Äänen puhdistus

Äänen puhdistus (Asetukset) vaimentaa tasaisen taustamelun ja tasoittaa tasot, viestilaatikolle ja, jos haluat, puhelun aikana.

Microsoft Teams (Direct Routing)

BitVoice voidaan olla istunnon reunaohjain (SBC) Microsoft Teams -vuokralaiselle, jotta Teams-käyttäjät voivat soittaa BitVoice-laajennuksia ja puhelinlinjoja, ja BitVoice soittaa Teams-käyttäjiä.

Mitä tarvitset: julkisen nimen tälle palvelimelle verkkotunnuksessa, jonka Microsoft 365 -vuokralaisesi on vahvistanut (sbc.esimerkki.com), avoin portti 5061 molempiin suuntiin Microsoftin verkkoihin 52.112.0.0/14 ja 52.120.0.0/14, ja varmenne kyseiselle nimelle julkiselta viranomaiselta. Teams-käyttäjien tarvitsee puhelinjärjestelmän lisenssi.

Vaiheet

1. Asetukset, Varmenne: asenna varmenne ja sen yksityinen avain (PEM). Sitä käytetään heti, tähän rajapintaan ja SIP-yhteyksiin TLS:än kautta, ja BitVoice esittää sen Microsoftille.
2. Trunkit, Lisää, aloita Microsoft Teams: syötä palvelimen julkisen nimen. Vetolaatikko kertoo, onko varmenne voimassa.
3. Kopioi PowerShell-komento, jonka vetolaatikko näyttää, ja suorita se Teams-järjestelmänvalvojana: se lisää SBC:n (New-CsOnlinePSTNGateway), äänireitin ja käytännön, ja numerosuunnitelman, jotta lyhyet laajennusnumerot saapuvat BitVoiceiin niin kuin ne on näppäilty; sitten anna kullekin Teams-käyttäjälle käytäntö ja heidän numeronsa.
4. Soittaaksesi Teams-käyttäjiä BitVoicesta, lisää lähtevä reitti heidän numeroilleen Teams-trunkin kautta. Teams löytää käyttäjiään vain numeroilla, joissa on + ja maakoodi: jos ihmiset näppäilevät niitä ilman, lisää + ja maakoodi reitin Esilaita-kenttään (puhelun syy-ura kertoo sen, kun yksi menee ulos ilman)

Kun Teams-käyttäjä siirtää puhelun, Microsoft pyytää BitVoicea asettamaan sen (REFER, jossa on oma välittäjä, numerolla tai Teams-käyttäjän ID:llä): BitVoice soittaa takaisin täsmälleen sen, mitä Microsoft nimesi, Referred-By-kentän arvolla, jota Microsoft antoi, joten siirto toiseen Teams-käyttäjään toimii yhtä hyvin kuin siirto puhelinnumeroon. BitVoice ei lähetä koskaan Teamsille Replaces-otsikkoa, jota Microsoft hylkää.

BitVoice lähettää Microsoftille OPTIONS-kyselyjä joka minuutti, joissa on SBC-nimi Contact-kentässä, kuten Microsoft vaatii, ja yrittää sip, sip2 ja sip3.pstnhub.microsoft.com -osoitteita vuorotellen. Media on aina salattu (SRTP). Terveys varoittaa, kun varmenne ei kata nimeä, on itse allekirjoitettu tai päättyy pian, ja kun Microsoft lopettaa vastaamisen.

Tämä noudattaa Microsoftin julkaisemia SBC-vaatimuksia ja on testattu simuloituun Microsoft-välittäjään; BitVoice ei ole Microsoftin luettelossa sertifioituja SBC:itä.

Tuo

Tuo laajennukset, soittoalueet, jonot ja trunkit yli FreePBX:stä, Asteriskista tai 3CX:stä; ja henkilöt, metsästys- ja soittoalueet, SIP-trunkit, saapuvat numerot ja numeromallit Cisco, Avaya ja Mitel. Lataa viennit, useita kerralla (myös .zip- tai .tar-pakkaus toimii); BitVoice näyttää tarkalleen, mitä muutoksia tapahtuu ennen kuin mitään sovelletaan, ja tuonti muodostuu revision, jonka voit perua Muutokset (luku 61)-sivulla.

Siirtyminen FreePBX:stä

Paras tiedosto on FreePBX-väylä: se sisältää kaiken, myös SIP-salasanat.

1. FreePBX:ssä: Admin → Varmuuskopio ja palautus → Lisää varmuuskopio. Valitse vähintään Core, Soittoryhmät, Jonot ja Ääniviestit (kaikki moduulit on ok), tallenna ja Suorita.
2. Lataa varmuuskopio riviltä (tiedoston nimi on esim. 20261001-100000-1790000000-17.0.19-1234567.tar.gz).
3. Asenna BitVoice uudelle palvelimelle ja tee asennus valmiiksi yhdellä FreePBX:n käyttämättömällä laajennuksella (esim. 199) ja ilman puhelinlinjoja: tuonti tuo linjat mukanaan.
4. Tuonti (luku 68)-sivulla pudota .tar.gz-tiedosto sellaisenaan. Lue esikatselu: varoitusluettelossa on kaikki, mitä ei voida tuoda.
5. Valitse Lisää. Se on yksi versio Muutokset (luku 61)-sivulla: peru se sieltä, jos jotain näyttää väärältä, ja tuonti uudelleen.
6. Siirrä puhelimet: osoita kunkin BitVoiceen (tai määritä ne Puhelimet (luku 4)-sivulta), samalla laajennusnumerolla ja SIP-salasanalla, joita ne aiemmin käyttivät.
7. Testaa puheluita sisään ja ulos, ja siirrä viimeiseksi operaattorin rekisteröinti (tai numeron siirto).

Kokeiltu oikealla järjestelmällä: FreePBX 17.0.33 (virallinen Debian 12 -asennus) neljällä laajennuksella ja vastapuhelulla, PJSIP-trunkilla, joka rekisteröityy, kahdella ulospäin menevällä reitillä (yksi esivalinnalla), soittoalueella, jonossa, jossa on rangaistukset ja kolme DIDIä, varmuuskopioitu Varmuuskopio ja palautus -toiminnolla, jossa on valittu kaikki moduulit. Varmuuskopio on 70 Mt, lähes kaikki äänitiedostoja ja puheluhistoriaa: BitVoice lukee sen, kun se tulee, ja pitää ainoastaan määritykset, joten varmuuskopion koko voi olla enintään 512 Mt. Kaikki yllä mainittu tuli mukana: salasanat, vastapuhelun PIN-koodit ja sähköposti, trunkin rekisteröinti ja koodaukset, reitit esivalinnoilla, soittoalueen vastapuhelu, kun se ei vastaa, jonon rangaistukset ja DIDI:t ryhmään, jonoon ja laajennukseen, laajennukseen.

Mitä tulee mukana:

• Laajennukset: numero, nimi, ulospäin menevän puhelun näyttö, soittoajan ja SIP-salasana (BitVoice luo uuden, kun FreePBX:n on lyhyempi kuin 12 merkkiä: syötä se uudelleen puhelimeen). Vastapuhelu sen PIN-koodilla ja sähköpostiosoitteella (ja sen, ovatko viestit liitettyinä).
• Trunkit: PJSIP- ja chan_sip -operaattoritilien tiedot: palvelin, portti, käyttäjänimi, salasana, rekisteröinti, mistä alueesta, koodaukset, puhelun näyttö, kanavien raja. Sammutetut trunkit pysyvät pois käytöstä. DAHDI-trunkit muuttuvat Telefony-kortin trunkiksi.
• Ulos menevät reitit, FreePBX:n järjestyksessä: kunkin mallin esivalinta muuttuu pudotetuiksi numeroiksi, esimallin numerot lisätään. Reitti, jonka mallit pudottavat tai lisäävät eri numeroita, muuttuu yhdeksi BitVoice-reitiksi kullekin.
• Soittoalueet: jäsenet, soittoajan, kaikkien soitto tai yksi toisensa jälkeen (metsästys, muistiinpanojen metsästys, ensimmäinen saatavilla), ja mihin vastaamattomat puhelut menevät.
• Jonot: jäsenet rangaistuksineen, strategia (soita kaikille, vähiten äskettäin, vähiten puheluita, pyöreä, lineaarinen, satunnainen), soittoajan, lopetusajan ja pisin odotusaika.
• Saapuvat reitit: kunkin DIDI:n laajennukseen, soittoalueeseen, jonoon, vastapuheluun, tai lopetus.

What does not, and is said in the preview: IVRs, time conditions, announcements, follow-me, custom trunks and contexts, caller-ID matching on routes, and outside numbers in ring groups. Build those on Menus (luku 21), Schedules (luku 26) and the extension's Follow me. Older backups (FreePBX 13 and before) and a plain mysqldump asterisk of the FreePBX database are read the same way.

Muut järjestelmät

Jokainen vienti on:

• FreePBX (vain laajennukset): Admin → Bulk Handler → Export → Laajennukset (CSV).
• Asterisk: pjsip.conf tai sip.conf.
• 3CX: Käyttäjät → Vienti (CSV).
• Cisco Unified CM: Bulk Administration → Puhelimet → Vienti puhelimista, kaikki tiedot; tai Käyttäjät → Vienti käyttäjistä. Puhelimen ensimmäinen linja tulee laajennukseksi, linjan hälytysnimi tai merkintä sen nimenä.
• Avaya IP Office: Manager → Tiedosto → Tuonti/Vienti → Vienti, Käyttäjät.
• Avaya Communication Manager: list station tallennettuna CSV-muodossa; virtuaaliset asemat ja VDN:t jätetään pois.
• Mitel MiVoice Business: Järjestelmätiedot → Käyttäjä- ja laitteiden konfiguraatio → Vienti.

Ryhmät ja reitit. Lataa ne yhdessä henkilöstötiedoston kanssa, jotta jokaisen ryhmän jäsenet voidaan löytää numeron tai nimen perusteella:

• Cisco Unified CM: Bulk Administration → Tuonti/Vienti → Vienti, valitsemalla Line Group, Hunt List, Hunt Pilot, SIP Trunk ja Route Pattern; lataa .tar-tiedosto sellaisenaan. Jokainen metsästyspilotti tulee soittoryhmäksi, jonka jäsenet ovat metsästyslistan linjaryhmien jäseniä, Top Down ja Circular yksi toisensa jälkeen, Broadcast kaikki yhtä aikaa, RNA-palautusajan soittoajan. Reitit tulevat ulospäin meneviksi reiteiksi: 9.[2-9]XXXXXX PreDot-kuviolla 9[2-9]XXXXXX pudottaa 9; ! tulee loppupisteksi. Kuviot, jotka käyttävät @ (kansallista suunnitelmaa), on lueteltu kirjoittamista varten.
• Avaya IP Office: Vienti metsästysryhmänä sekä Käyttäjät (molemmat ovat CSV-muodossa ilman otsariviä). Ryhmän tila on kaikki yhtä aikaa; Metsästys, Kierto ja Pisin odottelu soittavat yksitellen.
• Avaya Communication Manager: list hunt-group tallennettuna CSV-muodossa, jonka jäsenet ovat Jäsenet-sarakkeessa tai erillisessä jäsenten tiedostossa.
• Mitel MiVoice Business: Soitto- ja soitto- ja ryhmätehtävät (Cascade on yksi toisensa jälkeen, Ring All kaikki yhtä aikaa), ja metsästysryhmät.

Nämä vientitulokset tulevat pois kytkettyinä ja ilman salasanoja, koska vienti ei sisällä niitä. Reitit menevät ulos tuodun saman nimisen trunkin kautta; reitti, jonka trunkia ei ole täällä, jää pois ja ilmoitetaan. Kierron ja pisimmän odottelun soitto on lähempänä jonotuskuin soitto-ryhmää: esikatselu kertoo siitä, jotta voit tehdä siitä jonotuskuin.

Nämä vientitiedostot (kaikki paitsi FreePBX-varamuisti) eivät sisällä SIP-salasanoja, joten kullekin laajennukselle annetaan uusi salasana; viestilaatikkojen PIN-koodit, nimet ja sähköpostiosoitteet tulevat yli, kun vienti sisältää ne. Cisco-, Avaya H.323/DCP- ja Mitel-puhelimet suorittavat valmistajansa ohjelmistoa eivätkä voida asettaa BitVoice-konfiguraatioksi: tuonti kertoo, kuinka monta niitä luettiin. Cisco-puhelimet voidaan päivittää Cisco:n monialustan (SIP) ohjelmistolla; Avaya J100- ja Mitel 6800/6900-puhelimet voivat rekisteröityä BitVoiceen käsin SIP-tilassa.

Konfiguraatio koodina

Kaikki, mitä näytöt tekevät, menevät BitVoice'n REST API:n kautta, joten mitä tahansa voidaan skriptata, pitää Gitissä tai hallita Terraformilla. API on kuvattu työkaluille osoitteessa /api/openapi.json (/api/openapi.json).

API-tunnukset

Luo Ylläpitäjät (luku 57): yksi ohjelmaa kohden, vain luku- tai muokkausoikeudet. Lähetä se muodossa Authorization: Bearer bv_.... Se näytetään kerran; peruuta se, kun se ei ole enää tarpeen. Tunnisteen muutokset näkyvät Muutoksissa ja audit-lokissa sen nimen alla.

curl -H "Authorization: Bearer bv_..." https://pbx.example.com/api/extensions

Terraform tai OpenTofu

Repositoryn deploy/terraform näyttää laajennukset, soittoalueet ja reitit, jotka hallitaan yleisellä REST-toimittajalla: suunnitelma näyttää, mitä muutoksia tehtäisiin, ja soveltaminen tekee muutoksen. Toimittaja tarkistaa BitVoice'n varmenne; kun BitVoice vielä käyttää omaa itse allekirjoitettua varmennetta, hae se joko Let's Encryptistä (Asetukset, Varmenne) tai aseta bitvoice_insecure = true luotettavalle verkkoon (Linuxilla SSL_CERT_FILE osoittaa BitVoice'n varmennetta). Resurssit ovat vastakkain id:n mukaan, jonka BitVoice antaa niille, joten toinen suunnitelma ei näytä muutoksia, kunnes tiedosto tai näytöt muuttavat jotain.

Konfiguraatio Gitistä

Asetuksissa (luku 14) Konfiguraatio Gitistä BitVoice lukee konfiguraation tiedostosta repositorysta joka muutaman minuutin välein ja joko näyttää, mitä poikkeaa, tai tekee muutokset. Aloita tiedosto Vie Gitille, joka jättää salasanat pois; BitVoice pitää omat salasanat, joten salaisuudet eivät mene koskaan repositoryyn.

Asterisk-yhteensopivuus (AMI, ARI ja AGI)

Asteriskille kirjoitettuja työkaluja voidaan käyttää BitVoicen hallintaan: CRM, seinätaulut, klikkaa-puhelu-napit, puhelun tallentajien ohjaimet. Käytä sitä Settings (luku 14) -valikossa, Asterisk-yhteensopivuus. Työkalut näkevät puhelut kanavina, joilla on nimet kuten PJSIP/100-..., kuten Asteriskissa.

AMI

Hallintaliittymä TCP-portissa 5038 (AMI kuuntelee: oletuksena vain tämä tietokone). Tuettu:

Suodatin pitää vain tapahtumat, jotka vastaavat säännöllistä lauseketta (Event: Newchannel), tai hylkää ne !-merkillä ensin, kuten Asteriskissa. Asteriskissa ei ole komentoriviä: Komento vastaa virheellä.

ARI

Osoitteessa /ari/, perusautentikaatiolla tai ?api_key=user:secret:

Ulkoinen media-kanava, jota ei ole lisätty puheluun minuutin kuluessa, suljetaan.

ARI-sovellukset

ARI-sovellus (Asteriskin Stasis()) ajaa puheluita omasta ohjelmastasi. Lisää se ARI-sovellukset-kohtaan Asetuksissa, Asterisk-yhteensopivuus: nimi, valinnainen numero-laajennus, jota sovelletaan, ja väli-sovellus. Sitten lähetä puhelut siihen kohdistimen, valikonavan, aikataulun kautta.

Ohjelmasi muodostaa yhteyden osoitteeseen /ari/events?app=NAME (WebSocket, kirjautumisella ?api_key=user:secret). Jokainen sovellukseen tuleva puhelu vastaanotetaan ja saapuu StasisStart-tapahtumana, kanavalla; ohjelma ajaa sen sitten:

BitVoice vastaa jokaiseen Asteriskin julkaisemaan ARI-kutsuun (sen testisarja kutsuu kunkin niistä ja tarkistaa, mitä takaisin tulee, ja tarkistaa, että siinä on Asteriskin kuvausvaatimusten mukaiset kentät). Joillakin niistä ei ole täällä mitään tekemistä, ja ne vastaavat 501 syystä: lataukset moduulit (BitVoice on yksi ohjelma), Sorceryn dynaaminen konfiguraatio (BitVoice on määritelty sen verkkokäyttöliittymässä), lokikanavat, siltojen videosyötöt (ARI-sillat kantavat ääntä), puhelinten REFER-lähetys ja broadcast-puhelujen väittäminen. Kuuntelija kuulee vain soittajan (spy=in), ja whisperia ei tarjota: siltaa kanava heidän kanssaan puhuaksesi heille. Kaikkien puhelujen kanava-tapahtumat (ChannelCreated, ChannelStateChange, ChannelDestroyed) menevät jokaiselle ohjelmalle, kuten Asteriskin subscribeAll=true. ARI-kirjastot, jotka lukevat rajapinnan palvelimelta (ari-client ja muut), löytävät sen osoitteesta /ari/api-docs/resources.json. Mikä ohjelma pitää nyt, ARI-sovellusten alla Asetuksissa, näyttää sovellukset, mukautetut laitteen tilat, postilaatikot, globaalit muuttujat ja sillat, joita ohjelmat ovat asettaneet.

Näppäimistön näppäinten painallukset saapuvat ChannelDtmfReceived-muodossa; puhelimen lopettaminen StasisEnd-muodossa. Kun ohjelmaa ei ole liitetty, puhelu menee oletusarvoon; kun ohjelman viimeinen yhteys sulkeutuu, sen puhelut menevät sinne myös viiden sekunnin kuluttua (yhteyden uudelleenmuodostamiseen). Ohjelmatta logiikkaa varten käytä Skriptejä (luku 27), jotka suorittavat koko puhelun; äänen siirtämiseksi ohjelmalle, Ääniboteja (luku 24).

AGI-skriptit

AGI-skripti (Asteriskin AGI() ja EAGI()) suorittaa puhelutoimintoja yksitellen, joten Asteriskille kirjoitetut IVR:t ja integraatiot (phpagi, pyst2, Asterisk-Java, mikä tahansa FastAGI-palvelin) toimivat edelleen. Lisää se AGI-skripteihin Asetuksissa, Asterisk-yhteensopivuus:

Testi yhdistää palvelimeen (tai tarkistaa, onko ohjelma siellä ja suoritettavissa) ilman puhelun lähettämistä. Lähetä sitten puhelut sille kuin mihin tahansa kohteeseen.

BitVoice vastaa puheluun, lähettää agi_-muuttujat (agi_network_script, agi_callerid, agi_dnid, agi_extension, agi_language …) ja suorittaa komennot, vastaten Asterisk 20:n tavoin (testisarja vertaa jokaista vastausta Asteriskin nauhoitettuun vastaukseen):

BitVoicella ei ole laajennusohjelmaa: mihin skripti menisi Asteriskin laajennusohjelmassa (SET EXTENSION, EXEC Goto), sinne puhelu menee, kun skripti loppuu (laajennus, soittoryhmä, jono, valikko tai ulkoinen numero ulosmenorakenteiden kautta). Skriptit eivät koskaan soita hätänumeroita. Kun soittaja lopettaa puhelun, FastAGI-skripti saa HANGUP:n ja ohjelma SIGHUP:n; vain sille kanavalle sallitut komennot suoritetaan (511 muille), ja yhteys sulkeutuu 30 sekunnin kuluttua, jos skripti jatkuu. Kunkin suorituksen näytetään Viimeisimmät suoritukset alla VERBOSE-rivit, ja se menee tapahtumavirran mukana agi.ran:na.

Sounds for AGI scripts. Scripts play sounds by the names they use on Asterisk: upload them under Sounds for AGI scripts with a folder (custom/welcome; es/custom/welcome for callers in Spanish). WAV, MP3 and Asterisk's .gsm, .ulaw, .alaw, .sln and .sln16 are taken; a path like /var/lib/asterisk/sounds/en/custom/welcome.gsm finds custom/welcome. Asterisk's digits/0–digits/9, beep, silence/N and a few others (vm-goodbye, invalid, please-hold) play BitVoice's own prompts and tones. What scripts record is kept in the same library, marked recorded by a script, for the days you choose (30 by default). The library holds up to 1 GB.

Ohjelmat. Ohjelma suoritetaan tämän palvelimen oikeuksilla BitVoicen kanssa, joten se ei koskaan ladata verkon kautta: kopioi se AGI-ohjelmat -kansioon, joka näkyy ruudulla (DATA/agi-bin) ja tee siitä suoritettava. Se saa vain PATH ja AST_AGI_DIR ympäristöstä, suoritetaan kyseisessä kansiossa, ja mitä se kirjoittaa virheen normaaliin ulostuloon, menee palvelimen lokitiedostoon. FastAGI lähettää komennot selkeässä TCP:ssä: pidä palvelin tässä tietokoneessa tai yksityisverkossa.

Kirjautumiset

Jokaisella kirjautumisella on Käyttäjänimi ja Salasana. Kirjautumiset ovat vain luku -tilassa, ellei niitä ole merkitty Voivat muuttaa puheluita. Pidä AMI tässä tietokoneessa, ellei työkalu suorita muualla: AMI on selkeä, salaamaton TCP.

Älyavustajat (MCP)

Älyavustaja, kuten Claude, ChatGPT, Gemini tai Cursor, voi käyttää BitVoicea Model Context Protocolin (MCP) kautta, joka on standarditapa, jolla avustajat tavoittavat muita ohjelmia. Kysy sitä yksinkertaisilla sanoilla: kuka soitti aamulla ja vastasiko kukaan heille, mitä soittaja hammaslääkärin toimistosta sanoi, miksi kello 9 aikaan soitto meni vastaajaan, onko tarjoajan linja alhaalla. Luvallasi se voi myös tehdä puhelun, lähettää tekstiviestin tai lopettaa puhelun.

BitVoice on MCP-palvelin, osoitteessa https://YOUR-SERVER/mcp (Streamable HTTP; osoite näkyy Asetuksissa). Mitään ei lähetetä mihinkään älypalveluun, ellet ole liittänyt avustajaa, joka pyytää tietoja, ja silloinkin vain sitä, mitä se on pyytänyt.

Käynnistäminen

**Asetukset** (luku 14), AI-apuvälineet (MCP):

• Salli AI-apuvälineiden yhdistäminen: pois päältä oletuksena. Pois päältä, /mcp vastaa vain, että se on pois päältä.
• Salli apuvälineiden toiminta: pois päältä oletuksena. Pois päältä, apuvälineet voivat vain lukea, riippumatta heidän tunnisteestaan. Päällä, apuväline, jonka tunniste voi muuttaa asioita, saa myös työkalut, jotka toimivat.

Kortti näyttää osoitteen ja valmiin asetusten kopioinnin yleisimmille avustajille ja luetellaan kaikki työkalut.

Mitä avustaja voi tehdä

Lukeminen (mikä tahansa tunniste):

• puhelut_nyt: puhelut, jotka ovat parhaillaan käynnissä.
• puheluhistoria: menneet puhelut, haettavissa numeron tai nimen mukaan, suunnan mukaan ja ajankohdan mukaan, ja miksi kunkin puhelu meni sinne, mihin se meni.
• laajennukset: nimet, numerot, osastot, sähköposti; ei koskaan puhelimen salasanaa.
• puhelimet_liitetyt: mitkä puhelimet ovat rekisteröityneet, mistä ne ovat.
• vastaaja, hae_transkriptit: viestit ja mitä puheltiin tallennetuissa puheluissa.
• jonot, trunkit, terveys: jonot nyt, tarjoajan linjat, BitVoicein omat tarkastukset.
• hakemisto, tekstiviestit: yrityksen puhelinluettelo ja tekstikonversaatiot.

Toiminta (Anna apulaisille toimia, ja tokeni, joka voi muuttaa asioita):

• place_call: klikkaa puhelua. Laajennuksen puhelin soi ensin; kun joku siellä vastaa, BitVoice soittaa numeron heidän puolestaan, niin kuin he olisivat itse näppäilleet sen, joten heidän reitit, soittajan tunnistus ja rajoitukset pätevät.
• send_text: tekstiviesti yhdestä organisaation tekstausnumeroista.
• hang_up_call: lopettaa meneillään olevan puhelun.

Jokainen työkalu on yksi API:n omista reiteistä, suoritettuna apulaisena: se näkee ja muuttaa täsmälleen sen, mitä sen tokeni saa, ja samat tarkastukset pätevät, ja sen muutokset ovat audit-lokissa sen nimissä. Vastaus on noin 60 000 merkkiä; apulaiselle kerrotaan kapeampi hakusana, kun yksi leikataan.

Liittäminen apulaiseen

Apulaiset, jotka kirjauduva (Claude.ai ja ChatGPT mukautetut liittimet ja muut): lisää liittin BitVoicen osoitteella. Apulainen avaa BitVoicen kirjautumissivun selaimessasi; kirjaudu sisään normaalisti (salasana, kaksivaiheinen, yksittäinen kirjautuminen), ja sivu kertoo, kuka apulainen pyytää ja minne se palautuu. Hallinnoija voi antaa sille toimia tai Vain lukea; katsojan apulainen lukee vain. Älä salli lähettää sen pois ilman mitään. Sen pääsy on sitten Hallinnoijat (luku 57), API-tunnisteet, AI-apulainen, kirjautunut: se toimii vain /mcp:ssa, ei koskaan muussa API:ssa, kestää tunti kerrallaan ja uusii itsensä enintään 30 päivän ajaksi, jos sitä ei käytetä. Peruuta lopettaa sen heti. Nämä apulaiset tavoittavat BitVoicen omilta palvelimiltaan, joten sille tarvitaan osoite, joka on saatavilla internetistä, ja varmenne, jota ne luottavat (Let's Encrypt, Varmenne (luku 14)).

Apulaiset, joille annetaan token (Claude Code, Cursor, VS Code ja muut työkalut, jotka ottavat osoitteen ja otsikon): luo API-tunniste Hallinnoijat (luku 57):lla, vain lukea, ellei se tarvitse toimia, ja anna se Authorization: Bearer bv_...:

claude mcp add --transport http bitvoice https://pbx.example.com:8443/mcp --header "Authorization: Bearer bv_..."

Apulaiset, jotka käynnistävät ohjelman (Claude Desktop ja muut, jotka ottavat käskyn): BitVoicen ohjelma kantaa siltaa, bitvoice mcp, joka välittää jokaisen viestin palvelimelle HTTPS:llä. Anna sille palvelimen osoite ja token:

{ "mcpServers": { "bitvoice": { "command": "bitvoice", "args": ["mcp", "-url", "https://pbx.example.com:8443"], "env": { "BITVOICE_TOKEN": "bv_..." } } } }

BitVoicen omalla varmenteella (ei viranomaisen myöntämä), silta hylkää sen ja tulostaa sen SHA-256: tarkista, onko se palvelimesi, ja lisää "-pin", "THAT-SHA256" argumentteihin. Vain tämä varmenne hyväksytään sitten.

Turvallista jättää päälle

• Vain tunnisteet: selaimen kirjautuminen BitVoiceiin ei koskaan tavoita /mcp:tä, ja toisen sivun sivu hylätään (Alkuperä), joten verkkosivu ei voi käyttää apulaisen yhteyttä.
• Apulaiset voivat olla väärässä. Anna heille vain-luku-tunniste, ellei heidän tarvitse toimia; kaikki, mitä he tekivät, on audit-lokissa, ja puhelun asettaminen soittaa aina ensin henkilön puhelimen.
• Kirjautuminen OAuth 2.1:llä MCP:n määrittämällä tavalla: apulainen rekisteröi itsensä (julkinen asiakas vain, PKCE:llä), palauttaa vain rekisteröimilleen osoitteille (https, tai http omalle tietokoneelleen), ja koodi on hyvä kerran, minuutin ajan.
• Organisaatio, joka on isännöity toisen BitVoicen, antaa apulaisilleen tunnisteet; kirjautuminen OAuth:lla siellä ei ole vielä kokeiltu.

Arkisto

Arkisto pitää äänitallenteiden, vastapuhelujen ja määritysten kopiot jossain muualla: Amazon S3-bucketissa (tai millä tahansa S3-yhteensopivassa tallennustilassa) tai Azure Blob Storage -kontainerissa. Jos tämän palvelimen levy menetetään, arkistossa on edelleen kopiot.

Asetukset

1. Valitse Arkisto (luku 72), valitse Mihin arkistoida: Amazon S3 tai Azure.
2. S3: Bucket, sen Alue, valinnainen Kansio bucketissa ja Päätepiste (S3-yhteensopiville tallennustoiminnoille), sekä Access key ID ja Salainen pääsyavain. Kopioi käytäntö antaa ainoan tarvittavan käyttöoikeuden, jotta se voidaan liittää käyttäjään tai rooliin.
3. Azure: Container SAS URL kirjoitusoikeudella ja valinnainen Kansio kontainerissa.
4. Valitse, mitä muuta kuin määrityksiä kopioida: Puheluiden tallenteet, Vastapuhelut tai molemmat.

Mitä tapahtuu

BitVoice kopioida uudet tallenteet ja viestit, joita ei ole arkistossa vielä, ja kerran päivässä päivätty kopiointi määrityksistä (config/2026-10-13.json). Sivu näyttää viimeisimmän suorituksen, viimeisimmän onnistuneen ja mahdolliset virheet.

Jotain poistaminen täältä (säilytysajan perusteella tai käsin) ei poista arkiston kopiota: määritä bucketin tai kontainerin omat elinikäisäännöt siitä, kuinka kauan arkisto pitää asioita.

Oikeudelliset pidätykset

Oikeudellinen pidätyksellä säilytetään puhelujen tiedot, tallenteet ja vastaajan viestit, joita asia saattaa tarvita, ja estetään ketään poistamasta niitä, kunnes se vapautetaan. Käytä sitä, kun lakimies pyytää säilyttämään tiedot.

Lisääminen

Paina Lisää Oikeudelliset pidätykset (luku 73):

Kun pidätyksellä on

• Säilytys jättää sen, mitä se kattaa, koskemattomaksi, riippumatta sen iästä.
• Kukaan ei voi poistaa pidätettyä puhelua, tallennetta tai vastaajan viestiä, mukaan lukien ylläpitäjät.
• Pidätetyt puhelut näyttävät lukon Puheluhistoria (luku 47).

Vapauttaminen

Vapauta tekee sen, mitä pidätyksellä säilytettiin, jälleen säilytysasetusten alaiseksi: vanhemmat asiat poistetaan seuraavassa puhdistuksessa. Vapautetut pidätykset säilytetään luettelossa, kertoen, milloin ja kuka vapautti, ja pidätyksien lisääminen ja vapauttaminen on kirjautumislokeissa.

Mitattavat arvot: Prometheus, OpenTelemetry, Grafana, SNMP ja puhelutiedot

Prometheus kerää /metrics-osoitteen verkkotunnukselta. Luo API-tunniste ylläpitäjien alla (katselijan tunniste riittää) ja anna se Prometheusille sen kantajatunnisteena:

scrape_configs:
  - job_name: bitvoice
    scheme: https
    authorization: { credentials: bv_... }
    static_configs: [{ targets: ['pbx.example.com'] }]

Se lukee puhelut, jotka ovat käynnissä (tilan mukaan), puhelut, jotka on päättynyt (suunnan ja lopputuloksen mukaan), puheluajan, rekisteröityneet puhelimet, jokaisen trunkin tilan ja pyöristysajan, odottavat soittajat ja agentit jokaisessa jonossa, vastaanotetut äänipaketit ja menetetyt paketit, puhelulaatujen histogrammin (MOS) ja varatut puhelut. Laskurit nollautuvat, kun BitVoice käynnistetään uudelleen, kuten Prometheus odottaa.

OpenTelemetry: Asetuksissa, Mitattavat arvot, anna kerääjän OTLP/HTTP-osoite (ja otsikko, kuten Kelpoisuus, arvonsa kanssa) saadaksesi samat mittaukset työnnettyä joka minuutti (tai niin usein kuin asetat, 15 sekunnista alkaen). Työnnä nyt tarkistaa tallennetut asetukset.

Grafana-näyttö lataa valmiin näytön: tuominen Grafanaan ja valitse Prometheus-tietolähde.

SNMP

Valvontajärjestelmille, jotka puhuvat SNMP:ä (Zabbix, PRTG, LibreNMS, Nagios, SolarWinds), käytä SNMP-välinettä Asetuksissa. Se vastaa SNMPv2c GET-, GETNEXT- ja GETBULK-kyselyihin, vain luku, UDP-portti 161 (tai toinen, jonka valitset: portti 161 tarvitsee oikeuden avata alhaiset portit Linuxissa), ja vain niiltä verkoilta, jotka luetteloidaan. Valitse yhteisö, joka ei ole julkista tai yksityistä: se on salasana, joka siirtyy verkon yli selkeästi.

Se palvelee standardin mukaisen järjestelmäryhmän (sysDescr, sysUpTime, sysContact, sysName, sysLocation) ja BitVoicen omat arvot perus-OID:n alla: puhelut, jotka ovat käynnissä ja soivat, rekisteröityneet puhelimet, trunkit ylös ja asetettu, odottavat soittajat, puhelut, jotka on päättynyt, puhelu sekunteja, menetetyt paketit, keskimääräinen puhelulaatu, trunkkitaulukko (nimi, ylös tai alas, viive) ja jonotaulukko (odottavat, agentit, vastatut, hylätyt). Lataa BITVOICE-MIB asetusten vieressä valvontasi käyttöön lataamiseksi. BioDream LLC:llä ei ole vielä yritysnumeroa, joten oletusarvoinen perus-OID on Net-SNMP:n kokeellisessa tilassa; aseta se omalle yrityksellesi, jotta se säilyy vakaana.

Ansaitset (SNMPv2) menevät jokaiselle vastaanottajalle, jonka luetteloidaan, kun trunkki menee alas tai tulee takaisin, hälytyspuhelu tehdään tai klusterin palvelin lopettaa vastaamisen. SNMPv3:ta ei vielä tueta.

Puheluennätykset muualla

Lisäksi puheluhistoria, jokainen ennätys voidaan lähettää, kun puhelu päättyy, seuraaviin:

• Syslog (RFC 5424, JSON-muodossa) UDP-, TCP- tai TLS-yhteyden kautta logipalvelimelle tai SIEM:lle.
• Päivittäinen CSV-tiedosto, Asteriskin Master.csv-sarakkeilla, jotta Asteriskille tehtyjen raportointi- ja laskutustyökalujen lukemiseksi. Lataa tiedostot Puheluhistoria (luku 47)-sivun alhaalta. Solut, joita taulukkolaskin suorittaisi kaavoina, kirjoitetaan turvallisesti.
• PostgreSQL-taulu toisessa tietokannassa, joka luodaan ensimmäisen kerran Asteriskin cdr-sarakkeilla (calldate, clid, src, dst, duration, billsec, disposition, uniqueid...) sekä BitVoicen suunnan, trunkin, kustannuksen ja MOS:n. Jokainen puhelu kirjoitetaan kerran.

Lähetä testitietue kokee syslog-palvelimen ja tietokannan tallennetuilla asetuksilla.

Puhelugeneraattori

Puhelugeneraattori tekee oikeita puheluita oikealla äänellä BitVoiceen tietokoneelta: nähdäksesi, montako puhelua palvelin käsittelee ja miten hyvin, tai tarkistamaan muutoksen jälkeen, että puhelut menevät edelleen sinne, mihin ne kuuluvat.

Suorittaminen

Lukeminen tuloksista