# API ERP (SyBox)

Où : Paramètres > Intégrations > API ERP

À quoi ça sert :

Vos propres outils, accessibles sous forme de boutons à côté de chaque discussion. Lorsqu'un agent ouvre une conversation, SyBox interroge votre système sur ce client et affiche la réponse à côté de la discussion : l'agent n'a jamais besoin de quitter SyBox. La réponse peut inclure des commandes, un solde, des tickets ou toute autre donnée renvoyée par votre système. SyBox transmet le numéro de téléphone du client, ou son adresse e-mail pour les échanges par e-mail.

Il existe deux types d'API ERP :

- "Onglet latéral — afficher les données à côté du chat" : un bouton dans la barre latérale de la boîte de réception. Cliquer dessus affiche les données de votre système pour le client sélectionné.
- "Produits — cherchez dans votre catalogue et envoyez un article" : l'agent saisit la recherche du client. Votre système renvoie les produits correspondants sous forme de cartes avec nom, prix, photo et stock. Un clic insère le lien du produit dans la zone de message.

### Comment ajouter une API ERP

1. Allez dans Paramètres > Intégrations > API ERP.
   ![Settings, ERP APIs: a connected stock system that shows as a button in conversations](https://www.sybox.io/res/sybox/help/fr/add-an-erp-api-1.webp?v=e33b88e9)
2. Cliquez sur "Ajouter une API ERP".
   ![The new ERP API window: its type first, then its name, button and address](https://www.sybox.io/res/sybox/help/fr/add-an-erp-api-2.webp?v=fb8ec0e0)
3. Choisissez le "Type" (voir les deux types ci-dessus).
4. Remplissez le "Nom affiché", c'est-à-dire le nom complet de l'intégration.
5. Remplissez le "Nom du bouton", le libellé court visible sur le bouton.
6. Sous "Icône du bouton", sélectionnez l'icône de votre choix.
7. Dans "URL de l'API ERP", collez l'adresse de votre système. Elle doit impérativement commencer par http:// ou https://.
8. Dans "Jeton ERP", collez le jeton de votre système, s'il en utilise un. SyBox le transmet à chaque requête afin que votre système authentifie l'appel.
9. Facultatif : sous "En-têtes personnalisés", cliquez sur "Ajouter un en-tête" pour transmettre des paires nom/valeur supplémentaires à chaque requête, comme un code d'agence. Chaque en-tête possède son propre interrupteur pour le désactiver sans le supprimer. Cliquez sur l'icône de corbeille pour retirer un en-tête. Certains noms d'en-têtes réservés par SyBox sont ignorés.
10. Cliquez sur Enregistrer.

Le nouveau bouton apparaît immédiatement dans la boîte de réception. Inutile de recharger la page.

### Comment modifier, suspendre ou supprimer une API ERP

1. Repérez sa carte dans la liste des API ERP.
2. Cliquez sur Modifier pour ajuster vos paramètres. Pour conserver le jeton enregistré, laissez "Jeton ERP" vide ("Laisser vide pour conserver l'actuel").
   ![To edit, pause or delete an ERP API: "Edit" marked on the screen in SyBox](https://www.sybox.io/res/sybox/help/fr/edit-pause-or-delete-an-erp-api-2.webp?v=a51284f3)
3. Cliquez sur Activer / Désactiver pour masquer ou afficher le bouton dans la boîte de réception. Une carte désactivée porte la mention "Désactivé".
4. Cliquez sur Supprimer, puis confirmez "Supprimer cette intégration ?".

Contenu de la carte : le nom, le nom du bouton, l'adresse, ainsi que l'état "Actif" ou "Désactivé". La mention "Aucun jeton" s'affiche si aucun jeton n'est enregistré. Si un jeton existe, seuls ses derniers caractères restent visibles.

Règles et messages :

- "Nom affiché", "Nom du bouton" et "URL de l'API ERP" sont obligatoires. S'il en manque un, le message "Données incomplètes" s'affiche.
- L'adresse doit impérativement commencer par http:// ou https://.

Développement de votre côté : la Documentation développeur publique de SyBox (sur le site web de SyBox, rubrique Développeurs) détaille ce que SyBox envoie et la structure des réponses attendues. Cela inclut les formats d'affichage, les lignes cliquables pour ouvrir le détail d'un enregistrement et la recherche de produits.

**Q: J'ai ajouté une API ERP mais aucun bouton n'apparaît à côté de la discussion.**

Vérifiez que la carte indique "Actif". Les deux types créent un bouton dans la barre latérale de la boîte de réception.

**Q: Le volet s'ouvre mais n'affiche aucune donnée ou renvoie une erreur.**

SyBox affiche exactement la réponse renvoyée par votre système. Assurez-vous que votre adresse est accessible depuis Internet, que le jeton est correct et que votre système retrouve bien le client par son numéro de téléphone (ou par e-mail pour les échanges d'e-mails).

**Q: Puis-je connecter plusieurs systèmes ?**

Oui. Ajoutez autant d'API ERP que nécessaire. Chacune disposera de son propre bouton.

**Q: Qui a accès aux données affichées dans le volet ?**

Les membres de l'équipe autorisés à ouvrir cette conversation dans la boîte de réception.

Source: https://www.sybox.io/fr/help/erp-apis