Hjælp til WHMCS Apps

API 1

• Brug API'et direkte Alle endpoints ligger under /modules/addons/whmcspwa/api/index.php. Send en Authorization: Bearer-header med adgangstokenet. Opslagsskærmen viser den aktuelle rutetabel, genereret fra selve routeren.

Branding 4

• App-ikoner Lever en PNG på 192px og en på 512px. Kvadratisk, uden afrundede hjørner og uden gennemsigtighed: hver platform lægger sin egen maske på, og et gennemsigtigt ikon får en sort baggrund på iOS.
• Brandfarve og accent Brandfarven bruges til appens primære knapper, links og telefonens statuslinje. Accenten er forbeholdt ting, der kræver opmærksomhed, som en forfalden faktura. Når de holdes adskilt, kan en ubetalt saldo aflæses med det samme.
• Pastel, lys, mørk og automatisk Automatisk er standarden og følger telefonens indstilling: din lyse palet om dagen og det mørke tema om natten. Pastel er en råhvid baggrund med bløde linjer, lys er samme layout i køligere grå nuancer, og…
• Ikonet, der følger med modulet Indtil du uploader dit eget, bruger appen en stak rackenheder med én tændt statuslampe. Det er bevidst generisk, og det er et rigtigt ikon frem for en farvet firkant, så en installation uden nogen konfiguration stadig…

Funktioner 8

• Vedhæftning af et billede eller en fil, og hvem der ser det Personalet kan vedhæfte filer til en sag fra en telefon, også direkte fra kameraet, og vælge, om kunden kan se dem. Standarden er kun personale, og netop den standard er pointen: den fejl, der er værd at designe imod, er en…
• Vedhæft et skærmbillede til en ny sag Når du opretter en sag i kundeappen, er der et valgfrit vedhæftningsområde under beskeden: Vælg en fil henter hvad som helst fra enheden, og Tag et billede åbner kameraet, som er den hurtige måde at vedhæfte et…
• Luk din egen sag En service på en cPanel-server viser en cPanel-sektion under Forbrug, når kontoen er aktiv, med de daglige værktøjer. Når du vælger et, åbnes cPanel i en ny fane, logget ind og landet på det værktøj, uden adgangskode at…
• Filer på en sag Vedhæftninger vises under den besked, de kom med, og downloades med et tryk. At levere filer fra disken er det farligste, dette modul gør, så reglerne er strenge: linket navngiver filen i stedet for, at kalderen gør…
• Åbn cPanel En service på en cPanel-server viser en cPanel-sektion under Forbrug, når kontoen er aktiv, med de daglige værktøjer: Filhåndtering, E-mailkonti, Databaser, phpMyAdmin, Sikkerhedskopier med mere. Når du vælger et, åbnes cPanel i en ny fane, logget ind…
• Udskriv en faktura Appen laver sin egen udskrivbare kopi i stedet for at hente WHMCS-PDF'en, fordi den PDF leveres bag en session i kundeområdet, som appen ikke har, og at bede nogen om at logge ind to gange for at se deres egen faktura…
• Slå sektioner til og fra En sektion, der er slået fra, forsvinder fra appens navigation, og dens API-endpoints begynder at afvise anmodninger. Begge dele sker samtidig, så når en skærm skjules, tilbageholdes dataene reelt i stedet for kun at skjule knappen.
• Hvad kunderne ser først En service på en cPanel-server viser en knap Åbn cPanel under Forbrug, når kontoen er aktiv. Den logger dig direkte ind i cPanel i en ny fane uden adgangskode at skrive og lander på cPanels startside, hvor Fil…

Guider 7

• Guide: Få kunderne over på appen Meddelelsen, installationen og hvad du gør ved iPhones.Cirka 30 minutter.Angiv appens adresse Peg et underdomæne som app.yourhosting.com på appen, og brug det overalt. En kort adresse er forskellen mellem, at folk skriver den, og at folk…
• Guide: Håndter en sag fra telefon til løsning Hvad en kunde sender, hvad personalet ser, og hvordan offline-svar opfører sig.Cirka 10 minutter.Slå sager til Kunderne får en liste over deres sager og kan oprette nye i enhver afdeling, du har konfigureret i WHMCS.En kunde opretter en sag…
• Guide: Fra faktura til betaling på en telefon Sådan bliver en notifikation til en betalt faktura.Cirka 10 minutter.Fakturaen oprettes WHMCS opretter fakturaen som normalt. Appen fanger den hændelse og giver kunden besked med beløbet og forfaldsdatoen i notifikationen.De trykker på notifikationen…
• Guide: Start appen for første gang Fra en ny installation til en kunde, der trykker på din app på sin hjemmeskærm.Cirka 15 minutter.Kør opsætningen Guiden tjekker HTTPS, PHP-udvidelser og din WHMCS-version før alt andet, så du opdager en hindring nu i stedet for…
• Guide: Placér installationskoden, hvor den bliver scannet Fra den genererede kode til kunder med appen på deres hjemmeskærm.Cirka 30 minutter.Fastlæg appens adresse, før du udskriver noget Koden indeholder den adresse, der er angivet her. Udskriv den, ændr så adressen, og hver udskrevet kode peger…
• Guide: Slå passkeys til uden en bølge af supporthenvendelser Slå dem til, bevis at de virker på din egen enhed, og lad derefter folk finde dem.Cirka 20 minutter og derefter en uges overvågning.Beslut domænet først Før nogen tilmelder sig, så fastlæg det domæne, passkeys bindes til. Hvis appen måske flytter til app.yourhosting.com…
• Guide: Når noget ikke virker De tjek, der løser de fleste henvendelser, i den rækkefølge, de er værd at prøve.Cirka 5 minutter.Tjek sundhedspanelet først Det rapporterer HTTPS, PHP-udvidelser, API-administratorkontoen og notifikationsnøglerne. De fleste problemer skyldes, at en af de fire ikke er angivet.Ingen kan…

Installation 2

• Få koden foran folk Panelet i kundeområdet klarer arbejdet automatisk: en, der er logget ind på en computer, ser koden, mens en på en telefon ser en installationsknap i stedet, fordi en telefon ikke kan scanne sig selv. Ud over det er de to placeringer, der faktisk virker…
• Installationskoden En QR-kode med din apps adresse, genereret af modulet og ikke af en tredjepartstjeneste, så intet eksternt firma lærer noget om din kundetrafik. Den afspejler altid appens adresse på skærmen Branding. Udskriv den på fakturaer, vis den…

Notifikationer 4

• Notifikationsnøgler VAPID-nøgler identificerer din server over for Apples, Googles og Mozillas push-tjenester. Generér dem én gang. Hvis du genererer dem igen, bliver alle eksisterende tilmeldinger ugyldige, så alle skal slå notifikationer til igen.
• Notifikationer på iPhone iOS leverer kun webnotifikationer, når appen er føjet til hjemmeskærmen, og tilladelsesprompten skal komme fra et tryk. Appen spørger på skærmen Notifikationer i stedet for ved første indlæsning, netop af den…
• Giv personalet besked om sager Med notifikationer slået til kan personalet også få besked om sager: når en ny oprettes, og når en kunde svarer på en eksisterende. Et svar på en sag, der er tildelt en bestemt medarbejder, går til…
• Hvad der udløser en notifikation Faktura oprettet, betaling modtaget, betaling mislykkedes og et svar fra personalet på en sag. Hver af dem er en separat WHMCS-hook, så du kan slå én fra uden at røre de andre.

Offline 1

• Hvad der virker uden signal De sidste skærme, nogen har indlæst, kan stadig læses, og et sagssvar skrevet offline sættes i kø og sendes, i det øjeblik forbindelsen vender tilbage. Betalinger kræver altid en aktiv forbindelse.

Passkeys 6

• Lås appen En enhed kan indstilles til at låse appen, når den går i baggrunden, så det kræver et fingeraftryk at åbne den igen. Den oplagte måde at bygge det på er en prompt foran den eksisterende session, men det ville være teater:…
• Kræv fingeraftryk, ansigt eller PIN-kode Når dette er slået til, skal enheden bekræfte, hvem der holder den, før den signerer, så en telefon, som nogen har samlet op ulåst, ikke er nok i sig selv. Når det er slået fra, accepteres tilstedeværelse alene: et tryk på sikkerheds…
• Personalekonti med totrinsgodkendelse WHMCS har ingen understøttet måde at bekræfte en medarbejders anden faktor uden for sin egen loginformular. Hvis kun adgangskoden blev tjekket, ville denne app blive den nemme vej uden om en kontrol, du bevidst har slået til, så konti med totrinsgodkendelse kan ikke…
• Det domæne, passkeys er bundet til En passkey er knyttet til ét domæne og dets underdomæner, og den binding er det, der gør den umulig at phishe. Tom betyder, at modulet udleder det af din apps adresse. Angiv det bevidst, hvis du måske flytter appen senere:…
• Hvad en passkey er Et nøglepar, som telefonen eller den bærbare opretter og opbevarer bag sin egen låseskærm. At logge ind betyder, at enheden signerer en engangsudfordring med den private halvdel, som aldrig forlader den og aldrig sendes over netværket. Der er ingen…
• Når nogen mister enheden Deres adgangskode virker stadig, så ingen bliver låst ude. Passkeys gemt i iCloud-nøglering eller Google Password Manager følger også personen til en ny enhed af sig selv. Hvis en enhed virkelig er mistet, så log ind med adgangskoden,…

Sikkerhed 4

• Hastighedsbegrænsning Anmodninger pr. minut fra én IP-adresse. Loginforsøg begrænses separat og strammere. Hæv den, hvis et stort kontor bag én adresse bliver blokeret.
• Rotér signeringsnøglen Rotering logger alle ud af appen overalt med det samme. Brug det, hvis du har mistanke om, at et token er lækket. Ingen mister data; de logger bare ind igen.
• Sessioner og tokens Et login returnerer et kortlivet adgangstoken og et langlivet opdateringstoken. Opdateringstokens roteres ved hver brug; hvis et gammelt vises igen, tilbagekaldes hele sessionen, og det er sådan, et stjålet token bliver opdaget.
• Hvorfor personalelogin overhovedet kræver et tjek WHMCS har et understøttet kald til at validere en kundes adgangskode, men intet til at validere en medarbejders, så appen må selv læse den gemte hash. Hvor den hash ligger, har ændret sig mellem WHMCS-versioner: ældre installationer har den på…

Opsætning 5

• API-administratorkonto Appen tjekker adgangskoder og opretter sager ved at kalde WHMCS som denne administrator. Vælg en dedikeret konto med kun de rettigheder, appen har brug for, frem for en persons daglige login, så du kan tilbagekalde den uden at låse nogen ude.
• Få appen ind på en hjemmeskærm Android og Chrome på computer viser automatisk en installationsprompt, når appen har et manifest, et ikon på mindst 192px og en service worker. iOS har ingen prompt: folk bruger Del og derefter Føj til hjemmeskærm. Appen registrerer…
• Vis fejldetaljer Normalt viser appen en kort, generel besked, når en anmodning fejler, og de egentlige detaljer går til aktivitetsloggen. Når dette er slået til, kommer den egentlige besked og stedet, hvor det skete, også tilbage i appen. Det er beregnet…
• Bekræft cPanel-certifikatet For at åbne cPanel logger appen kunden ind via cPanel-serverens eget API over en sikker forbindelse. Forbindelsens certifikat tjekkes som standard. Nogle servere præsenterer et selvsigneret certifikat eller et certifikat med forkert værtsnavn på deres API-port, hvilket gør…
• Hvorfor HTTPS er påkrævet Browsere nægter at installere en hjemmeskærmsapp, registrere en service worker eller levere notifikationer over almindelig HTTP. Localhost er den eneste undtagelse, og derfor virker test, før dit certifikat gør.

Personale 19

• Handlinger på en service eller et domæne Fra en kundeskærm har hver service de handlinger, der passer til dens tilstand: suspendér en aktiv, genaktivér en suspenderet, kør oprettelsen/opsætningen for en, der stadig afventer. En suspendering beder om en begrundelse, fordi den begrundelse er den eneste…
• Tilføj en intern note En sagsskærm har et felt til interne noter for personalet under svarfeltet. Det, du skriver der, gemmes som en WHMCS-sagsnote — kun for personalet, og kunden får aldrig besked. Det er til den løbende kommentar…
• Annullér en faktura En ubetalt, kladde- eller forfalden faktura kan annulleres fra sin egen skærm, hvilket får WHMCS til at stoppe med at rykke for betaling. Det er tilgængeligt på telefonen, fordi det kan fortrydes: en annulleret faktura kan genoprettes som ubetalt fra…
• Hurtige handlinger for kunder En kundeskærm har en række handlinger til de ting, personalet gør uden at åbne en computer. Tilføj kredit sætter en saldo på kontoen. Send nulstilling af adgangskode udløser WHMCS' nulstillingsmail, så kunden får det sædvanlige link…
• Kontakt og handlinger på en kunde En kundeskærm har knapper til opkald, sms og e-mail øverst og en WHMCS-knap, der åbner hele kundens profil i adminområdet. De tre første er enhedslinks: de sender videre til telefonens opkaldsapp, beskedapp…
• Styr, hvad kunderne kan gøre Du styrer, hvad kunderne kan se og gøre i appen, på to niveauer. Konto, Tilladelser i kundeappen angiver de standarder, alle kunder arver: for hver ting, såsom at betale fakturaer, oprette sager eller åbne cPanel, afgør en kontakt, om…
• Invitér kunder til appen Du kan sende kunderne et link til appen på e-mail med en vejledning i at føje den til deres hjemmeskærm; de logger ind med den konto, de allerede har. Send til én fra kundeskærmen med knappen Invitér, eller til…
• Åbn en kunde Et tryk på en kunde hvor som helst i appen åbner én skærm med, hvad kunden har, hvad de skylder, og hvad de venter på: services med deres status, domæner med dage til udløb, fakturaer med ubetalte først og eventuelle åbne sager.…
• Tilsidesæt for én kunde En kundeskærm har App-tilladelser, hvor standarderne kan tilsidesættes for netop den kunde. Hver tilladelse viser tre valg: Standard følger den globale indstilling, Til gør den tilgængelig for denne kunde uanset standarden, og Fra fjerner den…
• Meld et netværksproblem En service på en cPanel-server viser cPanel-værktøjerne under Forbrug, når kontoen er aktiv, samt en knap Åbn cPanel. Når kunden vælger et værktøj, logges vedkommende ind og lander, hvor serveren tillader det, direkte på værktøjets…
• Aflæs dashboardet Dashboardet har tre sider: indtægter, ordrer og support. Swipe mellem dem, eller tryk på navnene over dem, hvilket er den hurtigste vej til den tredje. Indtægter tæller penge, der faktisk er modtaget, hvilket ikke er det samme som fakturerede penge:…
• Seneste aktivitet Seneste aktivitet, der linkes til fra dashboardet, er én strøm af det, der netop er sket i hele virksomheden: nye ordrer, modtagne betalinger, oprettede sager og anmodede opsigelser, nyeste først, for den seneste måned. Dashboardets tællere fortæller dig, hvor…
• Registrér en modtaget betaling Til penge, der kom ind uden om appen: en bankoverførsel, kontanter, en check. Appen sender betalingen til WHMCS via WHMCS' eget AddInvoicePayment-kald i stedet for selv at skrive i regnskabet, så WHMCS afgør, om fakturaen nu er…
• Gemte svar på en telefon De foruddefinerede svar, der allerede er sat op i WHMCS under Support, vises i appen grupperet efter kategori, og et tryk på et af dem føjer det til det, der allerede står i svarfeltet, i stedet for at erstatte det. Det er den funktion, der afgør…
• Forbliv logget ind Personalelogin har et felt, Hold mig logget ind på denne enhed. Lad fluebenet stå, så varer sessionen mellem besøg som normalt. Fjern fluebenet, så holdes sessionen kun, indtil appen lukkes helt, hvilket passer til en…
• Undgå, at en betaling registreres to gange Skriv bankreferencen eller kvitteringsnummeret i feltet Reference. Appen afviser en ny betaling med en reference, der allerede er registreret på fakturaen, og det er det, der redder dig, når en telefon mister forbindelsen midt i indsendelsen, og du trykker igen.…
• Søgefeltet Dashboardet har et søgefelt, der søger i kunder, fakturaer, sager og domæner på én gang, så en kunde i telefonen kan findes uden at vide, hvilken liste de står på. Skriv et navn, firma, en e-mail eller et telefonnummer…
• Visitér en sag En sag, der åbnes i køen, viser et visitationspanel for personalet under sin status. Derfra kan status, prioritet, afdeling og den medarbejder, sagen er tildelt, hver især ændres, og hver ændring træder i kraft i det øjeblik, den…
• Behandl en ordre Et tryk på en afventende ordre åbner den med de samme handlinger, som den officielle app tilbyder, bortset fra én: godkend, annullér, annullér og refundér, markér som svindel og tilbage til afventende. Hver af dem kører gennem WHMCS' dokumenterede ordre-API, så den gør præcis…

Support-hub 4

• Åbn hub'en fra Indstillinger Personalet når hub'en fra Indstillinger på skærmen Dig, hvor Åbn Keen2Support logger dig ind på din egen supportskranke med dit navn og din e-mail overført, så du ikke bliver spurgt igen. Det er et link snarere…
• Hjælpefeedet, som hub'en læser Hub'en modtager ikke hjælp fra dette modul; den henter den. En gang i timen læser den et feed, som dette modul leverer, og cacher artiklerne, så en supportmedarbejder, der håndterer en sag, kan søge i dem og indsætte et svar…
• Hvad forbindelsen til Keen2Support gør Keen2Support er din egen separate supportskranke hos dem, der har lavet denne app. Forbindelsen registrerer appen hos hub'en med en produktnøgle hentet derfra, og appen får et webstedstoken, som den bruger ved hver senere…
• Hvilken telemetri der sendes, og hvilken der ikke gør Telemetri er slået fra, indtil du slår den til. Når den er slået til, spejles de hændelser, som denne app allerede registrerer i sin egen aktivitetslog, til hub'en: ting som et login, en registreret betaling, en sendt push. Før noget forlader…

Værktøjer 2

• Tjek, at serveren kan sende notifikationer Kør "php modules/addons/whmcspwa/tools/selftest.php" på serveren. Den signerer et token, signerer en VAPID-anmodning og krypterer og dekrypterer derefter en rigtig push-nyttelast uden at røre din database. Atten tjek skal bestå. Hvis push-tjekkene fejler, mangler serveren…
• Versionsnumre og opgraderinger Versionen i version.php er det eneste sande svar; skærmen Overblik, API'et og appen læser den alle derfra. Tre filer, som browseren indlæser direkte, har en kopi, så deres cache ryddes ved opgradering. "php tools/version.php –check"…

Din konto 8

• Skift en domæneindstilling En domæneskærm har en sektion Indstillinger med tre kontakter, du selv kan ændre: automatisk fornyelse, WHOIS-beskyttelse og overførselslås. Hver viser sin nuværende tilstand og skifter, når du trykker, direkte til din konto hos udbyderen. Automatisk fornyelse på…
• Skift din adgangskode Konto, Skift adgangskode beder om din nuværende adgangskode og derefter en ny. Den nuværende adgangskode tjekkes først, så en, der samler en ulåst telefon op, ikke i al stilhed kan ændre den. Den nye adgangskode skal være mindst otte…
• Redigér dine oplysninger Konto, Dine oplysninger, Redigér dine oplysninger lader dig ændre dine egne kontaktoplysninger: navn, firma, e-mail, telefon og adresse. Når du gemmer, skrives det direkte til din konto hos udbyderen, på samme måde som hvis du redigerede det på deres websted, så fakturaer og…
• Glemt adgangskode På login-skærmen tager Glemt adgangskode en e-mailadresse og beder udbyderen om at sende et nulstillingslink til den. Linket og nulstillingssiden tilhører udbyderens eget system, præcis som på webstedet, så appen…
• Glemt brugernavn Kunderne logger ind med deres e-mailadresse, så der er intet separat brugernavn at glemme. Glemt brugernavn på login-skærmen forklarer dette og sender, hvis den indtastede e-mail hører til en konto, en kort påmindelse til den. Ligesom med…
• Betal alt på én gang Når mere end én faktura står ubetalt, tilbyder startskærmen én knap, Betal alle, med det samlede beløb sammen med et link til at se de enkelte fakturaer. Betal alle åbner udbyderens side til samlet betaling, som indfrier alle ubetalte fakturaer…
• Enheder, der er logget ind Konto, Enheder, der er logget ind viser alle steder, hvor din konto i øjeblikket er logget ind, med enheden, dens adresse og hvornår den sidst blev brugt, og markerer den, du bruger nu. Hvis du logger en enhed ud, som du ikke genkender, afsluttes dens session…
• Dine notifikationer Når notifikationer er slået til, og du har tilladt dem på en enhed, gemmes de ting, du får besked om — en ny faktura, en gennemført betaling, et svar på en sag — også i appen under…