URLs weavy

Version minimum	Date de mise à jour
5.5	5 juil. 2024

Fonctionnalité

Pouvoir appeler des pages de Divalto weavy web depuis un logiciel externe via des URLs directes.

Fonctionnement

Recherche par code

Un logiciel externe connaissant le code weavy d'un enregistrement peut rechercher cet élément avec une URL de la forme :

[urlweavy]/page/search?entity=[entite]&key=[codeEntite]

Exemple d'ouverture de la page intervention par son code :
https://weavy.divalto.com/page/search?entity=intervention&key=130000000055

Dans certains cas particuliers, un argument complémentaire tab permet d’accéder à un onglet particulier de la fiche recherchée avec une URL de la forme :

[urlweavy]/page/search?entity=[entite]&key=[codeEntite]&tab=[codeTab]

Recherche par champs

Un logiciel externe connaissant la valeur d’un autre champ que le code peut rechercher cet élément avec une URL de la forme :

[urlweavy]/page/search?entity=[entite]&key=[codeFieldName]&criteria=[fieldName]

Exemple d'ouverture de la page intervention par son numéro :
https://weavy.divalto.com/page/search?entity=intervention&key=013-00055&criteria=interventionNumber

Dans certains cas particuliers, un argument complémentaire tab permet d’accéder à un onglet particulier de la fiche recherchée avec une URL de la forme :

[urlweavy]/page/search?entity=[entite]&key=[codeFieldName]&criteria=[fieldName]&tab=[codeTab]

Si la recherche ne donne aucun résultat, alors l'application ira vers la page principale de l'entité.
Si la recherche donne un résultat, alors l'application accèdera à la fiche de ce résultat.
Si la recherche donne plusieurs résultats, alors l'application accèdera à la page home et indiquera un message d'avertissement à l'utilisateur.

Accès disponibles

Libellé accès	URL
Fiche tiers	[urlweavy]/page/search?entity=thirdparty&key=[code] [urlweavy]/page/search?entity=thirdparty&key=[codeFieldName]&criteria=[fieldName]
Fiche tiers - Liste des interventions	[urlweavy]/page/search?entity=thirdparty&key=[code]&tab=intervention [urlweavy]/page/search?entity=thirdparty&key=[codeFieldName]&criteria=[fieldName]&tab=intervention
Fiche tiers - Liste des équipements	[urlweavy]/page/search?entity=thirdparty&key=[code]&tab=equipment [urlweavy]/page/search?entity=thirdparty&key=[codeFieldName]&criteria=[fieldName]&tab=intervention
Fiche tiers - Liste des contrats	[urlweavy]/page/search?entity=thirdparty&key=[code]&tab=contract [urlweavy]/page/search?entity=thirdparty&key=[codeFieldName]&criteria=[fieldName]&tab=contract
Fiche contrat	[urlweavy]/page/search?entity=contract&key=[code] [urlweavy]/page/search?entity=contract&key=[codeFieldName]&criteria=[fieldName]
Fiche contact	[urlweavy]/page/search?entity=contact&key=[code] [urlweavy]/page/search?entity=contact&key=[codeFieldName]&criteria=[fieldName]
Fiche équipement	[urlweavy]/page/search?entity=equipment&key=[code] [urlweavy]/page/search?entity=equipment&key=[codeFieldName]&criteria=[fieldName]
Fiche adresse	[urlweavy]/page/search?entity=address&key=[code] [urlweavy]/page/search?entity=address&key=[codeFieldName]&criteria=[fieldName]
Fiche site	[urlweavy]/page/search?entity=site&key=[code] [urlweavy]/page/search?entity=site&key=[codeFieldName]&criteria=[fieldName]
Fiche site - Liste des interventions	[urlweavy]/page/search?entity=site&key=[code]&tab=intervention [urlweavy]/page/search?entity=site&key=[codeFieldName]&criteria=[fieldName]&tab=intervention
Fiche site - Liste des équipements	[urlweavy]/page/search?entity=site&key=[code]&tab=equipment [urlweavy]/page/search?entity=site&key=[codeFieldName]&criteria=[fieldName]&tab=equipment
Fiche intervention	[urlweavy]/page/search?entity=intervention&key=[code] [urlweavy]/page/search?entity=intervention&key=[codeFieldName]&criteria=[fieldName]
Fiche demande d'intervention	[urlweavy]/page/search?entity=interventionRequest&key=[code] [urlweavy]/page/search?entity=interventionRequest&key=[codeFieldName]&criteria=[fieldName]
Fiche collaborateur	[urlweavy]/page/search?entity=baseuser&key=[code] [urlweavy]/page/search?entity=baseuser&key=[codeFieldName]&criteria=[fieldName]
Fiche affaire	[urlweavy]/page/search?entity=deal&key=[code] [urlweavy]/page/search?entity=deal&key=[codeFieldName]&criteria=[fieldName]
Fiche opportunité	[urlweavy]/page/search?entity=project&key=[code] [urlweavy]/page/search?entity=project&key=[codeFieldName]&criteria=[fieldName]
Fiche évènement	[urlweavy]/page/search?entity=event&key=[code] [urlweavy]/page/search?entity=event&key=[codeFieldName]&criteria=[fieldName]

Recherche par email

Cette recherche permet d'accéder à une fiche tiers ou une fiche contact correspondant à un email avec une URL de la forme :

[urlweavy]/page/search?email=[monEmail]

S'il y a plusieurs réponses, un écran intermédiaire de sélection apparaîtra.

Recherche par numéro de téléphone

Cette recherche permet d'accéder à une fiche tiers ou une fiche contact correspondant à un numéro de téléphone avec une URL de la forme :
[urlweavy]/page/search?phone=[monNuméro]
S'il y a plusieurs réponses, un écran intermédiaire de sélection apparaîtra.

Cas pratique : Mise en place d’un CTI (Couplage Téléphonie-Informatique) entre Microsoft Teams et Divalto weavy.

Le but ici est de pouvoir ouvrir la fiche du contact appelant dans Divalto weavy lors d'un appel Teams.

Prérequis :
- Définir une stratégie d’appel (Calling policies) dans Teams. Se référer à la documentation Windows pour la mise en place : https://learn.microsoft.com/fr-fr/microsoftteams/teams-calling-policy
  - L’URL weavy à définir sera de la forme : [urlweavy]/page/search?entity=contact&phone={phone}
- Autoriser Teams à ouvrir des applications dans le navigateur : Sous Teams, aller dans les Paramètres -> Appels et cocher cette option

A chaque appel Teams, une fenêtre weavy apparaîtra dans votre navigateur.

Cette fenêtre :

vous permettra si ce numéro existe d'accéder à sa fiche contact . S'il y a plusieurs résultats, un écran intermédiaire de sélection apparaîtra.
vous redirigera vers la liste des clients si aucun résultat n'a été retrouvé.