Hermes Agent với Facebook, Instagram và Meta Ads

hermes -p ads mcp list          # thấy meta-ads
hermes -p ads mcp test meta-ads    # kiểm tra kết nối
hermes gateway restart

hermes -p ads config set META_AD_ACCOUNT act_<số tài khoản quảng cáo>

mkdir -p ~/.hermes/profiles/ads/skills/marketing/meta-ads-bao-cao
cat > ~/.hermes/profiles/ads/skills/marketing/meta-ads-bao-cao/SKILL.md <<'EOF'
---
name: meta-ads-bao-cao
description: Lấy số liệu Meta Ads qua Marketing API v26.0, phân tích và đề xuất — chỉ đọc, được tạm dừng khi chủ duyệt.
required_environment_variables:
  - name: META_ADS_TOKEN
    prompt: Token người dùng hệ thống (quyền ads_read)
  - name: META_AD_ACCOUNT
    prompt: ID tài khoản quảng cáo dạng act_123
---
# Meta Ads – báo cáo
G=https://graph.facebook.com/v26.0 ; gửi token bằng -H "Authorization: Bearer $META_ADS_TOKEN"
- Hôm qua theo chiến dịch: curl -s "$G/$META_AD_ACCOUNT/insights?level=campaign&date_preset=yesterday&fields=campaign_name,spend,impressions,reach,clicks,ctr,cpc,cpm,actions,cost_per_action_type" -H "Authorization: Bearer $META_ADS_TOKEN"
- 7 ngày: thay date_preset=last_7d ; khoảng tuỳ chọn: time_range={"since":"YYYY-MM-DD","until":"YYYY-MM-DD"}
- Danh sách chiến dịch: curl -s "$G/$META_AD_ACCOUNT/campaigns?fields=id,name,status,effective_status,daily_budget,lifetime_budget,objective" -H "Authorization: Bearer $META_ADS_TOKEN"
- Tiền VND: daily_budget=500000 nghĩa là 500.000đ (VND không có đơn vị lẻ).
- Tạm dừng 1 chiến dịch (CHỈ khi chủ trả lời "DUYỆT TẠM DỪNG <tên>"): curl -s -X POST "$G/<campaign_id>" -H "Authorization: Bearer $META_ADS_TOKEN" -d status=PAUSED
QUY TẮC BẮT BUỘC
1. Không bao giờ bật (ACTIVE) quảng cáo, không tăng ngân sách, không tạo chiến dịch — chỉ đề xuất để chủ tự làm trong Trình quản lý quảng cáo.
2. Mọi số liệu ghi rõ khoảng ngày và đơn vị; không đoán số.
EOF

hermes -p content config set META_PAGE_ID <ID Fanpage>
read -rsp "Dán token người dùng hệ thống rồi Enter: " SU; echo
T=$(curl -s "https://graph.facebook.com/v26.0/<ID Fanpage>?fields=access_token" -H "Authorization: Bearer $SU" | python3 -c 'import sys,json; print(json.load(sys.stdin).get("access_token",""))')
[ -n "$T" ] && hermes -p content config set META_PAGE_TOKEN "$T" && echo "Đã lưu token Fanpage" || echo "Không lấy được token — kiểm tra quyền và ID Fanpage"
unset SU T

mkdir -p ~/.hermes/profiles/content/skills/social-media/meta-fanpage
cat > ~/.hermes/profiles/content/skills/social-media/meta-fanpage/SKILL.md <<'EOF'
---
name: meta-fanpage
description: Đăng bài, hẹn giờ đăng, đọc và trả lời bình luận Fanpage qua Graph API v26.0 — luôn chờ chủ duyệt.
required_environment_variables:
  - name: META_PAGE_ID
    prompt: ID Fanpage
  - name: META_PAGE_TOKEN
    prompt: Page access token
---
# Fanpage qua Graph API
Dùng: G=https://graph.facebook.com/v26.0 và gửi token bằng header -H "Authorization: Bearer $META_PAGE_TOKEN".
Không đưa token vào URL, không in token ra màn hình hay tin nhắn.
- Đăng bài chữ/link: curl -s -X POST "$G/$META_PAGE_ID/feed" -H "Authorization: Bearer $META_PAGE_TOKEN" --data-urlencode "message=..." [--data-urlencode "link=..."]
- Đăng ảnh: curl -s -X POST "$G/$META_PAGE_ID/photos" -H "Authorization: Bearer $META_PAGE_TOKEN" --data-urlencode "url=<link ảnh>" --data-urlencode "caption=..."
- Hẹn giờ: thêm -d published=false -d scheduled_publish_time=<unix time>, trong khoảng 10 phút tới 30 ngày
- 10 bài gần nhất: curl -s "$G/$META_PAGE_ID/posts?fields=id,message,created_time&limit=10" -H "Authorization: Bearer $META_PAGE_TOKEN"
- Bình luận của bài: curl -s "$G/<post_id>/comments?fields=id,from,message,created_time" -H "Authorization: Bearer $META_PAGE_TOKEN"
- Trả lời bình luận: curl -s -X POST "$G/<comment_id>/comments" -H "Authorization: Bearer $META_PAGE_TOKEN" --data-urlencode "message=..."
QUY TẮC BẮT BUỘC
1. Mọi bài đăng và trả lời công khai: gửi bản nháp cho chủ trước, chỉ đăng khi chủ trả lời "DUYỆT".
2. Không xoá bài, không ẩn/xoá bình luận nếu chủ không yêu cầu rõ ràng.
3. Không bịa giá, khuyến mãi, cam kết; không dùng từ ngữ vi phạm chính sách quảng cáo.
EOF

hermes gateway restart

mkdir -p ~/.config && (umask 077; touch ~/.config/meta-bridge.env)
for K in APP_SECRET PAGE_TOKEN; do read -rsp "Dán $K rồi Enter (chữ không hiện): " V; echo; echo "$K=$V" >> ~/.config/meta-bridge.env; done; unset V
echo "PAGE_ID=<ID Fanpage>" >> ~/.config/meta-bridge.env
echo "VERIFY_TOKEN=$(openssl rand -hex 16)" >> ~/.config/meta-bridge.env
echo "GIOI_THIEU=Dạ em là trợ lý tự động của <tên shop>, nhân viên sẽ hỗ trợ thêm khi cần ạ." >> ~/.config/meta-bridge.env
grep '^API_SERVER_KEY=' ~/.hermes/profiles/cskh/.env | sed 's/^API_SERVER_KEY=/CSKH_API_KEY=/' >> ~/.config/meta-bridge.env
grep '^VERIFY_TOKEN=' ~/.config/meta-bridge.env     # copy chuỗi này cho bước D5

mkdir -p ~/meta-bridge && cat > ~/meta-bridge/cau_noi.py <<'EOF'
#!/usr/bin/env python3
"""Cầu nối Fanpage → Hermes (agent cskh). Aduca viết, dùng tự do.
Nhận webhook Messenger + bình luận, kiểm tra chữ ký, hỏi agent cskh qua API nội bộ, trả lời khách."""
import hashlib, hmac, json, os, re, threading, time, urllib.request
from http.server import BaseHTTPRequestHandler, ThreadingHTTPServer
from urllib.parse import urlparse, parse_qs

E = dict(l.strip().split('=', 1) for l in open(os.path.expanduser('~/.config/meta-bridge.env')) if '=' in l and not l.startswith('#'))
G = 'https://graph.facebook.com/v26.0'
HERMES = 'http://127.0.0.1:8642/p/cskh/v1/chat/completions'
KHACH = os.path.expanduser('~/meta-bridge/khach-de-lai-sdt.txt')
SDT = re.compile(r'(?:\+?84|0)(?:\d[\s.-]?){8,10}')
lan_cuoi = {}  # người gửi → lần nhắn gần nhất (để giới thiệu là trợ lý tự động)

def post(url, data, token, them=None):
    h = {'Content-Type': 'application/json', 'Authorization': 'Bearer ' + token, **(them or {})}
    with urllib.request.urlopen(urllib.request.Request(url, json.dumps(data).encode(), h), timeout=90) as r:
        return json.load(r)

def hoi_cskh(phien, noi_dung):
    try:
        j = post(HERMES, {'model': 'cskh', 'messages': [{'role': 'user', 'content': noi_dung}]},
                 E['CSKH_API_KEY'], {'X-Hermes-Session-Id': phien})
        return j['choices'][0]['message']['content'].strip()
    except Exception as e:
        print('Loi goi Hermes:', e, flush=True)
        return 'Dạ shop đã nhận tin nhắn, nhân viên sẽ phản hồi anh/chị sớm nhất ạ!'

def ghi_khach(nguon, ten, noi_dung):
    if SDT.search(noi_dung):
        with open(KHACH, 'a') as f:
            f.write(time.strftime('%d/%m %H:%M') + ' | ' + nguon + ' | ' + ten + ' | ' + noi_dung[:300].replace('\n', ' ') + '\n')

def xu_ly(body):
    for entry in body.get('entry', []):
        for m in entry.get('messaging', []):
            msg = m.get('message') or {}
            if not msg.get('text') or msg.get('is_echo'):
                continue
            nguoi = m['sender']['id']
            ghi_khach('Messenger', nguoi, msg['text'])
            tra_loi = hoi_cskh('fb-' + nguoi, msg['text'])
            if time.time() - lan_cuoi.get(nguoi, 0) > 86400:
                tra_loi = E.get('GIOI_THIEU', 'Dạ em là trợ lý tự động của shop.') + '\n' + tra_loi
            lan_cuoi[nguoi] = time.time()
            try:
                post(G + '/' + E['PAGE_ID'] + '/messages', {'recipient': {'id': nguoi}, 'messaging_type': 'RESPONSE',
                     'message': {'text': tra_loi[:1900]}}, E['PAGE_TOKEN'])
            except Exception as e:
                print('Loi gui tin:', e, flush=True)
        for c in entry.get('changes', []):
            v = c.get('value', {})
            tu = v.get('from') or {}
            if c.get('field') != 'feed' or v.get('item') != 'comment' or v.get('verb') != 'add' or not tu.get('id') or tu['id'] == E['PAGE_ID']:
                continue
            ghi_khach('Bình luận', tu.get('name', ''), v.get('message', ''))
            tra_loi = hoi_cskh('cmt-' + tu['id'], 'Khách bình luận công khai: "' + v.get('message', '') +
                               '". Viết 1 câu trả lời công khai ngắn, lịch sự, mời nhắn tin riêng; không nêu giá chi tiết hay thông tin cá nhân.')
            try:
                post(G + '/' + v['comment_id'] + '/comments', {'message': tra_loi[:1000]}, E['PAGE_TOKEN'])
            except Exception as e:
                print('Loi tra loi binh luan:', e, flush=True)

class H(BaseHTTPRequestHandler):
    def do_GET(self):  # Meta kiểm tra địa chỉ webhook
        q = parse_qs(urlparse(self.path).query)
        if q.get('hub.mode') == ['subscribe'] and hmac.compare_digest(q.get('hub.verify_token', [''])[0], E['VERIFY_TOKEN']):
            self.send_response(200); self.end_headers(); self.wfile.write(q.get('hub.challenge', [''])[0].encode())
        else:
            self.send_response(403); self.end_headers()

    def do_POST(self):
        raw = self.rfile.read(int(self.headers.get('Content-Length', 0)))
        ky = 'sha256=' + hmac.new(E['APP_SECRET'].encode(), raw, hashlib.sha256).hexdigest()
        if not hmac.compare_digest(ky, self.headers.get('X-Hub-Signature-256', '')):
            self.send_response(401); self.end_headers(); return
        self.send_response(200); self.end_headers()  # báo Meta đã nhận ngay (Meta yêu cầu dưới 5 giây)
        threading.Thread(target=xu_ly, args=(json.loads(raw),), daemon=True).start()

    def log_message(self, *a):
        pass

ThreadingHTTPServer(('127.0.0.1', 3001), H).serve_forever()
EOF

mkdir -p ~/.config/systemd/user && cat > ~/.config/systemd/user/meta-bridge.service <<'EOF'
[Unit]
Description=Cau noi Fanpage - Hermes
After=network-online.target
[Service]
ExecStart=/usr/bin/python3 %h/meta-bridge/cau_noi.py
Restart=always
RestartSec=5
[Install]
WantedBy=default.target
EOF
systemctl --user daemon-reload && systemctl --user enable --now meta-bridge
systemctl --user status meta-bridge --no-pager     # thấy active (running) là được

T=$(grep '^PAGE_TOKEN=' ~/.config/meta-bridge.env | cut -d= -f2-)
curl -s -X POST "https://graph.facebook.com/v26.0/<ID Fanpage>/subscribed_apps" -H "Authorization: Bearer $T" -d subscribed_fields=messages,feed; echo; unset T   # thấy {"success":true}

cat > ~/.hermes/scripts/khach-fanpage.sh <<'EOF'
#!/bin/bash
F=~/meta-bridge/khach-de-lai-sdt.txt; M=~/.hermes/scripts/.khach-fanpage.dem
[ -f "$F" ] || exit 0
n=$(wc -l < "$F"); c=$(cat "$M" 2>/dev/null || echo 0)
[ "$n" -gt "$c" ] && { echo "📞 Khách để lại số điện thoại trên Fanpage:"; tail -n $((n-c)) "$F"; }
echo "$n" > "$M"
EOF
chmod +x ~/.hermes/scripts/khach-fanpage.sh
hermes cron create "every 10m" --no-agent --script khach-fanpage.sh --deliver telegram --name "Khách Fanpage"