Automatisez le commentaire vers DM Instagram via l'API
CommentKeyword transforme les commentaires Instagram en conversations DM automatisées. L'API REST permet de créer des déclencheurs par mots-clés, de définir le texte des réponses et de connecter des agents IA par programmation — vos outils, vos workflows et vos agents IA peuvent ainsi tout gérer sans toucher au tableau de bord.
// 1. Find your live AI agent
const agentsResponse = await ck.get("/api/agents");
const agent = agentsResponse.data.find((item) => item.status === "live");
if (!agent) throw new Error("No live agent found");
// 2. Create the keyword trigger
const keywordResponse = await ck.post("/api/keywords", {
keyword: "GUIDE",
matchMode: "contains",
scope: "global",
commentReplies: ["Sent it to you, {{namefirst}}!"],
dmMessages: ["Hey {{namefirst}}, here's your free guide."],
delaySec: 20,
aiAgentId: agent.id
});
// 3. Go live.
console.log("Live:", keywordResponse.data.id);Tout ce que vous contrôlez via l'API
Un seul jeton PAT donne à votre code le contrôle total des déclencheurs par mots-clés, du texte des réponses et des connexions aux agents IA.
Créer et gérer des mots-clés
Créez un nouveau déclencheur par mot-clé en une seule requête POST. Définissez le mode de correspondance (exacte ou contient), la portée (globale ou limitée à un post) et les variantes de message sans toucher au tableau de bord.
POST /api/keywords
{
"keyword": "GUIDE",
"matchMode": "contains",
"scope": "global"
}Définir les réponses aux commentaires et les DM
Incluez commentReplies et dmMessages dans le même appel de création ou de mise à jour. Utilisez des variables comme « {{handle}} », « {{name}} » et « {{namefirst}} » pour personnaliser le texte au moment de l'envoi.
{
"commentReplies": ["Sent it to you, {{namefirst}}!"],
"dmMessages": ["Hey {{namefirst}}, here's the guide."],
"delaySec": 20
}Attacher un agent IA par ID
Si vous avez un agent IA Live dans votre espace de travail, liez-le à n'importe quel mot-clé en passant son ID public. L'agent prend automatiquement le relais des conversations DM une fois la question d'accroche envoyée.
PATCH /api/keywords/{id}
{
"aiAgentId": "a6be1900-8f4f-4ae6-8f4e-48f8b28f0f17"
}Laissez votre agent IA se configurer tout seul
Si vous construisez un système d'IA — un GPT personnalisé, un agent n8n, un workflow Claude ou votre propre backend — vous pouvez lui donner un jeton d'accès à l'API CommentKeyword et le laisser gérer toute la configuration d'automatisation Instagram.
L'agent peut lire vos agents Live existants, créer le déclencheur par mot-clé avec le bon texte de réponse, attacher l'agent IA approprié et activer le tout — sans aucune interaction manuelle avec le tableau de bord.
- Aucune connexion au tableau de bord requise une fois le jeton configuré
- Les IDs des agents IA sont lisibles via GET /api/agents
- Les mots-clés peuvent être créés en une seule requête POST
- Les mises à jour PATCH partielles permettent de changer le texte ou les agents sans tout recréer
- Désactivez les mots-clés en fin de campagne via PATCH
Exemple : lancement de campagne piloté par agent
1. Déclenchement de la campagne
Une publication produit est mise en ligne. Votre workflow n8n ou agent IA reçoit l'événement.
2. L'agent récupère les agents IA disponibles
Appelle GET /api/agents pour trouver l'agent Live adapté à ce type de campagne.
3. L'agent crée le mot-clé
Envoie le mot-clé, la réponse publique, le texte du DM et aiAgentId en un seul appel. Définit delaySec à 20.
4. Actif en quelques secondes
CommentKeyword commence immédiatement à surveiller les commentaires pour ce mot-clé. Aucune intervention humaine.
Qui utilise l'API
Tout workflow qui doit créer ou mettre à jour une automatisation de mots-clés Instagram sans travail manuel dans le tableau de bord.
Des agents IA qui se configurent eux-mêmes
Donnez un PAT à votre système d'IA et il peut créer le mot-clé, rédiger la réponse et se brancher lui-même comme agent de conversation — sans aucun travail manuel dans le tableau de bord.
Flux n8n, Make et Zapier
Déclenchez la création ou la mise à jour de mots-clés depuis vos plateformes d'automatisation au lancement d'une campagne, d'un produit ou d'un lead magnet.
Tableaux de bord personnalisés et outils d'agence
Construisez votre propre interface de gestion au-dessus de l'API. Créez et mettez à jour les mots-clés de plusieurs clients sans vous connecter séparément à chaque espace de travail.
Campagnes pilotées par script
Scriptez toute la configuration d'une campagne Instagram : créez le mot-clé, définissez le texte du DM, puis mettez-le à jour ou désactivez-le selon un calendrier — le tout depuis un seul script.
Serveur MCP — à venir
Un serveur Model Context Protocol exposerait les actions CommentKeyword comme des outils natifs pour Claude, GPT et tout système d'IA compatible MCP. Au lieu d'écrire des appels HTTP, votre agent appellerait directement des outils comme create_keyword ou attach_agent.
Si vous construisez un workflow d'IA qui bénéficierait d'une intégration MCP, contactez-nous — cela nous aide à prioriser.
// Utilisation future de MCP
await agent.use("commentkeyword");
await create_keyword({
keyword: "LAUNCH",
aiAgentId: agentId,
});
Commencez en quelques minutes
Créez un compte, générez un jeton PAT depuis les paramètres de votre espace de travail et lancez vos premières requêtes.
1. Générez un jeton PAT
Depuis les paramètres de votre espace de travail, créez un Personal Access Token et choisissez les autorisations dont votre intégration a besoin : keywords:read, keywords:write ou agents:read.
2. Faites votre première requête
curl -H "Authorization: Bearer TOKEN" \
https://commentkeyword.com/api/keywords3. Construisez votre workflow
Créez des mots-clés, attachez des agents, définissez le texte des réponses et gérez vos campagnes depuis votre code, votre plateforme d'automatisation ou votre système d'IA. Consultez la référence complète sur /api-docs ou utilisez la spécification OpenAPI lisible par machine.
Questions fréquentes
Que puis-je faire avec l'API CommentKeyword ?
Vous pouvez lister, créer, lire, mettre à jour et supprimer des déclencheurs par mots-clés. Chaque mot-clé peut inclure des réponses publiques, des messages DM, des paramètres de correspondance et un agent IA attaché en option. L'API expose également un endpoint en lecture pour vos agents IA afin de retrouver leurs IDs par programmation.
Comment puis-je m'authentifier ?
Utilisez un Personal Access Token (PAT) émis depuis les paramètres de votre espace de travail. Transmettez-le dans l'en-tête Authorization sous forme de Bearer token. Les jetons sont propres à un espace de travail et n'expirent pas automatiquement.
Puis-je attacher un agent IA à un mot-clé via l'API ?
Oui. Incluez le champ aiAgentId dans une requête POST ou PATCH. La valeur doit être l'ID public d'un agent Live dans le même espace de travail. Vous pouvez récupérer tous les IDs d'agents depuis l'endpoint GET /api/agents.
Un serveur MCP est-il disponible ?
Pas encore, mais il figure sur la feuille de route. Un serveur MCP permettrait aux agents IA d'interagir directement avec CommentKeyword via le Model Context Protocol, sans écrire d'appels HTTP bruts. Si vous construisez un système d'IA et que cela compte pour votre workflow, contactez-nous — cela aide à prioriser.
Faut-il un plan payant pour utiliser l'API ?
L'API est disponible sur tous les plans, y compris l'offre gratuite. Les comptes gratuits incluent 300 DM automatisés par mois. Les plans payants débloquent des volumes plus élevés, les agents IA et des fonctionnalités supplémentaires, également gérables via l'API.
Y a-t-il une limite de débit ?
L'API CommentKeyword est soumise à une limitation du débit par jeton d'espace de travail. La livraison Instagram est mise en file d'attente séparément pour chaque compte professionnel connecté et respecte les limites spécifiques à chaque endpoint de Meta. Si Meta bride une requête, les messages et réponses éligibles sont retardés puis retentés automatiquement.
Construisez une fois. Laissez l'API gérer le reste.
CommentKeyword donne à votre code — et à vos agents IA — le contrôle total des déclencheurs par mots-clés, du texte des réponses et du routage des conversations IA. Commencez gratuitement et ajoutez le jeton d'accès API depuis les paramètres de votre espace de travail.