Aller au contenu
FREN

Make

Envoyez ce qui se passe dans Cord vers n’importe quelle app de Make, et créez des données dans Cord depuis vos scénarios.

Ce que fait l’intégration

L’app Cord pour Make comprend un déclencheur instantané (Watch Events), des actions pour créer et modifier des données dans Cord, des recherches avec pagination et un module universel pour toute autre opération de l’API. Elle s’autorise d’un clic sur un écran de Cord, sans clé, et fonctionne dans toutes les zones de Make.

Prérequis

Où Ce qu’il vous faut
Cord Le droit Paramètres dans l’espace de travail que vous allez connecter. Toutes les offres.
Make Un compte Make. Pour installer l’app, être Admin, Owner ou App Developer de cette organisation Make. Les opérations consommées par vos scénarios sont facturées par Make selon votre offre Make.
Quota Chaque module d’action ou de recherche consomme des appels du quota mensuel d’API de votre offre Cord. Voir Limites.

Connecter l’app Cord

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

  1. Installez l’app. Cliquez sur Ouvrir Cord sur Make, puis sur Install, choisissez votre organisation Make et confirmez. Make ne permet d’installer des apps qu’aux Admins, Owners ou App Developers de cette organisation.
  2. Créez la connexion. Dans un scénario, ajoutez n’importe quel module Cord et cliquez sur Create a connection › Save.
  3. Autorisez dans Cord. Un écran de Cord s’ouvre : choisissez l’espace de travail et cliquez sur Autoriser. Aucune clé à créer ni à coller.

La personne qui autorise doit avoir accès aux Paramètres de cet espace. Make renouvelle l’accès de lui-même ; pour le couper, révoquez la connexion dans l’onglet Clés API du Cord Workbench, où elle apparaît comme Connexion autorisée de Make.

Type Modules
Déclencheur instantané Watch Events : vous choisissez les événements de Cord et le scénario démarre dès qu’ils se produisent.
Actions Create a Client, Update a Client, Get a Client, Create a Quote, Get a Quote, Send a Quote, Mark a Quote as Paid et Create a Task.
Recherches Search Clients et Search Quotes, avec pagination.
Universel Make an API Call, pour toute autre opération de l’API de Cord.

Chaque Watch Events actif crée son propre webhook dans Cord, avec un quota distinct des endpoints de votre offre.

Scénario Make avec trois modules en chaîne : Cord › Watch Events, Cord › Get a Client et Google Sheets › Add a Row. Ouvert, le webhook du déclencheur avec la connexion « Cord (Materiales del Valle) » et l’événement « Quotes: Quote approved ».

Ce qui circule et dans quel sens

Sens Ce qui circule Quand
De Cord vers Make L’événement choisi dans Watch Events, avec les données de l’objet. Instantanément, chaque fois qu’il se produit dans Cord.
De Make vers Cord Ce que fait le module : créer ou mettre à jour un client, créer ou envoyer un devis, le marquer comme payé ou créer une tâche. Quand le scénario s’exécute.
Recherches et consultations Make lit des clients ou des devis pour les utiliser dans le module suivant. Rien n’est modifié. Quand le scénario s’exécute.

Ce qu’un module 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.

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é fixé à 10 fois le volume inclus
Webhooks créés par vos scénarios 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 module d’action, de recherche ou Make an API Call, ainsi que l’enregistrement ou la suppression du webhook de Watch Events. Recevoir des événements ne consomme pas de quota.
  • Votre consommation : dans Paramètres › Offres et abonnement › Abonnement, ligne Appels API.
  • Les requêtes avec HTTP › Make a request et une clé sk_live_… consomment aussi du quota ; avec sk_test_…, non.

Déconnecter

Désactiver un scénario : désactivez-le dans Make. Pour que Cord cesse de lui envoyer des événements, supprimez aussi son webhook dans la section Webhooks de Make : en le supprimant, Make le retire de Cord.

Couper l’accès de Make à Cord :

  1. Allez dans Paramètres › Intégrations › Make 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 Make, avec l’étiquette OAuth.
  3. Cliquez sur Révoquer et confirmez.

À partir de ce moment, Make ne peut plus appeler l’API avec cette connexion, et les webhooks créés par ses scénarios cessent de recevoir des événements. Dans Make, les modules Cord échouent avec une erreur d’autorisation jusqu’à ce que vous recréiez la connexion. Si vous avez utilisé l’alternative avec Webhooks et HTTP, supprimez l’endpoint dans Webhooks et révoquez la clé dans API.

Alternative : Webhooks et HTTP

Si vous préférez ne pas installer l’app, Make se connecte à Cord avec deux modules que Make intègre déjà :

Sens Module Make Ce qu’il vous faut dans Cord
Cord → Make : un événement de Cord démarre votre scénario Webhooks › Custom webhook Un endpoint de webhook avec l’URL de Make
Make → Cord : votre scénario crée ou met à jour des données dans Cord HTTP › Make a request Une clé API secrète avec accès en écriture

Les deux se configurent dans le Cord Workbench (onglets Webhooks et Clés API) : si vous ne le voyez pas, activez le Mode développeur dans Votre compte › Préférences.

Recevoir les événements de Cord

  1. Créez le webhook dans Make. Dans votre scénario, ajoutez Webhooks › Custom webhook, cliquez sur Add, donnez-lui un nom et copiez l’URL fournie par Make.
  2. Enregistrez l’endpoint dans Cord. Ouvrez Webhooks dans le panneau Développeurs, collez l’URL de Make et enregistrez. Cord affiche un secret de signature une seule fois ; Make ne l’utilise pas, mais conservez-le si vous comptez vérifier les signatures plus tard.
  3. Choisissez les événements. Cochez uniquement ceux dont votre scénario a besoin, par exemple quote.approved ou invoice.paid.
  4. Apprenez à Make la structure de l’événement. Dans Make, cliquez sur Redetermine data structure et, dans Cord, cliquez sur Tester sur l’endpoint. Make reçoit un événement d’exemple et apprend ses champs.
  5. Mappez et activez. Utilisez les champs dans les modules suivants (par exemple data.folio, data.total, data.cliente) et activez le scénario.

Ce que contient chaque événement

Chaque événement est un JSON avec quatre champs :

Champ Description
id Identifiant unique de l’événement. Il reste le même si Cord relance l’envoi.
event Le type d’événement, par exemple quote.paid.
created_at Le moment où il s’est produit.
data Les données de l’objet : pour un devis, id, folio, status, moneda, total, cliente, cliente_id et le lien public.

La liste complète des événements et de leurs champs se trouve dans Webhooks pour les développeurs.

Un endpoint ou plusieurs

Vous pouvez enregistrer un endpoint par scénario avec uniquement ses événements, ou un seul endpoint avec plusieurs événements et un Router dans Make qui filtre sur event. La première option est plus simple à maintenir ; la seconde utilise moins d’endpoints.

Les endpoints que vous enregistrez à la main sont décomptés de la limite de webhooks de votre offre : 16 avec Gratuit, Starter et Professionnel ; 32 avec Scale ; 100 avec Developer.

Envois et relances

Chaque endpoint conserve un historique des envois avec le statut, le temps de réponse et la réponse de Make. Si Make ne répond pas, Cord relance l’envoi. Comme l’id ne change pas d’une relance à l’autre, ajoutez dans Make un filtre ou un data store pour ne pas traiter deux fois le même id.

Traitez l’URL du webhook Make comme un secret. Make ne vérifie pas la signature de Cord : toute personne qui connaît l’URL pourrait envoyer de fausses données à votre scénario. Ne la partagez pas et, si vous pensez qu’elle a fuité, supprimez l’endpoint dans Cord, créez un nouveau webhook dans Make et enregistrez la nouvelle URL.

Créer ou mettre à jour des données dans Cord

  1. Créez une clé. Dans API, dans le panneau Développeurs, créez une clé secrète avec la portée écriture. Elle n’est affichée qu’une seule fois ; enregistrez-la dans la connexion Make, pas dans un champ texte du scénario.
  2. Ajoutez HTTP › Make a request à votre scénario.
  3. Configurez-le :
    • URL : l’endpoint, par exemple https://cordhq.app/api/v1/clientes.
    • Method : POST pour créer, PATCH pour mettre à jour, GET pour rechercher.
    • Headers : Authorization avec Bearer suivi de votre clé, et Content-Type avec application/json.
    • Body type : Raw, Content type JSON, avec les champs de la ressource.
    • Parse response : activé, pour utiliser la réponse dans les modules suivants.
  4. Évitez les doublons avec l’en-tête Idempotency-Key (voir ci-dessous).

Ce que vous pouvez faire

Vous voulez Requête
Rechercher un client par e-mail avant de le créer GET /api/v1/clientes?email=client@example.com
Créer un client POST /api/v1/clientes avec au moins empresa
Mettre à jour les coordonnées d’un client PATCH /api/v1/clientes/{id} avec contacto, email, telefono, etc.
Rechercher un devis par numéro GET /api/v1/cotizaciones?folio=COT-00104
Créer un devis POST /api/v1/cotizaciones
Envoyer, approuver, refuser ou marquer un devis comme payé POST /api/v1/cotizaciones/{id} avec action : send, resend, approve, reject ou mark_paid
Créer une tâche POST /api/v1/tareas avec titulo et, en option, due_date et cotizacion_id

Les champs de chaque endpoint : Clients, Devis et Tâches.

Éviter les doublons

Make peut relancer un module. Pour qu’une relance ne crée pas deux fois le même client, ajoutez l’en-tête Idempotency-Key avec une valeur fixe pour cette opération, par exemple l’id de l’événement qui l’a déclenchée ou l’identifiant de la ligne de votre feuille de calcul. Si Cord a déjà reçu cette clé avec la même requête, il renvoie le résultat d’origine au lieu de créer un autre enregistrement.

Clés de test

Avec une clé sk_test_…, votre scénario travaille sur l’environnement de test de votre compte, isolé de vos données réelles. Utilisez-la pendant la construction du scénario, puis remplacez-la par la clé sk_live_… une fois terminé.

Exemples de scénarios

  • Devis approuvé → feuille de calcul : Custom webhook avec quote.approved → Google Sheets › Add a row avec le numéro, le client et le total.
  • Formulaire → client dans Cord : Typeform › Watch responses → HTTP GET /api/v1/clientes?email= → s’il n’existe pas, HTTP POST /api/v1/clientes.
  • Facture payée → comptabilité : Custom webhook avec invoice.paid → votre logiciel de comptabilité.
  • Paiement sur une autre plateforme → marquer comme payé dans Cord : le déclencheur de votre plateforme → HTTP GET /api/v1/cotizaciones?folio= → HTTP POST /api/v1/cotizaciones/{id} avec {"action":"mark_paid"}.

Erreurs fréquentes

Réponse de Cord Cause Que faire
401 La clé manque, a été mal copiée ou a été révoquée. Vérifiez l’en-tête Authorization: Bearer sk_live_….
403 La clé est en lecture seule. Créez une clé avec la portée écriture.
404 L’identifiant n’existe pas dans votre organisation. Vérifiez que vous avez mappé le bon id, et non le numéro du devis.
409 invalid_state L’action ne s’applique pas au statut actuel, par exemple approuver un brouillon. Vérifiez le statut du devis avant l’action.
422 idempotency_key_reused Vous avez utilisé la même Idempotency-Key pour une autre requête. Utilisez une clé différente pour chaque opération.
429 Vous avez dépassé la limite par minute ou le quota mensuel d’API. Ajoutez une pause entre les modules ou réduisez la fréquence. Vérifiez votre consommation dans Paramètres › Offres et abonnement ; avec l’offre Gratuite, attendez le mois suivant ou changez d’offre.
« Vous ne pouvez pas connecter d’applications ici » lors de l’autorisation Votre utilisateur n’a pas le droit Paramètres dans cet espace. Demandez à une personne qui l’a de donner l’autorisation.

Plus de détails dans Erreurs de l’API.

Voir aussi