Automatisation ActiveCampaign via Rube MCP
Automatisez les opérations CRM et de marketing automation d'ActiveCampaign via la boîte à outils ActiveCampaign de Composio, en utilisant Rube MCP.
Prérequis
- Rube MCP doit être connecté (
RUBE_SEARCH_TOOLSdisponible) - Connexion ActiveCampaign active via
RUBE_MANAGE_CONNECTIONSavec la boîte à outilsactive_campaign - Appelez toujours
RUBE_SEARCH_TOOLSen premier pour obtenir les schémas actuels des outils
Configuration
Obtenir Rube MCP : Ajoutez https://rube.app/mcp comme serveur MCP dans votre configuration client. Aucune clé API nécessaire — ajoutez simplement le point de terminaison et cela fonctionne.
- Vérifiez que Rube MCP est disponible en confirmant que
RUBE_SEARCH_TOOLSrépond - Appelez
RUBE_MANAGE_CONNECTIONSavec la boîte à outilsactive_campaign - Si la connexion n'est pas ACTIVE, suivez le lien d'authentification retourné pour terminer l'authentification ActiveCampaign
- Confirmez que l'état de la connexion indique ACTIVE avant d'exécuter des workflows
Workflows principaux
1. Créer et trouver des contacts
Quand l'utiliser : L'utilisateur souhaite créer de nouveaux contacts ou rechercher des contacts existants
Séquence d'outils :
ACTIVE_CAMPAIGN_FIND_CONTACT- Rechercher un contact existant [Facultatif]ACTIVE_CAMPAIGN_CREATE_CONTACT- Créer un nouveau contact [Requis]
Paramètres clés pour la recherche :
email: Rechercher par adresse e-mailid: Rechercher par ID de contact ActiveCampaignphone: Rechercher par numéro de téléphone
Paramètres clés pour la création :
email: Adresse e-mail du contact (requis)first_name: Prénom du contactlast_name: Nom du contactphone: Numéro de téléphone du contactorganization_name: Organisation du contactjob_title: Titre du poste du contacttags: Liste de tags séparés par des virgules à appliquer
Pièges :
emailest le seul champ obligatoire pour la création de contact- La recherche par téléphone utilise un paramètre de recherche général en interne ; elle peut retourner des correspondances partielles
- Lorsque
emailetphonesont combinés dans FIND_CONTACT, les résultats sont filtrés côté client - Les tags fournis lors de la création sont appliqués immédiatement
- La création d'un contact avec un email existant peut mettre à jour le contact existant
2. Gérer les tags des contacts
Quand l'utiliser : L'utilisateur souhaite ajouter ou supprimer des tags de contacts
Séquence d'outils :
ACTIVE_CAMPAIGN_FIND_CONTACT- Trouver le contact par email ou ID [Prérequis]ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG- Ajouter ou supprimer des tags [Requis]
Paramètres clés :
action: 'Add' ou 'Remove' (requis)tags: Noms des tags sous forme de chaîne séparée par des virgules ou tableau de chaînes (requis)contact_id: ID du contact (fournissez ceci ou contact_email)contact_email: Adresse e-mail du contact (alternative à contact_id)
Pièges :
- Les valeurs de
actionsont capitalisées : 'Add' ou 'Remove' (pas en minuscules) - Les tags peuvent être une chaîne séparée par des virgules ('tag1, tag2') ou un tableau (['tag1', 'tag2'])
- Soit
contact_idsoitcontact_emaildoit être fourni ;contact_ida la priorité - Ajouter un tag qui n'existe pas le crée automatiquement
- Supprimer un tag inexistant est une opération sans effet (ne génère pas d'erreur)
3. Gérer les abonnements aux listes
Quand l'utiliser : L'utilisateur souhaite abonner ou désabonner des contacts de listes
Séquence d'outils :
ACTIVE_CAMPAIGN_FIND_CONTACT- Trouver le contact [Prérequis]ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION- Abonner ou désabonner [Requis]
Paramètres clés :
action: 'subscribe' ou 'unsubscribe' (requis)list_id: ID de liste numérique sous forme de chaîne (requis)email: Adresse e-mail du contact (fournissez ceci ou contact_id)contact_id: ID du contact numérique sous forme de chaîne (alternative à email)
Pièges :
- Les valeurs de
actionsont en minuscules : 'subscribe' ou 'unsubscribe' list_idest une chaîne numérique (par exemple, '2'), pas le nom de la liste- Les IDs de liste peuvent être récupérés via le point de terminaison GET /api/3/lists (pas disponible en tant qu'outil Composio ; utilisez l'interface ActiveCampaign)
- Si
emailetcontact_idsont tous deux fournis,contact_ida la priorité - Le désabonnement change le statut en '2' (désabonné) mais l'enregistrement de la relation persiste
4. Ajouter des contacts aux automatismes
Quand l'utiliser : L'utilisateur souhaite inscrire un contact dans un workflow d'automatisation
Séquence d'outils :
ACTIVE_CAMPAIGN_FIND_CONTACT- Vérifier que le contact existe [Prérequis]ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION- Inscrire le contact dans l'automatisme [Requis]
Paramètres clés :
contact_email: Email du contact à inscrire (requis)automation_id: ID de l'automatisme cible (requis)
Pièges :
- Le contact doit déjà exister dans ActiveCampaign
- Les automatismes ne peuvent être créés que via l'interface ActiveCampaign, pas via l'API
automation_iddoit référencer un automatisme existant et actif- L'outil effectue un processus en deux étapes : recherche du contact par email, puis inscription
- Les IDs d'automatismes peuvent être trouvés dans l'interface ActiveCampaign ou via GET /api/3/automations
5. Créer des tâches de contact
Quand l'utiliser : L'utilisateur souhaite créer des tâches de suivi associées à des contacts
Séquence d'outils :
ACTIVE_CAMPAIGN_FIND_CONTACT- Trouver le contact pour associer la tâche [Prérequis]ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK- Créer la tâche [Requis]
Paramètres clés :
relid: ID du contact pour associer la tâche (requis)duedate: Date d'échéance au format ISO 8601 avec fuseau horaire (requis, ex. '2025-01-15T14:30:00-05:00')dealTasktype: ID du type de tâche basé sur les types disponibles (requis)title: Titre de la tâchenote: Description/contenu de la tâcheassignee: ID de l'utilisateur à qui attribuer la tâcheedate: Date de fin au format ISO 8601 (doit être postérieure à duedate)status: 0 pour incomplète, 1 pour terminée
Pièges :
duedatedoit être une date-heure ISO 8601 valide avec décalage de fuseau horaire ; n'utilisez PAS de valeurs facticesedatedoit être postérieure àduedatedealTasktypeest un ID sous forme de chaîne référençant les types de tâches configurés dans ActiveCampaignrelidest l'ID numérique du contact, pas l'adresse e-mailassigneeest un ID utilisateur ; résolvez les noms d'utilisateurs en IDs via l'interface ActiveCampaign
Schémas courants
Flux de recherche de contact
1. Appelez ACTIVE_CAMPAIGN_FIND_CONTACT avec l'email
2. S'il est trouvé, extrayez l'ID du contact pour les opérations suivantes
3. S'il n'est pas trouvé, créez le contact avec ACTIVE_CAMPAIGN_CREATE_CONTACT
4. Utilisez l'ID du contact pour les tags, abonnements ou automatismes
Marquage en masse des contacts
1. Pour chaque contact, appelez ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG
2. Utilisez contact_email pour éviter des appels de recherche séparés
3. Effectuez des lots avec des délais raisonnables pour respecter les limites de débit
Résolution d'ID
Email du contact -> ID du contact :
1. Appelez ACTIVE_CAMPAIGN_FIND_CONTACT avec l'email
2. Extrayez id de la réponse
Pièges connus
Casse des actions :
- Actions de tag : 'Add', 'Remove' (capitalisées)
- Actions d'abonnement : 'subscribe', 'unsubscribe' (minuscules)
- Mélanger la casse provoque des erreurs
Types d'ID :
- IDs de contact : chaînes numériques (ex. '123')
- IDs de liste : chaînes numériques
- IDs d'automatisme : chaînes numériques
- Tous les IDs doivent être passés sous forme de chaînes, pas d'entiers
Automatismes :
- Les automatismes ne peuvent pas être créés via l'API ; seule l'inscription est possible
- L'automatisme doit être actif pour accepter de nouveaux contacts
- Inscrire un contact déjà dans l'automatisme peut être sans effet
Limites de débit :
- L'API ActiveCampaign a des limites de débit par compte
- Implémentez un backoff en cas de réponses 429
- Les opérations par lots doivent être espacées de manière appropriée
Analyse des réponses :
- Les données de réponse peuvent être imbriquées sous
dataoudata.data - Analysez de manière défensive avec des schémas de repli
- La recherche de contact peut retourner plusieurs résultats ; faites correspondre par email pour plus de précision
Référence rapide
| Tâche | Slug de l'outil | Paramètres clés |
|---|---|---|
| Trouver un contact | ACTIVE_CAMPAIGN_FIND_CONTACT | email, id, phone |
| Créer un contact | ACTIVE_CAMPAIGN_CREATE_CONTACT | email, first_name, last_name, tags |
| Ajouter/supprimer des tags | ACTIVE_CAMPAIGN_MANAGE_CONTACT_TAG | action, tags, contact_email |
| Abonner/désabonner | ACTIVE_CAMPAIGN_MANAGE_LIST_SUBSCRIPTION | action, list_id, email |
| Ajouter à un automatisme | ACTIVE_CAMPAIGN_ADD_CONTACT_TO_AUTOMATION | contact_email, automation_id |
| Créer une tâche | ACTIVE_CAMPAIGN_CREATE_CONTACT_TASK | relid, duedate, dealTasktype, title |
Quand l'utiliser
Cette compétence est applicable pour exécuter le workflow ou les actions décrits dans l'aperçu.
Limitations
- N'utilisez cette compétence que lorsque la tâche correspond clairement au champ décrit ci-dessus.
- Ne traitez pas la sortie comme un substitut à une validation, un test ou une revue experte spécifiques à l'environnement.
- Arrêtez-vous et demandez des clarifications si les entrées, autorisations, limites de sécurité ou critères de succès requis sont manquants.