Intégrations Make.com
Comment construire des agents IA avec Make.com et Claude API. Architecture, modules clés, gestion des erreurs et templates prêts à l'emploi.
Architecture d'un agent Make + Claude
Un agent IA dans Make.com suit généralement cette structure :
- Déclencheur : Webhook, nouveau lead Pipedrive, email reçu, schedule
- Collecte de contexte : Récupérer les données du lead, historique, enrichissement
- Appel Claude API : Envoyer le contexte + instructions, recevoir la décision/contenu
- Parser la réponse : Extraire les informations structurées (JSON)
- Action : Mettre à jour le CRM, envoyer un email, créer une tâche
- Logging : Tracer l'exécution pour le debug
Modules Make.com essentiels
- HTTP > Make a request : Appeler l'API Claude/OpenAI
- JSON > Parse JSON : Extraire les données de la réponse
- Router : Brancher selon la décision de l'agent
- Tools > Set variable : Stocker des valeurs intermédiaires
- Error handler : Gérer les échecs d'API
Configurer le module HTTP pour Claude API
Voici la configuration du module HTTP pour appeler Claude API :
Paramètres de base
- URL :
https://api.anthropic.com/v1/messages - Méthode : POST
- Headers :
x-api-key: Votre clé API Anthropicanthropic-version:2023-06-01content-type:application/json
Corps de la requête (Body)
{
"model": "claude-3-5-sonnet-20241022",
"max_tokens": 1024,
"system": "Tu es un assistant commercial expert en qualification de leads B2B. Tu réponds toujours en JSON valide.",
"messages": [
{
"role": "user",
"content": "Analyse ce lead et détermine son niveau de qualification : {{lead_data}}"
}
]
}
Utilisez le mode « Request content: Raw » dans Make pour avoir un contrôle total sur le JSON envoyé. Le mode formulaire peut mal encoder certains caractères.
Structure des prompts efficaces
La qualité de votre agent dépend largement de vos prompts. Voici une structure éprouvée :
System prompt (personnalité et règles)
Tu es un agent de qualification pour [Nom entreprise], spécialiste en [secteur].
CONTEXTE :
- Notre ICP : [description du client idéal]
- Nos produits : [liste des offres]
- Signaux d'achat : [critères positifs]
- Signaux de disqualification : [critères négatifs]
RÈGLES :
- Réponds UNIQUEMENT en JSON valide
- Ne fais pas d'hypothèses, base-toi sur les données fournies
- Si une information manque, indique "inconnu"
FORMAT DE RÉPONSE :
{
"score": 0-100,
"qualification": "hot|warm|cold|disqualifié",
"raison": "explication en 1 phrase",
"prochaine_action": "action recommandée"
}
User prompt (données et demande)
Analyse ce lead :
NOM : {{lead.name}}
ENTREPRISE : {{lead.company}}
POSTE : {{lead.title}}
SECTEUR : {{lead.industry}}
EFFECTIF : {{lead.employees}}
SOURCE : {{lead.source}}
MESSAGE : {{lead.message}}
Fournis ton analyse au format JSON.
Gestion des erreurs
Les appels API peuvent échouer. Voici comment gérer les erreurs dans Make :
Erreurs courantes
| Code | Cause | Solution |
|---|---|---|
| 401 | Clé API invalide | Vérifier la clé dans les headers |
| 429 | Rate limit atteint | Ajouter un délai ou retry |
| 500 | Erreur serveur Claude | Retry automatique après délai |
| Timeout | Réponse trop longue | Augmenter le timeout Make, réduire max_tokens |
Pattern de retry
- Ajouter un Error Handler après le module HTTP
- Type : Resume avec Retry
- Configurer : 3 tentatives, délai de 10 secondes
- Si échec final : envoyer une notification Slack/email
Validation du JSON
Claude peut parfois retourner du JSON invalide. Ajoutez un module JSON > Parse avec un error handler qui :
- Tente de nettoyer la réponse (supprimer les backticks, le texte avant/après)
- Relance l'appel avec un prompt plus strict si échec
- Log l'erreur pour améliorer le prompt
Templates d'agents Make + Claude
🎯 Agent de qualification
Déclencheur : Nouveau lead Pipedrive
Actions : Analyse le lead, attribue un score, met à jour un champ custom, déplace dans le bon pipeline stage
Complexité : ⭐⭐ (intermédiaire)
✉️ Agent de personnalisation email
Déclencheur : Scheduled (batch quotidien)
Actions : Récupère les leads à contacter, enrichit avec Clay API, génère un email personnalisé, pousse vers Smartlead
Complexité : ⭐⭐⭐ (avancé)
📞 Agent de résumé post-call
Déclencheur : Webhook depuis outil de transcription (Grain, Fathom)
Actions : Reçoit la transcription, génère un résumé structuré, extrait les actions, met à jour la note Pipedrive
Complexité : ⭐⭐ (intermédiaire)
🔄 Agent de relance intelligente
Déclencheur : Scheduled (check quotidien)
Actions : Identifie les deals sans activité depuis X jours, analyse le contexte, génère une relance adaptée, crée une tâche ou envoie directement
Complexité : ⭐⭐⭐ (avancé)
Je peux vous accompagner dans la création de ces scénarios Make + Claude pour votre contexte spécifique. Réservez un audit gratuit pour en discuter.