Passer au contenu principal
L’API Replier permet à votre propre code ou à un outil d’automatisation de faire ce que vous faites dans Replier : lister les espaces de travail, comptes et publications, créer et modifier des automatisations, lire les résultats et les contacts, et envoyer des réponses de rattrapage ou d’automatisations ponctuelles. Pour utiliser Replier depuis ChatGPT, Claude ou un autre outil d’IA, utilisez plutôt les connexions IA. La référence de l’API (en anglais) décrit chaque endpoint avec ses paramètres et ses réponses.

​
Créer une clé API

  1. Dans Replier, ouvrez le menu de votre compte et choisissez Gérer le compte → Intégrations.
  2. Sous Clés API, sélectionnez Créer une clé API.
  3. Saisissez un nom que vous reconnaîtrez, choisissez son accès et sélectionnez Créer la clé.
  4. Copiez la clé. Replier ne l’affiche qu’une fois.
Toute personne qui détient la clé peut utiliser Replier en votre nom : gardez-la hors du code que vous partagez et hors du navigateur. Si elle fuite, supprimez-la et créez-en une autre. Une clé qui peut seulement consulter vos données est refusée quand elle tente de modifier quelque chose. Une clé qui peut aussi modifier peut créer, modifier, activer ou désactiver et supprimer des automatisations, enregistrer vos textes par défaut, réordonner la file de la prochaine publication, importer des photos de réponse et envoyer les réponses de rattrapage et d’automatisations ponctuelles. Dans les deux cas, la clé agit avec votre rôle dans chaque espace de travail : elle ne peut pas faire plus que vous.

​
Envoyer une requête

Envoyez la clé comme bearer token à https://api.usereplier.com/v1 :
Les autres requêtes se font dans un espace de travail. Utilisez un id de cette liste :
Les requêtes qui modifient quelque chose envoient du JSON :
Les automatisations créées ou modifiées par l’API ont les mêmes limites que dans Replier : jusqu’à 24 cibles, trois boutons, une photo facultative et des parcours de messages dans les espaces de travail Studio.

​
Erreurs

Une requête refusée répond avec un statut HTTP et un corps comme celui-ci :
code ne change pas ; message est une explication en anglais dont la formulation peut changer. Certaines erreurs ajoutent d’autres champs, comme l’automatisation qui utilise déjà la publication choisie.

​
Réessayer sans risque

Les requêtes qui modifient quelque chose acceptent l’en-tête Idempotency-Key. Envoyez une nouvelle valeur aléatoire, par exemple un UUID, pour chaque opération, et la même valeur quand vous la réessayez. Une nouvelle tentative avec la même valeur renvoie le premier résultat au lieu de créer une seconde automatisation ou d’envoyer les réponses deux fois. L’envoi des réponses de rattrapage, aux anciens commentaires ou d’automatisations ponctuelles, ainsi que la création d’une automatisation ponctuelle, exigent l’en-tête ; sans lui, la requête est refusée avec IDEMPOTENCY_KEY_REQUIRED.
Pour ne pas écraser la modification de quelqu’un d’autre, envoyez expected_version avec la version que vous avez lue. Si l’automatisation a changé depuis, la requête est refusée avec VERSION_CONFLICT. Il est obligatoire pour supprimer une automatisation.

​
Évolutions de l’API

Dans /v1, Replier ne fait qu’ajouter : de nouveaux endpoints, de nouveaux paramètres facultatifs, de nouveaux champs de réponse et de nouvelles valeurs dans les champs d’état ou de motif. Ignorez les champs et valeurs que vous ne connaissez pas. Un changement qui casserait le code existant arrivera en /v2.

​
Suspendre ou supprimer une clé

Dans Gérer le compte → Intégrations, chaque clé affiche son accès et sa dernière utilisation. Choisissez Suspendre l’accès pour refuser ses requêtes jusqu’à ce que vous choisissiez Réactiver l’accès. Choisissez Supprimer la clé pour la retirer définitivement ; le code qui l’utilise perd l’accès immédiatement. Les automatisations qu’elle a créées continuent de fonctionner.