Connecter Cord à Make

L’application Cord pour Make vous permet de lancer un scénario lorsqu’un devis progresse, et de créer ou de mettre à jour des données dans Cord depuis n’importe quelle autre application.

La connecter

1. Dans Cord, ouvrez Paramètres › Intégrations › Make et cliquez sur Ouvrir Cord sur Make. Cliquez sur Install, choisissez votre organisation Make et confirmez. Make ne permet d’installer des applications qu’aux administrateurs, propriétaires ou développeurs d’applications de cette organisation ; si ce n’est pas votre cas, demandez-le à quelqu’un qui l’est.
2. Dans Make, au sein d’un scénario, ajoutez un module Cord et cliquez sur Create a connection › Save.
3. Sur l’écran de Cord, choisissez l’espace de travail et cliquez sur Autoriser. Il n’y a aucune clé à créer ni à coller.

Vous devez avoir accès aux Paramètres de cet espace pour autoriser la connexion. Pour couper l’accès, ouvrez l’onglet Clés API du Workbench Développeurs (le lien Voir les connexions autorisées de Paramètres › Intégrations › Make vous y mène) et révoquez la connexion de Make, qui apparaît comme Connexion autorisée.

Ce que vous pouvez faire

• Déclencheur instantané : Watch Events, avec les événements Cord de votre choix.
• Actions : créer, mettre à jour et consulter des clients ; créer, consulter et envoyer des devis ; les marquer comme payés et créer des tâches.
• Recherches : clients et devis.
• Make an API Call : toute autre opération de l’API de Cord.

Sans installer l’application

Vous pouvez aussi connecter Cord à Make à l’aide de deux modules déjà inclus dans Make : Webhooks pour recevoir les événements de Cord et HTTP pour appeler l’API de Cord.

Recevoir les événements de Cord

1. Dans votre scénario Make, ajoutez le module Webhooks › Custom webhook, créez un webhook et copiez l’URL que Make vous fournit.
2. Dans Cord, activez le Mode développeur dans Votre compte › Préférences et ouvrez l’onglet Webhooks du Workbench, la pastille Développeurs dans le coin inférieur droit.
3. Cliquez sur Ajouter un endpoint, choisissez les événements qui vous intéressent (par exemple quote.approved), collez l’URL de Make et cliquez sur Créer l’endpoint.
4. Dans Make, cliquez sur Redetermine data structure puis, dans Cord, utilisez le bouton Tester de l’endpoint. Make apprend la structure de l’événement et vous pouvez alors mapper des champs comme data.folio, data.total ou data.cliente.

Chaque événement arrive avec id, event, created_at et data. Utilisez l’id pour ne pas traiter deux fois le même événement si Cord relance la livraison.

Make ne vérifie pas la signature de Cord à votre place. Traitez l’URL du webhook comme un secret : ne la partagez pas et, si vous pensez qu’elle a fuité, supprimez l’endpoint dans Cord et créez-en un nouveau.

Chaque endpoint est décompté de la limite de webhooks de votre offre.

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

1. Dans Cord, créez une clé secrète avec le droit d’écriture depuis l’onglet Clés API du Workbench Développeurs.
2. Dans Make, ajoutez le module HTTP › Make a request.
3. Configurez-le ainsi :
   • URL : l’endpoint dont vous avez besoin, par exemple https://cordhq.app/api/v1/clientes.
   • Method : POST pour créer, PATCH pour mettre à jour.
   • Headers : Authorization avec la valeur Bearer sk_live_... et Content-Type avec application/json.
   • Body type : Raw, contenu JSON, avec les champs de la ressource.
4. Si le scénario peut effectuer de nouvelles tentatives, ajoutez l’en-tête Idempotency-Key avec une valeur fixe par opération, par exemple l’id de l’événement qui l’a déclenchée. Ainsi, une nouvelle tentative ne crée pas l’enregistrement deux fois.

Ce que vous pouvez faire depuis Make :

• Créer un client avec POST /api/v1/clientes ou le mettre à jour avec PATCH /api/v1/clientes/{id}.
• Rechercher un client par e-mail avec GET /api/v1/clientes?email=....
• Créer un devis avec POST /api/v1/cotizaciones.
• L’envoyer ou le marquer comme payé avec POST /api/v1/cotizaciones/{id} et action.
• Créer une tâche avec POST /api/v1/tareas.

Les champs de chaque endpoint figurent dans la documentation pour les développeurs.