Guide voice management

L’étape requête permet d’appeler vos WebServices afin de déterminer le cheminement que va faire l’appel.

Par exemple : Si votre SVI demande à votre client de saisir le numéro de sa commande, on a faire une requête vers votre service pour connaître le statut de la commande et selon ce denier, renvoyer l’appel vers la bonne rubrique.

Il va y avoir différents protocoles d’échange d’information :

SOAP :

• Méthode : Méthode de la ressource à appeler (ex: statut_commande)
• Ressource : Adresse WSDL de la ressource SOAP (ex: http://guide.axialys.com/soap.php?wsdl)
• Variables en entrée : Doit être renseignées toutes les données que l’on va vous envoyer (cf les variables pré enregistrées). Les variables doivent être séparées par des “;”.
• Variables en sortie : Cela va être les variables dans lesquelles on va stocker les variables que vous enverrez. Les variables doivent être séparées par des “;”. Attention cela ne peut pas être les variables pré enregistrées.
• Les variables vont être associées dans l’ordre dont vous les aurez saisies.

GET :

• Méthode : N’est pas utilisé
• Ressource : adresse de la page à appeler
• Variable en entrée : les variables doivent être séparées par des ; = Mettre toutes les données que l’on souhaite envoyer au client (cf variables près enregistrées)
• Variable en sortie : 2 possibilités :

• Vous pouvez donner la liste des variables que vous souhaitez qu’Axialys initialise avec les valeurs envoyés par votre Webservice. Si vous définissez deux variables : sur la page retournée il doit seulement avoir deux lignes dans le même ordre que les variables renseignées
• (Méthode a utiliser de préférence) Vous pouvez utiliser la méthode @json qui permet de retourner les données sous la forme d’un objet au format json. Les différents paramètres de cet objet sont accessibles avec les variables sous la forme de la représentation d’une représentation hiérarchique avec des points.
• Par exemple :
  {“dossier”:{“tel”:”33618000000″, “cmd”:”45674154″, “statut”:”envoyée”}, « retour”:”OK”}
  dossier.tel = “33618000000”
  dossier.cmd = “45674154”
  dossier.statut = “envoyée”
  retour = « OK”
  Il suffira de mettre une rubrique “filtrage” la variable statut pour envoyer vers la bonne rubrique selon le statut.

Il faut saisir dans la partie ressource après l’adresse, la partie requête avec l’ensemble des variables en remplaçant la valeur qui “%s” qui sera remplacé par la valeur de la variable. Ex : http://?var1=%s&var2=%s …

POST : Ce protocole reprend la même logique que GET les variables seront envoyées au format POST (non dans l’URL)

La différence entre le POST et le GET : Pour le protocole GET, il faut renseigner les variables au niveau de la ressource, contrairement au POST.
Exemple de page que vous pouvez configurer :

• https://axialys.com/statut_commande?num=%s&e164=%s
• variables : cmd;@e164_caller
• Donc dans l’adresse, il faut définir l’ensemble des variables séparées par “&” et la valeur “%s”. Tous les “%s” seront remplacées par leur valeur.
• Ce qui sera vraiment appelé ensuite sera par exemple : https://axialys.com/statut_commande?num=5456484&e164=33618221822
• si cmd = 5456484 & le numéro de l’appelant est 33618221822

GRAPHQL : GraphQL est un langage de requête côté serveur et un environnement d’exécution pour les interfaces de programmation d’applications (API) visant à fournir aux clients uniquement les données qu’ils demandent, et rien de plus.

• Méthode : Pas utilisé 
• Ressource : Adresse de la page de l’API à appeler. http://api.iadvize.com/graphql)
• En tete : variable (key) et sa valeur séparées par par ‘:’.
• Variables en sortie : Cela va être le type de variable dans lesquelles on va stocker les variables que vous enverrez. Dans ce cas il s’agit de variables JSON. Les variables doivent être séparées par des “;”. Attention cela ne peut pas être les variables pré enregistrées.            
• Corps de la requête : Code de la requete SQL.                                           
• Par Exemple : mutation MyMutation {
  sendWhatsAppOutboundMessage(
  sendWhatsAppOutboundMessageInput: {
  templateName: « test_outbound_message_v1 »
  language: « fr »
  senderId: « 33644646081 »
  recipientId: « {{num}} »
  bodyVariables: [
  { key: « 1 », value: « Lorraine » }
  { key: « 2 », value: « B6574 » }
  { key: « 3 », value: « Paris » }
  ]
  headerVariables: { key: « [ ] », value: « [ ] » }
  campaign: { name: « Test Outbound WA », conversionDelay: 5 }
  }
  ) {
  messageText
  }
  }