Aller au contenu

Zapier

Connectez Cord à des milliers d’apps sans écrire de code : vos Zaps démarrent quand quelque chose se passe dans Cord et peuvent créer des données dans Cord.

Ce que fait l’app

L’app Cord pour Zapier propose des déclencheurs instantanés (un Zap démarre dès que quelque chose se passe dans Cord), des actions (le Zap crée ou modifie des données dans Cord) et des recherches (le Zap trouve un client ou un devis avant d’agir). L’autorisation se fait en un clic sur un écran de Cord : vous ne créez ni ne collez aucune clé.

Prérequis

Où Ce qu’il vous faut
Cord Le droit Paramètres dans l’espace de travail que vous connectez. Toutes les offres.
Zapier Un compte Zapier. Ce que vous pouvez construire (nombre de Zaps, nombre d’étapes) dépend de votre offre Zapier.
Quota Chaque action et chaque recherche consomme des appels du quota mensuel d’API de votre offre Cord. Voir Limites.

Connecter l’app Cord

L’app Cord pour Zapier est partagée sur invitation. Dans Paramètres › Intégrations › Zapier, le bouton Ouvrir Cord sur Zapier mène directement à l’invitation.

  1. Acceptez l’invitation. Cliquez sur Ouvrir Cord sur Zapier et acceptez. Zapier ajoute Cord à vos apps.
  2. Créez un Zap. Choisissez Cord comme déclencheur ou comme action, puis connectez votre compte.
  3. Autorisez l’accès dans Cord. Un écran de Cord s’ouvre : choisissez l’espace de travail et cliquez sur Autoriser. L’écran indique ce que Zapier pourra faire et ce qu’il ne pourra pas faire : il ne peut ni voir les mots de passe ou les données de carte, ni changer votre offre, ni gérer votre équipe.
  4. Testez le Zap. Zapier récupère un événement d’exemple pour que vous puissiez associer les champs dans les étapes suivantes.

Zapier renouvelle l’accès automatiquement. La connexion apparaît dans Cord comme Connexion autorisée de Zapier, dans l’onglet Clés API du Cord Workbench.

Écran d’autorisation de Cord ouvert depuis Zapier : choix de l’espace de travail (Materiales del Valle), ce que Zapier pourra faire et ne pourra pas faire, avec les boutons Annuler et Autoriser.

Ce que comprend l’app

Type Ce que vous pouvez faire
Déclencheurs instantanés Devis créé, envoyé, ouvert par le client, approuvé, refusé ou payé ; paiement partiel reçu ; facture payée ; nouveau client ; ou New Event, pour choisir n’importe lequel des 41 événements de Cord.
Actions Créer un client, mettre à jour un client, créer un devis (avec ses lignes, sa devise, ses conditions, sa validité et la possibilité de l’envoyer immédiatement), envoyer un devis, marquer un devis comme payé et créer une tâche.
Recherches Client par e-mail exact ou par nom, et devis par numéro.

La liste des 41 événements figure dans Déclencheurs et dans Webhooks pour les développeurs.

Ce qui circule et dans quel sens

Sens Ce qui circule Quand
De Cord vers Zapier L’événement que vous avez choisi, avec les données de l’objet : numéro, client, total, devise, statut et, pour un devis, le lien public. Instantanément, chaque fois que cela se produit dans Cord.
De Zapier vers Cord Ce que fait l’action : un client créé ou mis à jour, un devis créé ou envoyé, un paiement enregistré ou une tâche. Quand le Zap s’exécute.
Recherches Zapier lit un client ou un devis pour l’utiliser à l’étape suivante. Rien n’est modifié. Quand le Zap s’exécute.

Ce qu’une action fait dans Cord déclenche les mêmes événements que si une personne l’avait fait, avec Qui l’a déclenché : L’API. Si des workflows ou des Zaps écoutent ces événements, ils s’exécutent aussi.

Limites

Limite Valeur
Appels API par mois Gratuit 100, Starter 1 000, Professionnel 5 000, Scale 10 000, Developer 50 000
Au-delà du quota Avec l’offre Gratuite, les appels sont refusés jusqu’au mois suivant ; à partir de Starter, ils sont facturés en dépassement, avec un plafond de sécurité de 10 fois ce qui est inclus
Webhooks créés par vos Zaps 100 par organisation, en plus des endpoints de webhook de votre offre
Connexions autorisées actives 25 par app et par organisation
  • Ce qui consomme du quota : chaque action et chaque recherche (au moins un appel ; certaines actions relisent le devis après l’avoir modifié), ainsi que l’enregistrement ou la suppression du webhook quand vous activez ou désactivez un Zap. La réception d’événements ne consomme pas de quota.
  • Votre consommation : dans Paramètres › Offres et abonnement › Abonnement, ligne Appels API.
  • Chaque Zap actif avec un déclencheur Cord crée son propre webhook dans Cord ; quand vous désactivez le Zap, Zapier le supprime.

Déconnecter

Il y a deux niveaux, selon que vous voulez désactiver un Zap ou couper complètement l’accès de Zapier.

Désactiver un Zap : désactivez-le ou supprimez-le dans Zapier. Zapier supprime dans Cord le webhook que ce Zap avait créé ; les autres Zaps continuent de fonctionner.

Couper l’accès de Zapier à Cord :

  1. Allez dans Paramètres › Intégrations › Zapier et cliquez sur Voir les connexions autorisées. L’onglet Clés API du Cord Workbench s’ouvre.
  2. Repérez la ligne Connexion autorisée de Zapier, avec l’étiquette OAuth.
  3. Cliquez sur Révoquer et confirmez.

À partir de ce moment, Zapier ne peut plus appeler l’API avec cette connexion, et les webhooks créés par ses Zaps cessent de recevoir des événements. Dans Zapier, les Zaps Cord échouent avec une erreur d’autorisation jusqu’à ce que vous reconnectiez le compte. Si vous voulez aussi retirer le compte de Zapier, supprimez-le dans My Apps de Zapier.

Alternative : Webhooks by Zapier

Si vous préférez ne pas installer l’app, vous pouvez connecter Zapier avec les modules génériques. Webhooks by Zapier est une app Zapier disponible dans ses offres payantes.

  1. Créez le Zap. Dans Zapier, choisissez comme déclencheur Webhooks by Zapier › Catch Hook et copiez l’URL fournie.
  2. Enregistrez l’endpoint dans Cord. Activez le Mode développeur (Votre compte › Préférences), ouvrez l’onglet Webhooks du Workbench, collez l’URL de Zapier et enregistrez.
  3. Choisissez les événements, par exemple quote.approved.
  4. Envoyez un événement de test. Cliquez sur Tester sur l’endpoint Cord et, dans Zapier, sur Test trigger. Zapier affiche les champs : event, data__folio, data__total, data__cliente, etc.
  5. Ajoutez les actions du Zap et activez-le.

Chaque événement contient id, event, created_at et data. Si vous enregistrez plusieurs événements sur un même endpoint, ajoutez une étape Filter by Zapier ou Paths sur le champ event.

Zapier ne vérifie pas la signature de Cord. Traitez l’URL du Catch Hook comme un secret ; si vous pensez qu’elle a fuité, supprimez l’endpoint dans Cord et créez un nouveau Zap.

Les endpoints enregistrés de cette façon sont décomptés de la limite de webhooks de votre offre : 16 avec Gratuit, Starter et Professionnel ; 32 avec Scale ; 100 avec Developer.

Exemples

  • Devis payé → Google Sheets : déclencheur Quote Paid → Google Sheets › Create Spreadsheet Row. (Si vous voulez seulement la feuille de calcul, l’intégration directe Google Sheets ne consomme pas de quota.)
  • Nouveau prospect dans votre formulaire → client dans Cord : votre app de formulaires → Find Client par e-mail → s’il n’existe pas, Create Client.
  • Devis approuvé → nouveau projet : déclencheur Quote Approved → Asana, Trello ou ClickUp › Create task.

Problèmes courants

Message ou symptôme Que faire
« Vous ne pouvez pas connecter d’applications ici » lors de l’autorisation Votre utilisateur n’a pas le droit Paramètres dans cet espace de travail. Demandez à une personne qui l’a de donner l’autorisation, ou connectez-vous avec un autre compte.
« L’adresse de retour de cette demande ne correspond pas… » Recommencez la connexion depuis Zapier, et non depuis un lien enregistré.
Le Zap échoue avec une erreur d’autorisation La connexion a été révoquée dans Cord. Reconnectez le compte Cord dans Zapier.
Le Zap échoue avec une erreur 429 Vous avez dépassé la limite par minute ou le quota mensuel d’API. Vérifiez votre consommation dans Paramètres › Offres et abonnement ; avec l’offre Gratuite, attendez le mois suivant ou passez à une offre supérieure.
Cord indique que vos intégrations ont atteint le maximum de 100 abonnements par organisation Désactivez les Zaps, scénarios ou workflows n8n que vous n’utilisez plus pour libérer de la place.
Le déclencheur ne reçoit aucun événement Vérifiez que le Zap est activé et que l’événement se produit après son activation : un Zap ne reçoit pas les événements antérieurs. Pour tester, provoquez l’événement réel, par exemple en envoyant un devis à votre propre adresse e-mail.

Voir aussi