@fabienbibe/n8n-nodes-metricool-api

n8n-nodes-metricool-connector

Un connecteur n8n pour l'API Metricool qui permet l'intégration avec l'interface Inbox de Metricool.

Installation

Via npm (Recommandé pour n8n auto-hébergé)

npm install n8n-nodes-metricool-connector

Installation manuelle

• Téléchargez la dernière version depuis les releases
• Extrayez le package dans votre dossier ~/.n8n/custom/
• Redémarrez n8n

Configuration

Credentials Metricool API

Pour utiliser ce connecteur, vous aurez besoin de :

• User Token : Le code d'autorisation unique de votre utilisateur trouvé dans les paramètres de compte
• User ID : L'identifiant utilisateur de votre compte Metricool
• Blog ID : Le numéro d'identification de la marque (trouvé dans l'URL du navigateur)

Comment obtenir vos credentials

• Connectez-vous à votre compte Metricool
• Allez dans Paramètres du compte
• Trouvez votre User Token dans la section API
• Notez votre User ID
• Le Blog ID se trouve dans l'URL quand vous naviguez dans votre tableau de bord

Fonctionnalités

Ce connecteur prend en charge les opérations suivantes :

🗨️ Conversations

• Récupérer plusieurs conversations : Obtenir une liste de conversations
• Publier un message : Envoyer un message à une conversation
• Vérifier les autorisations : Vérifier les autorisations pour les conversations
• Récupérer une image : Récupérer une image depuis les conversations

📝 Notes

• Récupérer plusieurs notes : Obtenir une liste de notes
• Créer : Créer une nouvelle note
• Mettre à jour : Modifier une note existante
• Supprimer : Supprimer une note

💬 Commentaires de publications

• Récupérer plusieurs commentaires : Obtenir une liste de commentaires de publications
• Publier un commentaire : Ajouter un commentaire
• Supprimer un commentaire : Supprimer un commentaire
• Vérifier les autorisations : Vérifier les autorisations pour les commentaires

⭐ Avis

• Publier une réponse : Répondre à un avis
• Supprimer une réponse : Supprimer une réponse à un avis

📊 Statut

• Changer le statut : Modifier le statut de la boîte de réception

Exemples d'utilisation

Récupérer des conversations

{
  "resource": "conversations",
  "operation": "getAll",
  "provider": "instagram"
}

Créer une note

{
  "resource": "notes",
  "operation": "create",
  "noteBody": {
    "content": "Nouvelle note de suivi client",
    "participantScreenNames": ["user1", "user2"],
    "participantAccountIds": ["123", "456"],
    "provider": "facebook"
  }
}

Publier un message

{
  "resource": "conversations",
  "operation": "postMessage",
  "messageBody": {
    "conversationId": "conv_123",
    "message": "Merci pour votre message !",
    "provider": "instagram"
  }
}

Développement

Prérequis

• Node.js ≥ 18.10
• pnpm ≥ 8.1

Installation des dépendances

pnpm install

Build

pnpm build

Développement en mode watch

pnpm dev

Linting et formatage

pnpm lint
pnpm format

Structure du projet

n8n-nodes-metricool-connector/
├── credentials/
│   └── MetricoolApi.credentials.ts
├── nodes/
│   └── Metricool/
│       ├── Metricool.node.ts
│       └── metricool-icon.svg
├── dist/                          # Fichiers compilés
├── package.json
├── tsconfig.json
└── README.md

API Endpoints supportés

Ce connecteur utilise l'API Metricool v2 :

• GET /v2/inbox/conversations
• POST /v2/inbox/conversations
• GET /v2/inbox/conversations/authorizations
• GET /v2/inbox/conversations/fetch-image
• GET /v2/inbox/notes
• POST /v2/inbox/notes
• PUT /v2/inbox/notes/{id}
• DELETE /v2/inbox/notes/{id}
• GET /v2/inbox/post-comments
• POST /v2/inbox/post-comments
• DELETE /v2/inbox/post-comments
• GET /v2/inbox/post-comments/authorizations
• POST /v2/inbox/reviews/replies
• DELETE /v2/inbox/reviews/replies
• PUT /v2/inbox/status

Contribution

Les contributions sont les bienvenues ! Veuillez :

• Fork le projet
• Créer une branche pour votre fonctionnalité
• Committer vos changements
• Pousser vers la branche
• Créer une Pull Request

Licence

Ce projet est sous licence MIT. Voir le fichier LICENSE pour plus de détails.

Support

Si vous rencontrez des problèmes :

• Vérifiez que vos credentials Metricool sont corrects
• Consultez les issues GitHub
• Créez une nouvelle issue si nécessaire

Liens utiles

• Documentation n8n
• API Metricool
• Créer des nodes n8n personnalisés

Développé avec ❤️ pour la communauté n8n