afrikyol/workyol

workyol은(는) 무엇을 하나요?

Workyol은 사용자의 컴퓨터에서 실행되는 프로그램입니다. Meta의 공식 플랫폼(WhatsApp Business Platform, Instagram, Messenger), LinkedIn API 및 (해당되는 경우) YouTube API와 함께 작동합니다. 이 스킬은 Workyol의 MCP 도구를 사용하는 방법을 설명합니다.

사용 시기

다음과 같은 경우에 이 스킬을 사용하세요:

• 옵트인한 연락처 목록에 WhatsApp 템플릿 캠페인을 보내야 할 때
• 읽지 않은 답변(WhatsApp, Instagram, Messenger)을 읽고 답장해야 할 때
• 키워드 자동 응답 또는 댓글-개인메시지 규칙을 추가해야 할 때
• Reels, 사진 또는 캐러셀(Instagram 및 Facebook), LinkedIn 게시물 또는 YouTube 동영상을 예약해야 할 때
• Workyol 설정 또는 번호를 확인해야 할 때

연락에 동의하지 않은 사람에게는 사용하지 마세요.

요구 사항

1. Workyol이 컴퓨터에 설치되어 실행 중이어야 합니다 (localhost:4747에서 열림).
2. Workyol의 MCP 서버가 이 어시스턴트에 연결되어 있어야 합니다 (README 참조: Workyol, Connections, AI assistants, Connect next to the app).

모든 세션의 첫 단계: check_setup (설정에서 완료된 것 / 누락된 것)과 get_overview (연락처, 메시지, 읽지 않은 답변, 대기 중인 게시물)을 호출하세요. 도구가 존재하지 않거나 "Workyol이 실행 중이 아닙니다"라고 응답하면 중단하고 사용자에게 Workyol을 시작하고 MCP 서버를 연결하라고 알리세요. 추측하지 마세요.

대부분의 도구는 선택적 account (이름, Facebook 페이지 또는 @instagram)를 사용합니다. 기본 계정이 사용됩니다. 여러 브랜드나 클라이언트가 있는 경우 먼저 list_accounts를 사용하세요.

도구

개요 및 설정

• list_accounts: 계정(브랜드/클라이언트)과 각각에 연결된 항목.
• get_overview: 연락처, 전송/배달/읽음 처리된 메시지, 읽지 않은 답변, 연결된 페이지/Instagram/WhatsApp, 대기 중인 게시물.
• check_setup: 설정에서 완료된 것과 누락된 것(라이센스, 라이브 모드, Meta 앱, WhatsApp, 페이지 + Instagram, 웹훅). 사용자에게 다음 단계를 알리는 데 사용합니다.
• quick_connect: 클라이언트의 Facebook 페이지(및 해당 Instagram)를 한 단계로 Workyol 계정에 연결합니다. 사용자가 Graph API Explorer에서 복사한 토큰을 사용합니다. 매개변수: token, name, business_type (general, dental, realestate, wholesale, restaurant, salon, school, none), page_id, language (en, fr, tr, ar, es), confirm. 미리 만들어진 자동화는 꺼진 상태로 추가됩니다.

받은 편지함

• list_replies: 사람들이 보낸 메시지, 최신순, 사람별로 그룹화. 매개변수: unread_only, limit.
• send_reply: 동일한 채널에서 한 사람에게 답장. 매개변수: channel (whatsapp, instagram, messenger), to (list_replies의 값), text, confirm. WhatsApp은 마지막 메시지로부터 24시간 이내에만 자유 텍스트가 허용됩니다.

자동화

• list_automations: 키워드 자동 응답 및 댓글-개인메시지 규칙.
• add_automation: 매개변수 type (auto_reply 또는 comment_to_dm), keywords, channel, reply (auto_reply), file_link (선택적 https 링크, 사진, 비디오, 오디오 또는 PDF), private_message 및 public_reply (comment_to_dm), name, confirm. 텍스트의 {name}은 사람의 이름이 됩니다.

WhatsApp 캠페인

• list_contact_lists: 비즈니스 연락에 동의한 사람들의 목록.
• list_templates: Meta가 승인한 WhatsApp 템플릿 (캠페인은 이 템플릿만 사용 가능), 변수 포함.
• list_campaigns: 전송/배달/읽음/실패 상태의 캠페인.
• create_campaign: 승인된 템플릿을 옵트인한 목록으로 보내거나 예약. 매개변수: list_id, template_name, template_language, name, mapping, scheduled_at, confirm. confirm 없이 호출하면 미리보기(수신자 수, 건너뛰는 사람 수 및 이유)를 반환합니다.

Instagram 및 Facebook 게시물

• list_posts: 예약 및 게시된 게시물 (status 필터: waiting, published, failed, all).
• schedule_post: Reel (video_path: 세로 MP4, 9:16, 최대 100 MB, 선택적 cover_path) 또는 사진 (image_paths: 1 = 사진, 2~10 = 캐러셀; Instagram은 JPG만 허용). 또한 caption (최대 2200자), at (시간대가 포함된 ISO 8601), platforms (instagram, facebook), from_workyol_com, confirm.
• import_content_plan: CSV 시트(열: date, time, caption, files, 선택적 channels)와 미디어가 포함된 폴더에서 전체 계획을 예약합니다. confirm 없이 호출하면 각 행을 상태와 함께 나열합니다. 행이 두 번 예약되지 않습니다.
• delete_post: 예약된 게시물을 제거합니다 (게시된 게시물은 온라인에 유지됨).

LinkedIn (사용자 자신의 프로필)

• linkedin_status: 연결 여부, 남은 액세스 일수 (60일, 이후 사용자가 재연결을 클릭해야 함), 대기 중인 게시물.
• linkedin_schedule_posts: 하나 이상의 게시물. 각각: text (최대 3000자, 일반 텍스트, 해시태그 허용), at, 선택적 media_path (JPG/PNG 사진 또는 MP4), 선택적 lang. 호출당 최대 60개 게시물.
• linkedin_list_posts: 예약, 게시 및 실패한 게시물.
• linkedin_delete_post: 예약된 게시물을 제거합니다 (게시된 게시물은 LinkedIn에 유지됨).

YouTube (이 라이센스에서 YouTube가 열려 있는 경우에만; 현재 작성 시점에서는 아직 고객에게 열려 있지 않으며, 도구는 "YouTube가 아직 열리지 않았습니다"라고 응답합니다)

• youtube_status, youtube_playlists, youtube_list, youtube_schedule (MP4/MOV, 최대 2 GB; 제목, 설명, 태그, publish_at, privacy, thumbnail_path, playlist, first_comment; 채널당 하루 3개 업로드, 추가 동영상은 다음 날로 대기), youtube_delete.

워크플로우

WhatsApp 캠페인 준비

1. check_setup 호출 후 list_contact_lists 및 list_templates 호출.
2. 사용자와 함께 목록과 승인된 템플릿을 선택합니다. 옵트인된 목록만 표시됩니다.
3. create_campaign을 confirm 없이 호출합니다. 미리보기 표시: 수신자, 건너뛰는 사람 및 이유.
4. 사용자가 동의한 경우에만 confirm: true와 함께 다시 호출합니다. 나중 시간을 원하면 scheduled_at을 제공합니다.
5. 나중에: list_campaigns로 전송/배달/읽음/실패 보고.

읽지 않은 답변에 답장

1. unread_only: true로 list_replies 호출.
2. 사람과 채널별로 요약. 각각에 대한 답변 초안 작성.
3. 모든 초안 표시. 사용자가 승인한 후에만 send_reply와 confirm: true로 각각 전송.
4. WhatsApp에서 마지막 메시지가 24시간보다 오래된 경우 자유 텍스트가 실패합니다. 템플릿이 필요하다고 사용자에게 알리세요.

키워드 자동 응답 또는 댓글-개인메시지 추가

1. 중복을 피하기 위해 list_automations 호출.
2. 규칙(키워드, 채널, 답변)을 표로 표시.
3. 동의 후 add_automation을 confirm: true로 호출.

일주일 분량의 Reels 예약

1. 비디오 파일, 캡션 및 시간(시간대 포함)을 물어봅니다.
2. list_posts로 이미 대기 중인 항목 확인.
3. 전체 일정 표시. 동의 후 각 게시물에 대해 schedule_post를 confirm: true로 호출합니다. 또는 CSV 시트가 있는 폴더의 경우 import_content_plan을 사용합니다 (먼저 미리보기).

한 달 분량의 LinkedIn 게시물 예약

1. linkedin_status: 연결되지 않았거나 남은 일수가 너무 적으면 Workyol에서 연결 또는 재연결하라고 알리세요.
2. 게시물을 일반 텍스트(마크다운이나 굵게 없음)로 작성합니다. 날짜와 함께 모두 표시.
3. 동의 후 linkedin_schedule_posts를 confirm: true로 호출.

안전 규칙 (항상 준수)

• 사용자가 동의할 때까지 아무것도 전송, 게시 또는 변경되지 않습니다. 먼저 confirm 없이 도구를 호출하고 요약을 표시한 후, 해당 작업에 대한 명확한 동의 후에만 confirm: true를 전달합니다.
• 옵트인된 목록만. 캠페인은 Workyol에서 옵트인 확인란이 선택된 연락처 목록으로만 전송됩니다. 어떤 도구도 전화번호를 추가할 수 없습니다. 요청하지 않은 사람에게 메시지를 보내지 마세요.
• 스팸 금지, 낯선 사람에게 대량 메시지 금지. STOP을 존중하세요: STOP이라고 답장한 사람은 Workyol이 건너뜁니다.
• 액세스 토큰, 앱 비밀 또는 라이센스 키를 볼 수 없습니다. 요청하지 마세요.
• Workyol 자체 규칙은 여전히 적용됩니다: 24시간 WhatsApp 창, 옵트아웃, 승인된 템플릿, 라이센스 제한, Meta의 일일 제한.
• Meta는 비즈니스가 Instagram 및 Messenger에서 먼저 메시지를 보낸 사람에게만 답장할 수 있도록 허용합니다. 해당 채널에는 캠페인이 없습니다.
• "금지 없음"과 같은 결과를 약속하지 마세요. Workyol이 공식 API를 사용한다고만 말하세요.

예시 프롬프트

• "내 Workyol 설정을 확인하고 무엇이 누락되었는지 알려줘."
• "읽지 않은 답변이 몇 개나 있어? 요약하고 답변 초안을 작성해줘."
• "승인된 템플릿 'order_ready'를 사용하여 'Customers 2026' 목록에 WhatsApp 캠페인을 준비해. 먼저 미리보기를 보여줘."
• "자동 응답을 추가해: 누군가 CATALOG라고 쓰면 이 텍스트로 답장하고 내 PDF를 보내줘."
• "누군가 내 게시물 아래에 PRICE라고 댓글을 달면, 가격표가 포함된 개인 메시지를 보내줘."
• "이 비디오 5개를 Instagram과 Facebook에 Reels로 예약해, 매일 18:00에 하나씩."
• "폴더 C:\plans\november에서 콘텐츠 계획을 가져오고 미리보기를 보여줘."
• "치과 진료에 관한 LinkedIn 게시물 12개를 예약해, 주에 2개씩, 먼저 보여줘."