Que fait wecomcli-get-msg ?
Compétence pour les messages WeCom (WeChat Entreprise). Fournit les capacités de lister les sessions de chat, de récupérer les historiques de messages (texte, image, fichier, audio, vidéo), d'obtenir les fichiers multimédia et d'envoyer des messages texte. Déclenchée lorsque l'utilisateur a besoin de "voir les messages", "consulter l'historique", "envoyer un message à quelqu'un", "avoir les derniers messages", "envoyer un message dans un groupe", "voir les images/fichiers envoyés".
Contexte
- Nom de l'outil : wecomcli
- Description : Outil CLI pour interagir avec l'API WeCom. Capable de récupérer les historiques de messages, d'envoyer des messages, etc. Ne pas confondre avec les APIs d'autres plateformes (comme DingTalk, Lark).
Référence des API
Liste des sessions de chat
Commande : wecomcli conversation list
Description : Liste toutes les sessions de chat
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| appid | string | Oui | App ID WeCom |
| secret | string | Oui | Secret WeCom |
Résultat :
{
"chat_id": "wrAbc123...",
"name": "Groupe de développement",
"owner": "userid1",
"member_list": ["userid1", "userid2"]
}
Récupération de l'historique des messages
Commande : wecomcli message get-history
Description : Récupère l'historique des messages d'une session. Supporte l'extraction de messages texte, image, fichier, audio et vidéo.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| appid | string | Oui | App ID WeCom |
| secret | string | Oui | Secret WeCom |
| chatid | string | Non | Si non renseigné, récupère les messages de toutes les sessions. Pour une session spécifique, fournir le chat_id |
| limit | int | Non | Nombre de messages à récupérer. Par défaut 100, maximum 1000 |
Résultat :
{
"msgid": "1234567890...",
"msgtype": "text",
"content": "bonjour tout le monde",
"sender": "userid1",
"send_time": 1700000000,
"chatid": "wr..."
}
Note : Le paramètre limit ne nécessite pas de guillemets.
Marquage des messages comme lus
Commande : wecomcli message mark-read
Description : Marque les messages d'une session comme lus.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| appid | string | Oui | App ID WeCom |
| secret | string | Oui | Secret WeCom |
| chatid | string | Oui | ID de la session de chat |
Envoi de message texte
Commande : wecomcli message send-text
Description : Envoie un message texte à une session.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| appid | string | Oui | App ID WeCom |
| secret | string | Oui | Secret WeCom |
| chatid | string | Oui | ID de la session de chat |
| message | string | Oui | Contenu du message texte |
Téléchargement de fichier multimédia
Commande : wecomcli media get
Description : Télécharge un fichier multimédia (image, fichier, audio, vidéo) depuis le serveur de WeCom.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| appid | string | Oui | App ID WeCom |
| secret | string | Oui | Secret WeCom |
| msgid | string | Oui | ID du message |
| mediaid | string | Oui | ID du fichier multimédia |
Remarque : Les paramètres msgid et mediaid sont extraits du résultat de la récupération de l'historique des messages.