L'API iAdvize vous offre une intégration profonde et flexible avec d'autres systèmes, en vous permettant de transmettre et de récupérer des données structurées.
L'API ouvre la porte à une automatisation poussée des processus de reporting, d'administration, et d'orchestration des services.
Cette interface programmable est essentielle pour les entreprises cherchant à personnaliser leur utilisation d’iAdvize, permettant une adaptation et une évolution constantes en fonction des besoins spécifiques.
Grâce à cette capacité d'intégration avancée, vous pouvez maximiser l'efficacité de vos opérations et améliorer l'expérience de vos visiteurs.
Pour plus d’informations sur nos APIs, vous pouvez consulter la documentation en ligne sur notre dev platform.
1. Accéder à l’API GraphQL
- Adresse : https://api.iadvize.com/graphql si votre administration est sur ha.iadvize.com, https://api-sd.iadvize.com/graphql si elle est sur sd.iadvize.com.
-
Authentification : un jeton obtenu avec l’e-mail et le mot de passe d’un utilisateur iAdvize, à transmettre dans l’en-tête
Authorization: Bearer. La procédure est détaillée dans la documentation d’authentification. - Droits : les données renvoyées dépendent du rôle de l’utilisateur. Par exemple, pour les conversations clôturées, un administrateur ou un manager obtient les conversations de ses projets (limitées à son groupe s’il appartient à un groupe), un conseiller seulement ses propres conversations.
- Tester vos requêtes : l’explorateur Apollo (https://ha.iadvize.com/apollo ou https://sd.iadvize.com/apollo) utilise votre session : connectez-vous d’abord à votre administration.
Requêtes utiles
-
closedConversations: les conversations clôturées sur une période. -
conversation: le détail d’une conversation à partir de son identifiant. -
conversions: les transactions, filtrables par période, projet ou conversation. -
visitorConversationCustomData: les données personnalisées du visiteur pour une conversation.
2. Exporter vos données sans l’API
- Rapports > Conversations : le bouton Exporter vous envoie par e-mail un fichier CSV pour la période et les filtres en cours. Les messages peuvent être inclus si vous avez la permission Accès à l’export des messages de conversations. Les liens de téléchargement sont valables 7 jours.
- Rapports > Ventes, tableau Top Performances : téléchargement CSV de la vue actuelle ou des 10 000 premières entrées.