Obtention du taux de transfert d'un Agent vers un humain

Obtenez, sur une plage de temps donnée, le nombre de conversations d'un Agent, le nombre de conversations transférées à un humain et le taux de transfert vers un humain, avec la même méthodologie que le tableau de bord « Agent Insights → Taux de transfert vers un humain ».

Remarque : il est possible de consulter les données sur un maximum de 92 jours ; seules les chaînes de l'espace de développement sont comptées, voir la section « Méthodologie statistique » ci-dessous pour la portée de la statistique.

Méthode de requête

GET

Adresse d'appel

https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/human-handoff

Authentification de l'appel

Utilisez l'authentification Basic avec le DevKey / DevSecret au niveau du compte : Authorization: Basic ${BASIC_TOKEN}, où ${BASIC_TOKEN} est l'encodage Base64 de DevKey:DevSecret.

• Le compte appelé doit être membre de l'organisation correspondant à org_id et disposer de l'autorisation « Voir l'utilisation » (par défaut accordée au propriétaire et à l'administrateur de l'organisation), et doit pouvoir consulter cet Agent : le créateur de l'Agent, le propriétaire de l'organisation, ou un membre ayant reçu les permissions sur cet Agent (ou sur tous les Agents).
• Veuillez appeler l'adresse du centre de données où se trouve l'organisation. ${endpoint} correspond à region renvoyé par la liste des organisations (SG → sg, TH → th, JP → jp). Lorsqu'on appelle un autre centre de données, le message « N'est pas membre de cette organisation » sera renvoyé.

Fréquence des appels

• Chaque clé de développeur peut appeler cette API jusqu'à 60 fois par minute.
• Chaque appel compte également dans le quota « API statistiques » de l'organisation par minute, partagé avec les appels d'API statistiques utilisant la clé Agent.
• Les résultats des requêtes sont mis en cache pendant 10 minutes, il est recommandé d'effectuer un appel par heure.

Requête

Exemple de requête

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/org/agent/stat/human-handoff?org_id=${org_id}&agent_id=${agent_id}&start_time=1788192000000&end_time=1790784000000' \
  -H 'Authorization: Basic ${BASIC_TOKEN}'

                    

En-tête de la requête

Paramètres de la requête

Réponse

Exemple de réponse

                      
                      {
    "code": 0,
    "message": "OK",
    "data": {
        "agent_id": "65f0c2a1b4e8d93a1c7e5b21",
        "timezone": "+08:00",
        "range_start_date": "2026-09-01",
        "range_end_date": "2026-09-29",
        "data_until": 1790665200000,
        "conversation_count": 1200,
        "handoff_conversation_count": 96,
        "handoff_rate": 0.0800
    }
}

                    

Réponse réussie

Réponse échouée

Codes d'erreur

Le code HTTP correspond aux trois premiers chiffres du code d'erreur, par exemple 40000 correspond à 400, 40100 correspond à 401, 403132 correspond à 403.

Méthodologie statistique

• Nombre de sessions : nombre de sessions ayant eu au moins une conversation par jour, additionné quotidiennement ; les conversations qui se prolongent sur plusieurs jours sont comptées chaque jour.
• Nombre de sessions transférées à un humain : nombre de sessions transférées à un agent humain.
• Périmètre statistique : ne comptabilise que les canaux de l’espace développeur, y compris API, page de partage, intégration sur site web, composant popup, LiveDesk et tous les canaux de messagerie instantanée et téléphonie ; ne comprend pas l’utilisation de cet Agent après sa publication dans l’espace de travail.
• Fréquence de mise à jour : les dates des statistiques quotidiennes terminées récupèrent les statistiques quotidiennes ; calcul en temps réel le jour même. Les statistiques quotidiennes sont générées par la tâche statistique après minuit dans le fuseau horaire de l’organisation ; avant la génération, la veille est également calculée en temps réel, de sorte qu’après minuit, « hier » n’est pas à 0.
• Méthodologie des données en temps réel : comptabilisé selon l’heure du dernier échange de la session, les conversations prolongées sur plusieurs jours ne sont comptées qu’une seule fois dans la partie en temps réel (comptée le jour du dernier échange), ce qui peut légèrement différer des statistiques quotidiennes cumulatives.