Sellsy

Sellsy utilise OAuth, mais nécessite d’abord de créer des identifiants pour votre entreprise : un Client ID et un Client Secret. Après leur saisie dans Persyst, vous serez redirigé vers Sellsy pour autoriser la connexion.

Créer l’accès API dans SellsyCopier le lien de la section

La personne qui réalise cette étape doit pouvoir gérer les accès API de l’entreprise dans Sellsy.

1. Dans Sellsy, ouvrez Réglages → Portail Développeur → API v2.
2. Créez un accès de type Privé, destiné à une connexion avec autorisation utilisateur.
3. Renseignez l’URL de redirection de Persyst. Pour le service hébergé standard :

https://api.persyst.ai/integrations/sellsy/callback

4. Autorisez les scopes utilisés par Persyst. Lecture : companies.read, contacts.read, individuals.read, opportunities.read, phonecalls.read, staffs.read, search.read et activities.read, ainsi que comments.read et custom-fields.read. Pour les comptes personnels, ajoutez les scopes d’écriture CRM : companies.write, contacts.write, individuals.write, opportunities.write, comments.write et custom-fields.write.
5. Copiez immédiatement le Client ID et le Client Secret générés. Sellsy n’affiche le secret qu’une fois.

Pour un déploiement Persyst avec une adresse API différente, faites confirmer son URL de redirection à votre exploitant avant de créer l’accès.

Autoriser la connexion dans PersystCopier le lien de la section

1. Dans Sources de données → Ajouter une source, choisissez Sellsy.
2. Saisissez le Client ID Sellsy et le Client Secret Sellsy du même accès API.
3. Cliquez sur Connecter Sellsy pour ouvrir l’autorisation chez Sellsy.
4. Vérifiez le compte et l’entreprise concernés, puis autorisez l’accès.
5. De retour dans Persyst, attribuez la source et les outils aux bénéficiaires dans Gestion des accès.

Les membres auxquels vous ouvrez la source utilisent les droits accordés dans Persyst. Ne transmettez pas les identifiants API à leurs assistants.

Vérifier et maintenir la connexionCopier le lien de la section

Un membre autorisé peut demander à son assistant de rechercher une entreprise Sellsy connue et de citer sa fiche. Choisissez un exemple qu’il est autorisé à consulter.

Si les droits du compte Sellsy évoluent ou si l’accès API est révoqué, faites reprendre l’autorisation par la personne qui gère cette connexion. Un nouveau Client Secret doit être enregistré dans Persyst avant de retirer l’ancien accès utilisé par l’intégration.

Référence : types d’accès API Sellsy, portail et identifiants.

Autoriser l’enrichissement du CRMCopier le lien de la section

Les outils d’écriture permettent de créer et d’enrichir des sociétés, contacts, particuliers et opportunités, d’ajouter des commentaires de suivi, de renseigner des champs personnalisés et de rattacher un contact à une société.

1. Dans Mes connecteurs → Ajouter un connecteur, choisissez Sellsy.
2. Saisissez le Client ID et le Client Secret de l’accès API V2 privé avec les scopes d’écriture ci-dessus.
3. Autorisez votre propre compte sur l’écran de consentement Sellsy.

Les écritures utilisent exclusivement ce compte personnel, avec ses droits Sellsy et les outils ouverts dans Persyst. Les sources partagées restent en lecture seule, même pour la personne qui les a connectées. Chaque membre qui souhaite écrire connecte donc son propre compte.

Si votre compte personnel était connecté avant l’ajout de ces outils, activez les scopes d’écriture sur l’accès API Sellsy, puis reconnectez ce compte dans Mes connecteurs. Un simple rafraîchissement du jeton ne donne pas de nouveaux droits.

Pour ajouter un compte rendu sans remplacer une note existante, demandez l’ajout d’un commentaire de suivi. Pour modifier des coordonnées, l’assistant doit identifier la fiche puis ne fournir que les champs à mettre à jour.