Skip to main content
Créez des outils sur mesure pour connecter Quivr à n’importe quelle API.

​
Qu’est-ce qu’un outil personnalisé ?

Un outil personnalisé permet d’appeler votre propre API depuis vos workflows. Vous pouvez ainsi :
  • Récupérer des données depuis votre CRM ou ERP
  • Vérifier des informations dans votre base clients
  • Déclencher des actions dans vos systèmes internes
  • Intégrer des services tiers non supportés nativement
Exemple : Vous avez une API interne qui retourne le solde de fidélité d’un client. Créez un outil @get_loyalty_points et utilisez-le dans vos workflows.

​
Types d’authentification

Quivr supporte tous les types d’authentification courants :
Pour les APIs utilisant OAuth2 (Google, Salesforce, HubSpot…).Informations nécessaires :
  • Client ID
  • Client Secret
  • URL d’autorisation
  • Scopes requis

​
Créer un outil personnalisé

1

Préparez votre API

Assurez-vous que votre API :
  • Est accessible depuis Internet (ou via VPN si configuré)
  • Retourne des données en JSON
  • A une documentation des endpoints
2

Contactez notre équipe

Envoyez à support@quivr.app :
  • La documentation de votre API
  • Le type d’authentification
  • Les endpoints à exposer
  • Les cas d’usage prévus
3

Configuration par notre équipe

Nous configurons l’outil avec :
  • L’authentification sécurisée
  • Les paramètres d’entrée
  • Le format de sortie
4

Utilisez dans vos workflows

L’outil apparaît dans la liste avec @ et est prêt à l’emploi.

​
Exemple : Intégration PipeDream

PipeDream permet de créer des APIs rapidement. Voici comment l’intégrer à Quivr. Cas d’usage : Récupérer le profil complet d’un client depuis plusieurs sources. 1. Créez un workflow PipeDream qui :
  • Reçoit un email en entrée
  • Agrège les données de vos différents systèmes
  • Retourne un profil client unifié
2. Demandez l’intégration avec :
  • L’URL de votre workflow PipeDream
  • Les paramètres d’entrée (ex: email)
  • Le format de sortie attendu
3. Utilisez dans Quivr :

Utilisation API personnalisee

When to use
Quand tu as besoin d'informations depuis une API personnalisee
Steps

​
Bonnes pratiques de sécurité

Ne partagez jamais vos secrets API directement. Notre équipe les stocke de manière sécurisée.
Créez des tokens avec uniquement les permissions nécessaires.✅ Token en lecture seule si le workflow ne fait que consulter❌ Token admin complet “au cas où”
Changez régulièrement vos clés API et prévenez-nous pour mettre à jour la configuration.
Surveillez les appels à vos APIs depuis Quivr pour détecter tout comportement anormal.

​
Limitations

  • Timeout : Les appels API doivent répondre en moins de 30 secondes
  • Format : Seul le JSON est supporté en entrée/sortie
  • Taille : Les réponses sont limitées à 1 Mo

​
Besoin d’aide ?

Contacter le support

Notre équipe vous accompagne dans la création de vos outils personnalisés