Navodila za partnerje

Vaš slovenski AI telefonski agent od prijave do prvega klica. Javna izdaja · velja za vse partnerje · fab-voice.si/navodila.html

01Kaj je FAB VOICE

FAB VOICE je slovenski AI telefonski agent, ki lahko sprejema klice 24 ur na dan. Odgovarja na pogosta vprašanja, zajame rezervacijo ali povratni klic in lahko preveže na nastavljeno živo osebo. Po klicu v nadzorni plošči preverite zabeležen izid in dostavo v povezane sisteme.

• Dosegljivost po dogovorjeni zmogljivosti

  Agent lahko odgovarja tudi izven delovnega časa, ob praznikih in med gnečo. Pred začetkom uporabe opravite testni klic ter preverite dogovorjeno hkratnost.

• Naravna slovenščina

  Normalizator pomaga pri izgovorjavi številk, datumov, ur, cen, naslovov in kod.

• Nadzorovan dostop

  Nadzorna plošča zahteva geslo in dvostopenjsko prijavo. Podatki o hrambi, podobdelovalcih in lokaciji obdelave so navedeni v pogodbeni ter pravni dokumentaciji.

02Prijava

Vsaka oseba uporablja svoj račun. Prijavne podatke (e-naslov in začetno geslo) prejmete po e-pošti od skrbnika ob aktivaciji; v tem dokumentu jih ni. Ob prvi prijavi geslo zamenjate s svojim in nastavite dvostopenjsko prijavo.

• Kje se prijavite

  Nadzorna plošča: fab-voice.si/voice-dashboard.html. Partnerski portal za pregled računa in dostopov: fab-voice.si/stranke-portal.html.

• Prva prijava

  Vpišite prejeti e-naslov in začetno geslo, nato v plošči odprite Račun → Zamenjaj geslo. Začetno geslo je namenjeno samo prvi prijavi; po zamenjavi ga izbrišite iz e-pošte.

• Več oseb

  Vsak član ekipe dobi lasten račun; dostopov ne delite. Novega člana doda skrbnik prostora.

Dvostopenjska prijava (2FA)

Ob prvi prijavi se prikaže naslov »Nastavi 2FA (obvezno)« in navodilo »Povežite aplikacijo authenticator in potrdite nastavitev s trenutno kodo.« To ni koda po e-pošti.

1. Odprite fab-voice.si/voice-dashboard.html.
2. Vpišite e-naslov in geslo, ki ste ga prejeli ločeno.
3. Pod naslovom se izriše QR koda velikosti 134 px, pod njo pa je prikazan ročni ključ.
4. Skenirajte QR kodo z aplikacijo Google Authenticator ali Microsoft Authenticator. Če je ni, zaslon pokaže: »QR ni na voljo. Uporabite ročni ključ.«
5. Kodo vnesite v 6 ločenih polj. Vtipkate jo lahko po eni števki ali prilepite vseh šest, nato kliknete »Potrdi →«.
6. Ob naslednjih prijavah zaslon pokaže »Vpišite kodo« in »Odprite aplikacijo authenticator in vpišite 6-mestno kodo.« Vnesite trenutno kodo ter kliknite »Potrdi →«.

• Seja velja 2 uri

  Po dveh urah se znova prijavite z e-naslovom, geslom in novo kodo iz aplikacije.

• Izgubljen ali zamenjan telefon

  Obrnite se na skrbnika za ponastavitev 2FA. Po preverbi identitete skrbnik ponastavi vezavo; ob naslednji prijavi nastavite novo aplikacijo z novo QR kodo.

03Nadzorna plošča

Osrednji pregled dogajanja. Na vrhu vidite ključne kazalnike, spodaj pa zavihke za agente, klice, rezervacije, številke, integracije in analitiko.

• Pregled

  Klici danes, rezervacije, zamujeni klici in poraba minut na enem mestu.

• Agenti

  Ustvarite ali uredite agenta, ga preklopite v način pavze ali izbrišete.

• Klici

  Prepis, trajanje in izid klica; posnetek je prikazan le, če je snemanje učinkovito omogočeno in je zajem uspel.

• Rezervacije

  Zajete rezervacije in povratni klici; označite jih kot obdelane.

04Ustvarjanje agenta

1. Ime in začetna panoga - izbira panoge je enkratni pripomoček za pripravo začetnega scenarija. Panoga se ne shrani kot živa nastavitev; po ustvarjanju so pomembna dejanska navodila agenta.
2. Jezik in glas - izberite slovenščino ter glas. Predposluh je približek; dejanski glas in kakovost preverite s testnim klicem.
3. Pozdrav - prvi stavek, ki ga stranka sliši. Ime podjetja se lahko fonetično prilagodi za boljšo izgovorjavo.
4. Navodila (prompt) - določite delovni čas, storitve, cene in pravila rezervacij. Gumb AI izboljšava pomaga urediti osnutek; rezultat pred uporabo preglejte.
5. AI pregled - ob shranjevanju dobite kratko oceno, kaj je dobro in kaj velja dopolniti.

Nasveti za odličen prompt

Kakovost agenta je odvisna od navodil. Nekaj preverjenih nasvetov:

1. Bodite konkretni: navedite delovni čas, storitve in cene, ki jih agent sme povedati.
2. Napišite, česa agent NE sme (npr. ne sme dajati zdravstvenih nasvetov).
3. Določite, katere kontaktne podatke mora zajeti (ime, priimek, telefon ali e-naslov).
4. Povejte, kdaj naj preveže na živo osebo.
5. Uporabite gumb AI izboljšava — samodejno uredi in dopolni vaš prompt.

• Primer dobrega pozdrava

  „Dober dan, tukaj digitalni pomočnik salona Lepote. Kako vam lahko pomagam — želite rezervirati termin?“

05Glas, jezik in izgovorjava

FAB VOICE uporablja slovenski normalizator izgovorjave, ki številke, datume, ure, cene, odstotke, naslove in kode pretvarja v obliko, primerno za govor.

• Primeri

  „14:30“ → ob pol treh

  „od 2 do 3 ure“ → od dveh do treh ur

  „s 5 % popustom“ → s petodstotnim popustom

  „041 234 567“ → po številkah

• Glasovi

  Slovenski ženski in moški glasovi; agent govori o sebi v nastavljenem spolu.

  Za tuja imena in blagovne znamke pomaga fonetični zapis.

06Telefonske številke (SIP trunk)

Svojo številko pri operaterju pripeljete v FAB VOICE sami, v plošči: Telefonske številke → Dodaj številko (SIP trunk). Isti koraki so v pomočniku plošče (vprašanje »Kako dodam svojo telefonsko številko?«).

1. Odprite meni Telefonske številke.
2. Kliknite Dodaj številko (SIP trunk) - plošča skroli do kartice SIP voda.
3. Vpišite ime voda in izberite način overjanja: po IP-jih operaterja ali z uporabniškim imenom in geslom (digest).
4. Pri overjanju po IP kliknite Prevzemi operaterjev IP, da se vpiše razpon vašega operaterja.
5. V polje Številke vpišite številke v obliki +386...; pri načinu digest server vpišite tudi SIP domeno (samo javno ime, brez sip: in vrat).
6. Kliknite Shrani (SIP trunk).
7. Operaterju pošljite podatke iz kartice 'SIP vezava - kaj nastaviti pri operaterju' (naslov sip.fab-voice.si:5060, kodek G.711, DTMF RFC 2833).
8. Nato številko povežite z agentom (recept 'Povežem številko z agentom').

Tehnična pola za vašega operaterja (SIP)

Vaš operater na svoji strani usmeri dogovorjene številke na FAB VOICE. Pred preklopom obe strani uskladita številke, izvorne IP-je in testni termin. Podatke spodaj dobite tudi v plošči na kartici SIP vezava (gumb za kopiranje).

1. Signalizacija: dohodni promet za dogovorjene številke usmerite na sip.fab-voice.si:5060 prek UDP ali TCP po dogovoru. Za usmeritev uporabljajte ime gostitelja, ne golega IP-ja.
2. Zvok: omogočite G.711 PCMA in PCMU; RTP uporablja UDP vrata 16384-32768, DTMF pa RFC 2833.
3. Številke: klicana in kličoča številka naj bosta posredovani v mednarodnem formatu +E.164 (primer +386...).
4. Overjanje voda: po IP-jih (v plošči vpišete signalizacijske naslove VAŠEGA operaterja) ali z uporabniškim imenom in geslom (digest). Operater pred testom sporoči vse dejanske signalizacijske IP-je in RTP izvorne obsege.

Dogovorjeni tehnični podatki

Kontrolni povzetek za tehnični del vašega operaterja.

• SIP ciljsip.fab-voice.si:5060
• Dovoljeni IP-jisignalizacijski naslovi vašega operaterja (plošča → SIP trunk)
• KodekG.711 (PCMA / PCMU)
• Format+E.164
• MediaRTP UDP 16384-32768 · DTMF RFC 2833

07Integracije

Nekatere povezave so partnerske (e-pošta osebju, koledar in webhook po klicu), druge se nastavijo pri agentu (webhook med klicem). Po testnem klicu izid vedno preverite tudi v ciljnem sistemu.

• E-pošta osebju - Po klicu obvesti nastavljeni naslov osebja o rezervaciji ali povratnem klicu; ne pošilja potrditve stranki.
• Google Koledar - Preverja proste termine med klicem in po klicu poskusi ustvariti dogodek v povezanem koledarju.
• Webhook med klicem - Agentovo HTTPS orodje za vaš sistem; nastavi se pri posameznem agentu.
• Webhook po klicu - Partnerska nastavitev za pošiljanje izida rezervacije ali povratnega klica po koncu klica.
• Sheets / Slack / Teams / SMS - Izvedba prek zunanjega webhooka ali ponudnika; ni vgrajen samostojen prehod.

08Rezervacije in povratni klici

• Rezervacija

  Agent poskusi zajeti nastavljena polja ter jih prebrati nazaj. Po klicu preverite zapis in morebitni koledarski dogodek.

• Povratni klic

  Če termina ne more potrditi, lahko zabeleži kontakt za povratni klic; osebje nato zapis obdela.

• Obdelano

  Rezervacijo ali povratni klic označite kot obdelan; filter „Neobdelano“ pokaže odprte zapise.

• Zgodovina klicatelja

  Plošča lahko pokaže pretekle zapise iste številke. AI spomin na prejšnje klice je izklopljen in se med klicem ne uporablja.

09Klici in posnetki

V zavihku Klici preverite prepis, trajanje in izid zaključenega klica. Posnetek je na voljo samo, če je snemanje omogočeno na agentu in platformi ter je zajem uspešno končan.

• Prepis

  Pogovor v besedilu pomaga preveriti, kaj je bilo dogovorjeno. Po testu potrdite, da se je zapis pojavil.

• Posnetek - pogojno

  Če je učinkovito snemanje vključeno in zajem uspe, je posnetek mogoče predvajati prek avtenticirane povezave.

• Izvoz CSV

  Razpoložljive zapise klicev lahko izvozite za analizo ali arhiv; dostop je zaščiten s prijavo in 2FA.

• Brisanje

  Klic ali razpoložljivi posnetek lahko izbrišete skladno s pravicami računa in politiko hrambe.

Način pavze

Pavza ni mehanski izklop telefonske poti. Agent klic še vedno sprejme, vendar dobi vaše sporočilo in navodilo za ravnanje med odsotnostjo; nekatera orodja lahko ostanejo dosegljiva. Besedilo pavze zato nastavite jasno in ga obvezno preverite s testnim klicem.

10Analitika in obračun

Plošča prikazuje porabo minut, število klicev, rezervacije in kazalnike zamujenih priložnosti. Obračun preverjajte po dogovorjenem modelu in obdobju.

11Popolni vodič - od podjetja do prvega klica

Sedem korakov od priprave podatkov do preverjenega testnega klica.

1. Dodajte podjetje - vnesite ime in opis s storitvami, cenami ter delovnim časom. Ta vsebina pomaga oblikovati odgovore agenta.
2. Naložite PDF ali spletno stran (neobvezno) - po obdelavi preverite bazo znanja ter ključne odgovore, preden gradivo uporabite v klicu.
3. Ustvarite agenta - izbrana panoga pripravi samo začetni predlog. Preglejte in uredite shranjena navodila, nato nastavite glas, jezik ter pozdrav.
4. Nastavite obvezna polja - označite želene podatke (ime, priimek, telefon ali e-naslov). To je pogovorno navodilo, ne absolutno mehansko varovalo, zato rezultat preverite po testu.
5. Povežite integracijo - nastavite partnerjev koledar, e-pošto osebju ali webhook oziroma agentovo orodje. Izvedite testni klic in izid preverite na cilju.
6. Povežite telefonsko številko - po tehnični uskladitvi jo v zavihku Številke povežite z agentom.
7. Opravite testni klic - preverite pogovor, prepis in trajni izid. Če pričakujete snemanje, posebej potrdite, da je posnetek dejansko na voljo.

Seznam pred prvim klicem

Pred začetkom uporabe preverite celotno pot:

1. Agent ustvarjen - začetni panožni predlog pregledan in dejanska navodila prilagojena.
2. Pozdrav preverjen s testnim klicem; ime podjetja pravilno izgovorjeno.
3. Navodila vsebujejo delovni čas, storitve, cene in pravila rezervacij.
4. Obvezna polja so izbrana in praktično preizkušena; zapis po klicu je popoln.
5. Povezana integracija je preizkušena s testnim klicem, izid pa preverjen v ciljnem sistemu.
6. Telefonska številka je po uskladitvi z operaterjem povezana s pravim agentom.
7. Prepis je preverjen; če pričakujete snemanje, je preverjena tudi dejanska razpoložljivost posnetka.

12Odpravljanje težav

Najpogostejši primeri in prvi preverljivi koraki.

• Agent se ne oglasi

  Preverite, ali je telefonska številka v zavihku Številke povezana s pravim agentom in je povezava aktivna. Če je vezava pravilna, zapišite čas poskusa in obvestite skrbnika.

• Napačno prebrano ime

  V pozdravu ali navodilih dodajte fonetični zapis v oklepaju (npr. „Chorvath (Horvat)“) in rezultat preverite s testnim klicem.

• Rezervacije ni v ciljnem sistemu

  Najprej preverite zapis v plošči in nato e-pošto, koledar ali webhook. Sporočite skrbniku datum, uro in številko klica; običajni pogled ne zagotavlja gumba za ponovno dostavo.

• Napačen termin

  V navodilih jasno določite delovni čas in dovoljene termine. Pri Google Koledarju preverite tudi dejanski dogodek v povezanem koledarju.

13Pogosta vprašanja

14Slovarček izrazov

• Prompt - Navodila, ki agentu povedo, kako se vede in kaj sme povedati.
• SIP - Protokol za povezavo telefonske številke ali centrale z agentom.
• Webhook - HTTPS sporočilo vašemu sistemu med klicem ali po izbranem dogodku.
• 2FA / TOTP - Dvostopenjska prijava: poleg gesla še časovno omejena koda iz aplikacije Authenticator.
• Latenca - Zakasnitev med govorom stranke in odgovorom agenta.
• Normalizator izgovorjave - Modul, ki številke, datume, ure, cene in kode pretvori v obliko za govor.
• Prevezava (REFER) - Predaja klica živi osebi, kadar so izpolnjeni tehnični pogoji.

Pripravljeni na prvi testni klic

Povežite agenta, številko in ciljni sistem; nato preverite celotno pot od zvonjenja do trajnega izida.

Prijava v nadzorno ploščoVprašanje skrbniku