afrikyol/workyol

Que fait workyol ?

Workyol est un programme qui s'exécute sur l'ordinateur de l'utilisateur. Il fonctionne avec les plateformes officielles de Meta (WhatsApp Business Platform, Instagram, Messenger), avec l'API de LinkedIn et, là où YouTube est ouvert, avec l'API de YouTube. Cette compétence vous indique comment utiliser ses outils MCP.

Quand l'utiliser

Utilisez cette compétence lorsque la personne souhaite :

• envoyer une campagne de modèles WhatsApp à une liste de contacts ayant donné leur consentement (opt-in) ;
• lire les réponses non lues (WhatsApp, Instagram, Messenger) et y répondre ;
• ajouter des réponses automatiques par mots-clés, ou des règles de commentaire vers message privé ;
• planifier des Reels, photos ou carrousels (Instagram et Facebook), des publications LinkedIn ou des vidéos YouTube ;
• vérifier leur configuration Workyol ou leurs numéros.

Ne l'utilisez pas pour des personnes qui n'ont pas accepté d'être contactées.

Prérequis

1. Workyol est installé et en cours d'exécution sur l'ordinateur (il est accessible à l'adresse localhost:4747).
2. Le serveur MCP de Workyol est connecté à cet assistant (voir README : dans Workyol, Connexions, Assistants IA, Connecter à côté de l'application).

Première étape dans chaque session : appelez check_setup (ce qui est fait / manquant dans Configuration) et get_overview (contacts, messages, réponses non lues, publications en attente). Si les outils n'existent pas ou répondent "Workyol ne tourne pas", arrêtez-vous et dites à la personne de démarrer Workyol et de connecter le serveur MCP. Ne faites pas de suppositions.

La plupart des outils acceptent un paramètre optionnel account (nom, Page Facebook ou @instagram) ; sans celui-ci, le compte par défaut est utilisé. Utilisez list_accounts en premier lorsqu'il y a plusieurs marques ou clients.

Outils

Aperçu et configuration

• list_accounts : les comptes (marques/clients) et ce que chacun a de connecté.
• get_overview : contacts, messages envoyés/délivrés/lus, réponses non lues, Page/Instagram/WhatsApp connectés, publications en attente.
• check_setup : ce qui est fait et ce qui manque dans Configuration (licence, mode live, application Meta, WhatsApp, Page + Instagram, webhooks). Utilisez-le pour indiquer à la personne la prochaine étape.
• quick_connect : connecter la Page Facebook d'un client (et son Instagram) en tant que compte Workyol en une seule étape, à partir d'un jeton que la personne a copié dans Graph API Explorer. Paramètres : token, name, business_type (general, dental, realestate, wholesale, restaurant, salon, school, none), page_id, language (en, fr, tr, ar, es), confirm. Des automatisations prêtes à l'emploi sont ajoutées mais désactivées.

Boîte de réception

• list_replies : messages envoyés par les personnes, du plus récent au plus ancien, regroupés par personne. Paramètres : unread_only, limit.
• send_reply : répondre à une personne sur le même canal. Paramètres : channel (whatsapp, instagram, messenger), to (la valeur de list_replies), text, confirm. WhatsApp autorise le texte libre uniquement dans les 24 heures suivant le dernier message de la personne.

Automatisations

• list_automations : réponses automatiques par mots-clés et règles de commentaire vers MP.
• add_automation : paramètres type (auto_reply ou comment_to_dm), keywords, channel, reply (auto_reply), file_link (lien https optionnel vers une image, vidéo, audio ou PDF), private_message et public_reply (comment_to_dm), name, confirm. {name} dans un texte devient le prénom de la personne.

Campagnes WhatsApp

• list_contact_lists : listes de personnes qui ont accepté d'être contactées par l'entreprise.
• list_templates : modèles WhatsApp approuvés par Meta (les campagnes ne peuvent utiliser que ceux-ci), avec variables.
• list_campaigns : campagnes avec envoyés / délivrés / lus / échoués.
• create_campaign : envoyer ou programmer un modèle approuvé à une liste opt-in. Paramètres : list_id, template_name, template_language, name, mapping, scheduled_at, confirm. Sans confirm, il renvoie un aperçu (combien le reçoivent, combien sont ignorés et pourquoi).

Publications Instagram et Facebook

• list_posts : publications programmées et publiées (filtre status : waiting, published, failed, all).
• schedule_post : un Reel (video_path : MP4 vertical, 9:16, max 100 Mo, optionnel cover_path) ou des images (image_paths : 1 = photo, 2 à 10 = carrousel ; Instagram accepte uniquement JPG). Également caption (max 2200 caractères), at (ISO 8601 avec fuseau horaire), platforms (instagram, facebook), from_workyol_com, confirm.
• import_content_plan : planifier un plan complet à partir d'un dossier avec une feuille CSV (colonnes date, time, caption, files, canaux optionnels) et les médias. Sans confirm, il liste chaque ligne avec son statut. Une ligne n'est jamais programmée deux fois.
• delete_post : supprimer une publication programmée (une publication déjà publiée reste en ligne).

LinkedIn (propre profil de la personne)

• linkedin_status : connecté ou non, jours d'accès restants (60 jours, puis la personne clique sur Reconnecter), publications en attente.
• linkedin_schedule_posts : une ou plusieurs publications. Chacune : text (max 3000 caractères, texte brut, hashtags autorisés), at, media_path optionnel (image JPG/PNG ou MP4), lang optionnel. Max 60 publications par appel.
• linkedin_list_posts : publications programmées, publiées et échouées.
• linkedin_delete_post : supprimer une publication programmée (une publication publiée reste sur LinkedIn).

YouTube (uniquement là où YouTube est ouvert pour cette licence ; au moment de la rédaction, il n'est pas encore ouvert aux clients, et les outils répondent alors "YouTube n'est pas encore ouvert")

• youtube_status, youtube_playlists, youtube_list, youtube_schedule (MP4/MOV jusqu'à 2 Go ; titre, description, tags, publish_at, privacy, thumbnail_path, playlist, first_comment ; 3 uploads par jour par chaîne, les vidéos supplémentaires attendent le lendemain), youtube_delete.

Flux de travail

Préparer une campagne WhatsApp

1. check_setup, puis list_contact_lists et list_templates.
2. Choisissez la liste et un modèle approuvé avec la personne. Seules les listes avec opt-in sont affichées.
3. Appelez create_campaign sans confirm. Montrez l'aperçu : qui la reçoit, qui est ignoré et pourquoi.
4. Uniquement si la personne dit oui, appelez-la à nouveau avec confirm: true. Proposez scheduled_at si elle souhaite une heure ultérieure.
5. Plus tard : list_campaigns pour faire le rapport des envoyés / délivrés / lus / échoués.

Répondre aux réponses non lues

1. list_replies avec unread_only: true.
2. Résumez par personne et par canal. Rédigez une réponse pour chacune.
3. Montrez chaque brouillon. Envoyez chacun avec send_reply et confirm: true uniquement après l'approbation de la personne.
4. Sur WhatsApp, si le dernier message date de plus de 24 heures, un texte libre échouera : dites à la personne qu'un modèle est nécessaire.

Ajouter une réponse automatique par mot-clé ou un commentaire vers MP

1. list_automations pour éviter les doublons.
2. Montrez la règle (mots-clés, canal, réponse) sous forme de tableau.
3. Après un oui, add_automation avec confirm: true.

Planifier une semaine de Reels

1. Demandez les fichiers vidéo, légendes et horaires (avec fuseau horaire).
2. list_posts pour voir ce qui est déjà en attente.
3. Montrez le planning complet. Après un oui, appelez schedule_post pour chaque publication avec confirm: true. Ou, pour un dossier avec une feuille CSV, utilisez import_content_plan (aperçu d'abord).

Planifier un mois de publications LinkedIn

1. linkedin_status : si non connecté, ou s'il reste trop peu de jours, dites à la personne de se connecter ou de se reconnecter dans Workyol.
2. Rédigez les publications en texte brut (pas de markdown ni de gras). Montrez-les toutes avec leurs dates.
3. Après un oui, linkedin_schedule_posts avec confirm: true.

Règles de sécurité (suivez-les toujours)

• Rien n'est envoyé, publié ou modifié avant que la personne ne dise oui. Appelez l'outil sans confirm d'abord, montrez le résumé, et passez confirm: true seulement après un oui clair à cette action précise.
• Listes opt-in uniquement. Les campagnes vont uniquement vers les listes de contacts importées dans Workyol avec la case d'opt-in cochée. Aucun outil ne peut ajouter des numéros de téléphone. Ne messagerez jamais des personnes qui n'ont pas demandé.
• Pas de spam, pas de messages en masse à des inconnus. Respectez STOP : les personnes qui répondent STOP sont ignorées par Workyol.
• Vous ne voyez jamais les jetons d'accès, le secret de l'application ou la clé de licence. Ne les demandez pas.
• Les propres règles de Workyol s'appliquent toujours : la fenêtre WhatsApp de 24 heures, les désinscriptions, les modèles approuvés, les limites de licence et les limites quotidiennes de Meta.
• Meta autorise uniquement une entreprise à répondre aux personnes qui ont écrit en premier sur Instagram et Messenger. Il n'y a pas de campagnes sur ces canaux.
• Ne promettez pas de résultats comme "pas de bannissement". Dites seulement que Workyol utilise les API officielles.

Exemples de prompts

• "Vérifie ma configuration Workyol et dis-moi ce qui manque."
• "Combien de réponses non lues ai-je ? Résume-les et rédige des réponses."
• "Prépare une campagne WhatsApp avec le modèle approuvé 'order_ready' pour ma liste 'Clients 2026'. Montre-moi l'aperçu d'abord."
• "Ajoute une réponse automatique : quand quelqu'un écrit CATALOG, réponds avec ce texte et envoie mon PDF."
• "Quand quelqu'un commente PRIX sous ma publication, envoie-lui un message privé avec nos prix."
• "Planifie ces 5 vidéos en tant que Reels sur Instagram et Facebook, une chaque jour à 18h00."
• "Importe le plan de contenu depuis le dossier C:\plans\novembre et montre-moi l'aperçu."
• "Planifie 12 publications LinkedIn sur les soins dentaires, deux par semaine, et montre-les-moi d'abord."