DOC
Accueil/ Projets/ KOBIKE Tracking Notifier/ Guide 03 - Déclenchement cloud via Tencent HiFlow (腾讯轻联) → n8n

Guide 03 - Déclenchement cloud via Tencent HiFlow (腾讯轻联) → n8n

⛔ CADUC (2026-07-13). HiFlow abandonné (erreurs « get appid error » / connecteurs vides, jugé trop fragile). Chemin retenu : guide 07 - OpenAPI polling (Voie A). Guide conservé pour historique uniquement. Voir ADR 0001.

HiFlow (腾讯云 HiFlow 场景连接器 / « 腾讯轻联 ») est la plateforme d'automatisation officielle de Tencent (équivalent de Zapier/Make), avec un connecteur natif Tencent Docs.

Vue d'ensemble

Tencent Docs (feuille) --déclencheur HiFlow--> Action "Webhook / HTTP" --POST--> n8n (nœud Webhook)

1. Prérequis

2. Créer le nœud Webhook côté n8n (à faire en premier)

  1. Dans n8n, nouveau workflow → ajouter un nœud Webhook.
  2. Méthode : POST. Chemin : ex. /tencent-tracking.
  3. Sécuriser : ajouter un secret, au choix :
    • un segment aléatoire dans le chemin (/tencent-tracking/8f3k9x...), et/ou
    • un en-tête X-Webhook-Token: <secret> vérifié par un nœud IF en tête de workflow (rejeter si absent/incorrect).
  4. Copier l'URL de production du webhook (elle servira dans HiFlow).

3. Configurer le scénario HiFlow

  1. Se connecter à HiFlow → créer un scénario (流程).
  2. Déclencheur (触发) : choisir le connecteur 腾讯文档 (Tencent Docs) → événement « 当表格新增或修改一行 » (une ligne est ajoutée ou modifiée dans une feuille).
  3. Autoriser HiFlow à accéder à votre compte Tencent Docs (OAuth) et sélectionner le document DQ1lxSE5hQ1V3WlJh puis la feuille concernée.
    • ⚠️ Le déclencheur se configure par feuille. Pour chaque nouvelle feuille de période, créer un scénario équivalent (ou dupliquer) → voir gestion multi-feuilles (ADR 0004).
  4. Action : choisir « Webhook » / « 发送 HTTP 请求 » (envoyer une requête HTTP).
    • Méthode : POST
    • URL : l'URL du webhook n8n (étape 2)
    • En-tête : X-Webhook-Token: <secret> (si utilisé) + Content-Type: application/json
    • Corps : mapper les colonnes de la ligne déclenchée vers un JSON, en particulier Platform order number, Logistics tracking number, Customer email, Name, etc.

4. Exemple de payload attendu côté n8n

{
  "numero_commande": "KO260107-1",
  "tracking_number": "DG021887687500028",
  "email": "",
  "nom": "David Cerqueira",
  "telephone": "617014180",
  "pays": "FR",
  "sku": "AN1A-EU",
  "produit": "N1 AIR-GR（油刹）",
  "date_expedition": "2026/1/7",
  "entrepot": "米宝",
  "periode": "2026011",
  "feuille": "fb7j8n"
}

5. Tester

  1. Activer le workflow n8n (mode production).
  2. Dans HiFlow, utiliser « 测试 » (tester) le scénario, ou modifier une ligne de test dans le document.
  3. Vérifier la réception dans l'exécution n8n. Contrôler que le secret est bien validé.

6. Bonnes pratiques

  • Idempotence : n8n doit rester anti-doublon même si HiFlow renvoie deux fois le même événement → contrainte UNIQUE (numero_commande, tracking_number) + ON CONFLICT DO NOTHING (ADR 0004).
  • Filtrer tôt : ignorer les événements où tracking_number est vide (ne rien envoyer).
  • Journalisation : loguer chaque payload reçu (table technique ou nœud n8n) pour audit.
  • Quotas HiFlow : surveiller le plan tarifaire si le volume d'événements grimpe.

Checklist

  • Webhook n8n créé, sécurisé par un secret, en mode production.
  • n8n exposé en HTTPS public via Coolify.
  • Scénario HiFlow relié au bon document + bonne feuille.
  • Payload JSON mappé avec les colonnes clés.
  • Test bout-en-bout réussi (modif ligne → exécution n8n).

Ressources