Configurer le routage intelligent vers le propriétaire du contact HubSpot à l’aide du widget « Acheminer vers (via API) » dans un flux d’appel

Configurez le routage intelligent vers le propriétaire du contact HubSpot sur un numéro de téléphone Aircall partagé afin que les appelants soient efficacement mis en relation avec leur interlocuteur dédié.

Remarque: :
Le tutoriel vidéo peut présenter la version précédente de la section Tester la réponse. Reportez-vous toujours aux étapes écrites de cet article pour obtenir les instructions les plus récentes.

Dans ce guide, vous apprendrez :

• Comment l’utilisation du widget Sonner vers (via API) améliore l’efficacité et l’expérience client

• Comment configurer le routage intelligent vers le propriétaire du contact HubSpot

  • Première étape : créer des champs personnalisés dans HubSpot et générer un jeton Bearer

  • Deuxième étape : configurer le widget Sonner vers (via API) dans l’éditeur de flux

Important: :
Le widget Sonner vers (via API) est disponible uniquement avec le forfait Professional. Pour effectuer une mise à niveau, contactez votre responsable de compte Aircall.

Comment l’utilisation du widget Sonner vers (via API) améliore l’efficacité et l’expérience client

Le routage intelligent sur un numéro de téléphone partagé offre des avantages majeurs en matière d’efficacité, de précision et d’expérience client. En dirigeant intelligemment les appels entrants en fonction des données du CRM, le routage intelligent permet à chaque appelant de joindre rapidement la bonne personne, ce qui réduit les temps d’attente et améliore les taux de résolution dès le premier appel.

Dans un flux d'appel, le widget Sonner vers (via API) d’Aircall permet notamment d’acheminer directement les appelants entrants vers leur propriétaire du contact HubSpot. Cela évite que toute l’équipe soit interrompue par des appels qui ne lui sont pas destinés et qu’il soit nécessaire de mettre les appelants en attente pendant leur transfert vers leur interlocuteur dédié.

Comment configurer le routage intelligent vers le propriétaire du contact HubSpot

Première étape : créer des propriétés personnalisées dans HubSpot et générer un jeton Bearer

Important: :
Cette étape nécessite de connaître les champs personnalisés HubSpot et les applications privées HubSpot.

Commencez dans HubSpot par créer une propriété personnalisée pour stocker l’adresse e-mail du propriétaire du contact.

Étapes

1. Accédez à Propriétés des contacts dans les réglages de HubSpot.

2. Sélectionnez Créer une propriété.

3. Renseignez les détails de la propriété comme suit :

Remarque: :
Configurez la section Règles comme vous le souhaitez, mais veillez à ne pas restreindre les caractères spéciaux, car les adresses e-mail comprennent des caractères tels que @ et .

4. Vous pouvez ensuite créer un workflow HubSpot pour renseigner automatiquement ce champ :

• Inscrivez tous les nouveaux contacts lors de leur création.

• Pour inclure les contacts existants, sélectionnez Oui, inscrire les contacts existants qui répondent actuellement aux critères de déclenchement à l’étape Vérifier & publier de la configuration de votre workflow.

5. Une fois la propriété créée, renseignez-la avec une adresse e-mail. Vous aurez besoin de cette valeur ultérieurement pour tester la validité du chemin dans le widget Sonner vers (via API).

6. Ensuite, générez un jeton Bearer dans votre portail des développeurs HubSpot. Ce jeton authentifiera votre requête API lors de la configuration du widget Sonner vers (via API) dans l’éditeur de flux. Pour obtenir des instructions détaillées, consultez le guide de HubSpot sur les applications privées.

Étape 2 : configurer le widget Sonner vers (via API) dans l’éditeur de flux

Important: Cette section nécessite de connaître l’API REST de HubSpot, JSON et les flux d’appel.

1. Accédez à Tableau de bord Aircall > Numéros, puis ouvrez le numéro dont vous souhaitez configurer le flux d’appel.

   • Il est important de noter que les utilisateurs Aircall auxquels les appels seront acheminés via l’API n’ont pas besoin d’être affectés à la configuration du flux d’appel. S’ils y sont affectés, ils recevront une notification d’appel manqué dans leur liste de tâches s’ils manquent l’appel transféré. En revanche, ils ne recevront pas ces notifications s’ils ne sont pas affectés au numéro.

2. Accédez au numéro de téléphone sur lequel vous souhaitez configurer le widget Sonner vers (via API). Ajoutez le widget Sonner vers (via API) à l’emplacement souhaité dans la configuration de votre flux d’appel afin d’ouvrir l’éditeur du widget.

3. Définissez la méthode d’authentification sur Jeton Bearer, puis cliquez sur Définir les identifiants. Dans le formulaire contextuel des identifiants, collez le jeton Bearer créé à l’étape précédente.

4. Revenez dans l’éditeur du widget et terminez la configuration de la requête :

• URL : https://api.hubapi.com/crm/v3/objects/contacts/search

• Méthode : POST

• Corps :

  Copier

  {
    "properties": [
      "firstname",
      "lastname",
      "company",
      "email",
      "hubspot_owner_id",
      "aircall_contact_owner_email",
      "hs_calculated_phone_number",
      "hs_calculated_mobile_number",
      "hs_searchable_calculated_phone_number",
      "hs_searchable_calculated_mobile_number",
      "last_used_aircall_phone_number"
    ],
    "filterGroups": [
      {
        "filters": [
          {
            "propertyName": "hs_calculated_mobile_number",
            "operator": "EQ",
            "value": "{{callerNumber}}"
          }
        ]
      },
      {
        "filters": [
          {
            "propertyName": "hs_calculated_phone_number",
            "operator": "EQ",
            "value": "{{callerNumber}}"
          }
        ]
      }
    ],
    "sorts": [
      {
        "propertyName": "lastmodifieddate",
        "direction": "DESCENDING"
      }
    ],
    "limit": 10
  }

5. Définissez la configuration de la réponse :

• Type de réponse = Utilisateur (ID ou adresse e-mail)
• Chemin = results[0].properties.aircall_contact_owner_email

6. Exécutez un test dans le champ dédié Tester la réponse :

• Saisissez un numéro de téléphone valide au format international E.164.

• Vérifiez qu’une charge utile JSON est renvoyée.

• Vérifiez que le chemin est valide afin de trouver la valeur utilisée pour transférer ou acheminer l’appel entrant.

• Vérifiez que l’adresse e-mail du contact existant correspond à celle d’un utilisateur existant dans Aircall.

Conseil: Ajustez les paramètres de sonnerie situés directement sous le test en fonction des besoins de votre entreprise.

Vous êtes maintenant prêt à commencer à tester les appels entrants pour le routage intelligent vers le propriétaire du contact HubSpot à l’aide du widget Sonner vers (via API).