Passer au contenu principal

​
Vue d’ensemble

L’intégration Salesforce synchronise vos données commerciales entre Qwoty et Salesforce. Une fois Salesforce connecté, la configuration de l’intégration démarre automatiquement. Aucun workflow n’est à configurer manuellement.
Qwoty prépare automatiquement le flux de synchronisation une fois la connexion Salesforce autorisée.

​
Synchronisation des données

Un client Qwoty est synchronisé avec un Account Salesforce.Le contact principal du client est synchronisé avec un Contact Salesforce.
Un projet (devis) Qwoty est associé à une Opportunity Salesforce.Quand le projet change dans Qwoty, l’opportunité correspondante est mise à jour via une opération PATCH.
Chaque ligne de devis Qwoty crée un OpportunityLineItem Salesforce.Chaque phase associée à une ligne crée un OpportunityLineItemSchedule.
Quand un devis est accepté, Qwoty crée les enregistrements Salesforce Order et OrderItem correspondants.
Un produit Qwoty est synchronisé avec les enregistrements Salesforce Product2 et PricebookEntry.La synchronisation utilise une opération UPSERT :
  • Les enregistrements existants sont mis à jour.
  • Les enregistrements manquants sont créés.

​
Avant de vous connecter

Vérifiez que :
  • Vous avez accès aux paramètres de votre workspace Qwoty.
  • Vous disposez des droits System Administrator dans l’organisation Salesforce cible (nécessaires pour installer le package Qwoty et finaliser la connexion).
  • Votre utilisateur Salesforce a accès aux objets utilisés par l’intégration.
  • Les produits à synchroniser contiennent les informations de prix requises.
Des permissions Salesforce manquantes peuvent empêcher la création ou la mise à jour de certains enregistrements.

​
Connecter Salesforce

1

Ouvrir les paramètres des intégrations

Dans Qwoty, ouvrez les paramètres de votre workspace et allez dans Intégrations.
2

Sélectionner Salesforce

Repérez Salesforce dans la liste des intégrations CRM disponibles et lancez la connexion.
3

Installer le package Qwoty

La fenêtre d’installation propose deux liens : Installer sur une org de production ou Installer sur une sandbox. Ouvrez celui qui correspond à votre organisation Salesforce et installez-y le package Qwoty. Le package doit être installé avant la connexion.
4

Autoriser Qwoty

De retour dans Qwoty, cliquez sur Connecter mon org Salesforce, puis connectez-vous à Salesforce et approuvez l’accès demandé.
5

Finaliser la connexion

Revenez dans Qwoty après l’autorisation.La configuration de l’intégration démarre automatiquement. Vous n’avez pas besoin de configurer ni d’activer un workflow de synchronisation distinct.

​
Comportement de la synchronisation

Les enregistrements qui n’existent pas encore dans Salesforce sont créés lorsque l’événement de synchronisation correspondant se produit.Cela s’applique aux objets pris en charge qui utilisent CREATE ou UPSERT.
Les opportunités Salesforce existantes sont mises à jour quand les projets Qwoty associés changent.Les enregistrements de produits et de prix peuvent aussi être mis à jour via l’opération UPSERT.
Une commande est créée dans Salesforce quand le devis associé est accepté dans Qwoty.La synchronisation crée à la fois l’Order Salesforce et les enregistrements OrderItem associés.
Qwoty préserve les relations logiques entre les enregistrements synchronisés.Par exemple :
  • Un contact principal est lié au compte de son client.
  • Une ligne d’opportunité est liée à son opportunité.
  • Un échéancier de ligne est lié à sa ligne d’opportunité.
  • Une ligne de commande est liée à sa commande.

​
Correspondance des objets

​
Permissions Salesforce

L’utilisateur Salesforce qui autorise la connexion doit avoir accès aux objets nécessaires à l’intégration.
L’intégration a besoin d’accéder à :
  • Account
  • Contact
  • Opportunity
  • OpportunityLineItem
  • OpportunityLineItemSchedule
Pour synchroniser les devis acceptés, l’intégration a besoin d’accéder à :
  • Order
  • OrderItem
Pour synchroniser les produits et les prix, l’intégration a besoin d’accéder à :
  • Product2
  • PricebookEntry

​
Déconnecter Salesforce

Pour arrêter les synchronisations futures, ouvrez l’intégration Salesforce depuis les paramètres de votre workspace Qwoty et déconnectez-la.
La déconnexion de Salesforce arrête les synchronisations futures. Elle ne supprime pas automatiquement les enregistrements créés auparavant dans Salesforce.

​
Dépannage

Vérifiez que :
  • Vous vous connectez à la bonne organisation Salesforce.
  • Votre utilisateur Salesforce est actif.
  • Votre utilisateur est autorisé à approuver des applications connectées.
  • Votre navigateur ne bloque pas la fenêtre d’autorisation.
Vérifiez que le projet Qwoty est bien associé à une opportunité Salesforce.Vérifiez aussi que l’utilisateur Salesforce utilisé pour la connexion a le droit de mettre à jour l’objet Opportunity et les champs concernés.
Vérifiez que :
  • L’opportunité correspondante existe.
  • Le produit est disponible dans Salesforce.
  • Un PricebookEntry valide existe.
  • L’utilisateur Salesforce connecté peut créer des enregistrements OpportunityLineItem.
Vérifiez que la ligne d’opportunité associée a bien été créée.Une phase ne peut être synchronisée qu’une fois son OpportunityLineItem parent disponible.
Vérifiez que :
  • Le devis a bien atteint le statut accepté.
  • Le compte et l’opportunité Salesforce associés sont disponibles.
  • Les commandes (Orders) sont activées dans l’organisation Salesforce.
  • L’utilisateur connecté peut créer des enregistrements Order et OrderItem.
Vérifiez que le produit contient les informations requises et que l’utilisateur connecté peut créer ou mettre à jour des enregistrements Product2 et PricebookEntry.

​
Besoin d’aide ?

Si l’intégration reste indisponible après vérification de la connexion et des permissions, contactez le support Qwoty en indiquant :
  • La fiche Qwoty concernée.
  • L’enregistrement Salesforce correspondant, s’il existe.
  • L’heure approximative de la tentative de synchronisation.
  • Une description du résultat attendu.
Dernière modification le 27 octobre 2026