Aller au contenu principal
API 3CX Télécom Intégration

API BlueRockTEL : exemple d'utilisation avec le Call Flow Designer 3CX

Par Équipe BlueRockTEL

L'API BlueRockTEL

BlueRockTEL expose plusieurs routes API permettant d'interroger votre base clients en temps réel. Ces routes ont été conçues notamment pour s'intégrer avec le Call Flow Designer de 3CX, mais elles s'appliquent à tout système nécessitant une identification client à la volée.

Identification de base par numéro de téléphone

/api/isKnownPhoneNumber

Cette route identifie un appelant à partir de son numéro de téléphone. La recherche s'effectue sur :

  • Le numéro principal du dossier client
  • L'ensemble des numéros de téléphone des contacts associés
  • Les extensions renseignées dans les dossiers clients

La recherche utilise un index pour des résultats quasi-instantanés, même sur une base clients importante.

/api/isKnownCustomerAccount

Utilisée lorsqu'un appelant ne peut pas être identifié par son numéro, mais qu'il fournit son numéro de compte BlueRockTEL. Cette route valide l'existence du compte et retourne les informations associées.

Identification des clients VIP

BlueRockTEL permet de catégoriser vos clients. Les routes suivantes permettent de détecter si un appelant bénéficie du statut VIP :

  • /api/isVipByPhoneNumber — Vérifie le statut VIP via le numéro appelant
  • /api/isVipByCustomerAccount — Vérifie le statut VIP via le numéro de compte

Cela permet, par exemple, de router automatiquement les appels VIP vers une file dédiée ou un technicien référent.

Contrats d'astreinte

Ces routes vérifient si un client dispose d'un contrat d'astreinte actif :

  • /api/hasOnCallDutyContractByPhoneNumber — Via le numéro appelant
  • /api/hasOnCallDutyContractByCustomerAccount — Via le numéro de compte

Le cas d'usage typique : router les appels entrants hors horaires ouvrés vers une astreinte uniquement pour les clients ayant souscrit ce service — sans l'activer pour tous.

Cas d'usage dans le Call Flow Designer 3CX

En combinant ces routes dans un Call Flow Designer, vous pouvez construire des flux d'appels intelligents :

  1. L'appelant compose votre numéro
  2. Le CFD interroge /api/isKnownPhoneNumber — si non identifié, il demande le numéro de compte
  3. Le CFD vérifie /api/isVipByPhoneNumber — si VIP, l'appel est routé vers la file prioritaire
  4. Hors horaires ouvrés, le CFD vérifie /api/hasOnCallDutyContractByPhoneNumber — seuls les clients éligibles atteignent l'astreinte
Retour aux ressources