Guide voice management
LE GUIDE UTILISATEUR DE VOTRE SOLUTION CALL CENTER
API - Resumé d'appel
1 - Généralités
L’API de consultation des données de résumés d’appels permet de récupérer les données générales d’un appel entrant (statut etc… ) mais aussi des données liées à la réitération : Voir les statistiques de réitérations
Cette API est donc toute indiquée pour les données sources des calculs d'indicateurs tel que la Quality Service (QS)
C’est un des KPIs phares suivis en centres de contacts car l’impossibilité ou la difficulté à joindre un service client est générateur d’une forte insatisfaction client.
Il est normalement calculé sur le pourcentage du nombre d'appels décroché par rapport au nombre d'appels total.
2 - Formalisme & swagger
Cette API s’inspire du formalisme REST. Les données sont servies au format JSON.
Vous devez obtenir auprès de votre interlocuteur Axialys vos données d’authentification.
Cliquer ici pour retrouvez les informations de ce WS sur notre swagger
3 - Infos générales
3.1 - Récupération des données de résumé d'appels
| URL | /calls |
|---|---|
|
Méthode(s) |
GET |
Les paramètres suivants sont possibles :
| Nom de la propriété | Exemple | Format | Description | ||||||
| limit | 200 | Nombre entier | Pagination : Limite du nombre de résultats par page désiré | ||||||
| page | 1 | Nombre entier | Pagination : Numéro de page consultée désirée | ||||||
| date_start | 2002-07-01 | Date (yyyy-mm-dd) | Date de début (incluse) de la plage désirée au format Date (yyyy-mm-dd) | ||||||
| date_end | 2022-08-01 | Date (yyyy-mm-dd) | Date de fin (incluse) de la plage désirée format Date (yyyy-mm-dd) | ||||||
| first_group_id | Nombre entier | identifiant du premier groupe ayant été associé à l’appel | |||||||
| first_operator_id | Nombre entier | identifiant du premier opérateur ayant été associé à l’appel | |||||||
| last_group_id | Nombre entier | identifiant du dernier groupe ayant été associé à l’appel | |||||||
| last_operator_id | Nombre entier | identifiant du dernier opérateur ayant été associé à l’appel | |||||||
| with_reiteration | booleen | // savoir si on affiche les données de réitération (aucun filtre restrictif n’est appliqué) | |||||||
| iteration_type | « global », »service », « first_group », « last_groupe » | chaine de charactères | // Filtre multiple avec « OU » qui fonctionne avec filter_iteration_max ( Ex, je veux les appels avec (itération < 6000 pour Service OU itération < 6000 pour last_groupe ). Si non remplis, on applique le filtre en OU sur tous les types | ||||||
| iteration_max | Nombre entier | // facultatif, si on met rien, on affiche tous les appels | |||||||
| order_by | date.desc | chaine de charactères | {date_calll_ASC, date_call_DESC} | ||||||
Attention
Afin d'assurer les meilleures performances possibles, utilisez obligatoirement les paramètres pour définir un périmètre de données précis en fournissant notamment "date_start" et "date-end"
Périmètre de données demandées
Afin d'assurer les meilleures performances possibles, il est fortement conseillé de ne pas demander plus de 20 jours de données glissantes
Données retournées
Dans les données retournées, vous trouverez dans le bloc « data » l’ensemble des données désirées , avec notamment les informations de pagination :
| Nom de la propriété | Exemple | Format | Description |
| limit: | 1000 | Nombre entier | Limite du nombre maximum de transferts retournés par page ( par défaut : 100 ) |
| page: | 1 | Nombre entier | Pagination : numéro de la page de données en cours |
| pages: | 11 | Nombre entier | Pagination : nombre de pages totales de données |
| elements: | 10372 | Nombre entier | Nombre total de détails de communications correspondants aux filtres sélectionnés |
Ainsi qu’un tableau d’objets « calls » qui correspondent aux données des résumés d’appels et avec les filtres et tris :
Nom de la propriété | Exemple | Format | Description |
| id | 4415905 | Nombre entier | Identifiant technique du transfert |
| date | « 2022-08-01T08:35:28 », | Date /heure (yyyy-MM-dd’T’HH:mm:ss) | Date heure Minute secondes de réception par les serveurs Axialys |
| status | « ANSWER » | chaine de charactères | Résultat de l’appel : ( Repondu / Abandonnée / Perdu / SVI ) Rappel : Perdu est un appel non pris et qui a fait sonner un bandeau opérateur pendant au moins 1 seconde |
| caller | « 33688889955 » | chaine de charactères | Numéro de l’appelant |
| service.number | « 33178559966 » | chaine de charactères | Numéro appelé |
| service.reiteration | Bloc d’information sur la réitération du service | ||
| service.reiteration.call_id | 1221 | Nombre entier | id_appel de l’appel suivant de ce même appelant sur le même numéro de service |
| service.reiteration.delay | 25 | Nombre entier | Nombre de secondes entre cet appel et le prochain du même appelant sur le même numéro de service |
| first_operator.id | 11221 | Nombre entier | Identifant de l’opérateur |
| first_operator.name | « Rémy SOLNAIS » | chaine de charactères | Nom de l’opérateur |
| first_operator.email | « [email protected] » | chaine de charactères | Email de l’opérateur |
| first_group.id | 65456 | Nombre entier | Identifiant du groupe |
| first_group.name | « Assurance auto » | chaine de charactères | Nom du groupe |
| first_group.reiteration.call_id | 9954 | Nombre entier | id_appel de l’appel suivant de ce même appelant sur le même premier groupe |
| first_group.reiteration.delay | 64 | Nombre entier | Nombre de secondes entre cet appel et le prochain du même appelant sur le même premier groupe |
| last_operator.id | 11221 | Nombre entier | Identifant de l’opérateur |
| last_operator.name | « Rémy SOLNAIS » | chaine de charactères | Nom de l’opérateur |
| last_operator.email | « [email protected] » | chaine de charactères | Email de l’opérateur |
| last_group.id | 65456 | Nombre entier | Identifiant du groupe |
| last_group.name | « Assurance auto » | chaine de charactères | Nom du groupe |
| last_group.reiteration.call_id | 9954 | Nombre entier | id_appel de l’appel suivant de ce même appelant sur le même dernier groupe |
| last_group.reiteration.delay | 64 | Nombre entier | Nombre de secondes entre cet appel et le prochain du même appelant sur le même dernier groupe |
| reiteration.call_id | 6654 | Nombre entier | id_appel de l’appel suivant de ce même appelant sur ce même client |
| reiteration.delay | 95 | Nombre entier | Nombre de secondes entre cet appel et le prochain du même appelant sur ce même client |
- Table des matières
