Komme i gang

BitVoice er et fullstendig telefon-system i ett program: bytte som telefoner logger inn på, menyene og køene ringere går gjennom, voicemail, opptak, konferanserom, faks og tilkoblinger til telefon-selskaper. Alt settes opp i nettleseren, på skjermene denne håndboken beskriver. Det finnes ingen konfigurasjonsfil å redigere og ingenting annet å installere.

Hva du trenger

• En datamaskin å kjøre det på: en liten kontor-server, en virtuell maskin, en sky-eksempel eller for et første blikk din egen bærbare datamaskin. Linux, macOS og Windows fungerer alle. En Raspberry Pi 4 kjører en liten kontor.
• Telefoner: skrivebords-telefoner fra Yealink, Poly, Grandstream eller Snom settes opp automatisk; enhver annen SIP-telefon eller softphone fungerer med sine egne innstillinger; og hver nettleser er en telefon også.
• En trunk (en konto med et telefon-selskap) for å ringe utenom numre og bli ringt. Du kan starte uten en: utvidelser ringer hverandre og ekko-testen.

Første start

Start BitVoice og åpne adressen den skriver ut (på en skrivebord åpner nettleseren seg selv). Web-grensesnittet er HTTPS bare, på denne datamaskinen også. Til du installerer et sertifikat av din egen (Innstillinger, Sertifikat), bruker BitVoice ett det har laget selv, så nettleseren advarer en gang: velg å fortsette til siden. Oppsettsguiden spør fire ting: organisasjonens navn og land, den første administrator-passord, den første utvidelsen og ditt telefon-selskap hvis du har en. Landet bestemmer nød-numre, tone ringere hører og måten telefon-numre skrives på.

Første time

1. Utvidelser: en per person eller skrivebord. Hver har et nummer og en SIP-passord. Åpne Utvidelser (kapittel 3)
2. Telefoner: koble en skrivebordstelefon, softphone eller nettleser-telefon til hver utvidelse. Åpne Telefoner (kapittel 4)
3. Trunk: ditt telefoniselskapskonto, så du kan ringe utenom numre og motta samtaler. Åpne Trunk (kapittel 7)
4. Samtale-ruting: hvor samtaler fra utenom går (en person, en ring-gruppe, en meny), og hvilken trunk som brukes for utenom-samtaler. Åpne Samtale-ruting (kapittel 8)
5. Helse forteller deg hva som ennå mangler, nødsamtaler først. Åpne Helse (kapittel 13)

Deretter gjør en test-oppringing: fra enhver telefon tast *43, ekko-testen. Du hører deg selv tilbake, hvilket beviser at lyd fungerer begge veier.

Installerer det i ett kommando

På en Linux-server (Ubuntu, Debian, RHEL, Fedora, Alpine med systemd) eller en Mac:

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

På Windows, i PowerShell:

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

Det laster ned den siste utgaven for datamaskinen, sjekker den mot utgavens SHA-256-sum og BioDreams utgave-signatur (med OpenSSL 3, eller ellers med OpenSSHs ssh-keygen, som Windows 10 og 11, macOS og Ubuntu 20.04 har; ssh-keygen sjekker utgaver fra v0.1.14 og oppover), og installerer den som en tjeneste som starter selv:

• Linux: /usr/local/bin/bitvoice, en bitvoice-systembruker, data i /var/lib/bitvoice, systemd-tjenesten bitvoice med web-grensesnittet på port 443. Når ufw eller firewalld er på, åpner den 443, SIP (5060, 5061) og lydportene for samtaler (10000 til 20000 UDP). Den skriver ut adressen for å åpne og innstillingsskoden som hjelpen spør om fra en annen datamaskin.
• macOS: BitVoice i din Applikasjonsmappe (~/Applications/BitVoice.app), startet når du logger inn, web-grensesnittet på port 8443, data i ~/Library/Application Support/BitVoice (åpen bare for deg) og logger i ~/Library/Logs/BitVoice (bitvoice.log, holdt under 10 MB). Åpne BitVoice fra Launchpad eller Spotlight for å nå web-grensesnittet; når den ble stoppet, starter den det igjen. Den kjører under caffeinate, så Macen ikke går i søvn mens BitVoice kjører: en sovende Mac svarer ikke på samtaler, og selv kortvarige vedlikeholdssøvner stopper alt i mange sekunder. Skjermen kan likevel slå av. Kjør manuelt, bruk caffeinate -i -s ./bitvoice for samme.

For en Mac som svarer på samtaler mens ingen er logget inn, installer med sudo (curl -fsSL https://raw.githubusercontent.com/BioDream-LLC/bitvoice/main/deploy/install.sh | sudo sh): da er BitVoice i /Applications, starter med Macen, kjører som en skjult bruker på egen hånd (_bitvoice), betjener web-grensesnittet på port 443, holder dataene i /Library/Application Support/BitVoice og loggene i /Library/Logs/BitVoice, og Macens brannmur, når den er på, lar den akseptere forbindelser. En av de to per Mac: installatoren nekter den andre mens en er der. Når Macens brannmur er på, spør en BitVoice installert for deg om den kan akseptere inngående forbindelser: tillat det, så telefoner kan koble til. Hvis noe allerede bruker porten, navngir installatoren det og stopper (velg en annen med BITVOICE_HTTPS=:8444). sh install.sh --uninstall (med sudo for Macens egen) fjerner den og holder dataene; --purge fjerner dataene og loggene også. Prøvd på macOS 26 (Apple-silikon), installert for en person: installert, signatur sjekket med Macens egen ssh-keygen, en andre start på samme data nektet, tilbake etter programmet ble drept, startet igjen fra appen, oppgradert på plass, et manipulert program nektet, en port i bruk nektet, avinstallert og beholdt dataene, reinstallert på dem, og renset med ingenting igjen. Installasjonen for hele Macen (sudo) er prøvd på hver endring på GitHub's macOS-maskiner (Apple-silikon): kjører som _bitvoice på port 443, en brukerinstallasjon like ved siden av nektet, tilbake etter programmet ble drept, oppgradert, renset med ingenting igjen (den skjulte brukeren også). Intel-Mac er ikke prøvd ennå.

• Windows: som administrator, C:\Program Files\BitVoice, startet med Windows, data i C:\ProgramData\BitVoice, og en brannmurregel for private og domenenettverk; ellers for deg alene, startet når du logger inn. Den fungerer i Windows PowerShell 5.1 (hva Windows Server har) og i PowerShell 7, og i 5.1 startet fra innen 7. BitVoice skriver sin logg til bitvoice.log i data-mappen (holdt under 10 MB, den eldre delen i bitvoice.log.1), og installatoren skriver ut innstillingsskoden hjelpen spør om fra en annen datamaskin. Windows kaller et nytt Wi-Fi- eller nettverk Offentlig inntil det blir fortalt noe annet, og brannmurregelen lar ingenting inn der: for et hjemme- eller kontornettverk sier installatoren hvordan du kan gjøre det Privat (Innstillinger, Nettverk og internett, nettverkets Egenskaper); for en skytjener skriver den ut regelen du må legge til (åpne portene i leverandørens brannmur også). Installert som administrator, er data-mappen bare lesbar for administratorer (den inneholder databasen og nøklene), og Start-menyens BitVoice åpner web-grensesnittet; installert for deg, starter Start-menyen BitVoice, eller åpner det når det allerede kjører. Uansett er det i Innstillinger, Apper, Installerte apper, som fjerner det og spør om du vil fjerne dataene også. Prøvd på Windows 11 (som administrator og ikke) og på Windows Server 2022 på Amazon EC2: installert, nådd fra utsiden, kjører igjen etter en omstart.
• Prøvd på: Ubuntu 24.04 og 20.04, Debian 12 og Fedora 42 (hver med systemd): installert, signatur sjekket, en andre start på samme data nektet, tilbake etter programmet ble drept, oppgradert på plass, et manipulert program nektet, avinstallert og beholdt dataene, reinstallert på dem, og renset med ingenting igjen.
• Linux på en skytjener: adressen den skriver ut er maskinens egen, private; installatoren sier det. Åpne serveren ved dens offentlige adresse eller navn, med 443, SIP og lydportene åpne i leverandørens brannmur.

Run the same command again to upgrade (or use Updates (kapittel 62)). sh -s -- --version v0.1.5 (after the pipe) picks a release; --uninstall removes the program and service and keeps the data, --purge removes the data too. On Windows, save the script and run .\install.ps1 -Version v0.1.5, -Uninstall or -Purge, or remove it in Installed apps. For a server kept off the internet, copy the release's archive and SHA256SUMS into a folder and set BITVOICE_FROM to it.

Hvor det kjører

BitVoice kjører på Linux, macOS og Windows.

On Windows, keep the window it opens while you use BitVoice (closing it stops BitVoice), and when Windows asks whether it may use the network, allow private networks so phones can connect. -data puts the data anywhere else; -https and -sip choose the addresses and ports; -log FILE also writes everything it prints to a file, for a computer where nobody watches its window.

Portene det bruker

Hvis en annen telefon-system allerede har 5060, tar BitVoice neste ledige port og Helse sier det.

Alt i web-grensesnittet

Hver innstilling har en skjerm, og hver skjerm har et kapittel her. Ingen ting trenger en konfigurasjonsfil, en kommandolinje eller et annet verktøy. For automatisering, er de samme skjermene et REST-API, og konfigurasjonen kan følge en fil i Git (Konfigurasjon som kode (kapittel 69)), men ingen av delene er noen gang nødvendig.

Hva BitVoice er for

BitVoice er først og fremst et telefon-system for kontorer og kontakt-sentre, og en vertet telefon-tjeneste for leverandører: alt i de fem første delene av denne håndboken. 911-svar-profilen, radio-dispatch-konsollen og NG911 Core Services er en separat lab- og design-partner-spor (Offentlig sikkerhet (kapittel 77)): de er utenfor menyen til de er slått på i Innstillinger, og ikke sertifisert for live-bruk. Nød-samtaler fra dine egne telefoner er ikke en del av dette sporet; de fungerer på hvert telefon-system fra første start.

Finner veien

• Trykk ⌘K (Ctrl+K) hvor som helst for å hoppe til en skjerm, eller skriv inn et navn eller nummer på en utvidelse for å åpne den.
• På en telefon, er menyen bak ☰-knappen øverst til venstre (og søk ved siden av, øverst til høyre); å velge en side lukker den igjen.
• Hver skjerm har en Hjelp-lenke øverst til høyre som åpner kapitlet sitt i denne håndboken.
• Endringer beholder hver versjon av konfigurasjonen: du kan se hva som er endret og angre det.
• Tre temaer (Midnight, Dark og Light) er på bunnen av menyen.

Hvor moden hver del er

Hvor langt hver del er bevist, åpent. Felttestet: kjørt mot virkelige systemer over et virkelig nettverk (Amazon EC2, internettet, virkelige leverandør-tjenester). Sjekket mot en referanse: testet mot en uavhengig implementering eller standardens egne data. Programtestet: BitVoices egne tester og nettlesertester bare, ikke ennå med virkelig utstyr eller kontoer. Lab: offentlig-sikkerhets-deler, ikke sertifisert.

Utvidelser

En utvidelse er et nummer for en person eller et skrivebord. Telefoner logger inn med utvidelsesnummeret og dets SIP-passord; samtaler til nummeret ringer alle telefoner som er logget inn som det, samtidig.

Legg til en utvidelse

1. Åpne Utvidelser (kapittel 3) og trykk Legg til utvidelse. Det neste ledige nummeret og et sterkt SIP-passord er allerede fylt inn.
2. Skriv inn personens navn (vises på andre telefoner når de ringer) og e-post (for voicemail via e-post).
3. Fyll inn 911-locasjon: sted, etasje og rom. Den sendes med nødsamtaler.
4. Velg hva som skjer Hvis ingen svarer: voicemail som standard, eller en annen utvidelse, en gruppe eller en meny.
5. Lagre. Utvidelsen kan logge inn med en gang.

Feltene

Følg meg, plukk opp og intercom

Hver persons egen samtalebehandling er i sin egen boks på utvidelsen:

• Følg meg ringer flere numre når telefonene her ikke svarer: en mobil, en annen skrivebordstelefon. De ringer en etter en, eller alle sammen, for deres egen ringetid. Med Utenom numre trykk 1 for å ta samtalen på, trykker den som svarer på en mobil 1 først, så mobilens egen voicemail aldri tar samtalen. Se Funksjonskoder (kapittel 32).
• Oppringingsgruppe: hvem som helst i samme gruppe svarer denne utvidelsens ringerende samtaler ved å taste *8.
• Tillat intercom: *80 og dette nummeret svarer på høyttaleren av seg selv. Slå det av for personer som aldri ønsker det.
• Egne hurtigvalg: korte koder bare for denne personen, tastet etter *0.

Videreformidling nå

Under innstillingene vises og endres Videreformidling nå hva personen har satt fra telefonen eller ansattportalen: ikke forstyr, og videreformidling av hver samtale, samtaler mens busy, og samtaler som ikke svarer. Disse er live-tilstand, ikke konfigurasjon: å endre dem gjør ingen revisjon.

Hva som er koblet til

• Telefon: en skrivebordstelefon, softphone eller app.
• Dørstasjon: en intercom ved en dør. Hver som svarer trykker tastekoden, eller Åpne dør på Live-samtaler. Med en dørkontrolleradresse ringer BitVoice til den adressen (2N, Axis, Akuvox, relæbrett); uten en, sendes koden til stasjonen, som åpner døren selv.
• Høyttaler: samtaler til den svarer med en gang og høres over høyttaleren.
• Analogt adapterport: en gammel telefon, faks eller alarmpanel på en adapter. Samtaler bruker bare G.711, som faks trenger.

Koblete enheter

En åpen utvidelse viser hver enhet som er logget inn som den: telefonens merke og modell, hvordan den kobler til (UDP, TCP, TLS eller nettleseren) og siden når. Adressen og porten som skal gis til en telefon vises der også.

Koble telefoner

Enhver SIP-telefon eller app fungerer: peke den mot denne serverens adresse og port 5060, med utvidelsesnummeret som bruker og dets SIP-passord. Skrivebords-telefoner fra de fire store produsentene settes opp automatisk i stedet, så ingen skriver et passord inn i en telefons tastatur.

Automatisk oppsett (provisioning)

1. På Telefoner (kapittel 4) trykk Legg til telefon og skriv inn telefonens MAC-adresse (på en sticker underside) og utvidelsen den tilhører.
2. Velg merke: Yealink, Poly, Grandstream (inkludert HT-analog-adaptere), Snom, Fanvil, Cisco, Mitel, Sangoma, Algo eller CyberData.
3. Fortell telefonen hvor BitVoice er: i din DHCP-server, sett valg 66 til provisioning-adressen som vises på skjermen, så hver telefon på nettverket finner den selv; eller skriv inn samme adresse på telefonens egen nettside, under auto-provisioning.
4. Start telefonen på nytt. Den henter sin fil over HTTPS, logger inn og dens linjetaster viser hvem som er på telefonen.

HTTPS eller vanlig HTTP. Telefoner henter sine filer over HTTPS når de kan. Noen eldre telefoner kan ikke bruke HTTPS i det hele tatt, og mange stoler ikke på sertifikatet BitVoice lagde selv; for disse viser skjermen også en vanlig http://-adresse på samme port. Vanlig HTTP er bare for disse filene: hver andre side går fortsatt til HTTPS. Over vanlig HTTP går telefonens SIP-passord ukryptert over nettverket, så hold det til et pålitelig kontornettverk, eller installer et sertifikat fra en myndighet og slå på HTTPS bare for telefoner.

Filen inneholder utvidelsen, dets passord, tidszonene, kodekene, busy-lampe-tastene og adressen til denne serveren. Provisjonering er beskyttet av et brukernavn og passord telefonene får en gang.

Disse produsentene er også provisjonert, med filer skrevet fra hver produsents dokumenterte format, men ikke ennå prøvd på deres enheter (Telefoner-skjermen markerer dem som uprøvd):

Hver får sin konto, serveren (og reserve-serveren, med flere servere), transport og kryptering, og voicemail-nummeret der det har ett. Sett Algo- og CyberData-høyttalernes utvidelser til Høyttaler slik at samtaler til dem besvares med en gang.

Telefoner uten provisioning

Softphone og andre merker tar de samme tre ting: server (denne datamaskinens adresse, port 5060, eller 5061 med TLS), bruker (utvidelsesnummeret) og passord (dens SIP-passord). Helse lister telefoner som prøvde et feil passord; etter noen forsøk blir adressen blokkert en stund (se Sikkerhet (kapittel 60)).

Nettelefonen

Telefonikonet nederst på hver skjerm gjør denne nettleseren til en telefon for en utvidelse, med din mikrofon og høyttalere. Den bruker WebRTC: lyden er kryptert fra ende til ende, og den fungerer gjennom de fleste brannmurer uten noen innstilling.

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 (kapittel 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 trenger ingen pålogging av seg selv: softtelefonen logger på med SIP, og mislykkede påloggingsforsøk og for mange forespørsler teller for dens egen adresse, som for enhver telefon. En softtelefonside betjent fra en annen nettside må stole på denne serverens sertifikat (bruk Let's Encrypt), og nåværende Chrome spør brukeren før en offentlig nettside kan nå en server på det lokale nettverket.

Testet med to uavhengige biblioteker, JsSIP 3.13 og SIP.js 0.21: to softtelefoner av hver registrerer seg, ringer hverandre og hører hverandre gjennom BitVoice. Andre softtelefoner (Linphones nett-klient, Zoipers) snakker samme protokoll, men har ikke blitt prøvd.

TURN, for nettverk som blokkerer UDP

Noen nettverk (hoteller, gjest-Wi-Fi, strenge bedrifts-brannmurer) lar ingen UDP ut, eller skjuler datamaskiner bak NAT som WebRTC ikke kan komme gjennom. For disse, slå på TURN-server i Innstillinger (kapittel 14): BitVoice kjører da sin egen TURN-server (RFC 8656) på port 3478 (UDP og TCP) og, med denne serverens sertifikat, på port 5349 over TLS. Browser-telefoner, stab-telefon og samtale-lenker får midlertidige legitimasjoner for det, og bruker det når de ikke kan nå mediaportene direkte; lyden er fortsatt kryptert fra ende til ende, og BitVoice relayer den bare til sine egne adresser, så ingen kan bruke det til å nå noe annet.

Åpne TURN-porten, TLS-porten og relay-portene (49152 til 49407 med mindre du endrer dem) i brannmuren. TURN over TLS trenger et sertifikat nettleserne stoler på for navnet de bruker, som ett fra Let's Encrypt (kapittel 14): inntil det er ett, tilbyr BitVoice det ikke til nettleserne (de ville prøve det, feile og vente); og setter det tilgjengelig så snart sertifikatet ankommer; sett dets port til 443 på en server med en ledig adresse for å komme gjennom brannmurer som bare tillater HTTPS.

Endring av nettverk under et oppkall

En telefon som flytter til et annet nettverk under et oppkall (ut av kontorets Wi-Fi og inn på et mobilnett, eller en bærbar datamaskin fra ett Wi-Fi til et annet) får en ny adresse, og den gamle kommunikasjonsveien stopper å bære lyd. Web-telefoner og BitVoice-appene merker dette selv: når nettleseren sier at nettverket har endret seg, eller kommunikasjonsveien til oppkallet stopper å svare i to sekunder, starter telefonen ICE på nytt (RFC 8445 9). Den tilbyr nye ICE-legitimasjoner for oppkallet den har, og BitVoice svarer med nye legitimasjoner av sin egen og sjekker den nye kommunikasjonsveien, og oppkallet flyttes til den uten å måtte ringe på nytt. Krypteringen fortsetter med de samme nøklene. Mens dette skjer, vises oppkallet som Gjenkobler…; på en kommunikasjonsvei som fortsatt fungerer, er det ingen gap, ettersom den gamle kommunikasjonsveien bærer oppkallet til den nye kommunikasjonsveien er klar. SIP-softphone over WebSocket (JsSIP, SIP.js) gjør det samme ved å sende en ny INVITE med nye ICE-legitimasjoner. Ingen innstillinger må aktiveres, med BitVoice som ICE-lite eller bak en NAT.

BitVoice bak NAT

TURN-serveren ovenfor hjelper nettlesere på strenge nettverk å nå en BitVoice som har en offentlig adresse. Når BitVoice selv ikke har noen (i en bedrift bak en router uten portvidereføring, eller i et skytjenestenettverk uten offentlig adresse på maskinen), slå på Dette serveren er bak NAT under BitVoice bak NAT i Innstillinger (kapittel 14). BitVoice deltar deretter fullt ut i ICE (RFC 8445) i stedet for å svare på én adresse (ICE-lite):

• Den tilbyr nettleserne sine egne adresser, sin offentlige adresse som STUN-tjenestene ser den, og relayer på TURN-tjenestene den logger inn på (UDP; et brukernavn og passord hver), og sjekker hver adressepar med nettleseren, som nettleseren gjør.
• Relay hver samtale via TURN sender all nettlesermedia gjennom TURN-tjenestene, for nettverk som krever det.
• Finn mine adresser ber tjenestene som en samtale ville og lister hva BitVoice vil tilby: sine egne adresser, den offentlige adressen sett gjennom STUN (en STUN-tjeneste som ikke svarer, blir sagt så), og dens relayer.
• Den fungerer for nettlesertelefonen, samtalelenker, ekko-testen og SIP-over-WebSocket-softtelefoner, i begge roller: BitVoice svarer på nettleserens tilbud, og tilbyr en softphone den ringer. Nettlesere som skjuler sine adresser bak mDNS-navn (name.local) løses på det lokale nettverket, og nettleserens adresse som webtjeneren så den, blir sluppet gjennom relayer fra starten.
• Av ved default; den legger til et øyeblikk til hver samtale mens tjenestene svarer (høyst en og en halv sekund). Oppringerens video bruker ICE-lite uansett.

Den ansattes telefon

Åpne #/phone på enhver datamaskin eller mobilnettleser: personer logger inn med sin utvidelse og SIP-passord, uten en administrator-konto. Det er en fullstendig telefon: taste, svare, holde og overføre og tastaturet. For deres egen videreføring og voicemail bruker de ansattes portalen på #/me (se Ansattes portalen (kapittel 33)).

Mobilappene

BitVoice-appene for iPhone og Android kobles fra utvidelsessiden med en QR-kode. Oppkall vekker appen gjennom Apples og Googles push-tjenester, så den ringer selv når den er lukket (én gang push er konfigurert; se under).

Skinny-telefoner og MGCP-gateway

Telefoner og gateway som ikke snakker SIP kan fortsatt brukes. Skinny-telefoner og MGCP-gateway (under Samtaler) tar to eldre protokoller:

• Skinny (SCCP): Cisco-skrivebordstelefoner som kjører SCCP-firmware (79xx, 69xx, 89xx). Legg til hver telefon etter dens MAC-adresse og velg dens utvidelse; slå på Aksepter Skinny-telefoner og peke telefonen mot BitVoice (TCP-port 2000) i dens TFTP-innstillingsfil eller meny.
• MGCP (RFC 3435): gateway som BitVoice styrer ett og ett, som f.eks. analoge telefonadaptere og linjekort. Legg til gatewayen etter domenenavnet den bruker i sine endpointnavn (aaln/1@navn), dens adresse og utvidelsen til hver linje; sett gatewayens samtaleagent til BitVoice (UDP-port 2727).

Hver Skinny-telefon eller MGCP-linje er en mer enhet til dens utvidelse: den ringer med utvidelsens andre telefoner, ringer ut som utvidelsen og vises i utvidelsens enheter. Siden viser hver enkelt enhets tilstand.

Hva fungerer

• Skinny: registrering, linjen og dens nummer på skjermen, dialtone, valg (nummeret kommer etter en pause eller #, eller med en gang fra telefonens tastatur når den løftes etter valg), ringback, ringing med caller ID, svar og avslutt med håndsett, høyttaler eller bløtkeknapper (NewCall, Redial, Answer, EndCall), busy og reorder-toner.
• MGCP: dialtone, sifre samlet av gatewayen med en sifferkort, ringing med caller ID (ringer uten det når gatewayen avviser caller ID), ringback, busy og reorder-toner, og lydkoblingen (CRCX, DLCX). En gateway som starter på nytt (RSIP) får portene sine konfigurert på nytt.
• Lyden er G.711 µ-lov på begge; BitVoice konverterer til hva den andre parten bruker.

Hold, overføring og konferanse gjøres fra utvidelsens andre telefoner for øyeblikket, og en Skinny-telefons andre linje brukes ikke.

Sikkerhet

Ingen av protokollene har passord. Skinny-telefoner aksepteres bare fra det lokale nettverket og bare når de er listet; MGCP-kommandoer følges bare fra gatewayens adresse (eller, uten en, fra det lokale nettverket). Hold begge portene utenfor internettet.

En gateway som fortsatt arbeider med en kommando, kan svare "100 Trying" først: BitVoice venter deretter lengre før den sender kommandoen igjen og bekrefter det endelige svaret (000), slik RFC 3435 ber om. En port som gatewayen ikke vil overvåke, viser gatewayens egen nekt på siden, slik som gatewayen nektet å overvåke porten: 507 Unsupported Functionality fra en mediegateway uten analoge porter.

Hvordan de testes

• Skinny: to telefoner bygget fra en separat Skinny-implementering (den åpne mwicat/sccp-biblioteket) registrerer seg, ringer hverandre, svarer og legger på; en telefon som ikke er listet, blir nektet. Wiresharks Skinny-dissektor leser hver melding BitVoice sender uten feil, og meldingene har samme størrelse som Asterisks chan_skinny sender til Cisco-telefoner.
• MGCP: mot Yates MGCP-gateway (restart, midlertidige svar, bekreftelser, nekt) og BitVoices egen testgateway for hele samtaler. Yate-gatewayen har ingen analoge porter, så ingen samtale ble ringt gjennom den.

Telefoni-kort

Et telefoni-kort i BitVoice-computeren (Digium, Sangoma, OpenVox og andre kort med Linux DAHDI-drivere) kan bære analoge telefoner og telefoniselskapslinjer. Et separat program, bitvoice-dahdi, driver kortet og kobler portene til BitVoice over computerns egen nettverkskobling, så BitVoice selv aldri berører kernel-drivere og et kortproblem ikke kan stoppe telefonisystemet.

Konfigurasjon

1. Installer DAHDI-drivere og konfigurer portene som vanlig i /etc/dahdi/system.conf (fxoks=1-4 for porter med telefoner, fxsks=5-8 for porter med linjer, og landets toner i loadzone og defaultzone), og kjør dahdi_cfg.
2. Under Telefoni-kort (under Samtaler) slå på Bruk telefoni-kort. En token blir laget; kopier den inn i en fil som bare root kan lese, som /etc/bitvoice/cards.token.
3. Legg til hver port etter sin DAHDI-kanalnummer: en telefon-port (FXS, en telefon, faks eller dørtelefon plugges inn) med dens utvidelse, eller en linje-port (FXO, en telefoniselskapslinje) med linjens nummer. Velg A-lov for Europa og de fleste deler av verden, µ-lov for Nord-Amerika og Japan.
4. For linjer, legg til en trunk med protokollen Telefoni-kort-linjer på Trunker, og ruter numre til den som til noen trunk; innkommende ruter matcher hver linjes nummer.
5. Start bitvoice-dahdi -server https://127.0.0.1:8443 -token-file /etc/bitvoice/cards.token som en tjenestebruker som kan åpne /dev/dahdi. Den er i Linux-nedlastingen ved siden av bitvoice. Siden viser om den kjører og hver ports tilstand; endringer når den innen ti sekunder. En kanal en annen program fortsatt holder (eller en dahdi_cfg ikke har konfigurert ennå) prøves igjen hver to sekunder, så rekkefølgen ting starter i har ingen betydning.

Hva fungerer

• Telefoner: dialtone, valg (sifre høres av BitVoices egen tone-detektor; nummeret kommer etter en pause eller #), ringback, busy og congestion-toner fra kortets tone-sone, ringing for innkommende samtaler, og knappetrykk under en samtale (sendes på som RFC 4733-hendelser også).
• Linjer: en ringende linje ringer nummeret her og blir besvart når samtalen er; utgående samtaler tar en ledig linje, venter på telefoniselskapets dialtone og ringer nummeret som toner. Den fjerne enden som legger på blir merket når linjen rapporterer det (loop-strøm eller polaritet, avhengig av linjen). Analoge linjer sier ikke når den fjerne enden svarer, så en utgående samtale teller som besvart en gang nummeret er ringt.
• Lyden er G.711 til og fra kortet; BitVoice konverterer til hva den andre parten bruker.

Digitale linjer: T1 og E1 PRI

En T1 (23 samtaler på en gang) eller E1 (30) linje kjører som primær rate ISDN plugges inn i et digitalt kort (Digium/Sangoma TE-serie, OpenVox D-serie og lignende). BitVoice snakker PRI selv (Q.921 på D-kanalen, og Q.931 samtalekontroll), så hver samtale kommer inn med nummeret valgt og caller ID, går ut med utvidelsens caller ID, og telefoniselskapet sier når den fjerne enden svarer, ringer eller er busy.

1. I /etc/dahdi/system.conf, sett spann opp for PRI som vanlig (span=1,1,0,esf,b8zs, bchan=1-23, hardhdlc=24 for en T1; span=1,1,0,ccs,hdb3,crc4, bchan=1-15,17-31, hardhdlc=16 for en E1), og kjør dahdi_cfg.
2. Under Digitale linjer på Telefoni-kort (kapittel 6), legg til spann: T1 eller E1, dens første DAHDI-kanal, om BitVoice er PBX på telefoniselskapets linje (vanlig) eller nettverket (en annen PBX kobler til BitVoice som om til telefoniselskapet), og switch-typen telefoniselskapet ga deg.
3. Legg til kort-trunk på Trunker hvis det ikke finnes ennå, og innkommende ruter for numrene (DIDs) telefoniselskapet sender.

Utgående samtaler tar en PRI først, de analoge linjene etter; en busy-nummer, en feil-nummer eller ingen ledige kanal kommer tilbake som busy, ikke funnet eller utilgjengelig, som nettverket sier. Siden viser om hver spanns D-kanal er opp og hvor mange av dens kanaler er i samtaler. T1-kanaler konfigurert med robbed-bit-signaling (fxsks, fxoks) fungerer som de analoge portene ovenfor.

Navn, videreformidling og overføring. En ringers navn kommer inn med samtalen (fra Visnings-elementet, eller på Nasjonal ISDN-2 fra navnet nettverket sender som en fasilitet) og telefoner viser det; utgående samtal sender utvidelsens navn på samme måte. Nummeret et samtal ble videreformidlet fra kommer inn som dets omdirigeringsnummer (BitVoice sender det videre som SIPs Diversion, med årsaken: opptatt, ikke besvart, ubetinget), og når en utvidelses videreformidling sender et samtal ut på PRI, følger utvidelsens nummer med som omdirigeringsnummer, så den fjerne enden og telefon-selskapet vet hvem som ringer. Når et eksternt samtal besvares, forteller BitVoice nettverket nummeret som besvarte (det tilkoblede nummeret).

Slå på Overføring gjennom telefon-selskapet på en spann (brukerside, Nasjonal ISDN-2, 5ESS, DMS-100 eller EuroISDN) og når noen overfører en ringer på denne linjen til et annet nummer på samme linje, ber BitVoice nettverket om å koble de to samtalen selv: To B-kanal-overføring på Nasjonal ISDN-2 og 5ESS-linjer, Release Link Trunk-overføring på en Nortel DMS-100, eksplisitt samtale-overføring (ringeren holdes, så kobles) på EuroISDN. En DMS-100 gir kun en overførings-identifikator til samtal som BitVoice plasserer, så der må en av de to samtalen være et utgående samtal (det vanlige tilfelle: en ringer videreformidlet eller overført til et eksternt nummer). Begge kanalene frigjøres så snart nettverket har koblet dem. Linjen trenger tjenesten (spør telefon-selskapet om "to B-kanal-overføring" eller "ECT"); hvis nettverket nekter, fungerer overføringen likevel, gjennom BitVoice, ved å bruke begge kanalene som før.

Prøv det uten en kort

DAHDI's egne dynamiske spann kan stå inn for en kort: to spann koblet sammen inne i kjernen, BitVoice på en og en annen PBX (Asterisk's chan_dahdi, for eksempel) som telefon-selskapet på den andre. Last dahdi, dahdi_dynamic og dahdi_dynamic_loc, og i /etc/dahdi/system.conf:

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

La det siste nummeret (tidsstyring) være 0 på begge: DAHDI's egen tidsstyring driver dem da. Spann som er hverandres tidsstyringskilde tikker bare når den andre sender, og D-kanalen kommer og går. Legg til spann 1 her som en T1 (første kanal 1), og sett opp den andre PBX-en som nettverksiden på kanalene 25 til 48.

Grunnrate ISDN (BRI)

En BRI bærer to samtal på samme tid (B1 og B2) og er vanlig i Europa for små kontorer; den kobler også ISDN-bordtelefoner. BRI-kort (Digium B410P, HFC-baserte kort fra OpenVox, Junghanns og andre) fungerer gjennom DAHDI som PRI-kortene gjør: i /etc/dahdi/system.conf er spann span=1,1,0,ccs,ami med bchan=1-2 og hardhdlc=3. Legg til det under Digitale linjer med BRI som linjetypen; kanalene er B1, B2 og deretter D-kanalen.

• BitVoice er PBX-en (brukerside), punkt-til-punkt: en PBX-linje fra telefon-selskapet (Tysklands *Anlagenanschluss*): innkommende samtal bærer nummeret som ble valgt, utgående samtal bærer utvidelsens nummer.
• Brukerside, flerpunkt: en linje delt med andre enheter (*Mehrgeräteanschluss*): BitVoice ber nettverket om sin egen TEI (terminal-identifikator) og besvarer samtal til linjen ved siden av andre enheter på den; telefon-selskapet sender nummeret som ble valgt (MSN), som innkommende ruter matcher.
• BitVoice er nettverket, flerpunkt: ISDN-telefoner kobles til kortets S-buss som til en telefon-selskapslinje. Hver ber BitVoice om en TEI; et samtal til bussen ringer alle telefoner på den, den første som besvarer tar det og de andre holder opp med å ringe. Numre valgt digit for digit (som ISDN-telefoner ringer) samles inntil telefonen sier det er fullstendig, # er trykket, eller ingen digit kommer i fire sekunder. Rute numrene til og fra bussen med kort-trunken som for noen linje.

Navn, videreformidling, overføring på EuroISDN (eksplisitt samtale-overføring) og råd om avgift fungerer på en BRI som på en PRI.

E&M-trunker på en T1

En T1 hvis kanaler er satt opp som E&M (robbed-bit-signalling: e&m=1-24 i /etc/dahdi/system.conf) gir 24 trunker, hver signalisert på sin egen: tilkoblingslinjer til en annen PBX, kanalbanker og langdistanse-leverandørenes Feature Group D-trunker. Under Digitale linjer, legg til en T1 og sett Signalling til E&M, deretter:

• Startsignal: Wink start (det vanlige: den fjerne enden blinker når den er klar for nummeret, og BitVoice blinker tilbake ved et innkommende samtal), Umiddelbar start (nummeret følger straks etter beslag), Forsinket valg (den fjerne enden går av hook mens den blir klar, deretter på hook), eller Feature Group D (wink start med MF-numre, ringers nummer sendt først: KP 00 ANI ST, deretter KP nummer ST; ANI blir ringers ID).
• Numre sendt som: DTMF, eller MF (MF R1, KP nummer ST) som de fleste leverandør-trunker ønsker.
• Nummer når ingen er sendt: hva et innkommende samtal når hvis den fjerne enden beslagtar trunken uten å velge (en privat linje rett til resepsjonen, for eksempel).

Et utgående oppkall tar en ledig trunk, besetter den, venter på startsignalet (ingen blink innen fem sekunder er "ingen blink", og oppkallet feiler), sender nummeret og besvares når den fjerne enden går av hook (svarsovervåking). Et innkommende oppkall besvares ved å gå av hook når utvidelsen besvares.

CAMA-trunker (911, lab-spor). En PSAP som fortsatt mates av en 911-selektiv router over CAMA-trunker setter Startsignal til CAMA (911-trunk). Routeren besetter, BitVoice blinker, og routeren sender oppkallers nummer (ANI) i MF: forbedret CAMA som KP, to informasjons-siffer og alle ti siffer, ST; tradisjonell CAMA som KP, én nummerplan-siffer og syv siffer, ST. For tradisjonell CAMA, list opp under Områdeskoder for NPD 0 til 3 områdeskoden hver nummerplan-siffer står for (routerns konfigurasjonsark har dem); en siffer over 3 betyr at routeren ikke kunne identifisere linjen. Hvert oppkall går til innkommende rute for 911 som et 911-oppkall, med ANI som tilbakekallingsnummer, og BitVoice ser opp dens plassering etter dette nummeret (se 911-oppkall (kapittel 77), Plasseringsoppslag (ALI)). Informasjons-sifferne vises på oppkallet som CAMA (II 00).

MFC-R2 på en E1

I Latin-Amerika, deler av Asia og Afrika, er E1-linjer ofte MFC-R2 i stedet for ISDN: 30 kretser, hver med sine linjesignaler på A- og B-biter i timeslot 16 (ITU-T Q.421) og nummer, kategorien til oppringeren og oppringerens nummer utveksles i multifrekvens-toner (Q.441), frem og tilbake. Sett opp spannet som CAS i /etc/dahdi/system.conf (span=1,1,0,cas,hdb3, cas=1-15:1101, cas=17-31:1101, dchan fjernet), så under Digitale linjer legg til en E1, sett Signalling til MFC-R2 og velg Landvariant: ITU-T, Argentina, Brasil, Kina, Colombia, Tsjekkia, Ecuador, Mexico, Filippinene eller Venezuela. Hver land tilordner noen signaler forskjellig (hva som betyr beskjeftiget, hvordan slutten av nummeret fortelles, Mexicos ekstra gruppe C); varianten holder disse. Kina nr. 1 ber om oppringerens klasse (KA) og nummer etter nummeret som ble valgt, sender samtaletypen (KD: 3, en lokal samtale) sist, leser beskjeftiget og ledig etter KD den sendte, og setter både C- og D-biter til 1: der, skriv cas=1-15:1111 og cas=17-31:1111.

Hver krets bærer samtaler begge veier. En innkommende samtale når innkommende ruter med nummeret som ble valgt og oppringerens nummer (skjulte numre kommer inn som anonyme); en beskjeftiget utvidelse eller et feil nummer signaliseres tilbake som beskjeftiget eller ikke tilgjengelig, slik varianten sier. En utgående samtale sender nummeret og utvidelsens oppringer-ID, eller "nummer skjult"-signalet når oppringeren skjuler det.

MFC-R2-signalingen testes mot OpenR2 (R2-biblioteket Asterisks chan_dahdi bruker), i hver variant som tilbys og i begge retninger, inkludert et oppkall som avvistes som beskjeftiget; E&M mot BitVoices egne simuleringskanaler.

SS7

En bærer kan overføre T1-er eller E1-er signalisert av SS7 i stedet for ISDN: talekretsene bærer oppkall, hver navngitt av en kretsidentifikasjonskode (CIC), og en timeslot bærer signallinken til bærerens signaloverføringspunkt eller switch, over hvilken ISUP setter oppkallene opp. BitVoice er da et signalpunkt i seg selv, med en punktkode som bæreren tilordner. I /etc/dahdi/system.conf sett opp spannet som rene kanaler med signallink-tidsdelen som mtp2 eller hardhdlc (timeslot 16 på en E1, 24 på en T1). Under Digitale linjer legg til spannet, sett Signalling til SS7 (ISUP) og gi:

• SS7-variant: ANSI (Nord-Amerika; punktkoder nettverk-kluster-medlem, som 245-16-1) eller ITU-T (resten av verden; punktkoder sone-område-punkt, som 1-10-2, eller et vanlig nummer).
• Vår punktkode og Tilstøtende punktkode, Nettverk (nasjonal, vanlig, eller internasjonal), signallink-Link-kode (SLC, 0 med mindre det er oppgitt annet), og Første CIC: koden for spannets første talekanal, de andre følger i rekkefølge. Alle disse kommer fra bæreren.

Linksett med flere linker. Spann med samme variant, punktkoder og nettverk er ett linksett (inntil 16 linker): hver spanns signallink er en av dens linker, og trenger sin egen Link-kode, og hver spanns kretser tilhører det (deres CIC-er kan ikke overlappe). Trafikken deles mellom linkene i tjeneste ved meldingenes SLS, så en oppkalls meldinger holder seg til en link. Når en link feiler (linktesten blir ikke besvart, eller meldinger blir ikke bekreftet), skifter trafikken over til de andre (Q.704: COO og COA, meldingene den fjerne enden ikke fikk sendt på nytt på en annen link; eller, uten svar i tide, ved tid), oppkallene på hver spann fortsetter, og Telefonkort sier hvor mange linker er i tjeneste og hvordan denne spanns linker står. Når linken kommer tilbake og testes, skifter trafikken tilbake (CBD og CBA). Bare når alle linker er nede, er linksettet nede. Prøvd mot libss7 med to linker, en kuttet midt i et oppkall: libss7 tar nettverksledelsesmeldinger bare på linken deres SLS navner, så en omstillingmelding om den kuttete linken (sendt på den andre, som Q.704 har det) blir droppet der, og begge ender omstiller ved tid i stedet, som fungerer; mellom to BitVoice-ender går det via COO og COA.

Når lenken kommer opp, justerer BitVoice den (MTP nivå 2, med nødsituasjonsperioden som en enkelt-lenke-lenkesett bruker), tester den med lenketesten (SLTM/SLTA), bytter trafikken om igjen og nullstiller hver sirkuit (GRS). Samtaler som når inn til innkommende ruter med nummeret som ble valgt, samtaleres nummer (med unntak av anonyme), nummeret en samtale ble videreformidlet fra og, på ANSI, samtalerens navn; samtaler som går ut bærer utvidelsens samtale-ID og navn. Bærerens blokkering eller nullstilling av sirkuitene adlydes. Ved dobbel beslag tar enden med det høyere punktkoden beholdene sirkuitene, som Q.764 sier, og BitVoice tar de sirkuitene den beholder først.

SS7 testes mot libss7 (SS7-biblioteket Asterisk's chan_dahdi bruker), ITU og ANSI: justering, lenketest, trafikkgjenopptak, sirkuittnullstilling, samtaler begge veier med numre og navn, frigjøring, opptatt og blokkering; og BitVoice mot seg selv med rammer tapt på lenken (sendt igjen av MTP2-feilkorreksjon) og en dobbel beslag. Signaaloverføring (som en STP for andre) og SCCP/TCAP (nummerportabilitetsoppslag, tollfrie oversettelser) tilbys ikke: en PBX er en endepunkt, og disse er bærerens.

Signaloverføringspunkt (STP). bitvoice-dahdi kan også være et STP for sine ITU SS7-lenkesett: slå på Signaloverføringspunkt (SS7) under digitale linjer. Dets STP-punktkode er spansenes egen. Med Send meldinger for andre punktkoder, går en melding fra ett lenkesett for det nærmeste punktet i et annet til det lenkesettet, og en for en annen punktkode går til IP STP (M3UA): en IP STP eller signalgateway på vert:port, nås over M3UA (RFC 4666) over TCP, hvis meldinger for lenkesettets punkter kommer tilbake samme vei (BitVoice registrerer sin punktkode og de bak den, med mindre en Rutingskontekst er gitt). Global titteloversettelse sender SCCP-meldinger adressert til STP ved global tittel til punktkoden og underordnet system for den lengste matchende prefikset, som en SCCP-relé gjør. En melding som ikke kan leveres, kommer tilbake til avsenderen som en UDTS eller XUDTS når den ba om det: ingen oversettelse, ingen rute (MTP-feil), ingen underordnet system her, eller dens hoppteller er gått ut. STPs status viser M3UA-lenken og hvor mange meldinger den har sendt videre, oversatt og returnert. Dets SCCP (UDT, XUDT, UDTS, XUDTS) og TCAP (Start, Fortsett, Slutt, Avbryt, dialoger og komponenter) er sjekket mot Osmocom: OsmoSTP over M3UA, libosmo-sigtrans SCCP-ekko-bruker bak det, og libosmo-asn1-tcaps eget TCAP-koder begge veier. SCTP er ikke tilbudt (Go har ingen): M3UA går over TCP, som OsmoSTP og mange IP STP-er tar. Koblingsorientert SCCP, ANSI-lenkesett og SCCP-håndtering (SST, SSA) er ikke tilbudt.

Råd om avgift. På en EuroISDN-linje, slå på Råd om avgift og BitVoice ber telefonsselskapet, med hver samtale ut, om å si hva det koster: under samtalen (AOC-D) og ved dens slutt (AOC-E), i penger eller i avgiftsenheter. Den siste figuren havner på samtaleposten (belastet EUR 1,50 i Historikk, og ved siden av samtalen på Kostnader); når det er i din valuta (angitt på Kostnader) er det samtalekostnaden, i stedet for figuren fra stammeprisene. Telefonsselskapet må tilby tjenesten på linjen. SIP-stammer kan sende samme råd, som 3GPP AOC XML i en INFO eller BYE, og BitVoice beholder det på samme måte.

PRI-koden testes mot libpri (ISDN-biblioteket Asterisk bruker), både som brukersiden og som nettverksiden, for nasjonale ISDN-2 og EuroISDN-samtaler, navn, omdirigering og tilkoblede numre, eksplisitt samtaleoverføring, to B-kanaloverføring og DMS-100-frigjøringslenkeanmodningsbyte for byte (med libpri's PBX koblet til BitVoice som DMS-100), og råd om avgift i begge retninger; og på BRI, punkt-til-punkt og multipunkt, som terminal og som nettverk (TEI-tildeling, samtaler kringkastet til bussen, numre valgt tall for tall).

Ikke ennå: samtale-ID vist på analoge telefoner eller lest fra analoge linjer, hook flash og ekko-kansellering utover hva kortet selv gjør.

Trunker

En trunk er din konto hos et telefoniselskap. Den bærer samtaler til og fra eksterne numre. De fleste er SIP-trunker; en Asterisk- eller FreePBX-server, eller en IAX2-tilbyder, kan nås med IAX2 i stedet.

Legg til en SIP-trunk

1. På Trunker (kapittel 7) trykk Legg til trunk.
2. Skriv inn provider-serveren telefoniselskapet ditt ga deg (sip.provider.com), og porten hvis den ikke er 5060.
3. Skriv inn brukernavn og passord, og slå på Registrer hvis provideren sier det (de fleste gjør det).
4. Lagre. Innen noen sekunder vises trunken som registrert; hvis ikke, vises årsaken ved siden av.

Trunkhelsevurdering

Med to eller flere trunker på en utgående rute, vurderer BitVoice hver 15. sekund om hver trunk brukes på riktig måte eller prøves etter de andre trunkene. En trunk flyttes bak de andre når dens provider slutter å svare på keep-alive-sjekker, eller når dens siste utgående samtaler feiler ett etter ett på providerens side (Feilende samtaler på rad innen Innen (minutter), Innstillinger, Trunkhelsevurdering), og en annen trunk fungerer. Den flyttes ikke på grunn av en feilende keep-alive alene mens samtaler via den fortsatt kommer frem; og når alle trunker feiler samtidig, er det sannsynligvis dette systemets eget internett-tilknytning som er årsaken, så ingen trunker flyttes. En endring krever to vurderinger på rad (30 sekunder), så en trunk vil aldri flakke. En trunk tas aldri helt ut: den prøves fortsatt når de andre feiler, så en nødsamtale har alltid alle mulige utveier. Trunkens side viser vurderingen og dens årsaker; en samtale som gikk ut en annen vei viser det i sin journal.

1. Legg til en inngående rute for ditt nummer og en utgående rute som bruker denne trunken (Samtale-ruting (kapittel 8)).

Sky-providere

Start fra fyller inn Microsoft Teams Direct Routing, Amazon Chime SDK Voice Connector eller Azure Communication Services, med en notis om hva som må settes på deres side. Teams beskrives i sin egen kapittel (Microsoft Teams (kapittel 67)).

IAX2-trunker til Asterisk og FreePBX

Velg IAX2 som protokollen for å koble til en annen Asterisk- eller FreePBX-server, eller en IAX2-provider. IAX2 bærer signalisering og lyd på én UDP-port, 4569, som gjør det enkelt å gå gjennom brannmurer.

• Server-adresse: den andre serveren. La det være tomt når den andre serveren registrerer seg til BitVoice i stedet (en filial bak en endrende adresse); da er brukernavn og passord det den registrerer seg med.
• Brukernavn og passord: det samme på begge sider. BitVoice svarer og sender MD5-utfordringer, og håndterer samtale-token.
• Registrer: logg inn til den andre serveren, så den kan sende samtaler hit.

På Asterisk-siden er en peer som denne alt som trengs:

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

IAX2-port 4569 åpnes bare når den første IAX2-trunken legges til, så en Asterisk som kjører på samme datamaskin holder det til da.

H.323-trunker

Velg H.323 som protokollen for eldre gateways, PBX-er og video-konferansesystemer som snakker H.323, men ikke SIP. Gi gateways adresse (port 1720); samtaler aksepteres bare fra den. Samtaler settes opp med Hurtig-tilkobling og G.711 (µ-lov eller A-lov; trunkens codec-liste kan begrense det til ett), og lyden går rett mellom gatewayen og BitVoices media-porter. BitVoice konverterer til hva den andre parten bruker.

H.323 her er bevisst liten: ingen gatekeeper (RAS), ingen H.245 (så en gateway som ikke vil bruke Hurtig-tilkobling, får ingen samtale, og blir fortalt det), ingen video, ingen H.235-sikkerhet. Caller ID kommer fra Q.931-oppringer-nummer eller brukerens valgte-nummer-alias, navnet fra display eller dets H.323-ID. BitVoices H.225.0- og H.245-koding ble sjekket mot en uavhengig ASN.1-koder, men ikke ennå mot gateway-hardware.

Videreformidde anrop

Når et anrop når deg allerede videreformidlet (noen andres nummer er videreformidlet til ditt, eller en Teams-bruker), sier leverandøren det med History-Info (RFC 7044) eller Diversion (RFC 5806). BitVoice leser begge: Anropshistorikk (kapittel 47) viser videreformidlet av nummeret som sendte det videre, med nummeret som først ble ringt og grunnen i dets tips, anropssporingen sier det med ord, og anropsopptaket beholder det (forwardedFrom, original, forwardReason). Når leverandøren ber om at historikken skal være privat, beholdes ikke numrene.

Når en utvidelse videreformidler et anrop ut gjennom en trunk (videreformidler alle, når det er opptatt, når ingen svarer), fortelles leverandøren hvilken utvidelse som videreformidlet det og hvorfor, så den kan vise ditt nummer og fakturere riktig konto: som standard med begge headerne, og med historikken anropet kom inn med beholdes og videreformidlingen legges til. En leverandør som er forvirret av en av dem kan settes til den andre under trunkens Avansert, Videreformidde anrop sier hvis de er med. På en T1/E1-telefonikort blir hver header nettverkets omadresseringsnummer.

Hva status betyr

Anropsruting

Anropsruting avgjør to ting: hvor anrop fra utsiden går, etter nummeret som ble ringt, og hvilken trunk anrop til utenfor numre bruker.

Innkommende ruter

Hver innkommende rute matcher nummeret som ble ringt (eller noe nummer) og sender anropet til en destinasjon: en utvidelse, ringgruppe, kø, meny, timeplan, skript, konferanserom, AI-resepsjonist eller voicemail. Numre matcher i noen form: +1 212 555 0100, 2125550100 og 12125550100 er det samme.

• En rute for ett nummer vinner over en rute for noe nummer.
• En rute kan begrenses til en trunk, for numre som to leverandører begge sender.
• Med nødstilstand på (Innstillinger), går hver innkommende anrop til ett sted i stedet, uansett hva rutene sier: en evakuering, en stengning, en hendelse.

Utgående ruter

Utgående ruter matcher hva folk ringer, etter mønster, og sender det til trunker i rekkefølge: hvis den første er nede eller full, prøves den neste.

• Fjern fjerner siffer fra forkant (en 9 ringt for en utenlinje); Legg til foran legger noen på (et landskode).
• Rekkefølgen betyr noe: den første ruten som mønsteret matcher, brukes. Dra ruter for å endre den.
• Premium-numre (900 og lignende) avvises med mindre en rute navngir dem.

Nødanrop

Nødanroppene fungerer alltid. En rute som navngir nummeret nøyaktig, brukes først; med ingen, prøves hver arbeidende trunk i tur og orden. Et anrop til dem avvises aldri for en utvidelses begrensninger, en vert organisasjons begrensninger eller en manglende rute. Helse advarer når ingen trunk kan bære dem.

PIN-sett

Et PIN-sett (kapittel 9) er en liste over PIN-koder en utgående rute ber om før den ringer ut: for å holde internasjonale eller langdistanse-samtaler til personer med en PIN, eller for å fakturere samtaler til kunder og prosjekter etter deres kode.

1. Legg til PIN-sett og liste ut dets PIN-er (4 til 10 sifre hver).
2. Slå på Behold PIN-en i samtaleposten for å skrive PIN-en brukt inn i hver samtalepost som dets konto-kode (konto-kode-kolonnen i CSV, syslog og PostgreSQL samtale-post-utdata, og account i API-et).
3. På Samtale-ruting (kapittel 8), åpne en utgående rute og velg settet under Spør om en PIN.

Ringere som ringer et nummer som ruten tar, hører "Vennligst tast inn din PIN, deretter trykk på hash", taster den inn, og samtalen går ut. Tre feil PIN-er avslutter samtalen, og forsøket logges som et sikkerhets-hendelse. Nødstilfeller ber aldri om en PIN, uansett rute de tar, og videre-samtaler og følg-meg-numre blir ikke bedt om det heller: bare personer som ringer fra en telefon.

Ringere-id-søk

Mange telefon-selskaper sender en ringers nummer, men ingen navn. BitVoice ser først i selskaps-kontakter (kapittel 38); etter det kan en inn-gående rute be om en ringere-id-søk (kapittel 10):

• En nettadresse: din CRM eller en tjeneste som svarer med navnet. Sett {number} der nummeret skal være (https://crm.example.com/api/callers?phone={number}). Et ren tekst-svar gir navnet på første linje; for JSON, gi navn-feltet som en punktum-adresser (data.contact.name; et nummer går inn i en liste, som i results.0.name). Grunnleggende autentisering er valgfri.
• OpenCNAM: den nord-amerikanske oppringers navn-database, med din konto-SID og autentiseringstoken.

Velg søket på en inn-gående rute på Samtale-ruting (kapittel 8) (Ringere-id-søk). Telefoner viser navnet mens de ringer, og det går inn i samtale-posten.

Et søk holder aldri en samtale opp: BitVoice venter i maks vente (1,5 sekunder med mindre du endrer det, 5 som maks) og ringer deretter uten et navn. Svar beholdes i en dag (eller så lenge du setter, eller aldri med -1), så en vanlig ringer ikke søkes opp på hver samtale; numre tjenesten ikke kjenner, spørres igjen etter en time. Prøv det på søkets side ber om et nummer med en gang, med innstillingene som lagret.

Nødstilfeller

Nødstilfeller går alltid ut, fra hver enkelt utvidelse, selv de som ikke kan ringe utenfor numre. Dette kapitlet handler om nødstilfeller fra telefonene BitVoice kjører: et kontor som ringer 911. Å svare på 911-samtaler er 911-profilen (kapittel 77).

Hva BitVoice gjør på hver nødstilfelle

1. Ruter den, alltid: en rute som navngir nummeret først; med ingen, hver arbeidende trunk i tur. Begrensninger stopper aldri det: en utvidelse som ikke er tillatt utenfor numre, en vert-organisasjon på sin samtale-grense eller suspendert, en trunk på sin kanal-grense.
2. Sender hvor ringeren er: med Send ringerens adresse på (Innstillinger), samtalen bærer lokalitetens sivile adresse, etasje og rom til leverandøren som PIDF-LO.
3. Forteller personer på stedet (Kari's Law i USA): utvidelsene under Varsle får en melding på telefonene sine, hver åpen BitVoice-skjerm viser en varsling, og adressene under Også e-post får en e-post med ringerens navn, utvidelse, lokalitet, etasje og rom, så noen kan møte svarene ved døren.
4. Låter samtalen gå tilbake: i en time etter en nødstilfelle, innkommende samtaler nektas aldri, så svare-punktet alltid kan ringe tilbake.

Oppsett

1. Sjekk nødstilfells-numrene i Innstillinger (kapittel 14) (sett etter land: 911 og 933 i USA).
2. Legg til hver bygning under Steder (kapittel 12), med sin gate-adresse og nettverkene telefonene bruker.
3. Gi hver utvidelse sin lokalitet, etasje og rom.
4. Sørg for at en utgående rute og trunk tar nødstilfeller; Helse (kapittel 13) advarer når ingen kan.
5. Fyll inn Varsle og Også e-post.
6. Ring 933 (i USA) for å høre adressen din leverandør har.

Fjern-arbeidere

En telefon som registrerer seg fra utenfor lokalitetens nettverk er en fjern-arbeider: deres telefon-side ber om hvor de er, og den adressen brukes i stedet. Varslinger sier når den ikke ble bekreftet.

Nødmodus

En annen ting: en bryter som sender alle innkommende samtaler til ett sted (evakuering, stengning, hendelse). Sett hvor samtaler går, en valgfri kode som *55 og utvidelsene som er tillatt å ringe det i Innstillinger (kapittel 14); slå det på Dashbord (kapittel 1), eller ved å ringe koden (stigende toner for på, en lav tone for av). En rød linje vises på hver skjerm mens det er på.

Steder og kontor 911

Et sted er en bygning: dens gateadresse og nettverkene dens telefoner bruker. Steder er hvordan en nødrop oppgir hvor oppringeren er, ned til etasje og rom. I USA krever Kari's Law og RAY BAUM'S Act nøyaktig dette fra bedriftstelefoner.

Legg til en lokalitet

På Steder (kapittel 12), trykk Legg til:

Deretter på hver utvidelse gi dens sted, etasje og rom. Helse (kapittel 13) lister utvidelser uten en plassering.

Hvor en telefon plasseres

1. En telefon som registrerer seg fra ett av et stedets nettverk, er på det stedet, med etasje og rom for dens netttelefonnummer.
2. En varm skrivebord bærer skrivebordets eget sted, etasje og rom, ikke personen som er logget inn (Varmplassering (kapittel 36)).
3. En telefon som registrerer seg fra utenfor alle stedets nettverk er en remsearbeider. Ved sin første nødsituasjonskapable registrering fra et nytt sted, blir dens bruker bedt om å bekrefte sin adresse på sin telefonside; nødsamtaler har deretter denne adressen.
4. Hvis en remsearbeider aldri har bekreftet, går samtalen likevel ut, med netttelefonnummerets vanlige sted, og varslinger sier at adressen ikke ble bekreftet.

##Varsler på stedet Med E-post når noen ringer 911 angitt i Innstillinger, mottar personene som er navngitt der, navn, utvidelse, sted, etasje og rom så snart et oppkall til en nødnummer begynner, slik at noen kan møte respondentene ved døren. Varsle utvidelser får en melding på telefonene sine, og hver åpen BitVoice-skjerm viser en varsling. Se Nødanrop (kapittel 11).

Helse

Helse sier om systemet er klart for samtaler, og hvis ikke, hva du skal gjøre. Hver linje sier hva som er galt på vanlig språk og lenker til skjermen hvor det fikses. Sjekk det etter hver endring av noen størrelse.

Hva det sjekker

Problemer er fargede: rød stopper samtaler (ingen nød-rute), gul skal sjekkes (en telefon ikke koblet til), og grå er for informasjon.

Innstillinger

Innstillinger inneholder alt om systemet som helhet. Hver seksjon lagrer på egen hånd, og hver lagring er en revisjon på Endringer (kapittel 61).

Passord og nøkler vises aldri igjen en gang de er lagret; la dem være tomme for å beholde dem. Visere ser Innstillinger med alle hemmeligheter fjernet.

Sertifikatet og Let's Encrypt

BitVoice starter med et sertifikat det har laget selv, som nettlesere og telefoner advarer om. For en server med et offentlig navn, slå på Let's Encrypt under Sertifikat: angi navnene (pbx.example.com), valgfritt en e-postadresse, og apply. BitVoice får et gratis sertifikat fra Let's Encrypt, bruker det med en gang for nettgrensesnittet, SIP over TLS og Teams, og fornyer det omtrent 30 dager før det utløper (Let's Encrypt-sertifikater varer 90 dager eller mindre). Statuslinjen sier når det ble utstedt, når det fornyes og, hvis det feilet, hvorfor; det prøver igjen etter en time, så mindre ofte, innen Let's Encrypts grenser. Sjekk nå prøver med en gang.

Let's Encrypt må nå serveren under hvert navn fra internettet for å bevise at det er deres:

• http-01 (valget med mindre webgrensesnittet er på port 443): en forespørsel til port 80. BitVoice svarer på port 80 selv (på Linux trenger det retten til å åpne lavports, som setcap cap_net_bind_service=+ep bitvoice), eller viderevider port 80 på ruteren til webgrensesnittets port, som også svarer. Alt annet som ankommer port 80 sendes videre til HTTPS, bare for sertifikatets navn. Når BitVoice ikke kan åpne port 80, sier Let's Encrypt-boksen hvorfor i amber og hva som tillater det (den eksakte setcap-linjen for dette programmet, eller systemd's AmbientCapabilities=CAP_NET_BIND_SERVICE; eller et annet program allerede holder porten). Test navn ber deretter hver navn om en testfil over internettet, som Let's Encrypt vil, og sier for hver om den nådde BitVoice, nådde noe annet eller ikke er i DNS. Noen ruter gjør ikke hårnåle-NAT (hairpin NAT): der feiler testen fra innside selv om Let's Encrypt, fra utsiden, lykkes.
• tls-alpn-01: en TLS-tilkobling til port 443, besvart på webgrensesnittets egen port: for en server hvis webgrensesnitt er på 443.

Andre ACME-myndigheter som ikke trenger konto-binding (et selskaps eget step-ca, Let's Encrypts testtjeneste for tester) velges under Myndighet. Wildcard-navn trenger DNS-bevis, som BitVoice ikke gjør: installer disse sertifikatene manuelt. Hver server i en cluster får sitt eget sertifikat.

Skjermene på ditt språk

BitVoices skjermer kommer på engelsk og på tretten andre språk: Deutsch, Français, Español, Italiano, Português, Nederlands, Polski, Svenska, Dansk, Norsk bokmål, Suomi, 日本語 og 简体中文.

Velg ett

Hver nettleser har sitt eget språk: velg det under menyen (språklisten ved siden av temaene), på innloggingssiden eller på oppsettsguidens første side. Før du velger, bruker BitVoice nettleserens eget språk når det er ett av disse, ellers engelsk. Valget lagres bare i denne nettleseren: to personer på en server kan hver arbeide på sitt eget.

Alt på skjermene er oversatt: menyen, overskrifter, knapper, hint, meldinger fra serveren og navn skjermlesere annonserer. Søk (⌘K) finner en side etter dens navn på ditt språk eller på engelsk. Igjen som de er: hva mennesker skriver (navn, numre, notater), adresser, koder, skript i redigeringsverktøyene og navn på produkter og protokoller. Datoer og numre følger nettleserens egne innstillinger.

Hvordan det oversettes, og hvor godt

Oversettelsene er laget av en maskin (en stor språkmodell), for hver del av teksten skjermene viser, om lag 5 000 av dem; ingen har blitt sjekket av en person. Noen setninger skjermene bygger fra deler (et nummer og et ord) kan lese ujevnt, og en term kan bli oversatt på to måter på to steder. Alt uten oversettelse, som en skjerm nyere enn oversettelsene, forblir engelsk.

Hjelp holder denne håndboken på engelsk, som skrevet, med en lenke øverst på hvert kapittel til samme kapittel oversatt hele (også av maskin) på bitvoice.org.

Telefondelen er separat: hva ringere hører (lydinnspillinger, valgmeny for voicemail) er på standard lydinnstillingspråket (Lyder (kapittel 20)), med mindre en utvidelse eller en kø har sitt eget språk.

Samtaleflyt

Sjekk hver situasjon

Sjekk hver situasjon, øverst på Samtaleflyt (kapittel 16), prøver hele ditt samtaleplan i hver situasjon det kan være i, ikke et utvalg:

• hver kombinasjon av åpne og lukkede som dine planer faktisk når over det kommende året (hver helligdag inkludert), funnet i 15-minutters skritt;
• hver kombinasjon av dag/natt-omskifter (eller, med mer enn seks, hver enkelt omskiftet alene);
• hver inngående rute, og hver tast en caller kan trykke i hver meny, hver "hvis ingen svarer" og hver kø-tidsavbrudd langs veien;
• hver utvidelse ringer hver nødnummer.

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.

Den samme sjekken kjøres på endringer før de gjøres: et forslag fra Spør på en enkel måte og Gjenopprett denne ser på en gammel revisjon, begge lister hva endringen ville bryte som fungerer i dag.

Prøv et oppringning

Angi hvem som ringer (en utvidelse eller et eksternt nummer), hva de ringer og når, og trykk Prøv det. BitVoice følger oppringningen nøyaktig som den ville for ekte, uten å ringe noe: den innkommende ruten, tidsskjemaer på den tiden, routingskript (de kjører, i deres sandkasse), menyer, grupper og køer, og hva som skjer hvis ingen svarer. Veien denne oppringningen tar, er merket; andre veier på (en menys nøkler, et tidsskjemas andre side) kan åpnes. Grønt betyr det fungerer, gul betyr se på det (en telefon som ikke er koblet til, et skript som faller tilbake), rødt betyr oppringningen feiler der. Velg Anta at hver telefon er koblet til for å se planen som den er designet, i stedet for hvordan den er akkurat nå; Ankommer på velger trunken for ruter som bare tar en.

Diagrammet

Diagrammet viser hvor oppringninger fra utsiden går, boks for boks: hver innkommende rute, deretter menyer, grupper, køer, tidsskjemaer, skript og personer det leder til.

Klikk en boks (eller trykk Tab til den og trykk Enter) for å endre hvor oppringninger går fra den: en rutes destinasjon, en utvidelses eller gruppes Hvis ingen svarer, et tidsskjemas åpne og lukkede destinasjoner, en menys nøkler (legg til eller fjern nøkler rett der), et skripts fallback eller en resepsjonists person. Lagring av sjekker endringen som enhver annen og lager en revisjon. Åpne full redigerer går til elementets egen side. Legg til innkommende rute legger til en rute uten å forlate diagrammet.

Ringgrupper

En ringgruppe er ett nummer som ringer flere utvidelser: en salgsteam, resepsjonen og dens reserve, alle i verkstedet.

Ringestrategier

• Alle på en gang: hver medlems telefon ringer sammen, og den første som svarer tar anropet. De andre holder opp med å ringe.
• En etter en: hver medlem ringer for gruppen sin ringetid, i rekkefølgen de er listet. Flytt medlemmer med pilene, eller Alt+↑ og Alt+↓.

Medlemmer som er borte (i et møte på deres kalender, eller med ikke forstyr på) hopper over; gruppen ringer de andre. Medlemmer med mobilappen våkner med en push og ringer også.

Hvis ingen svarer

Når ingen svarer innen ringetiden, går anropet til Hvis ingen svarer: en medlems voicemail, en kø, en meny, en annen gruppe. Med ingenting satt, ringer det til den som ringer gir opp.

Grupper, køer eller plukk?

Køer

En kø holder anropere i rekkefølge, med musikk, og ringer den neste ledige agenten. Det er hjertet av en kontakt-senter, og nyttig i noen kontor hvor anrop kommer raskere enn mennesker kan ta dem.

Hvordan samtaler tilbys

• Rekkefølge: listen over agenter er i rekkefølge; flytt dem opp og ned. I rekkefølge og Round robin følges den.
• Straffpoeng rangerer agenter (0 til 100, 0 når tom): samtalene tilbys de ledige agentene med lavest straffpoeng, og en agent med høyere straffpoeng rings bare når ingen med lavere straffpoeng er ledig. Bruk dem for en første linje og en overflødslinje i én kø.
• Vekt rangerer køer som deler agenter: mens en kø med høyere vekt har noen som venter, tar dens agenter først dens oppringere.
• Avslutning gir en agent tid etter en samtale før neste.
• Lengste ventetid: oppringere som venter lengst går til køens tidsutløpsdestinasjon. 0 venter for alltid.
• Musikk på vent: oppringerne hører køens musikk (enhver klasse fra Lyder (kapittel 20)), systemets, eller køtons.
• Fortell ventende oppringere deres plass i køen og den forventede ventetiden (gjennomsnittlig ventetid for besvarte oppringere i dag, i minutter), hver så mange sekunder, på køens språk. Ordene kommer fra køens prompter i Lyder (kapittel 20); inntil de er innspilt, sies ingenting.

Skjermen Køer er en live tavle: hvem venter, hvor lenge, og hver agents tilstand.

Agenter

Agenter ringer *45 for å logge inn eller ut av hver kø, og *46 for å pause (en pause) og gjenopprette; pausede og logged-out agenter tilbys ikke samtaler. Tavlen har samme knapper, og viser hvorfor en agent pauserte.

Overvåkere

På Aktive samtalene (kapittel 46), Overvåk ringer en overvåkers telefon; når de svarer, kan de lytte (høres av ingen), viske (høres bare av agenten) eller bryte inn (høres av begge), og kan skifte mellom dem under samtalen.

Køer med faste agenter og VIP-er

Slå på Faste i en kø, og en gjentakende samtale (en som ble besvart i løpet av de siste 30 dagene, eller så mange som du setter) blir først tilbudt agenten som svarte sist, hvis den agenten er ledig; hvis de ikke svarer, fortsetter køen som vanlig. VIP-samtaler, nederst i Køer, går foran hver kø de ringer, etter eventuelle VIP-samtaler som allerede venter, og er merket VIP på tavlen.

Utgående oppkobler

Den utgående oppringeren (kapittel 19) ringer liste over kontakter for en kø (kapittel 18)'s agenter: fornyelser, avtalepåminnelser, innkrevinger, undersøkelser. Hver kampanje har sin egen kø, sin liste og sin måte å ringe på:

1. Legg til kampanje: dens kø, dens ringende ID (nummeret kontaktene ser), timene samtaler kan gjøres i en tidssone, hvor lenge en kontakts telefon ringer, hvor mange forsøk og hvor langt fra hverandre.
2. Åpne Kontakter og Legg til en liste: en CSV-fil med en header-rad og en kolonne kalt number (eller phone); name og andre kolonner vises til agenten i forhåndsvisning. Duplikate og ugyldige numreer hoppe over.
3. Ta opp meldingen (i kampanjen): hvem som ringer og hvorfor, og "trykk 9 hvis du ikke ønsker disse samtaler". Den spilles av til en person som har svart når ingen agent er ledig, og, hvis du velger, etter en beskjed på en telefonsvarer.
4. Start den. Den ringer bare innenfor sine timer, og stopper å ringe når den er pause eller ingenting er due.

Personer og maskiner. BitVoice lytter til de første sekundene etter en beskjed: en lang, uavbrutt hilsen er en telefonsvarer; en kort «hallo?» og en pause er en person. En maskin kan legges på (og forsøkes igjen), eller en melding kan bli etterlatt, eller den kan overføres til en agent som hvem som helst andre. Når det er tvil, tar den svaret for en person.

Frafunnete oppkall. En person som har svart når ingen agent er ledig i to sekunder, hører meldingen og teller som frafunnet. Med kraftig og prediktiv ringing, hvis andelen frafunnete oppkall over de siste hundre svarene går over kampanjens grense (3% med mindre du endrer det, US-regel), ringer kampanjen ett oppkall per ledig agent til det er tilbake under. Kampanjen viser sin frafunnsrate, oppkall som ringer og ledige agenter live.

Ikke ring liste. Ingen kampanje ringer et nummer på ikke ring listen, uansett hvilken liste det kom inn på; hvem som helst som trykker 9 under meldingen, legges til med en gang. Legg til numre for hånd eller gjennom API (POST /api/dnc). For den nasjonale registret (i USA, FTCs National Do Not Call Registry: last ned områdeskodene du ringer som en flat fil), velg filen under Nasjonalt register og Import: hver linje med et nummer teller (212,5550100 som FTC skriver dem, eller ett nummer per linje), overskrifter og ødelagte linjer hopper over og teller. Med Erstatt siste import på, fjernes de forrige nedlastningens numre først, så et nummer som har forlatt registret kan ringes igjen; numre lagt til for hånd eller ved å trykke 9 forblir alltid. Registret må oppdateres minst hver 31. dag (US-regler); siden teller listen og hvor mye av den som kom fra registret. API er POST /api/dnc/import?replace=1 med filen som brødteksten.

Lyder: prompter, språk og ventemusikk

Lyder (kapittel 20) inneholder alt BitVoice sier eller spiller til oppringere, bortsett fra hilsener og menyprompter, som blir innspilt der de brukes.

Prompter, på hvert språk

En prompt er en ting BitVoice sier: "Vennligst tast inn din PIN", "Din plass i køen er", tallene den leser opp. Navn- og oppslagskataloger, innringing (DISA), vekkingssamtaler og køannonsering snakker med dem. BitVoice har ordene til hver prompt på engelsk, spansk, fransk, tysk, italiensk, portugisisk, nederlandsk og polsk; tall leses opp siffer for siffer, som høres likt ut på hvert språk.

• Samtaler hører setter språket for alle. En kø, en innringingsnummer, en katalog eller en utvidelse kan velge et annet.
• Hver prompt kan innspilles i nettleseren, lastes opp (en hvilken som helst lydfil; den blir omgjort til telefonlyd) eller laget av tale-tjenesten: med en talemodell satt i Innstillinger, AI, en knapp lager hver prompt i et språk fra dens ord. Prompter som allerede er innspilt, blir beholdt med mindre du ber om å erstatte dem.
• Legg til et språk for et hvilket som helst annet språk (en kode som sv, ja eller pt-BR); dens prompter blir innspilt eller lastet opp, med de engelske ordene vist som en guide.
• En manglende prompt i et språk spilles på standard-språket, deretter på engelsk; med ingen innspilt i det hele tatt, hører samtaler en kort tone, så hver funksjon fungerer før en enkelt prompt er innspilt.

Bakgrunnsmusikk

Bakgrunnsmusikk er gruppert i klasser (Roft, Jazz, Salgs Tilbud…), hver en liste over spor som spilles ett etter ett, fra starten eller tilfeldig. Last opp spor på opptil femten minutter i ethvert format nettleseren kan lese; MP3- og WAV-filer kan også sendes direkte til API-et (PUT /api/music/{class}/{name}), og BitVoice dekoderer MP3 selv (MPEG-1, 2 og 2.5 Lag III, med en dekoder som gir samme eksempler som minimp3).

Internett radio. En klasse kan spille en strøm i stedet for sine spor: oppgi en MP3-strøms adresse (Icecast, Shoutcast, de fleste internett radio) under Internett radio. BitVoice kobler til når den første samtaler blir satt på vent med denne klassen, spiller den ene strømmen til alle som venter, og kobler fra halvannen minutt etter at den siste forlater.

Standard for alle kan være ventetonen, så ingenting endres før du velger musikk. Velg ventetonen på en kø eller utvidelse holder tonen der.

Menyer (auto attendant)

En meny (en auto attendant) besvarer, spiller en prompt og sender ringende der de trykker: 1 for salg, 2 for support, 0 for resepsjon.

Innstilling av en meny

1. På Menyer (kapittel 21) trykk Legg til meny og gi den et navn (og et nummer, hvis ansatte skal kunne ringe det).
2. Legg til valg: en tast, en etikett, og hvor taster går.
3. Ta opp prompten i nettleseren, eller last opp en innspilling i noe format (den konverteres til telefonlyd). Si hver valg: "For salg trykk 1, for support trykk 2."
4. Velg hva som skjer når ringende trykker ingenting: tidsutløpsdestinasjonen, etter at prompten har spilt antall gjentakelser du har satt.
5. Peke en innkommende rute (eller en timeplan) mot menyen.

Valg

• Ringende kan taste en utvidelse: ringende som kjenner nummeret skriver det under prompten.
• Vent på en tast: sekunder etter prompten før den gjentas.
• En tast kan gå til en annen meny, for en andre nivå ("for regningspørsmål trykk 1").

Prompter i andre stemmer

Med AI slått på (Innstillinger), kan en prompt skrives som tekst og leses av AI-stemmen istedenfor innspilt.

Navn-oppkoblingsskatalog

En dial-by-name-katalog (kapittel 22) lar oppringere nå noen uten å kjenne deres nummer: de staver de første bokstavene i navnet på tastaturet (2 for ABC, 3 for DEF, opp til 9 for WXYZ) og blir koblet gjennom.

1. Legg til katalog, navngi det, og gi det et nummer (411, for eksempel) eller la nummeret være tomt og bruk det som et menyvalg.
2. Velg hva samtaler skal stave: etternavn (vanlig), fornavn, eller begge.
3. Velg hvem som er listet, eller ingen for å liste alle med en telefon.

Samtaler hører "Vennligst oppgi de første tre bokstavene i personens navn". En match kobles til med en gang. Flere leses opp, åtte om gangen: hver persons navn, deretter "for å ringe denne personen, trykk 1", 2 og så videre, med 9 for flere navn. Ingen match: "Ingen matcher", og de prøver igjen (tre forsøk).

Uttales navn: Innspill hver persons navn på deres utvidelse (Uttales navn: Innspill i nettleseren eller last opp en fil), og katalogen sier det; inntil da leser den ut utvidelsesnummeret. Katalogens egne ord kommer fra katalogpromptene i Lyder (kapittel 20), på dets språk.

Innkobling (DISA)

En dial-in (kapittel 23) (DISA, "direkte innvendig systemtilgang") lar noen ringe inn fra utsiden, bevise hvem de er, og ringe ut igjen gjennom kontoret: samtalen går ut med kontorets oppringer-ID, dens ruter og dens takster, som om de var ved deres skrivebord.

1. Legg til dial-in, og sett et PIN (4 til 10 sifre), de numrene som er tillatt å bruke det (Kun fra disse numrene), eller begge deler. En av de to er påkrevd.
2. Velg utvidelsen som samtalen blir gjort fra: dens utenom-kalle-tillatelse, oppringer-ID og utgående ruter gjelder. Den må være tillatt å ringe utenom.
3. Gi det et nummer å ringe inn, og send et telefonnummer til det på Samtale-ruting (kapittel 8) (velg dial-in som destinasjon).

Oppringere hører "Vennligst tast inn ditt PIN, så trykk på hash", så "Vennligst tast inn nummeret du vil ringe, så trykk på hash", og blir koblet gjennom. Ordene kommer fra dial-in-promptene i Lyder (kapittel 20).

Taleboter (AudioSocket)

En talebot (kapittel 24) er et program du selv har laget (en AI-agent, en tale-gjenkjenning IVR, en opptaker) som tar oppkall over AudioSocket, det enkle protokollen Asterisk bruker: BitVoice svarer på oppkallet, åpner en TCP-tilkobling til boten og sender oppkallets UUID, deretter callerens lyd som 20 ms-rammer av 8 kHz 16-bit lineær audio og hver tast trykket; hva som helst lyd boten sender tilbake, spilles til calleren. Bots og tale-tjeneste-tilkoblinger skrevet for Asterisks AudioSocket fungerer uendret med BitVoice.

1. Legg til talebot: dens navn, botens adresse (10.0.0.9:9092) og, valgfritt, et nummer for å ringe den.
2. Velg hvor calleren går hvis boten ikke kan ta oppkallet, eller bryter av (en person, en kø, voicemail): påkrevd, så ingen caller noen gang blir droppet fordi en bot er nede.
3. Send oppkall til den fra Oppkallsruting (kapittel 8), en menyvalg, en timeplan eller en omkopling.

Når boten sender en AudioSocket-oppkobling, avsluttes oppkallet; når calleren legger på, sendes en til boten. En bot som ikke kan nås innen tre sekunder, eller hvis tilkoblingen bryter uten en oppkobling, overfører calleren til reservevalget, og feilen logges.

For å bringe et program inn i et oppkall som allerede er i gang (en lytting transkriber, en assistent som hvisker til ingen), bruk ARI-ekstern media: se Asterisk-kompatibilitet (kapittel 70).

Dag/natt-omkoplinger

En dag/natt-omkopling (kapittel 25) er en bryter for en oppkallstrøm (FreePBX kaller det oppkallstrøm-kontroll). Oppkall sendt til den går til dens normale destinasjon, eller til den andre mens noen har skiftet den over: kontoret lukker tidlig på grunn av en storm, noen ringer *281 på vei ut, og oppkall går til voicemail til det skiftes tilbake om morgenen. Den forblir som den ble latt, over omstarter.

1. Legg til omkopling, gi den en kode (1 til 3 siffer: ringt etter *28) og velg hvor oppkall går normalt og når den er skiftet over. Begge sider kan være en timeplan, så en omkopling kan sitte foran åpningstidene og overstyre dem.
2. Velg hvem som kan skifte den fra en telefon (ingen valgt lar hvilken som helst utvidelse).
3. Send oppkall til den fra Oppkallsruting (kapittel 8), en menyvalg eller en timeplan, som enhver annen destinasjon.

Skift den ved å ringe *28 og dens kode (en stigende tone: skiftet over; en synkende tone: tilbake til normalt), med omkoplingen ved siden av den på Omkoplinger-siden, eller gjennom API (POST /api/toggles/{id}/state). En busy-lampe-nøkkel som overvåker *281 er lys mens den omkoplingen er skiftet over, så personen som lukker opp kan se det fra sin pult. Omkoplingskoden selv er på Funksjonskoder (kapittel 32).

Timeplaner

En timeplan sender samtalene en vei når du er åpen og en annen når du er stengt. Peke en innkommende rute mot en timeplan, og timeplanen mot menyen (åpen) og voicemail (stengt).

Åpningstider

Hver linje med tider er en sett av dager og en tid fra og til. Flere linjer er tillatt: mandag til fredag 9:00 til 17:00, og lørdag 10:00 til 13:00. Tider kan kryss midnatt (22:00 til 06:00) for nattskifter.

Helligdager

Helligdager teller som stengt hele dagen, uansett hva tider sier. Legg til hver dato med et navn; navnet vises på Samtaleflyt (kapittel 16) når du prøver en samtale på den dagen.

Tidssone

Tidssonen er den i Innstillinger. Når klokken endrer, følger timeplanene lokal tid.

Skript (JavaScript og Lua)

Et skript bestemmer hvor en samtale går når menyer, timeplaner og grupper ikke er nok: ringende fra ett område til ett kontor, VIP-numre rett til en person, en beslutning fra dine egne data. Eller, sett til Kjører hele samtalen, besvarer det samtalen og kjører den, som en Asterisk-dialplan eller AGI-skript ville: promter og tale, taster, innspillinger, ringing av personer, overføring (nedenunder). Skriptene skrives i JavaScript eller Lua på Skript (kapittel 27).

Sikker ved design

• Et ruting-skript kjører i maks 200 ms. Hvis det feiler eller tar for lang tid, går samtalen til skriptets fallback, så en feil aldri mister en samtale. (Samtale-skript har sine egne begrensninger, nedenfor.)
• Det kjører i en sandbox: det kan ikke nå nettverket eller disken. Et ruting-skript kan bare velge; et samtale-skript kan bare gjøre de trinnene listen nedenfor, til sin egen samtale.
• Nødoppringer kjører aldri skript.

Hva et skript ser

call har:

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

Bruke et skript

Pek en innkommende rute, en menytast eller en timeplan mot skriptet, som mot en hvilken som helst destinasjon. Test kjører det med et oppring du beskriver, uten å plassere et oppring; kjørelisten viser hver ekte kjøring med dens avgjørelse, tid brukt og eventuelle feil. Oppringsflyt (kapittel 16) kjører også skript når du prøver et oppring.

Skript som kjører hele oppringen

Velg Kjører hele oppringen. Skriptet svarer da på oppringen og går fra topp til bunn, hvor hvert steg venter til det er ferdig:

En destinasjon er et nummer (en utvidelse, ringgruppe eller kø her, ellers et eksternt nummer gjennom utgående ruter; aldri et nødnummer) eller {type, target} som ovenfor. En tast trykket under en lyd stopper den; play og say returnerer den og den neste collect starter med den. Å returnere en destinasjon sender oppringen dit.

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()
}

Lua har de samme stegene (collect{max = 1}). Gi skriptet et Nummer å ringe for å ringe det fra en utvidelse.

Dets grenser holder oppringen trygg: skriptets egen kode kan kjøre maks en fjerdedel sekund mellom to steg; en oppring tar maks 1 000 steg; og hele skriptet stopper etter sin Lengste kjøring (10 minutter med mindre du sier, 60 som mest). Når det feiler, stoppes eller avslutter uten å avslutte eller overføre oppringen, går oppringen til sin fallback; en oppringer som legger på stopper det med en gang. Prøv det kjører skriptet med tastene du sier oppringeren trykker og lister hver steg, uten å plassere et oppring.

AI-resepsjonist, voicemail-triage og spørsmål

AI-funksjoner bruker AI-tjenesten satt i Innstillinger (kapittel 14): en OpenAI-kompatibel tjeneste (OpenRouter som standard) eller en du kjører selv. Hva de trenger sendes der, så velg en tjeneste du stoler på med samtaler; for en 911-sentrale, dens eget regjeringsnettverk teller som lokal.

AI-resepsjonist

Velg en resepsjonist som hvor samtaler går: en rute, et menyvalg eller en utvidelses Hvis ingen svarer. Den sier at den er automatisert, besvarer bare fra Godkjent informasjon, tar en melding, booker en tilbakekalling (se Tilbakekallinger (kapittel 30)), eller overfører til En person er. Trykk 0 eller spør om en person når du alltid når noen, og så gjør også noen problemer med AI-tjenesten eller talemodellen: ringere blir aldri stukket med den.

Modeller

Modell gjør tekstarbeid: sammenfatninger, resepsjonistens svar og spørsmål på vanlig språk. Å omdanne tale til tekst trenger en modell som tar audio; sett den som Tale-til-tekst-modell (for eksempel google/gemini-2.5-flash på OpenRouter) for å bruke en tekst-basert modell for resten, som meta-llama/llama-3.3-70b-instruct.

Tale til tekst i bygningen

Tale kan skrives ned uten noen språkmodell: en talegjenkjenner (whisper) hører audioen og skriver hva som ble sagt, ikke mer. Hvem skriver tale ned, i AI-innstillingene, har tre valg:

• Modellen over: audioen går til AI-tjenesten, hvis modell må ta audio.
• Denne serveren: BitVoice kjører whisper selv. Velg en Whisper-modell og lagre: BitVoice henter den en gang fra whisper.cpp-prosjektet (base er 60 MB; small, medium og large-v3-turbo er mer nøyaktig og langsommere; alle forstår omtrent 100 språk), sjekker den mot dens publiserte SHA-256, og starter whisper.cpp sin whisper-server på 127.0.0.1 ved siden av den, og starter den på nytt hvis den stopper. Ringernes audio forlater aldri datamaskinen og ingenting betales per samtale. whisper-server (MIT-lisens) kommer i BitVoice sine nedlastinger ved siden av programmet, og installatorene legger den ved siden av BitVoice; BitVoice finner også en installert på egen hånd (brew install whisper.cpp). Innstillingene viser hvor den står (henter modellen, starter, kjører, eller hvorfor den ikke er), og det gjør også Helse (kapittel 13). Mens den ikke kjører, feiler transkripsjoner og sier hvorfor: de blir aldri sendt noen andre steder i stedet.
• En tale-til-tekst-tjeneste: whisper.cpp sin whisper-server på en annen datamaskin i bygningen (http://192.168.1.20:8178/inference), for en maskin med en GPU som betjener flere BitVoice-servere, eller noen OpenAI-kompatibel …/audio/transcriptions (med Dens modell, som whisper-1, og Dens nøkkel). Bare http er akseptert til denne datamaskinen eller en privat nettverksadresse; alt annet må være https. For å kjøre en: 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.

Fakta nevnt i samtalen (ingen språkmodell)

Hver transkript leses også av regler, uten språkmodell, for faktene en call-taker noterer: hva som skjedde, hvor, hvor mange som er skadet (eller at ingen er), tilstander (pusting, våken, blødende ...), farer (brann, røyk, gass, våpen, kjemikalier, drivstoff), kjøretøy, hvem ringende er i forhold til personen i need, og et tilbakekallingsnummer. Hver faktum vises med setningen det kom fra og siden som sa det, i transkriptets Fakta nevnt i samtalen. Uten en modell, skrives sammenfatningen fra disse faktene alene, og sier det.

• Ingen ting legges til som ingen sa. "Ingen er skadet" er et faktum for seg; en ringende som videreformidler noen andres ord ("hun sier han puster ikke") merkes rapportert; "24 Pine Lane. Nei, unnskyld, 42" beholder 42; et bart "nei" svarer på spørsmålet som ble stilt rett før.
• Det er trofast, ikke fullstendig: ord det ikke kjenner, blir oversett. På tre sett med oppfunnete 911-samtaler (ingen ekte ringendes ord), finner det:

Det forseglende poengsummen er det en kan forvente på samtaler den ikke har sett, og de tre settene ble skrevet av samme personer som reglene, så virkelige samtaler vil sannsynligvis gjøre det dårligere. Les faktumene ved siden av transkripsjonen, aldri istedenfor den.

Større modeller trenger mer prosessor: en server som skriver ut mange samtaler samtidig, bør starte med base, eller bruke en maskin med en GPU som en tale-til-tekst-tjeneste for bygningen. På Apple-computere bruker whisper GPU-en.

Voicemail-triaging

Med Transkriber og summer voicemail på, blir hvert meldingsopptak også merket som急, normalt eller lav prioritet, med sin type (salg, support, fakturering...). Urgente meldinger utløser en varsel på hver administrators skjerm.

Spør på enkelt måte

På Endringer (kapittel 61), beskriv en endring ("send salgsoppringer til voicemail etter kl. 17"). AIen foreslår den, BitVoice sjekker den som enhver annen endring og viser nøyaktig hva som ville endre seg. Ingenting endres før du trykker Apply, og den blir en revisjon du kan gjenopprette. Passord sendes aldri til AIen.

Postkasse

Hver utvidelse kan ha en postkasse. Oppringere som ikke blir besvart hører dens hilsen og lar en melding; personen hører den på sin telefon, leser den på skjermen eller får den via e-post.

Slå det på

På utvidelsen, slå på Postkasse. Hvis ingen svarer er da satt til postkassen. Gi den et PIN (4 til 10 sifre): det åpner postkassen fra en annen telefon, og logger personen inn på medarbeiderportalen og på varme skrivebord.

Avspilling

• Fra egen telefon på utvidelsen, tast *97: meldinger spilles av nyeste først; tastene gjentar, sletter eller beholder hver enkelt.
• Fra en annen telefon, tast *97, skriv inn postkassenummer og dets PIN.
• På Voicemail (kapittel 29) (administratorer) eller i portalen for ansatte (personen): avspill, markér som hørt, slett.
• Telefonens meldingslys er på så lenge det er nye meldinger.

Med AI

Med Transkriber og summer postkasse på (Innstillinger, AI), blir hver melding skrevet ut, summerert på en linje, og merket som急, normal eller lav prioritet med sin type (salg, support, fakturering). Urgente meldinger utløser en varsling på hver administrators skjerm. Se AI (kapittel 28).

Lydrensing

Lydrensing (Innstillinger) fjerner jevne bakgrunnsstøy og jevner ut nivåer mens meldinger lagres, så en melding fra en bil eller en travel gate er lettere å høre.

Tilbakekall

Personer som ba om å bli ringt tilbake. En AI-resepsjonist bestiller en når en ringer ber om det: den samler inn navn, nummeret til å ringe (og tilbyr nummeret de ringer fra), en god tid og hva det gjelder, leser det opp igjen og bestiller det bare når ringeren samtykker. Den lover aldri en nøyaktig tid. Administratorer kan også legge til tilbakekall manuelt.

En ny tilbakekall viser en advarsel på hver åpen skjerm og blir sendt til eieren av resepsjonistens Ta meldinger for postboks når den utvidelsen har en e-postadresse og e-post er satt opp i Innstillinger.

For å ringe tilbake, velg din utvidelse og trykk Ring tilbake: telefonen din ringer først, og når du tar opp, ringer BitVoice nummeret for deg, med dine normale ruter og ringernavn. Deretter legg til en notis hvis du ønsker og trykk Ferdig (eller Avbryt). Fulle tilbakekall blir vist under åpne og kan åpnes igjen.

Samtalelenker og nettsamtaler

En samtalelenke er en nettadresse som ringer bedriftens telefon fra enhver nettleser: ingen telefonnummer, ingen app. Sett den i en e-post-signatur, skriv ut QR-koden på en flyer eller et butikkvindu, eller lim inn nettsideknappen på nettstedet ditt.

På Oppringingslenker (kapittel 31) legger du til en lenke, velger hvor oppringningene går (en utvidelse, en gruppe, en kø, et meny, AI-resepsjonist, en timeplan eller en voice-mail), og lagrer: siden viser adresse og QR-kode. Oppringeren ser tittelen og ordene du har satt, angir navn hvis du ber om det, tillater mikrofonen og trykker på Ring nå; tastaturet fungerer for menyer. Den som svarer ser Web: og oppringerens navn.

Slå Åpen av for å lukke linjen (siden sier det). Samtaler på en gang begrenser hvor mange personer som kan ringe gjennom en lenke (5 med mindre det er satt). Adressen inneholder en lang tilfeldig del, så den kan ikke gjettes; gjentatte feilaktige adresser blokkeres som feil innlogginger. Oppringernes mikrofoner trenger at siden serveres over HTTPS, så del ut HTTPS-adressen.

Funksjonskoder, videreformidling og hurtigvalg

Funksjonskoder er hva folk ringer på telefonene sine for å endre egne innstillinger og nå funksjoner. De fungerer på hver telefon, skrivebords- eller softphone, uten at noe er konfigurert på telefonen selv. En stigende tone betyr ferdig; en fallende tone betyr avvist.

Kodesamlingen på ett blunk

Videreformidling

• *72 videreformidler hver samtale. Ring det, hør en tone, så ring nummeret og #. Eller ring nummeret rett etter koden.
• *90 videreformidler samtaler som kommer mens du er på samtale. *52 videreformidler samtaler du ikke besvarer innen din ringetid.
• *73, *91 og *53 avbryter dem.

Videreformidling til en annen utvidelse bruker den utvidelsens egne innstillinger (dens voicemail, dens følg meg), opp til fire hopp så to personer som videreformidler til hverandre ikke kan danne en loop. Videreformidling til et eksternt nummer går gjennom utgående ruter, som om personen ringte det, og trenger at utvidelsen er tillatt eksterne samtaler.

Videreformidling er live-tilstand, ikke konfigurasjon: å sette den gjør ingen revisjon, og den beholdes over omstarter. Utvidelser (kapittel 3) og personaleportalen viser og endrer den også.

Ikke forstyr

*78 på, *79 av, *76 skifter. Med ikke forstyr på, samtaler går til voicemail, eller til utvidelsens ikke-svar-destinasjon. Ikke forstyr satt for hånd vinner over kalenderen (Kalendere (kapittel 39)). Nødsamtaler ringer fortsatt.

Følg meg

*21 slår follow-me på og av for utvidelser som har follow-me-numre angitt (på utvidelsen eller i ansattportalen). Skrivebordet ringer først i sin ringetid, deretter follow-me-numrene, ett etter ett eller alle sammen. På et eksternt nummer med trykk 1 på, hører personen en tone og trykker 1 for å ta opp samtalen; en voicemail eller stilhet gjør aldri det, og etter 15 sekunder flyttes samtalen videre.

Besvarer noen andres samtale

• *8 besvarer den eldste samtalen som ringer noen i din hentegruppe (angitt på hver utvidelse; navn sammenlignes uten hensyn til store og små bokstaver).
• ** og en utvidelse besvarer en samtale som ringer den utvidelsen: **101.

Intercom

*80 og en utvidelse ringer den med auto-svar: dens telefon svarer på høyttaleren, og begge sider snakker. Yealink, Grandstream og Snom leser BitVoices Call-Info-header, Poly leser Alert-Info; noen telefoner trenger intercom tillatt i sine egne innstillinger. En utvidelse kan nekte intercom; da ringer samtalen som vanlig. Dørstasjoner tar aldri intercom.

Hurtigvalg

*0 og en kode ringer et lagret nummer: *05. Selskapets hurtigvalg er på denne siden; hver person kan ha sine egne på sin utvidelse eller i ansattportalen, og deres seirer over selskapets med samme kode. Kodene er 1 til 3 sifre.

Endre kodene

Hver kode kan endres på Funksjonskoder (kapittel 32), eller slås av med ordet off. To funksjoner kan ikke dele en kode, og ingen kode kan være en utvidelses eller en gruppes nummer: BitVoice sier hvilken som kolliderer. Ekko, voicemail og park-numre er i Innstillinger (kapittel 14).

Ansattportalen

Personaleportalen lar alle se etter sine egne samtaler uten en administrator: ikke forstyr, videreformidling, følg-meg, hurtigvalg, voicemail og dens hilsen, deres PIN, og en liste over deres egne samtaler. Den er på #/me på denne serverens adresse, og koblet fra innloggingssiden.

Innlogging

Personer logger inn med sin utvidelsesnummer og sin voicemail-PIN: samme PIN som åpner deres voicemail fra en telefon og logger dem inn på varme skrivebord. En utvidelse uten PIN kan ikke logge inn; en administrator setter en på utvidelsen.

Gjentatte feil forsøk fra en adresse låser den ute i ti minutter. En portaløkt når bare personens egne innstillinger: aldri en annen utvidelse, konfigurasjon eller noen opptak.

Hva personer kan gjøre

Videreformidling og ikke forstyr som settes her er de samme som de som settes fra telefonen med funksjonskoder (Funksjonskoder (kapittel 32)): hvilken som helst som ble satt sist er i kraft. Følg-meg-numre og hurtigvalg er en del av utvidelsens konfigurasjon, så å endre dem gjør en revisjon på Endringer (kapittel 61), registrert som personens egen.

Chat og tilstedeværelse

Portalens Chat-faner viser kolleger med hvordan de er akkurat nå: tilgjengelig, på samtale, ringer, borte (ikke forstyr, et møte eller fravær fra kalenderen, med årsaken) eller frakoblet (ingen telefon tilkoblet), og statusen de har skrevet ("På lunsj, tilbake kl 14"). Velg en person for å sende melding; meldinger ankommer med en gang, og et tall ved siden av et navn teller ubeskjedne meldinger. Teamrom (Innstillinger, Personalechat) er samtaler for en gruppe eller for alle når et rom ikke har noen medlemmer.

Meldinger sees bare av personene i samtalen: administratorer håndterer rommene, leser dem aldri. Innstillinger, Personalechat slår av chat, og setter hvor lenge meldinger beholdes (0 beholdes de nyeste tusen av hver samtale).

Konferanserom

Et konferanserom er et nummer mennesker ringer for å snakke sammen. Ansatte ringer det fra sine skrivebord; eksterne ringere når det gjennom en inngående rute eller et menyvalg som peker på rommet.

Oppsett av et rom

1. Åpne Konferanserom (kapittel 34) og trykk Legg til konferanserom.
2. Gi det et nummer (ethvert ledig nummer, 500 som standard) og et navn.
3. Valgfritt sett et PIN. Ringere hører en tone, skriver inn PIN og trykker #. Tre feil PIN og samtalen avsluttes.
4. Valgfritt sett et leder-PIN, forskjellig fra PIN. Den som skriver det inn, går med som leder.
5. For å la eksterne ringere komme inn, peker en inngående rute (eller et menyvalg) på rommet.

Valg

Nøkler under en samtale

• 1 demper og demper opp deg selv (i et rom hvor medlemmer er stumt, ber det om å snakke).
• 2, for en leder, låser rommet så ingen nye kan gå med, og låser det opp.

Mens et rom er i bruk

Siden viser hvert rom i bruk: hvem som er i, hvem som snakker (den grønne lykten), hvem som er stumt, hvem som har bedt om å snakke, og hvem som fortsatt venter på lederen. En administrator kan dempe eller dempe opp noen, fjerne noen, og låse eller låse opp rommet.

Alle i et rom hører alle andre som ikke er stumt, blandet av BitVoice; hver persons telefon kan bruke sin egen codec. En samtaleopptak beholdes for hver persons samtale, og en for rommet selv med varighet og opptak.

HD-lyd

Slå på HD-lyd i et rom (nye rom har det på) og det blandes i 16 kHz i stedet for 8: mennesker på bredbåndstelefoner (G.722, Opus, nettleser-telefonen) hører hverandre i HD, med skarpheten til et moderne oppkall, mens mennesker på vanlige telefoner (G.711, mobiltelefoner gjennom en leverandør) hører samme rom som vanlig. Den live-visningen markerer rommet og hver medlem som er i HD. HD trenger G.722 blant codecene telefonene bruker (det er først i systemets liste, Innstillinger, Codec). Opptak av rommet beholdes i telefonkvalitet.

Videorom

Sett Video på et rom og videotelefoner (og softtelefoner) som går med, sender kamera og ser ett bilde, skiftet når mennesker snakker, som i Asterisks ConfBridge:

• Følg taleren: alle ser hvem som har snakket i ett sekund, en gang den på skjermen har vært stille i ett sekund; personen på skjermen ser den før.
• Vis lederen: alle ser lederen (som går med med leder-PIN); lederen ser hvem som snakket sist.
• Rutenett: alle ser alle på en gang, side om side (ett bilde fyller skjermen, to side om side, så 2 på 2 og 3 på 3, opp til ni), hver person i sin egen plass i rekkefølgen de gikk med, inkludert seg selv.

BitVoice skifter bildene uten å dekodere dem, så det koster nesten ingenting, og det ber hver nytt bilde fra telefonen om et fullt bilde (RTCP PLI og FIR, og SIP INFO billed-hurtigoppdatering de fleste skrivebords-telefoner svarer) så skiftet vises med en gang. Hvert medlems video bruker rommets video codec (H.264 med mindre du velger VP8); en telefon uten det går med med lyd bare. Hver seer får en stabil strøm (en kilde, sin egen payload-type), uansett hvem som er på skjermen.

Et rutenett lages på en annen måte: BitVoice gir hver bilde til ffmpeg på serveren, som dekoder dem, plasserer dem i et 1280 x 720-bilde med 15 bilder per sekund og koder det en gang for alle. Installer ffmpeg (Innstillinger, videoomvandling, sier om den er funnet); uten den følger et rutenettrom speakeren og rommets skjerm sier det. Hvert bilde koster prosessortid: på en liten server, hold rutenettene til noen få rom samtidig. Bare medlemmer hvis kamera sender er vist: noen som slutter seg uten video eller hvis kameraet stopper, forlater rutenettet (det fryser aldri på et stille kamera), og rutenettet gjenoprettes innen noen sekunder når det endres, med en kort pause i bildet. Den tiende medlemmen og senere høres, men vises ikke. Live-visningen markerer rutenettets størrelse og hvem som er i rutenettet.

Alle videoer (nettlesere)

Velg Alle videoer og rommet får sin egen side (Konferanserom, Åpne videorommet, eller #/video-room/NUMBER). Hver person der trykker Slå på med kameraet mitt: nettleseren sender kameraet en gang, i tre størrelser (simulcast), og mottar hvert annet kamera i sitt eget bilde. BitVoice videreformidler bildene som de kom, uten å dekodere dem (en selektiv videreformidlingsenhet, SFU), så det koster lite prosessortid; opplastingen av hver nettleser og nedlasting av hver viser er hva som begrenser et rom, så det tar opp til 16 kameraer.

• Det store bildet får full størrelse på det kameraet, de små bildene får liten størrelse; Gjør stort bytter dem, og switching skjer ved neste fullstendig bilde av den nye størrelsen, som BitVoice ber om med en gang (RTCP PLI).
• En nettleser som er kort på opplasting stopper å sende sin største størrelse; viserne får da den største størrelsen som fortsatt kommer.
• Lyden er rommets konferanse som alltid: å slå på kaller rommet på nettleser-telefonen, og hvem som ringer rommet fra en telefon høres og hører alle. Videotelefoner som ringer inn ser hvem som snakker.
• Et rom med en PIN ber om den på siden. Siden trenger en pålogging til BitVoice.

Del en skjerm: trykk Del min skjerm og velg en skjerm, et vindu eller en nettleserfane i nettleserens egen velger. Alle i rommet ser det som det store bildet, under ditt navn, med tekst som holdes skarp (bildesendingen reduseres i stedet når nettverket er kort). Du trenger ikke å bli med på kameraet ditt først. Stop deling, eller nettleserens egen Stop deling-linje, avslutter det.

• Et rom viser en delt skjerm om gangen: mens noen deler, venter andre knapp og sier hvem som deler. En delt skjerm teller ikke med i de 16 kameraene.
• En annen person kan gjøres til det store bildet med Gjør stor, som med kameraer; skjermen forblir i rommet.
• Skjermens bilde bare, aldri lyden: rommets lyd forblir konferansen.
• Telefoner som ikke kan dele en skjerm (de fleste nettleserbrett) viser knappen grået ut. Skrivebords- og andre videotelefoner som ringer inn til rommet ser ikke delte skjermer; de ser hvem som snakker.

Paging og høyttalere

Paging snakker gjennom mange telefoner på en gang: ring et pagingsnummer, og hver telefon i gruppen svarer på sin høyttaler av seg selv. Bruk det til annonseringer til en lager, en skole, en butikk-gulv.

Oppsett av en høyttalergruppe

1. På Høyttalere (kapittel 35) trykk Legg til høyttalergruppe og gi den et nummer (800 som standard) og et navn.
2. Velg telefonene. Overhead-høyttalere som er satt opp som utvidelser (type Overhead-høyttaler) kan også være medlemmer.
3. Valgfritt, en multicast-adresse og port.

Multicast

Multicast sender også siden til en multicast-adresse og port (239.0.1.10:5000), som G.711 µ-law, som overhead-høyttalere og mange skrivebords-telefoner kan lytte til uten en samtale hver. En gruppe kan bare ha en multicast-adresse. Den fungerer på ett nettverk: routere passerer ikke multicast med mindre de er konfigurert til det.

Høyttalere og intercom

Telefoner som ikke svarer på en høyttaler selv innen noen få sekunder, utelates, så en telefon uten auto-svar holder aldri en høyttaler opp. Noen telefoner trenger auto-svar (intercom) tillatt i sine egne innstillinger.

Hot desking

En hot desk er en delt telefon som blir til den som logger inn på den: for kontorer hvor folk ikke har faste plasser. Lag en ved å slå på Hot desk i utvidelsen telefonen er satt opp som (deskenes egen utvidelse, slik som 900 Desk 3).

Innlogging og utlogging

1. Ved telefonen, ring *33 og vent på tonen.
2. Skriv inn din utvidelse og #, og vent på tonen.
3. Skriv inn din voicemail-PIN og #. En stigende tone betyr at du er logget inn; en synkende tone betyr at det ble avvist.

Deretter ringer samtaler til din utvidelse også denne desken, samt dine andre telefoner, og samtaler du foretar fra den viser ditt nummer og navn og teller som dine på Kostnader. Innlogging på en annen desk flytter deg dit. *34 logger deg ut. Fem feil forsøk låser desken i ti minutter.

Administrasjon av hot desker

På Telefoner (kapittel 4), viser Hot desker hvem som er logget inn hvor; administratorer kan logge noen inn (uten deres PIN) eller ut. Kodene, og en tid hver dag når alle er logget ut, er i Innstillinger. Innlogninger beholdes over omstarter.

Hotell og vekkingoppkall

Vekkingoppkall

Hvem som helst kan bestille en vekking: gjester, nattskifter, personer på vakt. Fra sin egen telefon ringer de *62: BitVoice sier den ene som er satt (hvis noen), deretter angir de tiden som fire siffer (0630), eller trykker stjerne for å avbryte den. På Hotell (kapittel 37) bestiller en administrator en for enhver utvidelse, en gang eller hver dag.

Når det er tid, ringer telefonen med systemnavnet; besvart, hører den "God morgen. Dette er din vekking." (vekking-prompten i Lyder (kapittel 20), på gjestens eller utvidelsens språk). Ubesvart, prøves det igjen (3 forsøk, 5 minutter apart, begge innstilt under Innstillinger på siden), og etter siste gang kan resepsjon-utvidelsen ringes. Med flere servere, gjør bare en vekkingssamtaler.

Gjesterom

Slå på Gjesterom på utvidelsen til hver roms telefon. På Hotel vises hver rom sin gjest, vekking og romstatus, med Sjekk inn og Sjekk ut-knapper.

• Bar ledige rom: rom med ingen innkvartert gjest ringer bare utvidelser og nødnumre. Nødoppringer fungerer alltid.
• Tøm ved utsjekking: sletter rommets voicemail og avbestiller dens vekking, videreformidling og ikke forstyr, klar for neste gjest.
• En gjests språk (fra innkvartering) er språket rommets promter uttales på.
• Romstatus: hotellpersonale ringer *68 og en siffer fra rommets telefon (*683); hotellsystemet bestemmer hva hver siffer betyr.

Hotellsystemet (PMS)

• FIAS: BitVoice kobler til FIAS-grensesnittet til hotellsystemet (Oracle Opera og de mange systemene som snakker FIAS) på dets adresse og port. Den mottar inncheckinger, romflyttinger, utsjekking og vekkingbestillinger, og sender vekkingresultater, romstatus og oppkallingsgebyrer. Mens koblingen er nede, venter det den skulle sende og går når den er tilbake; siden sier om den er koblet. Postene følger Oracles FIAS 2.20.23-specifikasjon: BitVoice beskriver seg selv som et telefonisystem (IF PB), oppkallingsgebyrer er direkte gebyrer (PT C) med beløpet i valutas minste enhet og de valgte digitene uten + eller mellomrom, og et vekkingresultat gjentar den bestilte tiden til sekundet, så hotellsystemet kan matche det med sin forespørsel.
• REST API: hotellsystemet ringer POST /api/hotel/rooms/<room>/checkin (navn, konto, språk), /checkout, og PUT /api/wakeups/<room>, med en API-nøkkel fra Innstillinger, Automatisering. Gebyrer postes som JSON til den adresse du gir.
• Gebyr for oppkall: besvarte eksterne oppkall fra besatte rom går på gjestens regning, til trankens satser (fra Kostnader (kapittel 54)) pluss påslag.

Kontakter på hver telefon

Kontakter er bedriftskatalogen: leverandører, kunder og andre kontorer folk ringer. Hver telefon lister den ved siden av utvidelsene, og når ett av disse numrene ringer inn, viser telefonene og samtalekortet kontaktens navn (når leverandøren sendte ingen). Et nummer matcher uansett hvordan det er skrevet: +1 212 555 0100 og 2125550100 er samme linje.

Legg til kontakter

Legg til kontakt for en om gangen, med så mange numre (arbeid, mobil, hjem, annet) som de har. Importér tar en regneark lagret som CSV hvis første rad navngir kolonnene: navn, selskap, arbeid (eller telefon), mobil, hjem, annet, e-post, notater. BitVoice sjekker hele filen først og sier hvilke linjer som er feil; en kontakt med samme navn som en som allerede er der oppdateres i stedet for å bli lagt til to ganger, og Ersett alle kontakter starter listen på nytt. Eksporter laster ned listen som CSV.

På skrivebords telefoner

Telefoner satt opp av Telefoner (kapittel 4) (provisioning) får katalogen uten mer oppsett:

• Yealink: en fjern telefonbok navngitt Bedrift, oppdatert hver time.
• Grandstream: telefonbok nedlastning, hver time.
• Polycom: katalogfilen, lest når telefonen starter.
• Snom: listen skrives inn i telefonens innstillinger, så den oppdateres når telefonen neste sjekker dem.

I nettleser-telefonen

Kontakter under tastaturet finner et navn eller nummer og setter det klart til å ringe.

Fra Microsoft 365 eller Google Workspace

BitVoice kan holde Kontakter i takt med din organisasjons katalog: alle i den som har et telefonnummer, og dens delte kontakter (Exchanges organisasjonskontakter eller Googles delte domenekontakter). I Innstillinger (kapittel 14), Microsoft 365 og Google Workspace, velg tjenesten, gi hva den trenger, og trykk Sjekk nå: den logger inn, teller personene og sier hvilke utvidelser matcher en person etter e-post. Lagre, og Kontakter fylles inn innen en halv minutt; så hver halvtime, eller med en gang med Synkroniser kontakter nå.

Microsoft 365 (en app-registrering; du må kunne gi admin-samtykke):

1. I Entra-administrasjonssenteret, App-registreringer, Ny registrering: gi den navnet BitVoice, enkeltleiet, ingen omadresseringsadresse.
2. API-tilganger, Legg til en tilgang, Microsoft Graph, Applikasjons-tilganger: User.Read.All, OrgContact.Read.All og Calendars.ReadBasic. Deretter Gi admin-samtykke.
3. Sertifikater & hemmeligheter, Ny klienthemmelighet: kopier verdien (vises én gang).
4. I BitVoice: katalogen (leier) ID, applikasjons (klient) ID og hemmeligheten. En hemmelighet utløper (Microsoft tilbyr inntil to år): når den gjør det, sier kortet at hemmeligheten ble avvist; lag en ny og lim den inn.

Google Workspace (en tjenestekonto; du må være en super-administrator):

1. I Google Cloud, i ett av dine prosjekter: slå på People API og Google Calendar API, lag en tjenestekonto, og legg til en nøkkel (JSON) til den.
2. I Google Admin-konsollen, Sikkerhet, Tilgang og datakontroll, API-kontroller, Domene-omfattende delegasjon, Legg til ny: tjenestekontoenes klient-ID, med omfanget https://www.googleapis.com/auth/directory.readonly,https://www.googleapis.com/auth/calendar.freebusy.
3. I BitVoice: nøkkel-filen, og e-posten til en administrator for tjenestekontoen å fungere som.

Hva som kommer inn:

• En persons arbeidsnummer og mobil, navn, e-post, og deres stillingstittel og avdeling som kontaktenes notater; organisasjonens navn som deres selskap. Personer uten nummer er ikke med (en kontakt trenger ett); kontoer som er slått av er ikke med.
• Kontakter fra tjenesten er merket med dens navn, og blir endret der: å endre eller fjerne en her blir avvist, ettersom neste synkronisering ville gjøre det om.
• BitVoice leser bare. Dens tilgang er de lesen-tilganger ovenfor, og hemmeligheten eller nøkkelen blir lagret med de andre hemmelighetene: visere ser den aldri, og eksport for Git lar den utenfor.

Kalendere og ikke forstyr

En utvidelse kan følge personens kalender: under møter og fritid, går samtaler til voicemail eller blir videreformidlet (til en annen utvidelse eller en mobil), i stedet for å ringe en telefon som ingen vil svare på. Ringegrupper ringer de andre i mellomtiden, og i køer vises agenten som Borte.

I utvidelsen, Kalender og ikke forstyr, lim inn kalenderens private adresse:

• Outlook: Innstillinger, Kalender, Delte kalendere, Publiser en kalender; velg kalenderen og "Kan vise alle detaljer", så kopier ICS-lenken.
• Google Kalender: Innstillinger, kalenderen på venstre side, så Hemmelig adresse i iCal-format.

Sjekk leser den med en gang og lister de neste opptatte tidene. BitVoice leser hver kalender hver femte minutt. Fritid (alle døgns hendelser og Outlooks "utenfor kontor") teller alltid; møter teller når Møter teller som opptatt er på; hendelser merket som ledig teller aldri, og heller ikke avlyste hendelser. Gjentakende møter, med hoppede og flyttede hendelser, forstås. Hvis en kalender ikke kan leses, sier Helse det.

Ikke forstyr nå stopper utvidelsen fra å ringe til den slås av, uansett hva kalenderen sier. Utvidelseslisten viser hvem som er borte og til når.

Den private adressen fungerer som en passord: alle med den kan lese den kalenderen, så den holdes med de andre hemmelighetene.

Hver kalender på en gang: Microsoft 365 og Google Workspace

I stedet for en privat adresse per utvidelse, kan BitVoice lese hver persons kalender fra Microsoft 365 eller Google Workspace: konfigurer det en gang i Innstillinger (kapittel 14), Microsoft 365 og Google Workspace (se Kontakter (kapittel 38) for trinnvis vejledning), med Kalendere sier hvem er borte på. Hver utvidelse er koblet til sin person ved sin e-post; en med en privat adresse av sin egen type bruker den i stedet. Utvidelsens innstillinger her (Møter teller som opptatt, Mens opptatt, samtaler) gjelder som med en privat adresse.

• Microsoft 365 forteller møter fra fravær: et møte merket som utenfor kontor teller som fravær; usikre møter, og tid merket som ledig eller arbeider andre steder, stopper aldri telefonen fra å ringe. Et privat møte vises som "I et møte", uten tittelen.
• Google Workspace gir opptatte tider uten å si hvorfor, så de teller alltid som møter.
• Kalenderne leses hver femte minutt, og med en gang når innstillingene endres. En utvidelse hvis e-post tjenesten ikke kjenner, sier det i sin kalenderdel.

Mobilappene

BitVoice-appene for iPhone og Android gjør en mobiltelefon til en av utvidelsens telefoner. Den ringer som en skrivebords telefon, på telefonens egen samtale-skjerm, selv når appen er lukket.

Konfigurere push

En lukket app våknes for samtaler av en push-melding. I Innstillinger (kapittel 14), Mobilappene, velg en:

Sett Adressen appene bruker til denne serverens https-adresse som den nås fra hvor som helst, ikke bare kontoret.

Koble en telefon

1. Åpne utvidelsen og trykk Legg til en telefon.
2. Skann QR-koden i appen. Koden fungerer én gang, i ti minutter.

Når en samtale kommer inn

BitVoice våkner appen; den kobler seg, ringer på telefonens egen samtale-skjerm, og blir svart som en hvilken som helst annen telefon for utvidelsen: ring-grupper og køer ringer den med utvidelsens andre telefoner. Utvidelsens side listar sine koblete telefoner, om hver Kan våknes for samtaler, når den sist ble sett og sist våknet, og eventuelle push-problemer. Fjern kobling stopper en telefon fra å ringe med en gang, for en tapt telefon.

Under et oppkall

Appen er en fullstendig utvidelse, ikke bare en oppkallingsfunksjon:

• Overfør en oppkaller til en annen utvidelse eller et eksternt nummer (oppkallingskvalitets eget Overfør, eller appens knapp). Til parknummeret, parkeres oppkallet.
• Hold og ta tilbake, fra oppkallingskvaliteten eller appen; holdte oppkallere hører din holdemusikk der den er konfigurert.
• Et annet oppkall: ring mens det første er på hold, og byt mellom dem.
• Tastatone (DTMF) under oppkallet, og Mute.

De andre fanene

• Nylige: oppkall til og fra denne utvidelsen, nyeste først, trykk for å ringe tilbake (savnet oppkall markeres).
• Voicemail: hver melding med sin transkript (kapittel 29) der AI skriver en, spill den av, ring tilbake eller slett.
• Lag: hvem som er ledig, på et oppkall, ringer eller er borte (en busy-lampe), for å ringe dem eller overføre det nåværende oppkallet til dem.
• Kontakter: bedriftskatalogen, for å finne et navn og ringe det.
• Chat: lagets chat (Chat og tilstedeværelse), kolleger med deres tilstedeværelse og direkte meldinger, og lagrom, inne i telefonen. En ny melding mens appen er i bakgrunnen vises som en notifikasjon, og å trykke på den åpner Chat; når appen er lukket, kommer den gjennom samme push som oppkall.
• Deltag i et videorom: velg ett av videorommene (kapittel 34) (det lister dem, med hvor mange som er i hvert nå). Det åpner over telefonen, som fortsetter å kjøre under, og du deltar som din egen utvidelse: ingen administrator-innlogging. Første gang, spør telefonen om kameraet. Forlat, eller Tilbake på Android, returnerer til telefonen; rommets lyd forblir et oppkall på den til du legger på. Telefonen viser rommet som et videopkall på sin egen oppkallingskvalitet mens du er i det.
• Oppkall du gjør går på telefonens eget oppkallingsystem også (CallKit på iPhone, Androids Telecom), så Bluetooth, en bil eller en klokke viser dem, og et mobiloppkall som ankommer i mellomtiden vet om dem.

Live-transkript under et oppkall

Med Skriv ut oppkall live på (Innstillinger (kapittel 14), AI), skrives hver side av et oppkall ut mens det tales og vises på telefonen mens oppkallet pågår. Lyden går til tale-til-tekst-tjenesten (på din egen datamaskin, der det er konfigurert) eller AI-tjenesten mens oppkallet varer. Det er samme skrivning-ut som 911 live-transkripter (kapittel 13), for vanlige oppkall.

Videotelefoner

Når begge telefoner i et samtale sender video (videotelefoner, softphone, videodørklokkor), går bildet mellom dem gjennom BitVoice. Ingen å konfigurere: det er på med mindre Innstillinger → Videotelefoner er slått av.

• BitVoice formidler videoen som den er, på en egen port for hver telefon, så telefonene aldri lærer hverandres adresser. Med en kodek i fellesskap (nesten hver videotelefon har H.264) dekoder den aldri videoen; uten en, kan den konvertere (nedover). Når de nummerer samme kodek forskjellig, nummerer BitVoice den om på veien.
• Bildet er kryptert (SRTP) til hver telefon som krypterer sin lyd.
• En telefons forespørsel om et nytt bilde (etter tapte pakker) når den andre telefonen, så bildet gjenopprettes i et øyeblikk.
• En kamera slått på under et samtale (en softphones videoknapp) fungerer også: den andre telefonen spørres først, og bildet starter når den sier ja.
• En telefon uten video, eller et samtale til en ekstern nummer, får bare lyd. På hold eller mens parkert pauses bildet, og kommer tilbake når samtalen gjør. Etter en overføring fortsetter den bare når den nye parten sender video også.
• Video bruker mye mer av nettverket enn lyd (omtrent 0,5 til 2 Mbit/s hver vei per samtale): la plass for det på langsommere koblinger og i medieportområdet.

Konvertering av video

Telefoner og apper som deler en videokodek (de fleste bruker H.264) får hverandres video som den er. Når to parter ikke har noen kodek til felles (en skrivebords-telefon med bare H.264 og en nettleser med bare VP8), slå på Konverter video mellom H.264 og VP8 i Innstillinger: BitVoice tilbyr da begge kodekene, svarer hver part på sin egen, og konverterer hver vei med ffmpeg, som må være installert på serveren (apt install ffmpeg, brew install ffmpeg; eller gi dens sti). Konvertering koster omtrent en prosessor-kjerne per samtale og legger til en liten forsinkelse, så den er av som standard og brukes bare når nødvendig. Innstillinger sier om ffmpeg ble funnet.

Faks: sending og mottak, faks-maskiner og analoge telefoner

Faksmaskiner, analoge telefoner, dørtelefoner og gamle linjer kobles til gjennom en SIP-gateway (eller en telefoni-kort i BitVoice-datamaskinen: se Telefonikort (kapittel 6)): en ATA (Grandstream HT-serie, for en eller to analoge telefoner eller en faks), eller en større gateway (Patton SmartNode, AudioCodes MediaPack og Mediant) for mange analoge porter, en ISDN-linje (BRI/PRI) eller gamle analoge linjer (FXO). Hver port registrerer seg hos BitVoice som en utvidelse, som en telefon.

Motta faks uten en faks-maskin. På Faks, legg til et faks-nummer (300, si), med e-postadressene hver faks går til. Deretter i Telefonvei (kapittel 8) send en telefonnummers samtaler til den. BitVoice svarer som en faks-maskin, bytter samtalen til T.38 og tar imot faksen; hver faks blir en PDF, lagret på Faks (Vis, PDF) og sendt via e-post. En faks som bryter av delvis beholder sidene som ankom og sier det. Hver faks i listen viser den sendende eller mottakende maskinens egen identitet når den avviker fra nummeret, og hastigheten sidene gikk på (14 400 bit/s er den raskeste; en maskin hvis fakser stadig feiler på en lav hastighet har vanligvis en dårlig linje). Dette krever en leverandør som støtter T.38 (de fleste gjør det); en faks sendt som lyd kan ikke mottas på denne måten. Prøvd med T38Fax, en faks-leverandør: registrer stammen med dens brukernavn og passord til sip.t38fax.com, port 5080 (UDP); tillat UDP fra dens nettverk (8.34.182.0/24 og 8.20.91.0/24) gjennom enhver brannmur foran BitVoice.

Send en faks. På Faks, Send en faks: velg faks-nummeret det går fra, skriv nummeret til å sende til, skriv en notis hvis du ønsker (den blir den første siden) og legg til dokumenter. Tekstfiler og bilder (PNG, JPEG, GIF) fungerer overalt. PDF trenger poppler på serveren (apt install poppler-utils, apk add poppler-utils, brew install poppler); Word, Excel, OpenDocument og RTF trenger LibreOffice også. Siden sier hvilke serveren kan gjøre. Hver side får en header-linje, som faks-maskiner skriver ut: tiden, faks-nummerets navn, dens identitet og side-tellingen. Anropet går ut fra identitetens siffer (+1 212 555 0300 ringer fra +12125550300), eller fra faks-nummeret selv når identiteten ikke er et nummer. Sider er US-brevstørrelse i Nord-Amerika og A4 andre steder, fra landet i Innstillinger.

BitVoice ringer nummeret over dine utgående ruter, som en utvidelse ville, og sender på den raskeste hastigheten linjen bærer (14 400 bit/s, langsommere hvis linjen er dårlig). Faks fra ett faks-nummer går ett om gangen. Et beskjeftiget nummer, eller ett som ikke svarer, prøves igjen fem minutter senere, tre ganger i alt. Sendte faks er listet med mottatte faks: Sendt, Venter på å sende, Feilet (med Prøv igjen), eller Delvis sendt når linjen brøt etter noen sider.

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.

E-post er lett å forfalske, så BitVoice sender en faks bare når din postserver fant ut at den virkelig kom fra avsenders domene (DKIM, SPF eller DMARC, i Autentiserings-resultat-linjen den legger til). Andre meldinger droppes uten svar. Slå Aksepter e-post avsenderens domene ikke garanterer for på bare for en postkasse ingen ekstern e-post kan nå.

Faks maskiner på gateways. BitVoice sender faks over T.38, den internasjonale faksstandarden for internett: når gatewayen hører en faks tone, bytter den til T.38, BitVoice ber den andre siden (din provider eller en annen gateway) om å bytte også, og sender faksen mellom dem. Hvis den andre siden ikke kan håndtere T.38, forblir samtalen på G.711 og faksen sendes som lyd, som fungerer på et godt nettverk. Aktive samtaler viser faks (T.38) mens en faks pågår.

For pålitelige faks:

• Bruk T.38 på gatewayen og velg en provider som støtter det.
• Gjør portens utvidelse til en analog adapterport (Utvidelser, type): BitVoice tilbyr da bare G.711, som faks sendt som lyd trenger.
• På gatewayens faksport: Faksmodus T.38, bare PCMU eller PCMA, linje-ekkoavbryter av, vent på samtale av, og en fast, høy jitterbuffer.

Innboks: web-chat, WhatsApp og Messenger

Den Innboksen (kapittel 43) inneholder alle skrevne samtaler i én liste: chatboksen på nettstedet ditt, WhatsApp, Facebook Messenger og tekster (kapittel 44). Alle som er logget inn på nettgrensesnittet kan svare; den første som svarer tar samtalen (hver enkelt kan overføre den med Besvart av), og Lukk legger den bort til personen skriver igjen. Uleste samtaler teller seg, og listen oppdateres automatisk.

Chat-boksen på nettstedet ditt

Under Kanaler, slå på Web-chat, velg tittelen, fargen og første linjen, og legg til linjen som vises på nettstedets sider:

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

Den tegner en chat-knapp i hjørnet av hver side; besøkende skriver (med sitt navn hvis de ønsker) og ser dine svar mens de kommer. Samtalen forblir i deres nettleser, så den fortsetter mens de beveger seg mellom sider. List opp dine nettsteder under Kun på disse nettstedene så boksen kjører ingen andre steder. Besøkende må nå denne serverens adresse fra internettet, med et sertifikat nettleserne stoler på (Let's Encrypt (kapittel 14)). Ti nye chats fra en adresse på ti minutter er maksimum BitVoice tar.

WhatsApp

WhatsApp Business-numre på Metas Cloud API. På Metas utviklerside, lag en app med WhatsApp, legg til ditt nummer og lag en systembruker med en permanent tilgangstoken. Under Kanaler, slå på WhatsApp og gi telefonnummer-ID og forretningskonto-ID (begge fra API-oppssett), tilgangstoken og appens app-hemmelighet, så lagre. I appens WhatsApp-konfigurasjon, sett webhook: tilbakekall-adressen og verifiser token BitVoice viser, abonnert på *meldinger*.

WhatsApp lar deg svare fritt i 24 timer etter kundens siste melding; etter det aksepterer det bare meldingsskjemaer godkjent i WhatsApp Manager. Svar-boksen blir da en skjema-velger: velg et skjema (det lister opp kontoens skjemaer, med språk og type), fyll inn verdiene ({{1}}, {{2}} ...), sjekk forhåndsvisningen, som er hva kunden vil lese, og Send skjema. Skjemaer innboksen ikke kan fylle ut, er listet grått med årsaken: ett med bilde-, video- eller dokumentoverskrift, en variabel i overskriften eller en knapps lenke, navngitte parametre eller en kodeknapp; og de som ikke er godkjent enda. Lag skjemaer i WhatsApp Manager; Meta gjennomgår hver enkelt, vanligvis innen minutter.

Facebook Messenger

For en Facebook-side: i Meta-appen, legg til Messenger, kobler siden og lag en side-tilgangstoken. Under Kanaler, gi side-ID, side-tilgangstoken og app-hemmelighet; så sett webhook (adressen og verifiser token som vises), abonnert på *meldinger* og *messaging_postbacks*. Svar er tillatt i 24 timer etter personens siste melding. Fra da til 7 dager, tar Messenger svar skrevet av en person (sendt med Metas *human agent*-tag: appen trenger Metas Human Agent-tillatelse, bedt om i App-gjennomgang); den automatiske hilsenen går aldri da. Etter 7 dager, tar innboksen ikke svar før de skriver igjen.

Hver webhook sjekkes med app-hemmeligheten (Metas signatur) før BitVoice tror på den, og en melding Meta sender to ganger, blir lagret én gang. Bilder, lydnotater og andre vedlegg vises som hva de er ("[bilde]"); åpne dem i Metas egne apper.

Automatisk hilsen, når den er satt, svarer på den første meldingen i hver ny konversasjon med en gang.

Bedriftsteksting (SMS)

Send og motta tekstmeldinger fra bedriftsnumre på Tekster. Tekster går gjennom en tekst-leverandør. Innbygget: TextMagic, Twilio, SignalWire, Telnyx, Bandwidth, Vonage, Plivo, Flowroute og VoIP.ms, pluss Din egen webhook for enhver annen tjeneste eller en egen gateway. Ethvert antall leverandørkontoer kan brukes samtidig: hvert nummer sier hvilken som bærer det.

Oppsett

1. I leverandørens portal, finn kontoens API-detaljer. Skjemaet ber om eksakt hva leverandøren kaller dem (Twilio: Konto-SID og autentiseringstoken; Telnyx: en API-nøkkel; Bandwidth: API-bruker, passord, konto-ID og meldingsapplikasjons-ID; SignalWire: også ditt rom-adresse) og sier hvor du finner dem.
2. På Tekster, Tekstoppsett, legg til leverandøren med dem, og lagre. BitVoice viser en adresse for mottatte tekster: sett den i leverandøren som hvor mottatte meldinger sendes (dens tilbakekall, webhook eller meldings-URL). For VoIP.ms, legg til ?from={FROM}&to={TO}&message={MESSAGE}&id={ID} til slutten. Leveringskvitteringer sendt til samme adresse, ignoreres. BitVoice må være tilgjengelig fra internettet der.
3. Legg til hvert nummer du tekster fra (med landskoden), leverandøren som bærer det, og utvidelsene for å varsle på e-post når en tekst kommer inn.

US 10DLC

US-operatørene blokkerer tekstmeldinger fra vanlige bedriftsnumre som ikke er registrert. Registrer din merkevare og deretter en kampanje med din tekstleverandør; sjekklisen på Tekster sporer hvor de står, og advarer når din eksempelmelding mangler avmeldingsordene operatørene forventer.

Samtaler

Hver samtale viser hvem det er (fra Kontakter), uleste tekster og tråden. Send knappen sender; telleren viser hvor mange tekster en lang melding tar. Når noen svarer STOPP, kan ikke flere meldinger sendes til dem fra det nummeret før de svarer START. Mottatte tekster vises også som en melding i BitVoice.

Overføringsorienteringer

Så en ringsignal behøver aldri å gjenta seg selv: med Brief hver enkelt en samtale overføres til på (Innstillinger, AI), når en samtale overføres, skriver BitVoice en to-setningers sammenfatting av samtalen så langt (hvem som ringer, hva de ønsker, alt som allerede er lovet) for personen det går til. Den vises på deres nettleser-telefon med den ringende samtalen, på Aktive samtaler (kapittel 46), og som en tekst på deres skrivebords-telefons skjerm (for telefoner som viser SIP-meldinger).

Det fungerer på samme måte når AI-resepsjonisten overfører en ringende til en person: orienteringen kommer fra hva ringende fortalte assistenten.

Det trenger AI-tjenesten og en tale-til-tekst-modell (Innstillinger, AI), og samtalelyden så langt (inntil fem minutter) sendes til den tjenesten for å bli skrevet ut. En sammenfatting tar noen sekunder, så den kan vises like etter at telefonen begynner å ringe.

Aktive oppringninger

Aktive oppringninger viser hver oppringning i gang, oppdatert mens det skjer: hvem ringte hvem, hvor lenge det har pågått, dens kodeker og dens kvalitet.

Hva administratorer kan gjøre

For å lytte, viske eller barge, trykk Overvåk, velg telefonen du vil bruke under Fra telefon og trykk Ring meg: din telefon ringer, og når du svarer, slår du inn i oppringningen. Du kan bytte mellom å lytte, viske og barge mens du er i den.

Hva som vises ellers

• En oppringerkort mens en ekstern oppringning ringer (fra din CRM, eller tidligere oppringninger; se CRM (kapittel 49)).
• Den skriftlige briefing skrevet for personen en oppringning ble overført til (Overføringsbriefing (kapittel 45)).
• Oppringer-ID-dommen: Verifisert, Delvis verifisert eller Uverifisert (Spam-beskyttelse (kapittel 56)).
• Med flere servere, oppringninger på de andre også, kun lese: legg på eller lytt på serveren som har oppringningen.

Når et oppkall slutter, flyttes det til Oppkallshistorikk (kapittel 47).

Oppringningshistorikk

Hver ferdig oppringning: hvem ringte hvem, når, hvor lenge og hvordan den avsluttet. Sorter kolonnene, spill av innspillinger (en pause for kortnumre er merket), og last ned listen som CSV. Hvor lenge innspillinger beholdes, er angitt i Innstillinger, Oppringningsinnspilling; en rettslig hold (kapittel 73) holder dem lengre.

Hvordan det ble rutevalgt

Under hver samtale-resultat, Hvordan det ble rutevalgt lister, på vanlig språk og i rekkefølge, hva bestemte hvor samtalen gikk: den innkommende ruten som tok den, om en timeplan var åpen eller stengt og tid, en toggles side, hva en rutevalgsskript valgte (eller at dens fallback tok samtalen), tastene trykket i et meny, hvem var borte, hvem hadde ingen telefon koblet til, hvem ikke svarte, den utgående ruten og trunkene som ble brukt (og en trunk som helse-dommeren flyttet bak de andre), toll-svindel-vaktens dom, og, for en innspilt samtale hvis parter er under forskjellige samtykkes-regler, hvilken regel som ble brukt.

Quality, sound and encryption

The Quality column shows each answered call's score (MOS, out of 5) and two marks when they apply:

• No sound from a side: the call connected but nothing ever arrived from that phone or provider (calls shorter than 5 seconds, faxes, held calls and paging are left out). See Call quality (kapittel 53) for what to check.
• Not encrypted: BitVoice asked for encryption (SRTP) and that side answered without it. Encrypted means the sound was encrypted with every side that sent any. To refuse unencrypted calls from a provider instead, switch on Require encryption on its trunk.

Transkriberinger og søk

Med AI på og Transkriber innspilte samtaler slått på (Innstillinger, AI), hver innspilt samtale skrives ut, med en kort sammenfatting og dens handlingselementer: hva noen ble enige om eller ble bedt om å gjøre. Hver side av samtalen skrives ut separat fra opptakene, så transkriptet viser hvem sa hva, og når. Transkript-knappen ved siden av en opptak åpner den; administratorer kan også transkribere en enkelt samtale, eller transkribere en igjen.

Søk hva som ble sagt finner samtaler ved ord fra deres transkriberinger, sammenfatninger og handlingselementer. Bare innspilte samtaler transkriberes. En transkript slettes med dens opptak, og lesing eller søking av transkriberinger noteres i revisjonsloggen, som å spille av en opptak.

Kundetidslinje

Kundetidslinjen viser alt med ett telefonnummer over det siste året, nyeste først, så den som plukker opp vet hele historien.

Hva det viser

Et nummer matcher uansett hvordan det er skrevet: +1 212 555 0100 og 2125550100 er det samme.

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 (kapittel 48).

Notater

Administratorene kan Legg til en notat for teamet: det vises på tidslinjen for alle, med hvem som skrev det og når, og kan fjernes.

CRM: oppringerkort og oppkallshistorikk

Koble til en kundesystem i Innstillinger (kapittel 14), CRM. Den fungerer med alle systemer som har en webadresse, uten kode skrevet for hvert produkt.

Oppringerkort

Mens et oppkall fra utsiden ringer, viser Live calls et kort: hvem det er (fra din CRM, eller utvidelsens navn), hvor ofte de har ringt i 90 dager, eventuelle tilbakekall (kapittel 30) de venter på, og en sammenfatting av deres siste transkriberte oppkall. Nettside-telefonen viser et kortere kort til personen som svarer: hvem det er, tidligere oppkall og ventende tilbakekall, men ikke andre personers oppkallssammenfatninger.

For navnet, sett Oppslagadresse: BitVoice spør den (GET) med oppringers nummer i stedet for {number}, sender Oppslagheader med dets verdi (en vault-referanse fungerer), og forventer JSON med navn, selskap, url og notater; 404 betyr ukjent. Svar blir lagret i fem minutter. Åpne i CRM-lenke legger en lenke til oppringeren på kortet. Bruk Søk det opp for å prøve et nummer før du lagrer.

Et CRMs eget svar

De fleste CRMs svarer på en søkning i deres egen form, vanligvis en liste over treff, ikke BitVoices {"name": ...}. Åpne Svarfelt og angi hvor hver del er, som en punktert sti: et navn går inn i et objekt og et nummer inn i en liste, så list.0.name er navnet på det første treffet. Lenke til kontakt kan være en sti til en lenke som CRM-en gir, eller en nettadresse med stier i klammer, som https://crm.example.com/#Contact/view/{list.0.id}. Et tomt felt leser BitVoices eget navn for det. En søkning som ikke finner noen er det samme som 404: kortet sier at oppringeren ikke er kjent. Prøv et nummer med Søk det opp før du lagrer.

For eksempel, EspoCRM (testet mot en ekte EspoCRM): lag en API-bruker (Administrasjon, API-brukere, autentisering ved API-nøkkel) med en rolle som kan lese kontakter og kontoer, og deretter sett:

• Oppslag adresse: 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}
• Oppslag header X-Api-Key, dens verdi er API-brukerens nøkkel
• Svarfelt: navn list.0.name, selskap list.0.accountName, notater list.0.description, lenke https://crm.example.com/#Contact/view/{list.0.id}

EspoCRM holder numre i internasjonal form (+15405550117), som BitVoice passerer. Andre CRMs fungerer på samme måte med deres egen søkeadresse og felt navn; sjekk formen på deres svar i deres API-dokumentasjon, eller med Søk opp, hvis melding navngir hva den fant.

Logg av samtaler

Sett Loggadresse for samtaler og Hemmelig nøkkel for signering, og hver samtale sendes deretter når den avsluttes (hendelse call.ended), igjen med en sammenfatting, handlinger og transkript når det er transkribert (call.summarized), og hver booket tilbakekalling (callback.new). Hver POST-innhold bærer X-BitVoice-Event, X-BitVoice-Timestamp og X-BitVoice-Signature: sha256= etterfulgt av HMAC-SHA256, med hemmelig nøkkel, av tidsstempel, en punktum og innholdet. En mislykket levering prøves fire ganger over omtrent ett minutt; hvis den fortsatt mislykkes, sier Health det. Send en testhendelse sjekker adressen og hemmelig nøkkel.

Innsikt i samtaler for overordnede

For kontaktssentere: bevis om hvordan samtaler gikk, for en overordnet å lytte til, aldri en automatisk score.

I en samtale Transkript, Hvordan det gikk viser, målt fra opptakets lyd alene: hvor mye hver side snakket, hver sides lengste strek, hvor ofte hver side begynte å snakke over den andre, hvor lenge begge snakket samtidig, og den stille (en lang stillhet er ofte et hold eller dødt luft).

Med Noter hvordan hver transkribert samtale gikk på (Innstillinger, AI), leser AIen også transkriptet og sier hvordan oppringeren syntes på begynnelsen og slutten, og lister opp til seks øyeblikk: Gikk bra, Se på (snakke over oppringeren, et langt hold, et uklart svar), Ikke besvart (et spørsmål oppringeren stilte som ikke fikk noe svar) og Løftet (noe noen sa de ville gjøre), hver med tid og ord sagt, så du kan gå rett til det. En administrator kan be om det på enhver transkribert samtale med Se på denne samtalen.

På Kvalitet på samtaler (kapittel 50) summerer Samtaler, etter hvem tok dem de transkriberte samtaler for perioden per person: deres andel av samtalen, deres lengste sammenhengende tale, hvor ofte de talte over samtalepartneren, stille tid, samtaler som endte med at samtalepartneren ble irritert, og øyeblikkene som er merket. Bruk det til å velge samtaler å lytte til, ikke til å rangere mennesker.

Veiledningsnotater er dine egne ord på en samtale, i øyeblikket de handler om: under Hvordan det gikk, skriv Øyeblikk (1:05, eller la det stå tomt for begynnelsen) og Veiledningsnotat, og trykk Legg til notat. Notater listes i rekkefølgen til samtalen med hvem som skrev dem og når; administratorer skriver og fjerner dem, visere leser dem med transkriptet, og å legge til eller fjerne ett notat noteres i revisjonsloggen. De følger med opptakene, så deres oppbevaring og juridiske hold dekker dem også. Veiledningsnotater på Samtalekvalitet teller dem per person.

Oppringingsopptak og kortbetalinger

Opptak er satt i Innstillinger (kapittel 14), Oppringingsopptak: av, hver oppring, eller bare oppringene til utvidelser merket Opptak av oppring. Opptak spilles av fra Oppringslogg (kapittel 47), og med AI på blir de skrevet ut og summerert.

Informere mennesker

Noen steder må alle på et oppkall bli informert om at det er oppbevart: Announce, Beep og regler etter region er i Recording consent (kapittel 52).

Kortbetalinger (PCI DSS)

Kortnumre må ikke lagres i opptak. Før en oppringer leser ett høyt, trykker personen på utvidelsen *7; *8 gjenopptar. Pause opptak på Live calls (kapittel 46) gjør det samme. Den pauseerte delen er stille i opptaket og er listet i oppkallshistorikken, så en revisor kan se hvor og hvor lenge.

Konferanserom

Et rom med Opptak av rom på blir lagret som ett opptak av hele rommet (Konferanserom (kapittel 34)).

Hvor lenge ting blir lagret

Innstillinger bestemmer hvor mange dager opptak, oppkallshistorikk og voicemail blir lagret; eldre enn det slettes innen time. Alt under en rettslig hold (kapittel 73) blir lagret uansett alder. Arkiv (kapittel 72) kan lagre kopier andre steder.

Administratorene og seerne kan spille av opptak og lese transkriberinger; bare administratorer kan transkribere et oppkall eller transkribere det igjen. Å spille av et opptak eller lese dets transkript blir notert i revisjonsloggen.

Innspillings-samtykke

Noen steder lar en samtale bli innspilt når en person på den vet; andre krever at alle må bli informert, eller samtykke. I Innstillinger, Innspilling av samtaler, velg hvordan personer på en innspilt samtale blir informert:

• Ingen varsel.
• Kunngjør: når samtalen besvares, hører begge sider varselet (innspill det på samme sted, for eksempel "Denne samtalen blir innspilt for opplæring og kvalitet"), og innspilling starter bare etter at det har blitt spilt. Inntil en er innspilt, spilles tre pip, og Helse sier det.
• Pip: en kort tone til begge sider hver 15. sekund mens samtalen blir innspilt.

Regler velger etter det ytre nummeret (ringende på innkommende samtaler, nummeret som blir ringt på utgående samtaler), lengste match først: for eksempel numre som starter med 1415 (California) Kunngjør, 49 (Tyskland) Aldri innspill, alt annet som ovenfor. En regels Ingen varsel innspiller uten varsel; Aldri innspill lar disse samtaler være uten innspilling i det hele tatt. Samtaler mellom utvidelser følger hovedinnstillingen.

Ditt eget nummer teller også: reglene sammenlignes med både det eksterne nummeret og ditt eget (nummeret som blir ringt inn på innkommende samtaler, din ID på utgående samtaler), og den mest beskyttende av dem vinner (Aldri opptak før Annonsere før Signal før Ingen varsel). Så et kontor i et sted som trenger alle parters samtykke annonserer hvem de ringer, uansett hvor de er. Når partene faller under forskjellige regler, sier samtalenes historikk i Samtalehistorikk (kapittel 47) hvilken regel som ble brukt og hvorfor.

Opptak kan også pauses under en samtale med pausekoden (kortbetalinger). Ingen av dette er juridisk råd: sjekk lovene der du og dine samtalepartnere er.

Samtalekvalitet

How calls sounded over the last day, week, month or 90 days, from the sound BitVoice itself received on each side of each call. Phones are grouped by their site (kapittel 12) (or "no site"), and calls from outside by the provider's line they came in on.

Hver plass viser sine samtaler, gjennomsnittlig score (MOS, på en skala fra 1 til 5: over 4 er bra, under 3,6 lyder dårlig), andelen lydpakker som aldri ankom, og jitter (uregelmessig forsinkelse). Under dette forteller BitVoice hva som er galt på vanlig språk, for eksempel "Tap av lydpakker i hovedkontorets nettverk: 3,2% av lyden ankom aldri, hovedsakelig mellom 14:00 og 16:00", samt hva som bør sjekkes. Diagrammet viser lyden som gikk tapt etter klokkeslett.

Diagnosen sammenligner de to halvdelene av samme samtaler: lyden fra stedets telefoner og lyden fra leverandøren som samme samtaler gikk gjennom. Når den andre halvdelen ankommer ren, er tapet på dette stedets side, og det sier det; når begge halvdelene taper lyd, er stedet ikke alene skyldig og det peker på hva samtaler deler, dette systems eget internett-tilknytning. Hvis hvert sted mister lyd samtidig, er årsaken likeledes hva de deler. Hvordan dette ble arbeidet ut listar årsakene, steg for steg (samtalekvalitetsregelboken, se Sikkerhet (kapittel 60), "Hvordan BitVoice avgjør"). Steder med færre enn tre samtaler blir ikke vurderinger. Samtalekvalitet per samtale er også i Samtalehistorikk (kapittel 47) (Kvalitetskolonnen) og, mens samtaler er aktive, på Aktive samtaler (kapittel 46).

En samtale som koblet til, men fikk ingen lyd i det hele tatt fra en side, blir telt for seg, under uten lyd, og plassert først: det er ikke dårlig lyd, men lyd som aldri ankom, nesten alltid en brannmur eller NAT-router som lar SIP gå gjennom og holder media ute. Plassens råd sier hva som bør sjekkes (for en leverandør, dens media-adresser).

Kostnader og budsjetter

BitVoice priser hver samtale fra hva din leverandør beregner, og viser månedens utgifter etter avdeling, person og trunk, med de dyreste samtaler.

Priser

På Trunker (kapittel 7), åpne en trunk og dens Samtalepriser. Hver pris dekker numre som starter med noen siffer, slik nummeret sendes til leverandøren (siffer bare, så 44 for Storbritannia, 1900 for US premium rate); den lengste matchen vinner, og en pris uten siffer dekker alle andre numre. Gi prisen per minutt, eventuell avgift per besvart samtale, faktureringssteg (60 sekunder for hele minutter, 6 eller 1 for finere) og eventuell minimum. Innkommende samtaler, per minutt er for gratis numre du betaler for å motta. Hva ville det koste sjekker et nummer før noen ringer det. Valutaen settes på Kostnader.

En samtalekostnad er fast når den avsluttes, med prisene på tidspunktet; å endre en pris endrer ikke tidligere samtaler. Kostnader sier hvor mange besvarte utgående samtaler ikke hadde pris.

Avdelinger og budsjetter

Gi utvidelser en Avdeling (i utvidelsen). På Kostnader, legg til et budsjetter for hver samtale eller for en avdeling: en advarsel vises i BitVoice, og sendes til budsjetts e-postadresse og advarseladresse, på 80% og igjen på 100% av måneden.

Advarselen

Utgående samtaler koster mer enn dette i en time utløser en advarsel når utgående samtaler overstiger denne summen innen en time. En plutselig rekke dyre samtaler er det vanlige tegnet på tollsvindel (en stjålet telefonpassord): sjekk Samtalehistorikk, så deaktiver utvidelsen eller trunken.

Ringende ID-reputasjon og merket samtale

Telefonselskaper kjører spam-filtre som kan merke et bedriftsnummer "Svindel sannsynlig", eller blokkere det, og deretter svarer nesten ingen. Ringende ID-reputasjon overvåker hvert nummer du ringer ut fra, fra dine egne samtaler, og sier i klart språk hvordan det går:

• Svart: andelen samtaler som ble svart, og hva det var perioden før. En nedgang på halvparten eller under 20% er det vanlige tegnet på en ny merking.
• Lagt på med en gang: samtaler som ble svart og avsluttet innen 10 sekunder.
• Avvist som spam: samtaler en bærers filter avviste (SIP 608) eller som personen merket uønsket (607). Én 608 betyr at nummeret er merket.
• Tungt bruk: mer enn ca. 150 samtaler per dag fra ett nummer er hva robocallere gjør, og filtre merker.

Numre med færre enn 20 samtaler vises som for få til å dømme.

Dine utgående numre gir hvert nummer et navn (sendt som navnet til oppringeren), en årsak for å ringe og et logo (en https://-bilde). På en trunk med Send merket oppringer-ID på, går logoen og årsaken ut som rik oppringerdata (RFC 9796 Call-Info); operatører som støtter merket ringing viser dem på den ringede telefonen. De fleste telefoner viser navnet fra oppringer-navn (CNAM)-databasen i stedet, som din provider setter: spør dem. Overvåk setter en advarsel på Helse når et overvåket nummer begynner å se merket ut.

Siden sier også hva du skal gjøre når et nummer er merket.

Spam-beskyttelse og STIR/SHAKEN

I USA og Canada, signerer leverandøren en samtale starter med sin samtale-ID (STIR/SHAKEN): A når den kjenner ringende og kan bruke nummeret, B når den kjenner ringende, men ikke nummeret, C når den bare har videreformidlet samtalen. Din leverandør forteller enten BitVoice sin dom (verstat) eller sender den signerte Identitet-headeren videre, som BitVoice så sjekker selv: signatur, at den er under en minutt gammel, og at den navngir numrene i denne samtalen. Dommen vises som Verifisert, Delvis verifisert, Uverifisert eller Ikke verifisert på Aktive samtaler og i Samtalehistorikk.

I Innstillinger, Spam-beskyttelse, velg hva som skjer når en samtale-ID mislykkes verifisering (ringe, ringe merket, eller avvis), når den ikke er verifisert i det hele tatt, og når nummeret er skjult. En merket samtale ringer med Spam? (eller din egen merking) før ringendes navn. Blokkerte numre avvises; en post som slutter med * blokkerer et nummerområde (+1900* er alle amerikanske premium-numre). Alltid tillatt numre avvises eller merkes aldri. I Samtalehistorikk, knappen for å blokkere en ringende legger dem til listen; avviste samtaler vises som Blokkert.

Innen en time etter et nødkall fra noen utvidelse, avvises ingen kall (blokkerte ringer i stedet), i tilfelle det er nødetaten som ringer tilbake. Et 911-kall (fra ESInet eller en CAMA-trunk) avvises aldri eller hindres av skjerming.

Callers BitVoice does not know

A caller is known when the number is always allowed, in the contacts (kapittel 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:

Robottesten trenger ord: i Lyder (kapittel 20), ta opp eller lag (med en tale-tjeneste) skjermingsprompene og tallene 1 til 9 på kallerens språk. Inntil de er tatt opp, ringer slike oppkallinger som vanlig (en kaller kan ikke bestå en test de ikke kan høre), og Helse sier det. En kaller som består, teller som kjent i 90 dager. Testen besvarer oppkallet, så kallers leverandør starter å belaste dem fra det øyeblikket, som for ethvert besvart oppkall. Oppkallingshistorikken viser hver oppkallings resultat (bestått, feilet, sendt) og hvorfor-sporet sier hva som skjedde.

Et spam-database

BitVoice kan spørre en rykte-tjeneste om hver ukjent kaller før oppkallet ringer. Bruk Nomorobo via Twilio fyller inn Twilio Lookup med Nomorobo spam-poeng (installer Nomorobo-tillegget i din Twilio-konto, så skriv inn dets konto-ID og autentiseringstoken); enhver annen tjeneste som svarer i JSON fungerer også: gi dens adresse med {e164} (+12125550142) eller {number} (som leverandøren sendte det), hvor dens uttalelse er (Uttalelse-felt, en punktert sti), og når det betyr spam (et poeng på eller over Spam ved poeng, true, eller teksten i Eller spam når teksten er, som f.eks. BLOCK). Velg hva som skjer med en kaller det kaller spam: ring merket, robottesten eller avvist.

• Disse tjenestene belaster per oppslag. Kjente kallere blir aldri oppsøkt, og hvert svar blir lagret i en dag (Lagre svar).
• En langsom eller ødelagt tjeneste holder aldri et oppkall tilbake: etter Vent maks (1,5 sekunder med mindre du endrer det) ringer oppkallet som om svaret var "ikke spam".
• Test spør det om et nummer nå (og blir belastet som ethvert oppslag).

Blokker den siste kalleren

Like etter et uønsket oppkall, tast *32 (Funksjonskoder (kapittel 32)) fra telefonen det ringte: den siste ytre nummeret som ringte den utvidelsen i løpet av den siste dagen havner på blokkeringslisten, og telefonen leser nummeret igjen. Et alltid-tillatt nummer blir ikke blokkert, og telefonen sier det. Hver enkelt er i kontroll-loggen, med hvem blokkerte det.

Forslag fra dine oppkall

BitVoice leser de siste 30 dagers oppkall fra utsiden for numre som ringer igjen og igjen og blir kvitt med en gang: tre eller flere oppkall, nesten alle av dem over innen 10 sekunder, eller to robottester feilet, og aldri en ekte samtale (noen som snakker 30 sekunder eller mer). Kjente numre er ikke med. Hver kommer med hvorfor; Blokker setter det på blokkeringslisten og Ikke spam betyr at det aldri blir foreslått igjen. Ingenting blir blokkert før en person sier det.

For å sjekke sertifikater mot STI-myndighetene, lim inn deres sertifikater under STI-sertifikatmyndigheter; uten dem, sjekker BitVoice at samtalen ble signert med sertifikatet det navngir, men ikke hvem utstedte det sertifikatet.

Signering av egne samtaler

De fleste leverandører signerer kundenes samtaler selv. Hvis din leverandør lar deg signere (eller du er en leverandør som kjører BitVoice), slå på Signer avsender-ID på trunken (Trunker (kapittel 7)) og angi STI-sertifikat (fra en STI-sertifiseringsmyndighet, med din tjenesteleverandørkodetoken) og dens privat nøkkel (P-256). Hver samtale ut via trunken har deretter en signert Identity-header (ES256, som SHAKEN krever).

• Sertifikatadresse (x5u) er hvor den andre siden henter sertifikatet. La det være tomt og BitVoice publiserer det på /stir/<trunk>.pem på sin offentlige adresse (Innstillinger), som må være tilgjengelig fra internett over HTTPS.
• Verifisering: automatisk gir A når en utvidelse ringer med ett av systemets numre (et nummer som er ruteinn, eller en samtale-ID som er satt på trunken eller utvidelsen), B når en utvidelse ringer med et annet nummer, og C for samtaler som er videreformidlet fra utsiden (en videresendt ringende). Eller fastsett det på A, B eller C.
• Samtalehistorikk merker hver signert samtale med signert A, B eller C. En samtale stoppes aldri fordi den ikke kunne signeres; årsaken er i loggen.

Administratorene

Administratorene er personer som logger inn på dette nettgrensesnittet. Ansatte som bare tar hånd om sine egne samtaler, bruker ansattportalen i stedet og trenger ingen konto her (Ansattportalen (kapittel 33)).

Roller

En endring av rolle eller passord, logger personen ut overalt på en gang.

To-trinns innlogging

Hver person aktiverer to-trinns innlogging for seg selv: Konfigurer viser en nøkkel for en autentiseringsapp; å angi koden den viser, aktiverer den. Deretter ber innlogging om en kode i tillegg til passordet. Å deaktivere den, krever passordet.

Enkelt innlogging

Med enkelt innlogging (Innstillinger), logger personer inn med organisasjonens konto (Microsoft Entra, Google, Okta, enhver OpenID Connect-leverandør), og en konto opprettes for dem første gangen. Se Enkelt innlogging (kapittel 58).

API-tekster

Programmer (Terraform, skript) bruker API-tekster i stedet for passord: opprettet på denne siden, vist én gang, og tilbakekalt når som helst. Hver tekst er en administrator eller en viser. En tekst laget med Navngir personen det virker for (for en CAD) kan sende X-BitVoice-On-Behalf-Of med personens navn, og opptak navngir da personen ved siden av teksten (911-samtaler (kapittel 77)).

Enkelt innlogging

Enkelt innlogging lar mennesker logge inn i BitVoice med deres arbeidskonto, gjennom enhver OpenID Connect-leverandør: Microsoft Entra ID, Google, Okta, Keycloak og andre. Å forlate organisasjonen fjerner deres tilgang her også.

Setting it up

In Settings (kapittel 14), Single sign-on:

1. Register an application with the provider, with the Redirect address shown here.
2. Fill in for a provider sets the Issuer for the common ones; copy the Client ID and Client secret from the provider.
3. Name the provider's Administrator groups and Viewer groups. Groups claim is where the provider puts them (groups unless set).
4. Optionally change the Button text on the sign-in page.
5. Switch on Use single sign-on.

Hvordan det fungerer

• Kontoen her blir laget ved første pålogging; gruppene setter rollen ved hver pålogging, så å flytte noen mellom grupper hos leverandøren endrer deres rolle her.
• Noen i ingen av gruppene blir nektet, og nektelsen er i revisjonsloggen.
• Med Tillat også passord av, fungerer passord bare på denne datamaskinen, så en leverandørfeil aldri låser deg ute.

Bedriftskatalog (Active Directory og LDAP)

BitVoice kan lese bedriftskatalogen din, Active Directory eller en annen LDAP-tjener (OpenLDAP, Samba, 389 Directory Server, FreeIPA): personer med telefonnummer blir utvidelser, kataloggrupper fyller ringgrupper, og personer logger inn på webgrensesnittet med deres katalogpassord. BitVoice leser bare katalogen; den skriver aldri til den.

Tilkobling

I Innstillinger (kapittel 14), Bedriftskatalog:

1. Velg Active Directory eller OpenLDAP eller en annen LDAP-tjener: det setter hvilke attributter som leses (sAMAccountName eller uid for påloggingsnavn, displayName eller cn, mail, telephoneNumber). Endre noen av dem i dens boks.
2. Tjener: ldaps://dc1.example.com (port 636), eller ldap://... med StartTLS på. Vanlig LDAP avvies med mindre tjeneren er denne datamaskinen, fordi passord ville krysse nettverket uten kryptering. Når tjenerens sertifikat kommer fra din egen sertifikatmyndighet, lim inn myndigheten i Bedriftssertifikatmyndighet.
3. Lese-konto og Dens passord: en konto som har tillatelse til å lese personer og grupper (reader@example.com på Active Directory). Passordet kan være en referanse til en nøkkelhvelv (Innstillinger, Nøkkelhvelv).
4. Base DN: hvor personer og grupper er (dc=example,dc=com). Hvilke personer begrenser dem med en LDAP-filter; på Active Directory, er disabled accounts alltid utelatt.
5. Test logger inn med lese-kontoen og leser alle, uten å endre noe: det viser hvor mange personer det fant, hvor mange som har et nummer, og hvilken utvidelse hver ville få.

Extensions and ring groups

• With Make and update extensions on, each person with a number gets an extension: the number's last Digits kept (4 of +1 212 555 0123 is 0123; 0 keeps every digit, which must then be 2 to 8). New extensions get a SIP password and voicemail with a random PIN; the person's name and email come from the directory.
• The directory owns an extension it made: its number, name and email follow the directory at each sync. Everything else (devices, forwarding, voicemail settings) is yours.
• An extension you made by hand is never taken over, unless it has that person's name or email. Two people with the same number, a number someone else's extension already has, or a number of the wrong length is listed under To look at, and nothing is changed for them.
• With Turn off the extensions of people who left on, an extension the directory made is switched off when the person leaves, is disabled, or loses their number, and comes back on when they return.
• Ring groups filled from directory groups: each line puts the extensions of a group's members into a ring group (on Active Directory nested groups count). A group with nobody who has an extension leaves the ring group as it was.
• The directory is read every Read it every minutes (60 by default), and at once with Sync now. Each sync that changes something is one revision (kapittel 61) named "Company directory sync", so it can be undone; the last sync's report shows below the button.

Pålogging

Med Personer logger inn her med deres katalognavn og passord på, tar påloggingsiden katalognavn og passord i tillegg til BitVoices egne konti:

• Medlemmer av Administratorgrupper logger inn som administratorer, av Visergrupper som visere (uten visergrupper, hvem som helst andre i katalogen). Grupper er navngitt av deres navn (cn) eller DN; på Active Directory teller nestede grupper. Noen i ingen slike grupper, blir nektet.
• Kontoen her blir laget ved første pålogging, og dens rolle følger gruppene ved hver pålogging. Den tar aldri over en BitVoice-konto med samme navn.
• Et tomt passord blir alltid nektet (LDAP ville ellers ta det som en anonym pålogging), en deaktivert konto kan ikke logge inn, og navn er escapet før de når katalogen.
• To-trinns pålogging kan legges til disse kontoene som til noen andre.

Sikkerhet

Et telefonisystem på internett angripes innen timer: skannere prøver passord på hver SIP-port, og et overtatt system kjører opp samtaler til premium-numre. BitVoice er bygget for å motstå det som standard, i lag.

Mot passordgjetting

• Adresser som fortsatt mislykkes i å logge inn, blir midlertidig blokkert (Innstillinger, Beskyttelse): som standard blir adresser som har 10 feil påloggingsforsøk i løpet av en minutt, blokkert i en time. Blokkerte adresser listes på Sikkerhet (kapittel 60) og kan være avblokkert.
• Trusted networks er aldri blokkert: ditt kontornettverk.
• SIP-passord genereres, minst 12 tegn, ett per utvidelse. En telefon som logger inn som en utvidelse, kan aldri registrere en annen.
• En scanner som er blokkert, får ikke noen respons, så den lærer ingenting.

Mot svindel

• Utvidelser kan ringe eksterne numre bare når de er tillatt.
• Premium-rate-numre blir avvist med mindre en rute navngir dem.
• Svindel-vakt (under) dømmer hver samtale utenfor landet før den blir plassert.
• Kostnader (kapittel 54) varsler om budsjetter og om løpske utgifter: mange samtaler til ett land i en time.
• Hver utvidelse kan ha maks fire samtaler på samme tid (Innstillinger, Beskyttelse).

Svindelvakt

Slå det på i Innstillinger, Svindelvakt. Hver samtale utenfor landet (etter +, 00 eller 011, og steder som deler +1 med Nord-Amerika, men er andre land, som Jamaica, et klassisk svindel-mål) blir da dømt før den plasseres:

Land som alltid er tillatt (ringekoder, som 44) og Unntak (en utvidelse unntatt til en dag, for en reise) fjerner "første samtale" og "utenfor timer"; de unntar aldri mange samtaler i en kort tid eller et angrep, fordi en stjålet passord ser ut til å være godkjent også. Hvis samtale-historikken ikke kan leses, vet ikke vakt om en samtale er en første, og noe som ikke måles er aldri tatt for trygt: den ber om PIN-en. Hver dom blir listet på Sikkerhet (kapittel 60) med dets grunner, og er på samtale-posten i Samtalelogg (kapittel 47).

Hvordan BitVoice bestemmer

BitVoices dommere (svindel-vakten, trunk-helse-dommeren, samtale-kvalitets-diagnosen og 911-oppringer-lokasjons-sjekken) hver følger en regelbok: fakta som måles, konklusjoner de støtter, unntak som overruler en konklusjon, og valg. Hvordan BitVoice bestemmer, på Sikkerhet (kapittel 60), viser hver regelbok. Reglene dommerne holder:

• Hver svar kommer med dets grunner: hva holdt, hva ble argumentert mot det og hva overrulerte det.
• Noe ingen målte er ukjent, aldri "nei". Når et ukjent kunne endre svaret, tar dommeren dets forsiktige valg og sier hva det ikke kunne måle.
• "Kan ikke bestemme" er et svar: når reglene lar en situasjon uavgjort, tar dommeren dets forsiktige valg og sier så.
• Hver regelbok blir sjekket i hver kombinasjon av dets fakta før den brukes (når BitVoice starter, og ved dets tester): aldri to valg på samme tid, og hver regel er tilgjengelig. Skjermen viser hvor mange situasjoner hver ble sjekket i.

Kryptering

• TLS krypterer signalisering (port 5061), så passord og numre ikke er lesbare på nettverket.
• SRTP krypterer lyden av samtaler; nettleser-telefonen og appene bruker alltid den.
• Web-grensesnittet har HTTPS på port 8443 med sitt eget sertifikat, eller ett du installerer.

Hvem kan gjøre hva

• Administratorene kan endre alt; seere ser alt, men endrer ingenting; ansatte bruker portalen bare for egne samtaler.
• Slå på to-trinns pålogging for hver administrator (Administratorene (kapittel 57)): en kode fra en autentiseringsapp.
• Enkelt pålogging (kapittel 58) logger mennesker inn via din identitetsleverandør.
• Revisjonsloggen registrerer hver administrativ handling og hvem som gjorde det, og kan ikke redigeres.

Endringer, sikkerhetskopier og import

Hver lagret endring er en revisjon: nummerert, med hvem som gjorde det, når, og en enkel linje med sammenfatting. Ingen del av konfigurasjonen går noen gang tapt.

Sammenlign og gjenopprett

• Hva endret viser forskjellen mellom en revisjon og den forrige, felt for felt.
• Gjenopprett viser hva gjenoppretting ville endre og spør først. Gjenoppretting er selv en ny revisjon, så den kan også angres.

Eksport og import

• Eksport laster ned hele konfigurasjonen som en fil (hemmeligheter utelatt med mindre du ber om dem).
• Import viser forhåndsvisning av en fil sine endringer før de blir anvendt.
• Import (kapittel 68) leser også FreePBX og Asterisk-konfigurasjoner, 3CX-brukerlister og CSV-eksport fra Cisco Unified CM, Avaya og Mitel.
• Arkiv (kapittel 72) kopierer sikkerhetskopier, opptak og voicemail til Amazon S3 eller Azure.

Endringer gjort samtidig

To administratorer som redigerer samme ting samtidig kan ikke overskrive hverandre: den andre lagringen avvises med en melding om å laste inn på nytt, og ingenting går tapt.

Oppdateringer

Oppdatering av BitVoice er ett klikk, og trygt: den sjekker den nye versjonen, installerer den ved siden av den gamle, og går tilbake på egen hånd hvis den nye ikke forblir oppe.

Installer en oppdatering

1. Last ned den nye utgaven og pak den ut. Ved siden av programmet er dens signatur fra BioDream: bitvoice.sig, eller bitvoice.exe.sig på Windows.
2. På Oppdateringer (kapittel 62), last opp programmet og .sig-filen.
3. Trykk Installer. Som standard venter BitVoice til ingen samtaler er i gang; du kan også installere med en gang.
4. BitVoice starter på ny på den nye versjonen. Med flere servere, overføres samtaler i gang til en annen server og fortsetter.

Gå tilbake

Den versjonen du forlot, blir beholdt: Gå tilbake returnerer til den på ett klikk. En ny versjon som ikke starter to ganger, eller ikke forblir oppe i ett minutt, erstattes av den forrige av seg selv.

Signaturer

Hver utgave fra v0.1.3 inneholder BioDreams utgivelsesnøkkel. Slike bygninger installerer bare programmer signert med den nøkkelen: et usignert fil, en signert av noen andre, eller en endret med en enkelt byte, avvises med signaturer stemmer ikke overens. Siden sier om denne bygningen sjekker (Kreves) eller ikke.

Flere servere som ett telefonisystem

To eller flere BitVoice-servere som deler en PostgreSQL-database fungerer som ett telefonisystem:

• En samtale når en telefon uansett hvilken server den er registrert hos: ringegrupper, køer, overføringer til en utvidelse og samtaler fra leverandørslinjer ringer telefoner på hver server.
• Innstillinger endret på en server gjelder på alle innen fem sekunder; brukere, kontakter, samtalehistorikk, transkripter av opptak og tekstmedlinger deles.
• Okkuperte lamper (BLF) viser telefoner på hver server som ringer og er opptatt; parkering-plasser deles, så en samtale parkert på en server kan hentes fra en telefon på en annen; høyttalere når telefoner på hver server; tekster når skrivebords telefoner uansett hvor de er registrert.
• En køagent på en samtale på en server teller som opptatt på de andre, og en leverandørslinjes kanalbegrensning teller samtaler på hver server.
• Aktive samtaler på hver server lister samtaler på de andre også (kun lese: legg på eller lytt med på serveren som har samtalen).
• Samtaleposten skrives bare en gang, av serveren som har ringende, og en samtale blir også opptatt der.

Konfigurasjon

1. Flytt den første serverens data til PostgreSQL: Innstillinger, Database.
2. Start hver annen server med samme database: bitvoice -database postgres://… (eller BITVOICE_DATABASE-miljøvariabel). Den slutter seg til med en gang; Servere lister den.
3. På Servere, sjekk hvor hver server nås (dens adresse og SIP-port på nettverket serverne deler), og gi hver en navn. Servere som hver nås fra internettet på en adresse av sin egen (skytservere med offentlige IP-er, ingen delt adresse) får Den offentlige adresse også: leverandører og telefoner utenfor blir fortalt den, så når en server overtar en samtale, følger leverandørens lyd med. Tomt, bruker en server den offentlige adressen i Innstillinger.
4. Fortell telefoner hvordan de finner serverne (nedover).
5. Leverandørslinjer (nedover).

Hvordan telefoner finner serverne. Telefoner BitVoice konfigurerer (Yealink, Polycom, Grandstream) får en annen kjørende server som reserve av seg selv. For de andre, Snom og telefoner konfigurert for hånd, bruk en av disse på Servere:

• En DNS-navn for hver server: et navn som pbx.example.com med SRV-poster (_sip._udp, _sip._tcp, _sips._tcp) som lister hver server. Telefoner BitVoice konfigurerer, får navnet, og Servere sjekker postene mot kjørende servere, lister hva som mangler og gir postene til å opprette, klare til å kopiere.
• En delt adresse: en ubrukt adresse på servernettet, som 192.168.1.50/24. En kjørende server holder den på et tidspunkt og forteller nettverket med en gang (gratuitous ARP); hvis den stopper, tar neste server adressen innen få sekunder, fortsetter samtaler og svarer telefoner på samme adresse, uten at de må registrere seg igjen. Den trenger Linux og NET_ADMIN- og NET_RAW-tilgang (i en container: --cap-add NET_ADMIN --cap-add NET_RAW), og servere på ett nettverk. Restart hver server etter å ha konfigurert den.

Leverandørslinjer. I hver trunk, sier Delt mellom servere hvordan:

• Hver server bruker den: hver server registrerer seg og foretar samtaler. For leverandører som tillater flere registreringer på ett konto, eller ingen.
• En server om gangen: en server registrerer seg og håndterer linjen; de andre viser den som Reserve, holdt av den serveren og sender sine samtaler ut gjennom den. Hvis den stopper, registrerer neste server seg innen få sekunder. For leverandører som tillater én registrering per konto.

Når en server stopper

• Samtaler fortsetter. Hver server holder en notis om sine samtaler i databasen; når en stopper, tar en kjørende server over hver samtale innen få sekunder, flytter lyden til seg selv og forteller begge ender (en re-INVITE). Det er et gap på noen sekunder i lyden. En planlagt stopp (en oppgradering, en omstart) overfører samtaler med en gang, uten gap.
• En samtale hvis telefon er registrert hos serveren som overtar, fortsetter der uten å forstyrre den telefonen: bare den andre parten flyttes.
• Dens telefoner fortsetter gjennom reserve-serveren, DNS-navnet eller den delte adressen.
• En server som bare restartes (en oppgradering, en omstart) husker fortsatt hvor sine egne telefoner er registrert: den holder dem i sin data-mappe (registrations.json), så samtaler når dem før de registrerer seg igjen.
• Health og Servere viser den som stoppet; når den kommer tilbake, tar den ikke noe tilbake fra serveren som overtok.

Mellom servere. Serverne når hverandre på SIP-porten over TCP, eller TLS når de har et sertifikat (hver aksepterer bare sertifikatet den andre har publisert, og lyden mellom dem er da kryptert med SRTP), og sender lyd til hverandres medieporter (UDP, rekken i Innstillinger). Samtaler mellom servere er signert med en hemmelighet de deler i databasen, og bare akseptert fra en kjørende medlem på sin egen adresse. En brannmur mellom dem må slippe disse portene igjennom.

Prøv det først: laben. BitVoice kommer med en lab som kjører to servere, deres database og testtelefoner på én datamaskin med Docker, hver på en adresse på sin egen: deploy/lab/run.sh up bygger og starter den og setter den delte adressen; run.sh call ringer mellom telefoner på forskjellige servere; run.sh failover dreper serveren som bærer en samtale gjennom den delte adressen og sjekker om samtalen fortsetter (lyden kommer tilbake om ca. fem sekunder); run.sh impaired ringer fra en telefon på et dårlig link (forsinkelse, jitter og 5% tap) og sjekker samtalekvaliteten BitVoice rapporterer; run.sh down fjerner den. Servernes sider er på https://127.0.0.1:18501 og :18502 (bruker admin).

Hvor dataene lagres (SQLite eller PostgreSQL)

BitVoice lagrer innstillinger og deres lagrede versjoner, brukere, kontakter, samtalelogg, revisjonslogg, tekster, notater og transkripsjoner i en database. Innspillinger og voicemail blir som lydfiler i data-mappen.

Denne serverens egen fil (SQLite, standard): en enkelt fil, bitvoice.db i data-mappen, med ingenting å installere. Sikkerhetskopier data-mappen og du har alt.

PostgreSQL: for flere BitVoice-servere som deler én sett med data, eller for rapporter i verktøy som Power BI, Grafana eller Metabase. I Innstillinger, Database, Flytt dataene inn i PostgreSQL: lag en tom database og en bruker som eier den, skriv inn dens adresse (postgres://bruker:passord@host:5432/database), trykk Test, så Kopier dataene og start på nytt på PostgreSQL. Alt blir kopiert i ett slag (alt eller ingenting) og BitVoice starter på nytt på det; den gamle filen blir hvor den var. Å flytte tilbake til serverens egen fil fungerer på samme måte. Flyttinger blir avvist mens samtaler pågår.

Servere som deler en PostgreSQL-database ser hverandres innstillingsendringer innen fem sekunder. Hver server svarer fortsatt på sine egne telefoner og samtaler; for at en annen server skal overta en annen servers telefoner, må telefonene ha begge adressene (eller én adresse som flyttes).

Databasen kan også navngis når BitVoice starter, med -database postgres://… eller miljøvariabelen BITVOICE_DATABASE; den blir da endret der, ikke i Innstillinger.

Eldre installasjoner: på første start av denne versjonen, kopierer BitVoice sine gamle JSON-filer inn i databasen og flytter dem til pre-database i data-mappen.

Vert for andre organisasjoner

En BitVoice kan vertse flere organisasjoner. Hver organisasjon er et eget telefonisystem: eget utvidelser, numre, trunker, ruter, administratorer, voicemail, opptak og samtalehistorikk. Ingen organisasjon kan se en annens. De deler bare denne serverens SIP-port, IAX2-port og medieporter.

Når du skal bruke det

• En leverandør, eller et IT-selskap, som kjører telefonisystemer for mange små kunder på en server.
• En gruppe kontorer eller klinikker som ønsker separate systemer, administrert separat, på delt maskinvare.
• Flere svarpunkt som deler ett system, hver med sine egne svarere og poster.

Hovedsystemet er en organisasjon også: den denne serveren ble satt opp som. Dets administratorer administrerer de andre.

Legg til en organisasjon

1. Åpne Organisasjoner (kapittel 65) og trykk Legg til organisasjon.
2. Gi dens navn og et kort navn (små bokstaver, tall og bindestreker). Det korte navnet er en del av dens web-adresse, /t/acme/, og av dens telefoners innlogginger, acme.100. Det kan ikke endres senere.
3. Gi eventuelt dens eget domene, som pbx.acme.example, pekt på denne serveren. Telefoner registrerer seg til det domenet, og dens administratorer åpner det i en nettleser.
4. Sett dens første administrator: et brukernavn og et passord på minst 12 tegn, og dets land.
5. Gi eventuelt begrensninger.

Organisasjonen starter med en gang med et tomt telefonisystem, klart for dens administrator å sette opp som beskrevet i Komme i gang (kapittel 1).

Hvordan samtaler finner riktig organisasjon

Så to organisasjoner kan begge ha utvidelse 100, og flere kan dele en leverandørkonto med forskjellige numre.

Hvor dens data er

På SQLite, har hver organisasjon sin egen mappe under tenants/ i data-mappen, med sin egen databasefil. På PostgreSQL, har hver sin egen skjema i samme database (tenant_acme). Sikkerhetskopier, arkiver og eksport er per organisasjon.

Begrensninger

0 er ingen begrensning. Nødsamtaler blir aldri nektet: en organisasjon på sin samtalebegrensning, eller suspendert, kan fortsatt ringe 911 og bli ringt tilbake.

Åpne en organisasjon

Åpne logger deg inn til dens web-grensesnitt som leverandøren, uten dens egen konto; det vises i dens audit-logg som leverandøren. Dens administratorer logger inn på dens egen adresse med sine egne konti. Hver organisasjon har sin egen innloggings-cookie, så å være logget inn på en gir aldri noen innlogging på en annen.

Organisasjoner ser aldri denne serverens egne skjermer: oppdateringer, database, andre servere, sertifikat, SIP-sporing (som viser hver organisasjons meldinger), samtale-generatoren eller denne listen.

Suspendering og fjerning

Suspenderer stopper innlogginger og hver samtale unntatt nødsamtaler; ingenting blir slettet. Fjern stopper organisasjonen og flytter dens mappe til side (tenants/.removed-<name>-<time>), så en feil kan bli gjort om for hånd.

Kodeker og lyd

En kodek er hvordan lyd omgjøres til data i en samtale. Telefoner, nettlesere og operatører støtter hver sine; BitVoice omgjør mellom hvilke som helst to kodeker når to parter forskjeller, så alle kan snakke med alle. Når begge bruker samme kodek går lyden ubesvart gjennom.

Kodekene

Innstillinger lister opp kodekene telefoner kan bruke, beste først; hver trunk kan ha sin egen liste. Analog adapterporter bruker alltid G.711, som faks, modemer og alarmpaneler trenger.

G.722.1, G.722.1C, G.719 og Codec2 bringes ubesvart mellom to parter som begge bruker dem, med deres båndbredde eller modus beholdt i tilbudet (BitVoice omgjør dem ikke, så en samtale mellom en av disse og en telefon uten det bruker en annen kodek begge har). Legg dem i en liste, over G.711, der romsystemer eller konferansetelefoner bør beholde sin lydrekkeffekt når de ringer hverandre. Listene navngir G.722.1 på 32 kHz G7221C, selv om SDP kaller begge G7221.

G.723.1 bringes ubesvart mellom to parter som begge bruker det. For å la en G.723.1-enhet snakke med noe annet, slå på Omgjør G.723.1 med ffmpeg i Innstillinger og installer ffmpeg (apt install ffmpeg, brew install ffmpeg): BitVoice kjører da ffmpeg som et eget program for hver retning som trenger omgjøring (hørt ved hver rate, sendt ved 6,3 kbit/s, hastigheten ffmpeg-kodekens encoder lager), omtrent 60 ms senere enn andre kodeker, og stopper det noen sekunder etter samtalen. BitVoice har ingen G.723.1-kodek på egen hånd: ITUs referansekode har ingen lisens som tillater å inkludere den, og ffmpeg installeres og kjøres på egen hånd.

Hva konvertering koster

Konvertering tar prosessortid, bare på oppkall der de to sidene er forskjellige. Per oppkall, omtrent 0,3 ms av en kjerne hver 20 ms for Opus og 0,12 ms for G.729 (noen 60 og 170 konverterte oppkall per kjerne); G.726 og GSM koster mindre enn G.729; G.711 og G.722 nesten ingenting. G.729 sendes uten Annex B (ingen stille-rammer).

Lydrensing

Lydrensing (Innstillinger) dumper ned jevne bakgrunnsstøy og jevner ut nivåer, for voicemail og, hvis du ønsker, under oppkall.

Microsoft Teams (Direct Routing)

BitVoice kan være session border controller (SBC) for en Microsoft Teams-leier, så Teams-brukere ringer BitVoice-utvidelser og dine telefonlinjer, og BitVoice ringer Teams-brukere.

Hva du trenger: et offentlig navn for denne serveren i et domene ditt Microsoft 365-leier har verifisert (sbc.eksempel.com), åpne port 5061 begge veier til Microsofts nettverk 52.112.0.0/14 og 52.120.0.0/14, og et sertifikat for det navnet fra en offentlig myndighet. Teams-brukere trenger en Phone System-lisens.

Steg

1. Innstillinger, Sertifikat: installer sertifikatet og dens private nøkkel (PEM). Det brukes med en gang, for dette grensesnittet og for SIP over TLS, og BitVoice presenterer det til Microsoft.
2. Trunker, Legg til, start fra Microsoft Teams: skriv inn serverens offentlige navn. Skuffen sier om sertifikatet dekker det.
3. Kopier PowerShell som skuffen viser og kjør det som en Teams-administrator: det legger til SBC (New-CsOnlinePSTNGateway), en stemmerute og -politikk, og en dialplanregel så kort utvidelsesnumre når BitVoice som valgt; deretter gi hver Teams-bruker politikken og deres nummer.
4. For å ringe Teams-brukere fra BitVoice, legg til en utgående rute for deres numre gjennom Teams-trunken. Teams finner sine brukere bare ved numre med + og landskoden: hvis mennesker ringer dem uten, legg til + og landskoden i rutens Foran (kallens hvorfor-spor sier så når ett går ut uten).

Når en Teams-bruker overfører et kall, ber Microsoft BitVoice om å plassere det (en REFER som navngir sin egen proxy, med nummeret eller Teams-brukerens ID): BitVoice ringer eksakt hva Microsoft navnga, med den Referred-By Microsoft ga, så en overføring til en annen Teams-bruker fungerer like bra som en til et telefonnummer. BitVoice sender aldri en Replaces-header til Teams, som Microsoft avviser.

BitVoice sender Microsoft OPTIONS hver minutt med SBC-navnet i Kontakt, som Microsoft krever, og prøver sip, sip2 og sip3.pstnhub.microsoft.com på rad. Media er alltid kryptert (SRTP). Helse advarer når sertifikatet ikke dekker navnet, er selv-signert eller utløper snart, og når Microsoft stopper å svare.

Dette følger Microsofts offentliggjorte SBC-krav og er testet mot en simulert Microsoft-proxy; BitVoice er ikke på Microsofts liste over sertifiserte SBC-er.

Importér

Bringer over utvidelser, ringgrupper, køer og trunker fra FreePBX, Asterisk eller 3CX; og personer, jakt og ringgrupper, SIP-trunker, innkommende numre og valgmodn fra Cisco, Avaya og Mitel. Last opp de eksporterte filene, flere på en gang (en .zip eller .tar av dem fungerer også); BitVoice viser nøyaktig hva som vil endres før noe blir anvendt, og importen blir en revisjon du kan angre på Endringer (kapittel 61).

Flytting fra FreePBX

Den beste filen er en FreePBX- Sikkerhetskopiering: den inneholder alt, inkludert SIP-passord.

1. I FreePBX: Admin → Sikkerhetskopiering & Gjenopprettelse → Legg til Sikkerhetskopiering. Velg minst Core, Ringgrupper, Køer og Voicemail (alle moduler er greit), lagre og Kjør.
2. Last ned sikkerhetskopien fra dens rad (filen har navn som 20261001-100000-1790000000-17.0.19-1234567.tar.gz).
3. Installer BitVoice på den nye serveren og fullfør oppsettet med en utvidelse som FreePBX ikke bruker (sier 199) og ingen telefonlinje: importen bringer linjene.
4. På Importér (kapittel 68), slipp .tar.gz-filen som den er. Les forhåndsvisningen: advarselen lister opp alt som ikke kan komme over.
5. Velg Legg til. Det er en revisjon på Endringer (kapittel 61): angre det der hvis noe ser feil ut, og importér på nytt.
6. Flytt telefonene: peke hver av dem mot BitVoice (eller konfigurer dem fra Telefoner (kapittel 4)), med samme utvidelsesnummer og SIP-passord de hadde.
7. Test anrop inn og ut, og flytt deretter registreringen av operatøren (eller nummeroverføringen) som siste punkt.

Prøvd på et ekte system: en FreePBX 17.0.33 (den offisielle Debian 12-installasjonen) med fire utvidelser og voicemail, en PJSIP-trunk som registrerer, to utgående ruter (en med et valgforanledningsprefiks), en ringgruppe, en kø med straffer og tre DIDs, sikkerhetskopiert av Sikkerhetskopiering & Gjenopprettelse med alle moduler valgt. Sikkerhetskopien er 70 MB, nesten alt av det er lydfiler og anropshistorikk: BitVoice leser det som det kommer og beholder bare konfigurasjonen, så en sikkerhetskopiering på opptil 512 MB lastes opp. Alt ovenfor kom over: passordene, voicemail-PINene og e-post, trunkens registrering og kodeker, rutene med deres prefikser, ringgruppens voicemail når den ikke besvares, køens straffer og DIDs til gruppen, køen og utvidelsen.

Hva som kommer over:

• Utvidelser: nummer, navn, utgående anrop-ID, ringetid og SIP-passord (BitVoice lager et nytt når FreePBX sitt er kortere enn 12 tegn: skriv det inn på nytt i den telefonen). Voicemail med dens PIN og e-postadresse (og om meldinger sendes vedlagt).
• Trunker: PJSIP og chan_sip-operatørkontoer: server, port, brukernavn, passord, registrering, fra domene, kodeker, anrop-ID, kanalbegrensning. Avslåtte trunker blir av. DAHDI-trunker blir Telefoni-kort-trunker.
• Utgående ruter, i FreePBX sin rekkefølge: hver mønsters foranledningsprefiks blir siffer droppet, dens forhengs-siffer blir lagt til. En rute hvis mønster dropper eller legger til forskjellige siffer blir en BitVoice-rute for hver.
• Ringgrupper: medlemmer, ringetid, ring-alle eller en-etter-en (jakt, minnehunt, først tilgjengelig), og hvor ubesvarte anrop går.
• Køer: medlemmer med deres straffer, strategi (ring alle, minst nylig, færrest anrop, rundt om, lineær, tilfeldig), ringetid, opprydnings-tid og lengste ventetid.
• Innkommende ruter: hver DID til dens utvidelse, ringgruppe, kø, voicemail-boks eller avslag.

Hva som ikke kommer over, og som blir sagt i forhåndsvisningen: IVR-er, tid-betingelser, annonsering, følg-meg, egne trunker og kontekster, anrop-ID-matching på ruter, og eksterne numre i ringgrupper. Bygg disse på Menyer (kapittel 21), Tidsplaner (kapittel 26) og utvidelsens Følg meg. Eldre sikkerhetskopier (FreePBX 13 og før) og en ren mysqldump asterisk av FreePBX-databasen leses på samme måte.

Andre systemer

Hvor hver eksport er:

• FreePBX (utvidelser bare): Admin → Bulk Handler → Eksport → Utvidelser (CSV).
• Asterisk: pjsip.conf eller sip.conf.
• 3CX: Brukere → Eksport (CSV).
• Cisco Unified CM: Bulk Administration → Telefoner → Eksport Telefoner, alle detaljer; eller Brukere → Eksport Brukere. Telefonenes første linje blir utvidelsen, med linjens varslingnavn eller etikett som navn.
• Avaya IP Office: Manager → Fil → Import/eksport → Eksport, Brukere.
• Avaya Communication Manager: list station lagret som CSV; virtuelle stasjoner og VDN-er utelates.
• Mitel MiVoice Business: System Data Management → Bruker- og enhetskonfigurasjon → Eksport.

Grupper og ruter. Last dem opp med personfilen, så hver gruppes medlemmer finnes ved nummer eller navn:

• Cisco Unified CM: Bulk Administration → Import/eksport → Eksport, med Line Group, Hunt List, Hunt Pilot, SIP Trunk og Route Pattern valgt; last opp .tar-filen som den er. Hver hunt pilot blir en ringgruppe med medlemmene fra sin hunt liste, Top Down og Circular som en etter en, Broadcast som alle på en gang, RNA-reverseringstiden som ringetid. Route-mønster blir utgående ruter: 9.[2-9]XXXXXX med PreDot er mønster 9[2-9]XXXXXX som dropper 9; ! blir et punktum til slutt. Mønster som bruker @ (nasjonal plan) listes for å skrives for hånd.
• Avaya IP Office: Eksport Hunt Group samt Brukere (begge er CSV uten header-rad). Gruppe-modus er alle på en gang; Hunt, Rotary og Longest Waiting ringer en etter en.
• Avaya Communication Manager: list hunt-group lagret som CSV, med medlemmene i en Medlem-kolonne eller en separat medlemsfil.
• Mitel MiVoice Business: Ring-grupper og Ring-gruppe-tildeling (Cascade er en etter en, Ring All alle på en gang), og Hunt-grupper.

Trunker fra disse eksportene kommer inn slått av og uten passord, da eksportene ikke inneholder dem. Ruter går ut på den importerte trunk med samme navn; en rute hvis trunk ikke er her, utelates og meldes. Rotasjon og lengste ledig ringing er nærmere en kø enn en ringgruppe: forhåndsvisningen sier det, så du kan gjøre det til en.

Disse eksportene (alle unntatt en FreePBX- Sikkerhetskopiering) inneholder ingen SIP-passord, så hver utvidelse får et nytt; voicemail-PIN-er, navn og e-postadresser kommer over når eksporten har dem. Cisco-, Avaya H.323/DCP- og Mitel-telefoner kjører produsentens egen programvare og kan ikke konfigureres av BitVoice: importen sier hvor mange som ble listet. Cisco-telefoner kan bli gjenprogrammert med Ciscos multiplattform (SIP)-firmvare; Avaya J100 og Mitel 6800/6900-telefoner kan registrere seg hos BitVoice for hånd i SIP-modus.

Konfigurasjon som kode

Alt skjermene gjør, går gjennom BitVoices REST-API, så hva som helst kan skrives om, lagres i Git eller håndteres med Terraform. API-et beskrives for verktøy på /api/openapi.json (/api/openapi.json).

API-tekster

Lages på Administrere (kapittel 57): en per program, kun lese eller i stand til å endre alt. Send den som Authorization: Bearer bv_.... Den vises én gang; tilbakekall den når den ikke lenger er nødvendig. En teksts endringer vises i Endringer og revisjonsloggen under dens navn.

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

Terraform eller OpenTofu

Repositorys deploy/terraform viser utvidelser, ringegrupper og ruter håndtert med den generiske REST-leverandøren: plan viser hva som ville endres, apply gjør endringen. Leverandøren sjekker BitVoices sertifikat; mens BitVoice fortsatt bruker sitt eget selvsignerte sertifikat, hent enten ett fra Let's Encrypt (Innstillinger, Sertifikater) eller sett bitvoice_insecure = true på et nett du stoler på (på Linux, SSL_CERT_FILE som peker på BitVoices sertifikat fungerer også). Ressursene sammenlignes med id-en BitVoice gir dem, så en andre plan viser ingen endringer før filen eller skjermene endrer noe.

Konfigurasjon fra Git

I Innstillinger (kapittel 14), Konfigurasjon fra Git, leser BitVoice konfigurasjonen fra en fil i et repository hver få minutter og enten viser hva som avviker eller gjør endringene. Start filen med Eksportér for Git, som lar være å inkludere passord; BitVoice beholder sine egne, så hemmeligheter havner aldri i repository.

Asterisk-kompatibilitet (AMI, ARI og AGI)

Verktøy skrevet for Asterisk kan kontrollere BitVoice: CRM, wallboards, klikk-til-ring-knapper, kontrollere for opptak av samtaler. Slå det på i Innstillinger (kapittel 14), Asterisk-kompatibilitet. Verktøy ser samtaler som kanaler med navn som PJSIP/100-..., som på Asterisk.

AMI

Administrasjonsgrensesnittet på TCP-port 5038 (AMI lytter på: denne datamaskinen bare som standard). Støttet:

Filter holder bare hendelsene som en regulær uttrykk matcher (Event: Newchannel), eller dropper dem med ! først, som på Asterisk. Det finnes ingen Asterisk-kommandolinje: Command svarer med en feil.

ARI

På /ari/, med grunnleggende autentisering eller ?api_key=user:secret:

En ekstern media-kanal som ikke er lagt til en samtale innen en minutt blir stengt.

ARI-applikasjoner

En ARI-applikasjon (Asterisk sin Stasis()) kjører samtaler fra ditt eget program. Legg den til under ARI-applikasjoner i Innstillinger, Asterisk-kompatibilitet: et navn, et valgfritt nummer utvidelser ringer, og en fallback. Så send samtaler til den som til enhver destinasjon: en innkommende rute, en menyknapp, en timeplan.

Ditt program kobler seg til /ari/events?app=NAME (en WebSocket, med innlogging i ?api_key=user:secret). Hver samtale som når applikasjonen blir besvart og ankommer som StasisStart, med kanalen; programmet kjører den så:

BitVoice svarer på hver enkelt operasjon i Asterisks publiserte ARI (testsvitene kalder hver enkelt og sjekker hva som kommer tilbake har feltene Asterisks beskrivelse krever). Noen har ingen relevans her og svarer 501 med årsaken: lastbare moduler (BitVoice er et program), Sorcerys dynamiske konfigurasjon (BitVoice er konfigurert i sin nettgrensesnitt), loggekanaler, broer videokilder (ARI-broer bærer lyd), sending av REFER til telefoner og krav om kringkastingsanrop. En snikelytter hører bare oppringeren (spy=in), og whisper tilbys ikke: bro en kanal med deres for å snakke med dem. Kanalehendelser for hver samtale (ChannelCreated, ChannelStateChange, ChannelDestroyed) går til hvert program, som med Asterisks subscribeAll=true. ARI-biblioteker som leser grensesnittet fra serveren (ari-client og andre) finner det på /ari/api-docs/resources.json. Hvilke programmer holder nå, under ARI-applikasjoner i Innstillinger, viser applikasjonene, tilpassede enhetsstater, postkasser, globale variabler og broer programmer har satt.

Tastetrykk ankommer som ChannelDtmfReceived; en oppringer som legger på som StasisEnd. Når ingen program er koblet, går samtalen til fallbacken; når programmet siste kobling lukkes, går samtalen der også etter fem sekunder (tid til å gjenopprette koblingen). For samtalelogikk uten et eget program, bruk Skript (kapittel 27) som kjører hele samtalen; for å overføre lyden til et program, Taleboter (kapittel 24).

AGI-skript

Et AGI-skript (Asterisks AGI() og EAGI()) kjører en samtale kommando for kommando, så IVR og integrasjoner skrevet for Asterisk (phpagi, pyst2, Asterisk-Java, enhver FastAGI-server) fungerer fortsatt. Legg det til under AGI-skript i Innstillinger, Asterisk-kompatibilitet:

Test kobler til serveren (eller sjekker om programmet er der og kjørbar) uten å sende en samtale. Deretter send samtaler til det som et vanlig mål.

BitVoice svarer på samtalen, sender agi_-variablene (agi_network_script, agi_callerid, agi_dnid, agi_extension, agi_language …) og utfører kommandoene, og svarer som Asterisk 20 gjør (testsviten sammenligner hvert svar med en innspilling av Asterisks):

BitVoice har ingen valgplan: hvor et skript ville gå videre i Asterisks valgplan (SET EXTENSION, EXEC Goto), går samtalen til det nummeret her (en utvidelse, ringegruppe, kø, meny eller et eksternt nummer via utgående ruter) når skriptet avsluttes. Skriptene ringer aldri nødnumre. Når oppringeren legger på, får en FastAGI-skript HANGUP og et program SIGHUP; bare kommandoer som er tillatt på en død kanal kjører deretter (511 for de andre), og koblingen lukkes 30 sekunder senere hvis skriptet fortsetter. Hver kjøring vises under Siste kjøringer med sine VERBOSE-linjer, og går til hendelsesstrømmen som agi.ran.

Lyder for AGI-skript. Skriptene spiller lyder med navnene de bruker på Asterisk: last dem opp under Lyder for AGI-skript med en mappe (custom/welcome; es/custom/welcome for oppringere på spansk). WAV, MP3 og Asterisks .gsm, .ulaw, .alaw, .sln og .sln16 aksepteres; en sti som /var/lib/asterisk/sounds/en/custom/welcome.gsm finner custom/welcome. Asterisks digits/0–digits/9, beep, silence/N og noen andre (vm-goodbye, invalid, please-hold) spiller BitVoices egne promter og toner. Hva skriptene innspiller, beholdes i samme bibliotek, merket innspilt av et skript, for de dagene du velger (30 som standard). Biblioteket holder opptil 1 GB.

Programmer. Et program kjører på denne serveren med BitVoices rettigheter, så det lastes aldri opp via web: kopier det inn i AGI-programm-mappen som vises på skjermen (DATA/agi-bin) og gjør det kjørbar. Det får bare PATH og AST_AGI_DIR fra miljøet, kjører i den mappen og hva det skriver til standardfeil går til serverloggen. FastAGI sender kommandoer i ren TCP: hold serveren på denne datamaskinen eller et privat nettverk.

Innlogging

Hver innlogging har et Brukernavn og Hemmelighet. Innlogginger er kun lese med mindre de er merket Kan endre samtaler. Hold AMI på denne datamaskinen med mindre verktøyet kjører et annet sted: AMI er ren, ukryptert TCP.

AI-assistenter (MCP)

En AI-assistent som Claude, ChatGPT, Gemini eller Cursor kan bruke BitVoice gjennom Model Context Protocol (MCP), standardmåten assistenter når andre programmer. Spør den i vanlige ord: hvem ringte i morra og om noen ringte tilbake, hva var det ringende fra tannlegens kontor sa, hvorfor gikk 9-tiden ringingen til voicemail, er leverandør-linjen nede. Med din tillatelse, kan den også initiere et oppkall, sende en tekst eller avslutte et oppkall.

BitVoice is the MCP server, at https://YOUR-SERVER/mcp (Streamable HTTP; the address shows in Settings). Nothing goes to any AI service unless an assistant you connected asks for it, and then only what it asked for.

Slå den på

I Innstillinger (kapittel 14), AI-assistanter (MCP):

• Tillat AI-assistanter å koble til: av som standard. Av, /mcp svarer bare at den er av.
• Tillat assister å handle: av som standard. Av, assister kan bare lese, uansett deres token. På, en assistent hvis token kan endre ting får også verktøyene som handler.

Kortet viser adressen og innstillinger som er klare til å kopieres for de vanlige assistentene, og lister alle verktøy.

Hva en assistent kan gjøre

Lese (med noen token):

• calls_now: pågående oppkall.
• call_history: tidligere oppkall, søkt etter nummer eller navn, etter retning og fra en tid, med hvorfor hvert gikk der det gikk.
• utvidelser: navn, numre, avdelinger, e-post; aldri en telefons passord.
• phones_connected: hvilke telefoner er registrert, hvorfra.
• voicemail, search_transcripts: meldinger og hva som ble sagt på innspilte oppkall.
• queues, trunks, health: køer nå, leverandør-linjene, BitVoices egne sjekker.
• katalog, text_messages: bedrifts-telefonkatalogen og tekst-samtaler.

Handle (med La assistenter handle, og en token som kan endre ting):

• place_call: klikk for å ringe. Utvidelsens telefon ringer først; når noen der tar opp, ringer BitVoice nummeret for dem som om de hadde tastet det, så deres ruter, ringe-identitet og begrensninger gjelder.
• send_text: en tekst-melding fra en av organisasjonens tekst-numre.
• hang_up_call: avslutter et pågående oppkall.

Hvert verktøy er en av API-ene sine egne ruter, kjørt som assistenten: den ser og endrer nøyaktig hva dens token kan, samme sjekker gjelder, og dens endringer er i revisjonsloggen under dens navn. Et svar beholdes på omtrent 60 000 tegn; assistenten blir bedt om å begrense sin søk når en er kutta.

Kobling av en assistent

Assistenter som logger inn (Claude.ai og ChatGPT-tilpassede koblinger, og andre): legg til en kobling med BitVoices adresse. Assistenten åpner BitVoices innlogging i nettleseren din; logg inn som vanlig (passord, to-trinns, enkelt innlogging), og siden sier hvilken assistent som ber og hvor den returnerer til. En administrator kan la den fungere eller Kun la den lese; en seers assistent kan bare lese. Tillat ikke sender den vekk med ingenting. Tilgangen er deretter på Administratorene (kapittel 57), API-tekster, som AI-assistent, logget inn: den fungerer bare på /mcp og aldri for resten av API-en, varer en time av gangen og fornyer seg selv i opp til 30 dager uten å bli brukt. Tilbakekall avslutter den med en gang. Disse assistentene når BitVoice fra sine egne servere, så det trenger en adresse som er tilgjengelig fra internettet og et sertifikat de stoler på (Let's Encrypt, i Sertifikat (kapittel 14)).

Assistenter gitt en token (Claude Code, Cursor, VS Code og andre verktøy som tar en adresse og en header): lag en API-tekst på Administratorene (kapittel 57), kun lese med mindre den skal fungere, og gi den som Authorization: Bearer bv_...:

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

Assistenter som starter et program (Claude Desktop, og andre som tar en kommando): BitVoice-programmet har en bro, bitvoice mcp, som passerer hver melding til serveren over HTTPS. Gi den serveradressen og tokenet:

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

Med BitVoices eget sertifikat (ikke ett fra en myndighet), nekter broen det og skriver ut dets SHA-256: sjekk at det er din servers, og legg til "-pin", "THAT-SHA256" til argumentene. Bare dette sertifikatet aksepteres deretter.

Sikker å forlate på

• Bare token: en nettlesers innlogging til BitVoice når aldri /mcp, og en side på en annen nettsted er nektet (Opphav), så en nett-side kan ikke bruke en assistent-kobling.
• Assistenter kan være feil. Gi dem en kun-lese-tekst med mindre de må fungere; alt de gjør er i revisjonsloggen, og å plassere et oppkall ringer alltid en persons telefon først.
• Innlogging via OAuth 2.1 som MCP spesifiserer: assistenten registrerer seg selv (bare offentlige klienter, med PKCE), returnerer bare til de adressene den registrerte (https, eller http til sin egen datamaskin), og en kode er gyldig en gang, i ett minutt.
• En organisasjon som er vert på en annens BitVoice gir sine assistenter token; innlogging via OAuth der er ikke prøvd ennå.

Arkiv

Arkivet holder kopier av opptak, voicemail og konfigurasjonen et annet sted: en Amazon S3-bucket (eller en annen S3-kompatibel lagring) eller en Azure Blob Storage-beholder. Hvis denne serverens disk går tapt, har arkivet dem fortsatt.

Konfigurasjon

1. På Arkiv (kapittel 72), velg Hvor arkivere: Amazon S3 eller Azure.
2. For S3: Bucket, Region, et valgfritt Mappe i bucket og Endpoint (for S3-kompatible lagringssteder), og et Tilgangsnøkkel-ID og Hemmelig tilgangsnøkkel. Kopier politikken gir den eneste tillatelse BitVoice trenger, for å koble til brukeren eller rollen.
3. For Azure: en Container SAS-URL med skrive-tillatelse, og et valgfritt Mappe i containeren.
4. Velg hva som skal kopieres utenom konfigurasjonen: Opptak, Voicemail, eller begge.

Hva skjer

Hver tiende minutt kopierer BitVoice nye opptak og meldinger som ikke er i arkivet ennå, og en gang om dagen en datert kopi av konfigurasjonen (config/2026-10-13.json). Siden viser den siste kjøringen, den siste suksessen og eventuelle feil.

Sletting av noe her (ved oppbevaring eller for hånd) sletter ikke arkivets kopi: sett bucketens eller containerens egne livssyklusregler for hvor lenge arkivet beholder ting.

Juridisk varetekt

En juridisk varetekt holder samtalelogg, opptak og voicemail som en sak kan trenge, og forhindrer at noen sletter dem, til den blir løst. Bruk den når en advokat ber om at loggene skal bevares.

Legg til en vakt

På Lovlige vakter (kapittel 73), trykk Legg til:

Mens en vakt er på

• Bevaring lar det det dekker være uendret, uansett alder.
• Ingen kan slette en vaktet samtale, opptak eller voicemail, inkludert administratorer.
• Vaktede samtaler viser en lås i Samtalelogg (kapittel 47).

Løsning

Løs gjør det varetektet holdt tilgjengelig for varetektinnstillingene igjen: ting eldre enn varetektet blir slettet ved neste opprydning. Løste varetekter blir vist, med når og av hvem, og å legge til og løse varetekter er i revisjonsloggen.

Målinger: Prometheus, OpenTelemetry, Grafana, SNMP og oppkallshistorikk

Prometheus scraper /metrics på webadressen. Lag en API-nøkkel under Administratorer (en seernøkkel er nok) og gi den til Prometheus som dens bærernøkkel:

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

Den leser oppkall i gang (etter tilstand), oppkall avsluttet (etter retning og resultat), samtaletid, telefoner registrert, hver trunks tilstand og rundtur, oppringere som venter og agenter i hver kø, lydpakker mottatt og tapt, en histogram over oppkallskvalitetspoeng (MOS), og tilbakekall booket. Tellerne starter igjen fra null når BitVoice restartes, som Prometheus forventer.

OpenTelemetry: i Innstillinger, Målinger, skriv inn en samlers OTLP/HTTP-adresse (og en header som Autorisasjon, med dets verdi) for å få de samme målingene dyttet hver minutt (eller så ofte du setter, fra 15 sekunder). Dytt nå sjekker de lagrede innstillingene.

Grafana- dashboard laster ned et ferdiglaget dashboard: importer det i Grafana og velg din Prometheus-datakilde.

SNMP

For overvåkingssystemer som snakker SNMP (Zabbix, PRTG, LibreNMS, Nagios, SolarWinds), slå på SNMP-agenten i Innstillinger. Den svarer på SNMPv2c GET, GETNEXT og GETBULK, kun lese, på UDP-port 161 (eller en annen du velger: port 161 trenger retten til å åpne lavports på Linux), og bare fra nettverkene du lister. Velg en samfunn som ikke er offentlig eller privat: det er en passord som krysser nettverket i klart.

Den serverer standard systemgruppen (sysDescr, sysUpTime, sysContact, sysName, sysLocation) og BitVoices egne verdier under basis-OID: oppkall i gang og ringende, telefoner registrert, trunks opp og konfigurert, oppringere som venter, oppkall avsluttet, samtalesekunder, tapt pakker, gjennomsnittlig oppkallskvalitet, en trunktabelle (navn, opp eller ned, latency) og en køtabelle (ventende, agenter, besvart, forkastet). Last ned BITVOICE-MIB ved siden av innstillingene for din overvåking å laste. BioDream LLC har ingen bedriftsnummer ennå, så standard basis-OID er i Net-SNMPs eksperimentelle rom; legg til en under ditt eget bedriftsnummer for å holde det stabilt.

Feller (SNMPv2) går til hver mottaker du lister når en trunk går ned eller kommer tilbake, et nødoppkall blir gjort, eller en server i en kluster slutter å svare. SNMPv3 støttes ikke ennå.

Oppkallshistorikk andre steder

Ved siden av Oppkallshistorikk, kan hver post gå, når oppkallet slutter, til:

• Syslog (RFC 5424, som JSON) over UDP, TCP eller TLS, for en loggtjener eller en SIEM.
• En CSV-fil per dag, med Asterisks Master.csv-kolonner, så rapport- og faktureringsverktøy laget for Asterisk kan lese den. Last ned filene ved foten av Oppkallshistorikk (kapittel 47). Cellene som et regneark ville kjøre som en formel, blir skrevet trygt.
• En PostgreSQL-tabelle i en annen database, laget første gang med Asterisks cdr-kolonner (calldate, clid, src, dst, duration, billsec, disposition, uniqueid…) pluss BitVoices retning, trunk, kostnad og MOS. Hver oppkall blir skrevet én gang.

Send en testpost prøver syslog-tjeneren og databasen med innstillingene lagret.

Oppkallsgenerator

Oppkallsgeneratoren plasserer ekte oppkall med ekte lyd inn i BitVoice fra denne datamaskinen: for å se hvor mange oppkall en server håndterer og hvor godt, eller for å sjekke etter en endring at oppkall fortsatt går der de skal.

Kjør en test

Les resultater