Dokumentation

1. Opret konto og opret en instans

1. Registrér dig på /register.
2. Verificér din e-mail (tjek spam, hvis den ikke dukker op).
3. Log ind. Du lander på dit kontrolpanel.
4. Klik på Opret ny instans. Giv den et visningsnavn.

2. Indlejr Alex på dit website

Hver instans viser en kodestump på én linje på sin detaljeside. Indsæt den i dit websites HTML, helst lige før </body>:

<script src="https://alex.siimii.ai/embed/v1/widget.js"
        data-instance-key="YOUR-INSTANCE-KEY"
        defer></script>

Valgfrie attributter på script-tagget:

• data-position — bottom-right (standard) eller bottom-left
• data-button-text — etiket på launcher-knappen (standard "Ask Alex")
• data-open — auto (standard), open eller closed

For iframe-indlejringer uden launcher skal du pege en iframe mod /widget?instance_key=YOUR-INSTANCE-KEY.

3. Konfigurer persona og viden

På din instans' detaljeside:

• Persona-instruktioner — systemprompt i almindeligt sprog. Fortæl Alex, hvem den er, hvordan den skal tale, og hvad den skal afvise.
• Stemme — vælg blandt de realtidsstemmer, platformen tillader.
• Eskalerings-e-mail — hvor anmodninger om menneskelig opfølgning sendes hen.
• Vidensbase — tilføj poster (titel + indhold + tags). Alex konsulterer denne, før den besvarer faktuelle spørgsmål.

4. Valgfrit: indgående telefonopkald

Sådan lader du Alex besvare et rigtigt telefonnummer:

1. Gennemfør KYC-verificering på /dashboard/verification.php (Stripe Identity, tager ~2 minutter).
2. På din instans-side → fanen Telefon → søg i Telnyx-lageret efter land / område / lokalitet → klik på Tildel ved det nummer, du ønsker.
3. Nummeret begynder at dirigere indgående opkald til Alex' stemme inden for få sekunder.

5. Overdragelse til et menneske på telefon

To tilstande pr. instans:

• Lejer-SIP-URI — indsæt din eksisterende PBX-adresse (f.eks. sip:help@your-pbx.example.com). Alex overfører aktive opkald dertil, når den beslutter at eskalere.
• Vores PBX (agenter) — tilføj en eller flere agenter på /dashboard/agents.php. Hver får et SIP-login. Agenten installerer Linphone / Zoiper med login-oplysningerne og holder appen kørende. Alex ringer til dem ved eskalering.

Hvis intet menneske svarer inden for din timeout (10–180 s), overtager Alex opkaldet igen, undskylder og indsamler kontaktoplysninger til opfølgning via e-mail.

Angiv operatørens åbningstider + helligdage på instans-siden for at undgå at ringe til agenter uden for deres vagt.

6. Fakturering

• Abonnement — 499 kr./md. ekskl. moms pr. konto. Første måneds betaling indsættes som forbrugssaldo; fra anden måned trækkes beløbet fra saldoen d. 1. i måneden.
• Forbrug — alt AI-forbrug (tale, tekst, øvrig AI) afregnes pr. token og trækkes fra den forudbetalte saldo. Vejledende: tale ca. 5 kr./min, tekst ca. 66 øre pr. spørgsmål/svar. Fyld op på /dashboard/billing.php; automatisk genopfyldning kan slås til.
• Månedsopgørelser — genereres d. 1. for den foregående måned med tale-minutter, spørgsmål/svar og øvrigt AI-forbrug, og kan ses/udskrives i dashboardet.
• Telefonbroer — videreføres fra Telnyx med avance, og der opkræves kun for besvarede broer.

7. API (til avanceret brug)

Account-servicen udstiller et REST-API på /account-api/. Autentificér med din JWT (cookie fra login eller Authorization: Bearer). Vigtige endpoints:

• GET /account-api/tenants/:tenantId/instances
• POST /account-api/tenants/:tenantId/instances
• PATCH /account-api/instances/:id
• POST /account-api/instances/:id/pause · .../resume
• POST /account-api/instances/:id/telnyx/provision
• GET /account-api/tenants/:tenantId/kyc
• POST /account-api/payment/checkout-session
• GET /account-api/billing

Scopes og korrelationsheadere med request-ID (X-Request-Id) videreføres fra ende til ende på tværs af web, account-service og voice-gateway.

8. Sikkerhed

• JWT-cookies er HttpOnly + Secure + SameSite=Strict på kontrolpanelet.
• Formularer i kontrolpanelet indeholder CSRF-tokens, der valideres på serversiden.
• Hastighedsgrænser pr. IP på auth- og widget-chat-endpoints.
• Stripe Identity KYC kræves for al telefoni-tildeling.

9. Support

Spørgsmål? Svar på enhver e-mail, du modtager fra platformen, eller eskalér inde fra Ask Alex selv — beskeden lander på vores kontrolpanel.