Intégration n8n, Make, Zapier
En bref
La voie d'adoption la plus courante : nœud HTTP Request vers api.askmarcel.app/v1/diagnostic. Idéal pour automatiser le SAV.
Prérequis
- Compte n8n, Make ou Zapier
- Clé API AskMarcel (ak_live_)
- Palier Starter minimum pour la production
n8n
- 1
Ajouter un nœud HTTP Request
Method POST, URL api.askmarcel.app/v1/diagnostic.
- 2
Headers
Authorization: Bearer {{$env.ASKMARCEL_API_KEY}} et Content-Type: application/json.
- 3
Body JSON
Mappez brand, model, error_code depuis votre trigger (ticket Zendesk, formulaire, etc.).
Body{ "brand": "{{ $json.brand }}", "model": "{{ $json.model }}", "error_code": "{{ $json.error_code }}" } - 4
Parser la réponse
steps[] → liste pour email/Slack. source.manual + source.page → citation opposable.
Make (Integromat)
- 1
Module HTTP > Make a request
POST https://api.askmarcel.app/v1/diagnostic avec Bearer token.
- 2
Mapper les champs
Utilisez JSON > Create JSON pour le body. Parsez steps et source dans les modules suivants.
Zapier
- 1
Webhooks by Zapier → POST
URL diagnostic, header Authorization Bearer, payload JSON avec brand/model/error_code.
- 2
Formatter
Extrayez steps et source pour alimenter Gmail, Slack ou votre CRM.
Webhooks sortants (optionnel)
Pour une architecture événementielle, configurez un webhook AskMarcel (Starter+) qui notifie votre endpoint quand un diagnostic est terminé.
Vérifier que ça marche
Exécutez le workflow avec un code erreur connu (ex. Mitsubishi E7). La réponse doit contenir steps[] non vide et source.page.
curl -s https://api.askmarcel.app/v1/diagnostic \
-H "Authorization: Bearer ak_live_..." \
-H "Content-Type: application/json" \
-d '{"brand":"Mitsubishi","model":"Ecodan PUHZ-W85","error_code":"E7"}'Limites connues
- Rate-limit : respectez les quotas de votre palier
- ManyChat et autres bots conversationnels : préférez Make/n8n comme intermédiaire si le mapping JSON est complexe
Vidéo en cours de tournage
Prévenez-moi