Brancher votre Yeastar

Une fois votre Yeastar branché, chaque appel terminé est envoyé à ScanBiz, qui récupère son enregistrement, le transcrit et l'analyse. Le branchement se fait en deux endroits : la page Standard Yeastar de ScanBiz et le portail d'administration de votre Yeastar.

Avant de commencer

• Un compte administrateur ScanBiz, et votre adresse e-mail confirmée.
• Un accès administrateur au portail de votre Yeastar P-Series, avec l'enregistrement des appels activé sur les postes à analyser.
• L'annonce d'enregistrement réglée dans votre Yeastar : chaque correspondant doit savoir que l'appel est enregistré et analysé. ScanBiz ne diffuse pas cette annonce.
• « Webhook Event Push » envoie les événements de tout le standard. Vous ajoutez l'adresse ScanBiz à une liste : n'enlevez aucune adresse déjà présente, un autre outil peut s'en servir. Côté ScanBiz, seuls les postes que vous cochez sont analysés et facturés.

Étapes

Ouvrez Paramètres, section Connexions, puis cliquez sur Connecter à côté de Standard Yeastar. La page compte cinq étapes, à suivre dans l'ordre.

1. Activer l'API sur votre Yeastar, dans son portail : Intégrations › API. Activez l'API, créez un accès — Yeastar affiche alors un Client ID et un Client Secret, le secret n'étant montré qu'une fois — et cochez Webhook Event Push. Cette case doit être cochée dans le portail : rien d'autre ne peut l'activer à votre place.
2. Renseigner l'accès API et les postes à analyser : saisissez Adresse du standard (le nom d'hôte, sans https://), Identifiant API (Client ID), Secret API (Client Secret) et vérifiez le Fuseau horaire du standard — il est prérempli avec celui de votre navigateur, et une erreur ici décale l'heure de tous vos appels. Cochez ensuite les postes à superviser (ou Analyser tous les appels du standard), cochez la case qui confirme l'annonce d'enregistrement, puis cliquez sur Créer la connexion.
3. Déclarer l'adresse ScanBiz dans Yeastar : l'étape affiche maintenant une adresse. Dans Webhook Event Push, ajoutez-la en méthode POST, avec le seul événement Enregistrement d'appel terminé (30012).
4. Coller le secret du webhook : à l'ajout de l'adresse, Yeastar génère un secret. Copiez-le depuis le portail et collez-le dans Secret du webhook, puis enregistrez. Sans lui, ScanBiz refuse les appels reçus : c'est ce secret qui prouve qu'ils viennent bien de votre standard.
5. Passer un premier appel : appelez depuis un poste supervisé, raccrochez, puis revenez sur cette étape. L'appel apparaît en quelques minutes, puis dans vos alertes.

Tant qu'aucun poste n'est coché, les appels arrivent mais ne sont ni analysés ni facturés.

Si ça ne marche pas

L'étape Passer un premier appel affiche un diagnostic sur 7 jours :

• « Aucun appel reçu pour l'instant » : vérifiez dans votre Yeastar que Webhook Event Push est coché, que l'adresse ScanBiz est bien dans la liste en méthode POST, et que l'événement 30012 est sélectionné.
• « … Cochez maintenant les postes à analyser … » : votre standard est branché, il reste à cocher vos postes.
• « … sont arrivés sans leur enregistrement » : activez l'enregistrement des appels sur ces postes dans votre Yeastar.
• « … l'enregistrement de … n'a pas pu être récupéré » : vérifiez que les enregistrements restent accessibles sur votre standard (durée de conservation, espace disque).
• « Votre standard a refusé les identifiants enregistrés » : l'accès API a été supprimé ou régénéré côté Yeastar. Recréez-le, puis remplacez le Client ID et le Client Secret dans l'étape 2.
• « … sont sortis du périmètre analysé » : ces appels venaient de postes non supervisés, ou étaient internes. Écrivez-nous s'ils devaient être analysés.
• « Aucun appel reçu depuis 7 jours » : vérifiez que l'adresse ScanBiz est toujours dans Webhook Event Push.

Bon à savoir

• Tester la connexion interroge votre standard avec les identifiants enregistrés : c'est le seul test possible côté API. La réception des appels, elle, se juge sur les appels reçus.
• L'abonnement est facturé par poste supervisé. Analyser tous les appels du standard inclut aussi les postes internes et les appels de test.
• Les heures affichées suivent le fuseau renseigné à l'étape 2 : si vos appels apparaissent décalés d'une ou deux heures, c'est là qu'il faut regarder.
• Pour déconnecter votre Yeastar, écrivez à l'adresse indiquée en bas de la page.
• Ensuite : Régler une alerte.