Passer au contenu principal

Vue d’ensemble

Les nodes d’intégration connectent Draft & Goal à vos outils métier — CRM comme HubSpot, CMS comme WordPress, sources de données comme Google Sheets et BigQuery, et plus encore. Automatisez les flux de données entre les systèmes.

Intégrations disponibles

Google Suite

SEO Tools

CRM

Content Management

Web & Communication

Configurer les intégrations

Avant d’utiliser les nodes d’intégration, connectez vos comptes :
  1. Allez dans ParamètresIntégrations
  2. Cliquez sur Ajouter une intégration
  3. Sélectionnez le service (HubSpot, Google, WordPress, etc.)
  4. Complétez l’authentification OAuth ou saisissez les clés API
  5. L’intégration est disponible dans tous les workflows
Les intégrations sont au niveau de l’espace de travail. Configurez une fois, utilisez partout.

Intégrations OAuth (HubSpot, Google)

  1. Allez dans ParamètresIntégrations
  2. Cliquez sur Ajouter une intégration → Sélectionnez le service
  3. Cliquez sur Connecter (ex. « Se connecter avec HubSpot »)
  4. Autorisez l’accès chez le fournisseur
  5. L’intégration est prête

Intégrations par clé API (WordPress)

  1. Allez dans ParamètresIntégrations
  2. Cliquez sur Ajouter une intégrationWordPress
  3. Saisissez l’URL de votre site WordPress
  4. Ajoutez votre mot de passe d’application
  5. Testez la connexion

Intégration HubSpot

Ce que vous pouvez faire

ActionNode
Lister toutes les entreprisesHubSpot List Companies
Obtenir les détails d’une entrepriseHubSpot Get Company
Mettre à jour les propriétés d’une entrepriseHubSpot Update Company

Workflows courants

Enrichissement de leads Reporting CRM

Travailler avec les propriétés

HubSpot utilise des propriétés pour les données entreprise :
{
  "name": "Acme Inc",
  "domain": "acme.com",
  "industry": "Technology",
  "numberofemployees": "50-100",
  "custom_property": "value"
}
Mettez à jour les propriétés par nom :
{
  "industry": "SaaS",
  "lead_score": "85"
}

Intégration WordPress

Ce que vous pouvez faire

ActionNode
Créer des articlesWordPress Post Create
Créer des pagesWordPress Post Create (type: page)
Publier du contenuWordPress Post Create (status: publish)

Création d’article

Créer un nouvel article de blog : Entrée :
{
  "title": "My Blog Post",
  "content": "Post content in HTML...",
  "status": "draft",
  "categories": [1, 2],
  "tags": [5, 6],
  "featured_media": 123
}
Sortie :
{
  "id": 456,
  "link": "https://yoursite.com/my-blog-post",
  "status": "draft"
}

Workflow de contenu

Générer et publier du contenu :

Modèles courants

Enrichissement de données CRM

Automatisation de contenu

Synchronisation multi-plateforme

Lire → Traiter → Écrire

Le workflow de données le plus courant :

Agrégation multi-sources

Combiner des données de plusieurs sources :

Synchronisation planifiée

Garder les systèmes synchronisés automatiquement :
Planification : Tous les jours à 2 h
  → Lire depuis la source
  → Transformer
  → Écrire vers la destination
  → Enregistrer les résultats

Travailler avec Google Sheets

Lire les données

Le node Google Sheets renvoie des données structurées :
{
  "data": [
    {"name": "Alice", "email": "alice@example.com"},
    {"name": "Bob", "email": "bob@example.com"}
  ],
  "rows": 2,
  "columns": 2
}

Écrire les données

Écrire des tableaux de tableaux :
[
  ["Name", "Email", "Status"],
  ["Alice", "alice@example.com", "Active"],
  ["Bob", "bob@example.com", "Pending"]
]

Conseils pour Sheets

  • Utilisez les plages nommées pour des références stables
  • Incluez des en-têtes pour une sortie structurée
  • Utilisez la notation A1 pour les plages : Sheet1!A1:D100

Travailler avec BigQuery

Lire avec SQL

Écrivez des requêtes SQL standard :
SELECT 
  date,
  campaign,
  SUM(spend) as total_spend
FROM `project.dataset.table`
WHERE date >= DATE_SUB(CURRENT_DATE(), INTERVAL 7 DAY)
GROUP BY date, campaign
ORDER BY date DESC

Écrire les données

Indiquez la table et le mode d’écriture :
  • Append : Ajouter de nouvelles lignes
  • Truncate : Remplacer toutes les données
  • Write if empty : Écrire uniquement dans une table vide

Conseils pour BigQuery

  • Utilisez des requêtes paramétrées pour les valeurs dynamiques
  • Partitionnez les tables pour de meilleures performances
  • Définissez un timeout adapté pour les grosses requêtes

Authentification

Flux OAuth

Pour les intégrations OAuth (HubSpot, Google) :
  1. Draft & Goal redirige vers le fournisseur
  2. Vous autorisez l’accès
  3. Le fournisseur renvoie les jetons
  4. Les jetons sont stockés de manière sécurisée
Les jetons sont rafraîchis automatiquement.

Clés API

Pour les intégrations par clé API :
  1. Générez la clé dans la plateforme
  2. Ajoutez-la dans les intégrations Draft & Goal
  3. La clé est chiffrée au repos
Ne partagez jamais vos clés API. Traitez-les comme des mots de passe.

Bonnes pratiques

Gestion des erreurs

Gérez les erreurs API proprement :
Conditional :
  Si HubSpot_0.status == "error"
    → Enregistrer l'erreur
    → Réessayer ou alerter
  Sinon
    → Continuer le workflow

Erreurs courantes

ErreurCauseSolution
403 ForbiddenPas de permissionVérifier les scopes OAuth
404 Not FoundMauvais IDVérifier l’ID de feuille/table
Quota dépasséTrop de requêtesAjouter des délais, regrouper les requêtes
Plage invalideMauvaise notation A1Vérifier le format de la plage

Logique de nouvelle tentative

Pour les erreurs temporaires :
  1. Ajoutez un mécanisme de nouvelle tentative (3 essais)
  2. Attendez entre les tentatives (backoff exponentiel)
  3. Enregistrez les échecs pour analyse

Limitation du débit

Respectez les limites de débit des API :
PlateformeLimite
HubSpot100 requêtes / 10 secondes
WordPressVariable selon l’hébergeur
Google SheetsVariable selon le quota
Ajoutez des délais pour les opérations en masse.

Validation des données

Validez avant de mettre à jour le CRM ou d’écrire des données :
  • Vérifier les champs obligatoires
  • Vérifier le format des données
  • Confirmer que les ID existent
  • Gérer les données vides proprement

Utiliser les ID, pas les noms

Les noms de feuilles peuvent changer. Utilisez les ID :
❌ "Marketing Budget 2024"
✅ "1BxiMVs0XRA5nFMdKvBdBZjgmUUqptlbs74OgvE2upms"

Gérer les données vides

Vérifiez toujours les résultats vides :
Conditional :
  Si data.rows == 0
    → Gérer le cas vide
  Sinon
    → Traiter normalement

Valider avant d’écrire

Vérifiez la qualité des données avant d’écrire :
  • Champs obligatoires présents
  • Types de données corrects
  • Pas de doublons (si nécessaire)

Étapes suivantes