afrikyol/workyol

Was macht workyol?

Workyol ist ein Programm, das auf dem eigenen Computer der Person läuft. Es arbeitet mit den offiziellen Plattformen von Meta (WhatsApp Business Platform, Instagram, Messenger), mit der LinkedIn-API und, wo geöffnet, mit der YouTube-API. Dieser Skill erklärt, wie man die MCP-Tools verwendet.

Wann verwenden

Verwenden Sie diesen Skill, wenn die Person Folgendes möchte:

• eine WhatsApp-Vorlagenkampagne an eine Kontaktliste senden, die zugestimmt hat (Opt-in);
• ungelesene Antworten lesen (WhatsApp, Instagram, Messenger) und beantworten;
• Keyword-Auto-Antworten oder Comment-to-Private-Message-Regeln hinzufügen;
• Reels, Fotos oder Karussells (Instagram und Facebook), LinkedIn-Beiträge oder YouTube-Videos planen;
• ihren Workyol-Setup oder ihre Nummern überprüfen.

Nicht verwenden für Personen, die nicht zugestimmt haben, kontaktiert zu werden.

Voraussetzung

1. Workyol ist installiert und läuft auf dem Computer (es öffnet sich unter localhost:4747).
2. Der MCP-Server von Workyol ist mit diesem Assistenten verbunden (siehe README: In Workyol, Verbindungen, KI-Assistenten, neben der App auf "Verbinden" klicken).

Erster Schritt in jeder Sitzung: Rufen Sie check_setup auf (was ist erledigt / fehlt im Setup) und get_overview (Kontakte, Nachrichten, ungelesene Antworten, wartende Beiträge). Wenn die Tools nicht existieren oder mit "Workyol läuft nicht" antworten, stoppen Sie und sagen Sie der Person, sie solle Workyol starten und den MCP-Server verbinden. Nicht raten.

Die meisten Tools akzeptieren ein optionales account (Name, Facebook-Seite oder @instagram); ohne Angabe wird das Standardkonto verwendet. Verwenden Sie list_accounts zuerst, wenn es mehrere Marken oder Kunden gibt.

Tools

Übersicht und Setup

• list_accounts: Die Konten (Marken/Kunden) und was jedes verbunden hat.
• get_overview: Kontakte, gesendete/zugestellte/gelesene Nachrichten, ungelesene Antworten, verbundene Seite/Instagram/WhatsApp, wartende Beiträge.
• check_setup: Was erledigt ist und was im Setup fehlt (Lizenz, Live-Modus, Meta-App, WhatsApp, Seite + Instagram, Webhooks). Verwenden Sie es, um der Person den nächsten Schritt zu sagen.
• quick_connect: Verbinden Sie die Facebook-Seite eines Kunden (und deren Instagram) in einem Schritt als Workyol-Konto, mit einem Token, das die Person im Graph API Explorer kopiert hat. Parameter: token, name, business_type (general, dental, realestate, wholesale, restaurant, salon, school, none), page_id, language (en, fr, tr, ar, es), confirm. Vorgefertigte Automatisierungen werden hinzugefügt, aber AUSgeschaltet.

Posteingang

• list_replies: Nachrichten, die Personen gesendet haben, neueste zuerst, gruppiert nach Person. Parameter: unread_only, limit.
• send_reply: Eine Person auf demselben Kanal antworten. Parameter: channel (whatsapp, instagram, messenger), to (der Wert aus list_replies), text, confirm. WhatsApp erlaubt Freitext nur innerhalb von 24 Stunden nach der letzten Nachricht der Person.

Automatisierungen

• list_automations: Keyword-Auto-Antworten und Comment-to-DM-Regeln.
• add_automation: Parameter type (auto_reply oder comment_to_dm), keywords, channel, reply (auto_reply), file_link (optionaler https-Link zu einem Bild, Video, Audio oder PDF), private_message und public_reply (comment_to_dm), name, confirm. {name} im Text wird durch den Namen der Person ersetzt.

WhatsApp-Kampagnen

• list_contact_lists: Listen von Personen, die zugestimmt haben, vom Unternehmen gehört zu werden.
• list_templates: Von Meta genehmigte WhatsApp-Vorlagen (Kampagnen können nur diese verwenden), mit Variablen.
• list_campaigns: Kampagnen mit gesendet/zugestellt/gelesen/fehlgeschlagen.
• create_campaign: Eine genehmigte Vorlage an eine Opt-in-Liste senden oder planen. Parameter: list_id, template_name, template_language, name, mapping, scheduled_at, confirm. Ohne confirm wird eine Vorschau zurückgegeben (wie viele erhalten sie, wie viele werden übersprungen und warum).

Instagram- und Facebook-Beiträge

• list_posts: Geplante und veröffentlichte Beiträge (Filter status: waiting, published, failed, all).
• schedule_post: Ein Reel (video_path: vertikales MP4, 9:16, max. 100 MB, optionales cover_path) oder Bilder (image_paths: 1 = Foto, 2 bis 10 = Karussell; Instagram akzeptiert nur JPG). Auch caption (max. 2200 Zeichen), at (ISO 8601 mit Zeitzone), platforms (instagram, facebook), from_workyol_com, confirm.
• import_content_plan: Einen ganzen Plan aus einem Ordner mit einer CSV-Tabelle (Spalten: Datum, Uhrzeit, Bildunterschrift, Dateien, optionale Kanäle) und den Mediendateien planen. Ohne confirm wird jede Zeile mit ihrem Status aufgelistet. Eine Zeile wird niemals zweimal geplant.
• delete_post: Einen geplanten Beitrag entfernen (ein veröffentlichter bleibt online).

LinkedIn (eigenes Profil der Person)

• linkedin_status: Verbunden oder nicht, verbleibende Zugriffstage (60 Tage, dann muss die Person auf "Erneut verbinden" klicken), wartende Beiträge.
• linkedin_schedule_posts: Einen oder mehrere Beiträge planen. Jeder: text (max. 3000 Zeichen, Klartext, Hashtags erlaubt), at, optionales media_path (JPG/PNG-Bild oder MP4), optionales lang. Max. 60 Beiträge pro Aufruf.
• linkedin_list_posts: Geplante, veröffentlichte und fehlgeschlagene Beiträge.
• linkedin_delete_post: Einen geplanten Beitrag entfernen (ein veröffentlichter bleibt auf LinkedIn).

YouTube (nur wo YouTube für diese Lizenz geöffnet ist; zum Zeitpunkt der Erstellung ist es für Kunden noch nicht geöffnet, und die Tools antworten dann mit "YouTube ist noch nicht geöffnet")

• youtube_status, youtube_playlists, youtube_list, youtube_schedule (MP4/MOV bis zu 2 GB; Titel, Beschreibung, Tags, publish_at, privacy, thumbnail_path, playlist, first_comment; 3 Uploads pro Tag pro Kanal, zusätzliche Videos warten auf den nächsten Tag), youtube_delete.

Arbeitsabläufe

Eine WhatsApp-Kampagne vorbereiten

1. check_setup, dann list_contact_lists und list_templates.
2. Wählen Sie die Liste und eine genehmigte Vorlage mit der Person aus. Es werden nur Listen mit Opt-in angezeigt.
3. Rufen Sie create_campaign ohne confirm auf. Zeigen Sie die Vorschau: wer sie erhält, wer übersprungen wird und warum.
4. Nur wenn die Person zustimmt, rufen Sie es erneut mit confirm: true auf. Bieten Sie scheduled_at an, falls sie einen späteren Zeitpunkt wünscht.
5. Später: list_campaigns, um über gesendet/zugestellt/gelesen/fehlgeschlagen zu berichten.

Ungelesene Antworten beantworten

1. list_replies mit unread_only: true.
2. Fassen Sie nach Person und Kanal zusammen. Entwerfen Sie für jede eine Antwort.
3. Zeigen Sie jeden Entwurf. Senden Sie jeden mit send_reply und confirm: true nur, nachdem die Person ihn genehmigt hat.
4. Bei WhatsApp: Wenn die letzte Nachricht älter als 24 Stunden ist, schlägt ein Freitext fehl. Sagen Sie der Person, dass eine Vorlage benötigt wird.

Eine Keyword-Auto-Antwort oder Comment-to-DM hinzufügen

1. list_automations, um Duplikate zu vermeiden.
2. Zeigen Sie die Regel (Keywords, Kanal, Antwort) als Tabelle.
3. Nach einer Zustimmung: add_automation mit confirm: true.

Eine Woche Reels planen

1. Fragen Sie nach den Videodateien, Bildunterschriften und Zeiten (mit Zeitzone).
2. list_posts, um zu sehen, was bereits wartet.
3. Zeigen Sie den vollständigen Zeitplan. Nach einer Zustimmung: Rufen Sie schedule_post für jeden Beitrag mit confirm: true auf. Oder, für einen Ordner mit einer CSV-Tabelle, verwenden Sie import_content_plan (zuerst Vorschau).

Einen Monat LinkedIn-Beiträge planen

1. linkedin_status: Wenn nicht verbunden, oder zu wenige Tage übrig, sagen Sie der Person, sie solle sich in Workyol verbinden oder erneut verbinden.
2. Verfassen Sie die Beiträge in Klartext (kein Markdown oder Fettdruck). Zeigen Sie sie alle mit ihren Daten.
3. Nach einer Zustimmung: linkedin_schedule_posts mit confirm: true.

Sicherheitsregeln (immer befolgen)

• Nichts wird gesendet, veröffentlicht oder geändert, bis die Person zustimmt. Rufen Sie das Tool zuerst ohne confirm auf, zeigen Sie die Zusammenfassung, und übergeben Sie confirm: true nur nach einer eindeutigen Zustimmung zu dieser genauen Aktion.
• Nur Opt-in-Listen. Kampagnen gehen nur an Kontaktlisten, die in Workyol mit aktiviertem Opt-in-Kästchen importiert wurden. Kein Tool kann Telefonnummern hinzufügen. Niemanden kontaktieren, der nicht gefragt hat.
• Kein Spam, keine Massennachrichten an Fremde. STOP respektieren: Personen, die mit STOP antworten, werden von Workyol übersprungen.
• Sie sehen niemals Zugriffstoken, das App-Geheimnis oder den Lizenzschlüssel. Fragen Sie nicht danach.
• Workyols eigene Regeln gelten weiterhin: das 24-Stunden-WhatsApp-Fenster, Opt-outs, genehmigte Vorlagen, Lizenzlimits und Metas tägliche Limits.
• Meta erlaubt einem Unternehmen nur, Personen zu antworten, die zuerst auf Instagram und Messenger geschrieben haben. Es gibt keine Kampagnen auf diesen Kanälen.
• Versprechen Sie keine Ergebnisse wie "kein Bann". Sagen Sie nur, dass Workyol die offiziellen APIs verwendet.

Beispielaufforderungen

• "Überprüfe mein Workyol-Setup und sag mir, was fehlt."
• "Wie viele ungelesene Antworten habe ich? Fasse sie zusammen und entwirf Antworten."
• "Bereite eine WhatsApp-Kampagne mit der genehmigten Vorlage 'order_ready' für meine Liste 'Kunden 2026' vor. Zeig mir zuerst die Vorschau."
• "Füge eine Auto-Antwort hinzu: Wenn jemand KATALOG schreibt, antworte mit diesem Text und sende mein PDF."
• "Wenn jemand PREIS unter meinem Beitrag kommentiert, sende ihnen eine private Nachricht mit unseren Preisen."
• "Plane diese 5 Videos als Reels auf Instagram und Facebook, eines pro Tag um 18:00 Uhr."
• "Importiere den Inhaltsplan aus dem Ordner C:\plaene\november und zeig mir die Vorschau."
• "Plane 12 LinkedIn-Beiträge zum Thema Zahnpflege, zwei pro Woche, und zeig sie mir zuerst."