Étape 1 : Générer les identifiants de la Pull API
Accédez à https://callanalytics.salestrail.io/integration/apidocs et générez le nom d’utilisateur et le mot de passe en haut de la page. Enregistrez ces identifiants, car le mot de passe ne sera plus affiché par la suite.
Étape 2 : Appeler les API.
Plusieurs endpoints sont disponibles pour récupérer les données de votre organisation.
- /export/calls/byCreated/csv : récupère les données d’appels en fonction de la date et de l’heure de création, au format CSV
- /export/calls/byCreated/json : récupère les données d’appels en fonction de la date et de l’heure de création, au format JSON
- /export/calls/csv : récupère les données d’appels en fonction de la date et de l’heure de début de l’appel, au format CSV
- /export/calls/json : récupère les données d’appels en fonction de la date et de l’heure de début de l’appel, au format JSON
- /export/calls/{callId}/recording : récupère l’enregistrement d’un appel identifié par callId
L’authentification pour ces endpoints utilise le schéma Basic (https://en.wikipedia.org/wiki/Basic_access_authentication) avec le nom d’utilisateur et le mot de passe générés à l’étape 1. Les données renvoyées dépendent des données auxquelles vous êtes autorisé à accéder dans le tableau de bord. Cela signifie qu’en tant que USER, vous ne récupérerez que vos propres données, tandis qu’en tant qu’OWNER, vous récupérerez toutes les données.
Étape 2.1 : Appeler les endpoints -- Les quatre premiers endpoints nécessitent les paramètres de requête HTTP 'from' et 'to' afin de filtrer les résultats sur une période spécifique, en utilisant soit le timestamp de création, soit le timestamp de début de l’appel. Tous les timestamps sont fournis en UTC.
Exemple d’appel avec cURL :
'https://standalone-api.salestrail.io/export/calls/byCreated/json?from=2025-02-01T00%3A00%3A00.000Z&to=2025-03-01T00%3A00%3A00.000Z' Cet appel récupère au format JSON les données des appels créés entre le 2025-02-01 00:00:00.000Z et le 2025-02-28 23:59:59.999Z.
Étape 2.2 : Endpoint d’enregistrement -- Cet endpoint vous permet de récupérer un enregistrement. Pour appeler cet endpoint, vous devez disposer d’un call id provenant des API d’appels.
Exemple d’appel avec cURL :
'https://standalone-api.salestrail.io/export/calls/12345678-1234-1234-1234-123456781234/recording'
Cette API renvoie un code 404 si aucun enregistrement n’est trouvé ou si vous n’avez pas accès à cet enregistrement. En cas de succès, le statut HTTP renvoyé est 302 et l’en-tête Location fournit une URL de stockage blob que vous pouvez utiliser pour télécharger l’enregistrement. En général, cela se fait directement à l’aide de l’option « follow redirects » du client ou de la bibliothèque que vous utilisez (cURL : -L/--location). Vous pouvez également analyser la réponse et exécuter une autre requête.