Services web (API)

À propos

La technologie des services Web offre un moyen rapide et efficace d'échanger des informations entre clients, fournisseurs, partenaires commerciaux et leurs différentes plates-formes. 

Ainsi, les services Web de Dialog Insight vous permettent d'envoyer directement les données de vos systèmes dans Dialog Insight, et également d'en recevoir. Par l'utilisation de protocoles et standards XML et HTTP pour transférer les données, les services Web sont compatibles avec de nombreux autres environnements de développement, et donc indépendants des plates-formes. 

Les principaux avantages de l'utilisation d'un service Web :

• permet aux applications clientes d'accéder aux services de manière automatique;

• utilise des langages et protocoles indépendants des plates-formes, ce qui assure la compatibilité entre les services ;

• utilise des normes standardisées du Web, ce qui permet une interaction facile entre les clients et favorise l'interopérabilité.

Lorsque vous utilisez Dialog Insight comme application de marketing électronique, le recours aux services Web facilite l'échange des données entre vos diverses plateformes.

Voici quelques exemples d'utilisation :

• Toutes les informations de vos clients sont gérées par un CRM, mais vous voulez transférer certaines de ces données dans Dialog Insight afin de leur envoyer des messages électroniques et en analyser les résultats. Vous pourriez par exemple programmer un appel de service Web pour créer et modifier ces contacts en temps réel.
  Voir les méthodes Contacts.Get et Contacts.Merge
• Les informations sur vos contacts sont gérées par une ou plusieurs applications autres que Dialog Insight et vous voulez synchroniser ces données dans Dialog Insight afin de pouvoir cibler vos contacts en fonction des plus récentes données.
  Voir les méthodes Contacts.Get et Contacts.Merge
• Vous voulez vous assurer de supprimer de Dialog Insight les contacts qui ont été inscrits sur votre liste noire.
  Voir la méthode KillFile.CheckExists
• Vous voulez importer dans Dialog Insight les produits achetés sur votre site par vos clients. Les produits en question seront enregistrés dans une table relationnelle de Dialog Insight. Vous pourrez alors envoyer des courriels de suivi d'achat à ces contacts.
  Voir la méthode RelationalTables.Get
• Vous voulez envoyer un rappel de rendez-vous par SMS aux personnes qui ont un rendez-vous dans 48 heures. Voir la méthode SMSSendings.SendText.
• Une fois par jour, vous voulez vérifier les clients nouvellement ajoutés et lancer dans Dialog Insight un scénario automatisé de bienvenue.
  Voir la méthode Scenario.LaunchSingle
• Vous voulez faire un envoi marketing à grande échelle, par exemple à 100, 100 0000 ou même 1 million de contacts par services Web.
  Voir la méthode Sendings.SendBatch
• Après qu'un client ait fait un achat, vous voulez lui envoyer un courriel de remerciement. Voir Sendings.SendSingle2

La liste de tous les services Web disponibles, de même que la description de ces services et des méthodes correspondantes, sont présentées ici :
https://app.dialoginsight.com/webservices

Comment faire

Les services Web de Dialog Insight vous permettent d'envoyer directement les données de vos systèmes dans Dialog Insight, et également d'en recevoir. Par l'utilisation de protocoles et standards XML et HTTP pour transférer les données, les services Web sont compatibles avec de nombreux autres environnements de développement, et donc indépendants des plates-formes.

Pré-requis	Avoir accès au module Services Web Avoir la permission de configurer des clés d’accès La configuration d’une clé d’accès vous permettra d’initier la communication avec le système Dialog Insight pour vos appels de services.
Chemin d'accès	Gestion du compte > Utilisateurs > Services Web

Créer les clés d'accès

1. Dans le menu de gauche, sous Utilisateurs, sélectionnez Services Web.
2. Dans la liste des clés d'accès aux services web, cliquez sur Créer une clé.
3. Saisissez le nom de la clé et le courriel associés à l’utilisation.
   Ces informations serviront à communiquer avec vous si un problème survient.
4. Dans le champ Liste d’accès IP, entrez les adresses de réseau et IP à partir desquelles la clé sera utilisée.

   Lorsqu'on configure les modules d'une compagnie et qu'on active l'accès aux services Web, il faut préciser les adresses IP ayant le droit d'accéder aux services en question. Les informations permettant l'accès aux services Web (adresse HTTP du service, identifiant de la compagnie, clé d'authentification) ne sont pas des informations sécurisées, il est donc primordial de définir les adresse IP pouvant effectuer ses appels de service afin de prévenir qu'une personne mal intentionnée puisse modifier votre liste de contacts d'un projet et effectuer des opérations destructrices.

5. Au besoin, entrez une date d’expiration pour limiter la durée d’utilisation de la
   clé d’accès.
6. Cochez l’option Actif et cliquez sur Sauvegarder pour activer la clé configurée.
7. Sous la section Permissions, attribuez des permissions à la clé, en cliquant sur Ajouter.
8. Dans la section Propriétés de la clé figurent le idKey et la Clé. Prenez note
   de ces informations, qui sont requises dans les appels de services Web pour
   définir le paramètre AuthKey.

Documentation des services Web

https://app.dialoginsight.com/WebServices/

Cette documentation offre une description détaillée des services et des méthodes, une interface de tests, ainsi qu'un registre (Logs) des appels de service.

Limites

Les services web ont un volume maximal d'appel par compte. Nous recommandons de garder vos volumes bien en dessous de ces limites sinon vos processus prioritaires seront complètement ignorés.