Guide 01 - Compte Tencent Docs & accès au document
Objectif : obtenir l'accès au document Tencent Docs et récupérer les identifiants techniques nécessaires au déclenchement (guide 03) et, en secours, à l'API (guide 02).
Le document cible :
https://docs.qq.com/sheet/DQ1lxSE5hQ1V3WlJhL'identifiant du fichier est la partie après/sheet/→DQ1lxSE5hQ1V3WlJh.
1. Prérequis
- Un compte Tencent / QQ / WeChat (nécessaire pour se connecter à
docs.qq.com). - L'accès en lecture au document, partagé par les collègues en Chine (en cours).
2. Obtenir l'accès en lecture au document
Demander au propriétaire du document (collègue en Chine) de partager le fichier :
- Ouvrir le document → bouton 分享 (Partager) en haut à droite.
- Ajouter votre compte, ou générer un lien de partage avec droit 可查看 (lecture seule).
- Vérifier que vous pouvez ouvrir le lien
https://docs.qq.com/sheet/DQ1lxSE5hQ1V3WlJhune fois connecté.
3. Récupérer les identifiants techniques du document
Ces valeurs serviront à cibler la bonne feuille dans HiFlow (guide 03) ou l'API (guide 02).
- Doc ID (文档ID) :
DQ1lxSE5hQ1V3WlJh(dans l'URL après/sheet/). - Feuille / onglet (sub_id / tab) : chaque onglet possède un identifiant, visible dans l'URL quand on clique sur un onglet (paramètre
tab=..., ex.tab=fb7j8n). Noter l'identifiant de chaque feuille de période (une par année/semestre) - à consigner dans la tablefeuille_source(ADR 0004).
4. Deux niveaux d'API Tencent Docs (selon le besoin)
Tencent expose le document via deux écosystèmes distincts - ne pas les confondre :
| Écosystème | Quand l'utiliser | Console |
|---|---|---|
| WeCom / 企业微信 (智能表格 API) | Si le doc est géré dans WeCom en Smart Sheet - pour le fallback polling | Voir guide 02 |
Tencent Docs Open Platform (open.docs.qq.com) |
Webhooks natifs / API publique Tencent Docs | https://open.docs.qq.com |
Pour le chemin principal (déclenchement cloud via HiFlow), aucune clé API n'est nécessaire : HiFlow se connecte au document via votre simple login Tencent → passez directement au guide 03.
5. Vérifications finales (checklist)
- Je peux ouvrir le document en lecture avec mon compte Tencent.
- J'ai noté le Doc ID
DQ1lxSE5hQ1V3WlJh. - J'ai noté l'identifiant de chaque feuille/période (
tab=...). - Je sais si le doc est un tableur classique ou un Smart Sheet (智能表格) - déterminant pour le fallback API (guide 02).
Ressources
- Tencent Docs : https://docs.qq.com
- Tencent Docs Open Platform : https://open.docs.qq.com
