Aller au contenu principal

API Branded Call et Secure Branding

  • Mise à jour

Avec l'API Branded Call, vous pouvez pré-autoriser vos appels sortants avant qu'ils n'atteignent le réseau. Secure Branding est la fonctionnalité qui utilise cette pré-autorisation : une fois activée sur un numéro de téléphone, les appels provenant de ce numéro sont vérifiés par rapport à vos données de pré-autorisation, et tout appel qui ne correspond pas perd son authentification avant d'atteindre le destinataire. Ces deux éléments sont traités ensemble ici, car Secure Branding dépend de la mise en place de l'intégration API : activer l'un sans l'autre modifie ce qui se passe lors d'un appel, ce qui explique l'importance de l'ordre dans lequel vous les configurez.

Accès rapide :

Pourquoi ne vois-je pas les contrôles Secure Branding et API ?

Si l'API Branded Call et Secure Branding ne sont pas encore activées, vous ne verrez pas les contrôles et les analyses mentionnés ci-dessous. Si vous souhaitez activer ces fonctionnalités, veuillez contacter votre représentant de compte.

Clés API

Pour générer et gérer vos clés API, accédez à la page des clés API dans la section Branded Call.

Pour générer une clé, cliquez sur le bouton « Générer une clé API ». Vous pouvez créer au maximum une clé pour un environnement de production et une pour des fins de test. Sélectionnez votre type de clé, saisissez un nom de clé et générez votre clé.

Une clé sera automatiquement générée et les détails s'afficheront dans le tableau des clés. Les clés API Branded Call comprennent un ID API et un « secret » API qui peut être révélé en cliquant sur l'icône en forme d'œil. Pour supprimer une clé, cliquez sur l'icône de menu contextuel (trois points) à droite.

Un lien permet également d'ouvrir et de consulter la documentation technique de l'API Branded Call.

Qui envoie l'appel de pré-autorisation. C'est le système de votre chaîne d'appels qui gère la connexion technique avec Hiya, qu'il s'agisse de votre propre outil de numérotation ou système téléphonique, ou d'un partenaire agissant en votre nom, comme une plateforme de centre de contact ou un fournisseur de communications. Il n'est pas nécessaire que cet envoi provienne du même système qui passe l'appel, et cela n'implique pas du tout votre opérateur : la pré-autorisation parvient à Hiya via Internet, séparément de l'appel lui-même, et doit simplement arriver avant que l'appel n'atteigne le réseau de destination. Si vous vous connectez à Hiya par l'intermédiaire d'un partenaire, confirmez avec lui lequel de ses systèmes est chargé de l'envoyer.

Fonctionnement de Secure Branding

Secure Branding utilise un message court, une annonce, envoyé à Hiya juste avant qu'un appel n'ait lieu, séparément de l'appel lui-même. Voici la séquence :

  1. Annoncer. Votre système (ou celui de votre partenaire, en votre nom) indique à Hiya lequel de vos numéros est sur le point d'appeler quel numéro de destination.
  2. Enregistrer. Hiya conserve cette information sous forme d'enregistrement temporaire pendant une courte durée.
  3. Passer l'appel. L'appel part normalement, via votre opérateur habituel : l'annonce et l'appel circulent de manière totalement séparée et doivent simplement arriver au même endroit, côté destinataire, dans ce court délai.
  4. Vérifier. Lorsque l'appel atteint le réseau mobile destinataire, ce réseau demande à Hiya s'il dispose d'un enregistrement correspondant et non expiré pour cette paire exacte de numéros.
  5. Afficher. S'il y a correspondance, Hiya renvoie votre authentification approuvée et l'appel s'affiche normalement. S'il n'y a pas de correspondance — parce que rien n'a été annoncé, que les numéros ne correspondent pas, ou que l'enregistrement a déjà expiré — l'appel atteint le destinataire sans votre authentification.

C'est pourquoi Secure Branding dépend de la réalisation de votre annonce avant l'appel, et pourquoi il s'agit d'un contrôle anti-fraude plutôt que d'une fonctionnalité d'affichage en soi : un appel qui n'a jamais été annoncé ne peut tout simplement pas être mis en correspondance, ce qui est précisément l'objectif.

Pourquoi cela ne fonctionne pas de manière identique sur tous les réseaux. Même lorsque l'annonce fonctionne correctement, deux facteurs côté opérateur déterminent si l'authentification atteint effectivement le destinataire :

  • VoLTE. Les informations d'authentification ne sont pas transmises sur une connexion 2G. Sur certains opérateurs, la VoLTE (voix sur LTE) doit également être activée pour le contrat mobile spécifique du destinataire par son opérateur : disposer d'un téléphone compatible VoLTE n'implique pas automatiquement que cette fonction soit activée. Si l'appareil ou la connexion du destinataire bascule en 2G, ou si la VoLTE n'est pas provisionnée sur cette ligne, l'appel affichera généralement le numéro brut, sans authentification, même si tout a bien fonctionné de votre côté.
  • Alignement des champs d'identifiant d'appelant (PAI et FROM). Chaque appel transporte deux champs techniques d'identifiant d'appelant censés correspondre. Sur certains opérateurs, un tronc ou un fournisseur de routage situé plus loin dans la chaîne d'appel peut faire différer ces deux champs : cela se produit côté réseau, et non du fait de votre configuration. Lorsque cela se produit, l'authentification peut échouer silencieusement sur cet opérateur spécifique, même si votre annonce et votre configuration sont correctes. Cela ne se produit pas sur tous les réseaux ; il vaut donc la peine de l'exclure plutôt que de le présumer.

Quand Secure Branding peut-il être requis

Certains opérateurs peuvent exiger Secure Branding avant que l'authentification ne s'affiche pour les appelants des services financiers et des administrations publiques. Les exigences et la disponibilité peuvent varier selon l'opérateur et le marché. Contactez votre représentant de compte pour confirmer ce qui s'applique à vos appels.

Si Secure Branding est requis et disponible pour vos appels, la configuration comprend généralement les étapes suivantes :

  1. Hiya active Secure Branding sur votre compte et vous délivre vos identifiants API.
  2. Votre équipe technique intègre l'API Secure Branding à votre outil de numérotation ou système d'appel.
  3. Une fois que vous avez confirmé le bon fonctionnement de l'intégration, Hiya peut activer la diffusion sur un réseau compatible.

Si Secure Branding est activé avant que votre intégration ne fonctionne, vos appels peuvent perdre leur authentification sur plusieurs réseaux. Consultez la section suivante avant de l'activer.

Avant d'activer Secure Branding

Secure Branding et la pré-autorisation de l'API Branded Call sont conçus pour être activés ensemble, et une fois que vous activez Secure Branding pour un numéro, chaque appel provenant de ce numéro doit être annoncé, et pas seulement les appels qui vous préoccupent particulièrement.

Si vous activez Secure Branding pour un numéro avant que votre intégration de pré-autorisation n'envoie correctement les annonces, les appels provenant de ce numéro perdent immédiatement leur authentification — discrètement, et sur tous les réseaux, pas seulement celui que vous cherchiez à protéger. Cela peut ressembler exactement à une attaque ou à une défaillance de la plateforme, alors que la cause réelle est que l'intégration n'est pas encore en production.

Si cela vous arrive : désactivez Secure Branding pour le ou les numéros concernés. Cela rétablit immédiatement l'authentification standard. Une fois que votre intégration d'annonce est testée et confirmée fonctionnelle — par exemple, en envoyant une annonce de test et en passant un appel réel pour vérifier son affichage — vous pouvez réactiver Secure Branding. Cette opération ne fait rien perdre et constitue le moyen le plus rapide de rétablir une authentification normale pendant que vous terminez vos tests.

Contrôles Secure Branding

Lorsque Secure Branding est activé pour votre compte, vous pouvez gérer les numéros de téléphone pour Secure Branding sous l'onglet Secure Branding de la liste des numéros de téléphone Branded Call. Vous pouvez également gérer les paramètres liés à Secure Branding pour des numéros de téléphone individuels sur leur page de détails, en cliquant sur le bouton « MODIFIER L'AFFICHAGE ET LES PARAMÈTRES ».

Modifier les paramètres pour tous vos numéros

  • En utilisant le bouton « Activer pour tous les numéros », Secure Branding sera activé pour chaque numéro de téléphone Branded Call de votre compte.
  • En utilisant le bouton « Désactiver pour tous les numéros », Secure Branding sera désactivé pour chaque numéro de téléphone Branded Call de votre compte.

Modifier les paramètres pour des numéros de téléphone individuels

Pour gérer la pré-authentification Secure Branding pour des numéros de téléphone Branded Call individuels, accédez à la section « Mettre à jour Secure Branding pour des numéros de téléphone individuels », recherchez et sélectionnez un ou plusieurs numéros de téléphone que vous souhaitez modifier, puis cliquez sur « Activer les éléments sélectionnés » ou « Désactiver les éléments sélectionnés ».

Analyse de la protection contre l'usurpation

Vous pouvez consulter l'analyse de la protection contre l'usurpation pour les appels initiés par vos numéros de téléphone Branded Call. Si Secure Branding est disponible pour votre compte, l'onglet Secure Branding s'affichera lorsque vous cliquerez sur Performance des appels dans la section Branded Call du menu de navigation à gauche.

La première section présente l'utilisation de Secure Branding, c'est-à-dire le nombre de numéros de téléphone pour lesquels Secure Branding est activé.

La deuxième section concerne les appels usurpés ou non autorisés ; elle indique le pourcentage d'appels sortants qui n'étaient pas autorisés. Vous pouvez ajuster la période d'affichage des analyses en cliquant sur le sélecteur de dates situé sous le titre de la section. Vous pouvez consulter les performances semaine par semaine, mois par mois ou jour par jour.

La dernière section affiche une liste des numéros de téléphone ayant signalé des appels usurpés ainsi que leurs taux d'usurpation sur une période donnée. Vous pouvez sélectionner une période parmi trois options : les sept derniers jours, les trente derniers jours ou les trois derniers mois.