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

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

Configuration

Credentials Metricool API

Pour utiliser ce connecteur, vous aurez besoin de :

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

Comment obtenir vos credentials

1. Connectez-vous à votre compte Metricool
2. Allez dans Paramètres du compte
3. Trouvez votre User Token dans la section API
4. Notez votre User ID
5. 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 :

1. Fork le projet
2. Créer une branche pour votre fonctionnalité
3. Committer vos changements
4. Pousser vers la branche
5. 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 :

1. Vérifiez que vos credentials Metricool sont corrects
2. Consultez les issues GitHub
3. 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