Aide WHMCS Apps

API 1

• Utiliser l’API directement Chaque point d’accès se trouve sous /modules/addons/whmcspwa/api/index.php. Envoyez un en-tête Authorization: Bearer avec le jeton d’accès. L’écran de référence liste la table des routes en direct, générée à partir du routeur lui-même.

Personnalisation 4

• Icônes d’application Fournissez un PNG de 192 px et un de 512 px. Carrés, sans coins arrondis ni transparence : chaque plateforme applique son propre masque, et une icône transparente s’affiche sur fond noir sur iOS.
• Couleur de marque et accent La couleur de marque colore les boutons principaux de l’application, les liens et la barre d’état du téléphone. L’accent est réservé à ce qui demande de l’attention, comme une facture en retard. Les garder distinctes permet de repérer un solde impayé d’un coup d’œil.
• Pastel, clair, sombre et automatique Automatique est le réglage par défaut et suit celui du téléphone : votre palette claire le jour, le thème sombre la nuit. Pastel est un fond blanc cassé avec des lignes douces, clair est la même mise en page dans des gris plus froids, et…
• L’icône fournie avec le module Tant que vous n’avez pas téléversé la vôtre, l’application utilise une pile d’unités de rack avec un voyant d’état allumé. Elle est volontairement générique, et c’est une vraie icône plutôt qu’un carré de couleur, pour qu’une installation sans aucune configuration reste…

Fonctionnalités 8

• Joindre une photo ou un fichier, et qui le voit L’équipe peut joindre des fichiers à un ticket depuis un téléphone, y compris directement depuis l’appareil photo, et choisir si le client les voit. Par défaut, ils sont réservés à l’équipe, et ce choix par défaut est voulu : l’erreur à éviter en priorité est un…
• Joindre une capture d’écran à un nouveau ticket Lors de l’ouverture d’un ticket dans l’application client, une zone de pièce jointe facultative se trouve sous le message : Choisir un fichier sélectionne n’importe quel fichier de l’appareil, et Prendre une photo ouvre l’appareil photo, ce qui est le moyen rapide de joindre une…
• Fermer votre propre ticket Un service sur un serveur cPanel affiche une section cPanel sous Utilisation une fois le compte actif, avec les outils du quotidien. En choisir un ouvre cPanel dans un nouvel onglet, connecté et directement sur cet outil, sans mot de passe à…
• Fichiers d’un ticket Les pièces jointes apparaissent sous le message qui les accompagnait et se téléchargent d’un appui. Servir des fichiers depuis le disque est l’opération la plus dangereuse de ce module, les règles sont donc strictes : le lien désigne le fichier plutôt que de laisser l’appelant…
• Ouvrir cPanel Un service sur un serveur cPanel affiche une section cPanel sous Utilisation une fois le compte actif, avec les outils du quotidien : Gestionnaire de fichiers, Comptes e-mail, Bases de données, phpMyAdmin, Sauvegardes et plus encore. En choisir un ouvre cPanel dans un nouvel onglet, connecté…
• Imprimer une facture L’application génère sa propre copie imprimable plutôt que de récupérer le PDF de WHMCS, car ce PDF est servi derrière une session de l’espace client que l’application ne détient pas, et demander à quelqu’un de se connecter deux fois pour voir sa propre facture…
• Activer et désactiver des sections Une section désactivée disparaît de la navigation de l’application et ses points d’accès API commencent à refuser les requêtes. Les deux se produisent ensemble, masquer un écran retient donc réellement les données au lieu de seulement cacher le bouton.
• Ce que les clients voient en premier Un service sur un serveur cPanel affiche un bouton Ouvrir cPanel sous Utilisation une fois le compte actif. Il vous connecte directement à cPanel dans un nouvel onglet sans mot de passe à saisir, sur l’accueil de cPanel où le Gestionnaire de…

Guides 7

• Guide : amener les clients sur l’application L’annonce, l’installation et que faire pour les iPhone.Environ 30 minutes.Définir l’adresse de l’application Faites pointer un sous-domaine tel que app.yourhosting.com vers l’application et utilisez-le partout. Une adresse courte fait la différence entre des gens qui la tapent et des gens qui…
• Guide : gérer un ticket du téléphone à la résolution Ce qu’un client envoie, ce que voit l’équipe et comment se comportent les réponses hors ligne.Environ 10 minutes.Activer les tickets Les clients obtiennent la liste de leurs tickets et peuvent en ouvrir de nouveaux dans n’importe quel département configuré dans WHMCS.Un client ouvre un ticket…
• Guide : de la facture au paiement sur un téléphone Comment une notification devient une facture réglée.Environ 10 minutes.La facture est émise WHMCS crée la facture comme d’habitude. L’application intercepte cet événement et notifie le client, avec le montant et l’échéance dans le corps de la notification.Il touche la notification…
• Guide : lancer l’application pour la première fois D’une installation neuve à un client qui touche votre application sur son écran d’accueil.Environ 15 minutes.Lancer la configuration L’assistant vérifie HTTPS, les extensions PHP et votre version de WHMCS avant toute chose, pour que vous découvriez un blocage maintenant plutôt que…
• Guide : placer le code d’installation là où il sera scanné Du code généré aux clients ayant l’application sur leur écran d’accueil.Environ 30 minutes.Fixez l’adresse de l’application avant d’imprimer quoi que ce soit Le code encode l’adresse définie ici. Imprimez-le, puis changez l’adresse, et chaque code imprimé pointe…
• Guide : activer les passkeys sans vague de demandes d’assistance Activez-les, vérifiez qu’elles fonctionnent sur votre propre appareil, puis laissez les gens les découvrir.Environ 20 minutes, puis une semaine d’observation.Choisissez d’abord le domaine Avant que quiconque s’enregistre, fixez le domaine auquel les passkeys sont liées. Si l’application risque de passer sur app.yourhosting.com…
• Guide : quand quelque chose ne fonctionne pas Les vérifications qui résolvent la plupart des signalements, dans l’ordre où il vaut la peine de les essayer.Environ 5 minutes.Consultez d’abord le panneau de santé Il indique HTTPS, les extensions PHP, le compte administrateur API et les clés de notification. La plupart des problèmes viennent de l’un de ces quatre éléments non défini.Personne ne peut…

Installation 2

• Mettre le code sous les yeux des gens Le panneau de l’espace client fait le travail automatiquement : une personne connectée sur ordinateur voit le code, une personne sur téléphone voit un bouton d’installation à la place, car un téléphone ne peut pas se scanner lui-même. Au-delà, les deux emplacements qui convertissent vraiment…
• Le code d’installation Un code QR contenant l’adresse de votre application, généré par le module plutôt que par un service tiers, pour qu’aucune entreprise extérieure ne connaisse votre trafic client. Il reflète toujours l’adresse de l’application indiquée sur l’écran Personnalisation. Imprimez-le sur les factures, affichez-le…

Notifications 4

• Clés de notification Les clés VAPID identifient votre serveur auprès des services push d’Apple, Google et Mozilla. Générez-les une seule fois. Les régénérer invalide tous les abonnements existants, et tout le monde doit alors réactiver les notifications.
• Notifications sur iPhone iOS ne délivre les notifications web qu’une fois l’application ajoutée à l’écran d’accueil, et la demande d’autorisation doit venir d’un appui. L’application la demande sur l’écran Notifications plutôt qu’au premier chargement précisément pour cette…
• Notifier l’équipe au sujet des tickets Avec les notifications activées, l’équipe peut aussi être prévenue au sujet des tickets : lorsqu’un nouveau ticket est ouvert, et lorsqu’un client répond à un ticket existant. Une réponse sur un ticket attribué à un membre de l’équipe en particulier est envoyée à…
• Ce qui déclenche une notification Facture créée, paiement reçu, paiement échoué, et réponse de l’équipe sur un ticket. Chacun est un hook WHMCS distinct, vous pouvez donc en désactiver un sans toucher aux autres.

Hors ligne 1

• Ce qui fonctionne sans réseau Les derniers écrans chargés restent lisibles, et une réponse à un ticket rédigée hors ligne est mise en file et envoyée dès le retour de la connexion. Les paiements nécessitent toujours une connexion active.

Passkeys 6

• Verrouiller l’application Un appareil peut être réglé pour verrouiller l’application lorsqu’elle passe en arrière-plan, de sorte que la rouvrir demande une empreinte. La façon évidente de le faire serait une invite devant la session existante, mais ce ne serait que du théâtre :…
• Exiger une empreinte, le visage ou un code PIN Avec cette option activée, l’appareil doit confirmer qui le tient avant de signer, un téléphone ramassé déverrouillé ne suffit donc pas à lui seul. Désactivée, la simple présence est acceptée : un appui sur la clé de sécurité…
• Comptes de l’équipe avec authentification à deux facteurs WHMCS ne propose aucun moyen officiel de vérifier le second facteur d’un membre de l’équipe en dehors de son propre formulaire de connexion. Ne vérifier que le mot de passe ferait de cette application le moyen facile de contourner un contrôle que vous avez délibérément activé, les comptes avec deux facteurs ne peuvent donc pas…
• Le domaine auquel les passkeys sont liées Une passkey est liée à un domaine et à ses sous-domaines, et c’est ce lien qui la rend impossible à hameçonner. Vide, le module le déduit de l’adresse de votre application. Définissez-le délibérément si vous risquez de déplacer l’application plus tard :…
• Ce qu’est une passkey Une paire de clés que le téléphone ou l’ordinateur crée et conserve derrière son propre écran de verrouillage. Se connecter signifie que l’appareil signe un défi à usage unique avec la moitié privée, qui ne le quitte jamais et ne transite jamais par le réseau. Il n’y a aucun…
• Quand quelqu’un perd son appareil Son mot de passe fonctionne toujours, personne n’est donc bloqué. Les passkeys stockées dans le trousseau iCloud ou le Gestionnaire de mots de passe de Google suivent aussi la personne d’elles-mêmes sur un appareil de remplacement. Si un appareil est réellement perdu, connectez-vous avec le mot de passe,…

Sécurité 4

• Limite de débit Requêtes par minute depuis une même adresse IP. Les tentatives de connexion sont plafonnées séparément et plus strictement. Augmentez cette valeur si un grand bureau derrière une seule adresse se retrouve bloqué.
• Renouveler la clé de signature Le renouvellement déconnecte immédiatement tout le monde de l’application, partout. Utilisez-le si vous soupçonnez la fuite d’un jeton. Personne ne perd de données ; il suffit de se reconnecter.
• Sessions et jetons La connexion renvoie un jeton d’accès de courte durée et un jeton de rafraîchissement de longue durée. Les jetons de rafraîchissement changent à chaque utilisation ; si un ancien est présenté à nouveau, toute la session est révoquée, c’est ainsi qu’un jeton volé est détecté.
• Pourquoi la connexion de l’équipe nécessite une vérification WHMCS propose un appel officiel pour valider le mot de passe d’un client, et aucun pour celui d’un membre de l’équipe : l’application doit donc lire elle-même le hachage enregistré. L’emplacement de ce hachage a changé entre les versions de WHMCS : les installations plus anciennes le conservent sur…

Configuration 5

• Compte administrateur API L’application vérifie les mots de passe et ouvre les tickets en appelant WHMCS en tant que cet administrateur. Choisissez un compte dédié doté uniquement des autorisations nécessaires à l’application plutôt que l’identifiant quotidien d’une personne, afin de pouvoir le révoquer sans bloquer personne.
• Installer l’application sur un écran d’accueil Android et Chrome sur ordinateur affichent automatiquement une invite d’installation dès que l’application a un manifeste, une icône d’au moins 192 px et un service worker. iOS n’a pas d’invite : on utilise Partager, puis Sur l’écran d’accueil. L’application détecte…
• Afficher le détail des erreurs Normalement, lorsqu’une requête échoue, l’application affiche un message court et générique et le vrai détail va dans le journal d’activité. Avec cette option activée, ce vrai message et l’endroit où l’erreur s’est produite remontent aussi dans l’application. C’est prévu…
• Vérifier le certificat cPanel Pour ouvrir cPanel, l’application connecte le client via l’API propre au serveur cPanel, sur une connexion sécurisée. Le certificat de cette connexion est vérifié par défaut. Certains serveurs présentent un certificat auto-signé ou ne correspondant pas au nom d’hôte sur leur port API, ce qui fait…
• Pourquoi HTTPS est obligatoire Les navigateurs refusent d’installer une application sur l’écran d’accueil, d’enregistrer un service worker ou de délivrer des notifications en HTTP simple. Localhost est la seule exception, c’est pourquoi les tests fonctionnent avant votre certificat.

Équipe 19

• Agir sur un service ou un domaine Depuis l’écran d’un client, chaque service propose les actions adaptées à son état : suspendre un service actif, réactiver un service suspendu, lancer la création/configuration d’un service encore en attente. Une suspension demande un motif, car ce motif est la seule…
• Ajouter une note interne L’écran d’un ticket comporte une zone Note interne réservée à l’équipe, sous la zone de réponse. Ce que vous y écrivez est enregistré comme note de ticket WHMCS — visible par l’équipe uniquement, et le client n’est jamais notifié. Elle sert au suivi au fil de l’eau…
• Annuler une facture Une facture impayée, en brouillon ou en retard peut être annulée depuis son propre écran, ce qui empêche WHMCS d’en réclamer le paiement. C’est proposé sur le téléphone parce que c’est réversible : une facture annulée peut être rétablie comme impayée depuis la…
• Actions rapides sur un client L’écran d’un client propose un ensemble d’actions pour ce que l’équipe fait sans ouvrir d’ordinateur. Ajouter du crédit crédite le compte. Envoyer une réinitialisation du mot de passe déclenche l’e-mail de réinitialisation WHMCS, le client reçoit donc le lien habituel…
• Contacter un client et agir sur son compte L’écran d’un client comporte en haut des boutons appel, SMS et e-mail, ainsi qu’un bouton WHMCS qui ouvre sa fiche complète dans l’espace d’administration. Les trois premiers sont des liens vers l’appareil : ils passent la main au composeur du téléphone, à l’application de messages…
• Contrôler ce que les clients peuvent faire Vous contrôlez ce que les clients peuvent voir et faire dans l’application à deux niveaux. Compte, Autorisations de l’application client définit les valeurs par défaut dont hérite chaque client : pour chaque élément, comme payer des factures, ouvrir des tickets ou ouvrir cPanel, un interrupteur décide si…
• Inviter les clients sur l’application Vous pouvez envoyer aux clients un e-mail avec un lien vers l’application et des instructions pour l’ajouter à leur écran d’accueil ; ils se connectent avec le compte qu’ils ont déjà. Envoyez-le à un client depuis son écran avec le bouton Inviter, ou à…
• Ouvrir un client Toucher un client n’importe où dans l’application ouvre un écran qui regroupe ce qu’il a, ce qu’il doit et ce qu’il attend : services avec leur statut, domaines avec le nombre de jours avant expiration, factures avec les impayées en premier, et tous les tickets ouverts.…
• Exception pour un client L’écran d’un client comporte Autorisations de l’application, où les valeurs par défaut peuvent être modifiées pour ce client uniquement. Chaque autorisation propose trois choix : Par défaut suit le réglage global, Activé la rend disponible pour ce client quelle que soit la valeur par défaut, et Désactivé la retire…
• Publier un incident réseau Un service sur un serveur cPanel affiche les outils cPanel sous Utilisation une fois le compte actif, ainsi qu’un bouton Ouvrir cPanel. Choisir un outil connecte le client et, lorsque le serveur le permet, l’amène directement sur l’outil…
• Lire le tableau de bord Le tableau de bord a trois pages : revenus, commandes et assistance. Balayez de l’une à l’autre, ou touchez les noms au-dessus, ce qui est le chemin le plus rapide vers la troisième. Les revenus comptent l’argent réellement encaissé, ce qui n’est pas la même chose que l’argent facturé :…
• Activité récente L’activité récente, accessible depuis le tableau de bord, est un fil unique de ce qui vient de se passer dans l’entreprise : nouvelles commandes, paiements reçus, tickets ouverts et demandes d’annulation, du plus récent au plus ancien, sur le dernier mois. Les compteurs du tableau de bord vous indiquent combien…
• Enregistrer un paiement reçu Pour l’argent arrivé en dehors de l’application : un virement bancaire, des espèces, un chèque. L’application transmet le paiement à WHMCS via son propre appel AddInvoicePayment plutôt que d’écrire elle-même dans le grand livre, c’est donc WHMCS qui décide si la facture est désormais…
• Réponses enregistrées sur un téléphone Les réponses prédéfinies déjà configurées dans WHMCS sous Support apparaissent dans l’application, regroupées par catégorie, et en toucher une l’ajoute à ce qui se trouve déjà dans la zone de réponse au lieu de le remplacer. C’est la fonctionnalité qui décide…
• Rester connecté La connexion de l’équipe comporte une case Rester connecté sur cet appareil. Laissez-la cochée et la session persiste d’une visite à l’autre, comme d’habitude. Décochez-la et la session n’est conservée que jusqu’à la fermeture complète de l’application, ce qui convient à un…
• Éviter qu’un paiement soit saisi deux fois Indiquez la référence bancaire ou le numéro de reçu dans le champ Référence. L’application refuse un second paiement portant une référence déjà enregistrée pour cette facture, ce qui vous sauve lorsqu’un téléphone perd le réseau en pleine validation et que vous appuyez à nouveau.…
• Le champ de recherche Le tableau de bord comporte un champ de recherche qui parcourt à la fois les clients, les factures, les tickets et les domaines, pour retrouver un client au téléphone sans savoir dans quelle liste il se trouve. Tapez un nom, une société, un e-mail ou un numéro de téléphone…
• Trier un ticket Un ticket ouvert depuis la file affiche un panneau Tri pour l’équipe, sous son statut. De là, son statut, sa priorité, son département et le membre de l’équipe auquel il est attribué peuvent chacun être modifiés, et chaque changement prend effet dès qu’il…
• Traiter une commande Toucher une commande en attente l’ouvre avec les mêmes actions que l’application officielle, à une exception près : accepter, annuler, annuler et rembourser, marquer comme fraude, et remettre en attente. Chacune passe par l’API de commandes WHMCS documentée, elle fait donc exactement…

Hub d’assistance 4

• Ouvrir le hub depuis les Paramètres L’équipe accède au hub depuis Paramètres sur l’écran Vous, où Ouvrir Keen2Support vous connecte à votre propre support avec votre nom et votre e-mail transmis, pour qu’on ne vous les redemande pas. C’est un lien plutôt…
• Le flux d’aide lu par le hub Le hub ne reçoit pas l’aide de ce module ; il va la chercher. Une fois par heure, il lit un flux servi par ce module et met les articles en cache, pour qu’un agent d’assistance qui traite un ticket puisse les rechercher et coller une réponse…
• Ce que fait la connexion à Keen2Support Keen2Support est votre propre support distinct, chez les créateurs de cette application. La connexion enregistre cette application auprès du hub à l’aide d’une clé produit obtenue là-bas, et l’application reçoit un jeton de site qu’elle utilise à chaque échange ultérieur…
• Ce que la télémétrie envoie, et ce qu’elle n’envoie pas La télémétrie est désactivée tant que vous ne l’activez pas. Une fois activée, les événements que cette application enregistre déjà dans son propre journal d’activité sont reproduits sur le hub : par exemple une connexion, un paiement enregistré, un push envoyé. Avant que quoi que ce soit ne quitte le…

Outils 2

• Vérifier que le serveur peut envoyer des notifications Exécutez « php modules/addons/whmcspwa/tools/selftest.php » sur le serveur. Il signe un jeton, signe une requête VAPID, puis chiffre et déchiffre une vraie charge utile push, sans toucher à votre base de données. Dix-huit vérifications doivent réussir. Si celles liées au push échouent, il manque au serveur le…
• Numéros de version et mises à niveau La version dans version.php est la seule vraie réponse ; l’écran Vue d’ensemble, l’API et l’application la lisent toutes là. Trois fichiers chargés directement par le navigateur en portent une copie pour que leur cache soit vidé lors d’une mise à niveau. « php tools/version.php –check »…

Votre compte 8

• Modifier un réglage de domaine L’écran d’un domaine comporte une section Réglages avec trois interrupteurs que vous pouvez modifier vous-même : renouvellement automatique, confidentialité WHOIS et verrou de transfert. Chacun affiche son état actuel et bascule d’un appui, directement sur votre compte chez l’hébergeur. Le renouvellement automatique activé…
• Changer votre mot de passe Compte, Changer le mot de passe vous demande votre mot de passe actuel, puis un nouveau. Le mot de passe actuel est vérifié en premier, pour que quelqu’un qui a pris un téléphone déverrouillé ne puisse pas le changer discrètement. Le nouveau mot de passe doit comporter au moins huit…
• Modifier vos coordonnées Compte, Vos coordonnées, Modifier vos coordonnées vous permet de changer vos propres informations de contact : nom, société, e-mail, téléphone et adresse. L’enregistrement écrit directement dans votre compte chez l’hébergeur, comme une modification sur son site web, donc les factures et…
• Mot de passe oublié Sur l’écran de connexion, Mot de passe oublié prend une adresse e-mail et demande à l’hébergeur d’y envoyer un lien de réinitialisation. Le lien et la page de réinitialisation sont ceux du système de l’hébergeur, exactement comme sur le site web, donc l’application…
• Identifiant oublié Les clients se connectent avec leur adresse e-mail, il n’y a donc pas d’identifiant distinct à oublier. Identifiant oublié sur l’écran de connexion l’explique et, si l’e-mail saisi correspond à un compte, y envoie un court rappel. Comme pour…
• Tout payer en une fois Lorsque plusieurs factures sont en attente, l’écran d’accueil propose un seul bouton Tout payer affichant le total cumulé, avec un lien pour voir les factures une par une. Tout payer ouvre la page de paiement groupé de l’hébergeur, qui règle toutes les factures impayées…
• Appareils connectés Compte, Appareils connectés liste tous les endroits où votre compte est actuellement connecté, avec l’appareil, son adresse et sa dernière utilisation, et signale celui que vous utilisez. Déconnecter un appareil que vous ne reconnaissez pas met fin à sa session…
• Vos notifications Lorsque les notifications sont activées et que vous les avez autorisées sur un appareil, ce dont vous êtes informé — une nouvelle facture, un paiement effectué, une réponse à un ticket — est aussi conservé dans l’application sous…