# SETUP GUIDE — Facebook Page auto-posting

Is guide mein aap `FB_PAGE_ID` aur `FB_PAGE_ACCESS_TOKEN` banayenge. Ye do cheezein
bot ko aapke Page par post karne ki permission deti hain.

> **Note:** Aap apne hi Page ke admin hain, isliye app ko **Development mode** mein
> rakh kar bhi post kar sakte hain — App Review ki zaroorat nahi (jab tak sirf aap
> aur aapke app roles waale log use kar rahe hain).

---

## Part A — Facebook Developer App banao

1. Jao: https://developers.facebook.com → right-top **My Apps** → **Create App**.
2. "What do you want to do?" → **Other** chunein → Next.
3. App type → **Business** chunein → Next.
4. App ka naam daalein (jaise "My Auto Poster") → Create App.
5. App ban jaane par **App Settings → Basic** kholo. Yahan **App ID** aur
   **App Secret** note kar lo — aage kaam aayenge.

---

## Part B — Access token generate karo (Graph API Explorer)

1. Kholo: https://developers.facebook.com/tools/explorer
2. Top-right **Meta App** dropdown mein apna naya app select karo.
3. **Permissions** mein ye add karo (ek-ek karke search karke tick karein):
   - `pages_show_list`
   - `pages_manage_posts`
   - `pages_read_engagement`
   - `pages_manage_metadata`
   - `business_management`
   - `public_profile`
4. **Generate Access Token** dabao → Facebook login window aayega → apne Page
   waale account se allow karo.
5. Ab Explorer mein token ban gaya hai (ye **short-lived User token** hai, ~1 ghante).

---

## Part C — Page ID aur Page token nikaalo

Explorer mein method `GET` rakho aur path likho:

```
me/accounts
```

**Submit** dabao. Response aisa dikhega:

```json
{
  "data": [
    {
      "name": "Aapke Page ka naam",
      "id": "123456789012345",
      "access_token": "EAAG...page-token..."
    }
  ]
}
```

- `id` → ye aapka **FB_PAGE_ID** hai (jis page par post karna hai).
- `access_token` → ye **Page access token** hai (abhi short-lived).

---

## Part D — Token ko long-lived banao (zaroori!)

Short-lived token ~1 ghante mein expire ho jaata hai. Isko **long-lived** banayein:

### D1. User token ko long-lived karo
Explorer mein ya browser mein ye URL chalao (values apni daalein):

```
https://graph.facebook.com/v21.0/oauth/access_token?grant_type=fb_exchange_token&client_id={APP_ID}&client_secret={APP_SECRET}&fb_exchange_token={SHORT_USER_TOKEN}
```

Response mein `access_token` milega — ye **long-lived User token** hai (~60 din).

### D2. Long-lived Page token lo
Ab Explorer mein (ya browser mein) is **long-lived User token** ke saath dobara:

```
me/accounts?access_token={LONG_LIVED_USER_TOKEN}
```

Is baar jo `access_token` milega wo **long-lived Page token** hai — practically
kabhi expire nahi hota (jab tak aap admin rahein aur user token valid rahe).
**Yahi value `FB_PAGE_ACCESS_TOKEN` mein daalein.**

> Tip: token ki validity check karne ke liye **Access Token Debugger** use karo:
> https://developers.facebook.com/tools/debug/accesstoken/

---

## Part E — Hugging Face token (image generation ke liye)

1. Jao: https://huggingface.co/settings/tokens → **New token**.
2. Type: **Read** (ya Fine-grained mein "Make calls to Inference Providers" on karein).
3. Copy karke `HF_TOKEN` mein daalein.

---

## Part F — Sab kuch test karo (optional, terminal se)

Page info check:
```bash
curl "https://graph.facebook.com/v21.0/{FB_PAGE_ID}?fields=name,fan_count&access_token={FB_PAGE_ACCESS_TOKEN}"
```

Ek test photo post (kisi public image URL se):
```bash
curl -X POST "https://graph.facebook.com/v21.0/{FB_PAGE_ID}/photos" \
  -d "message=Test post from bot" \
  -d "url=https://picsum.photos/1024" \
  -d "access_token={FB_PAGE_ACCESS_TOKEN}"
```

Agar `{"id": "..."}` aata hai to sab theek hai — token kaam kar raha hai.

---

## Common problems

| Problem | Wajah / Fix |
|---|---|
| `OAuthException: (#200) Permissions error` | Token mein `pages_manage_posts` permission nahi hai — Part B dobara karein |
| `Error validating access token: expired` | Short-lived token use hua — Part D follow karein (long-lived banao) |
| `(#190) This may be because the user logged out` | User token invalid — dobara login karke naya token banao |
| Post page par nahi dikh raha | Confirm karein `FB_PAGE_ID` sahi page ka hai (Part C) |
| Image post fail, text chal raha | Image URL/bytes theek nahi — bot disk se file bhejta hai, isliye `generated_images/` folder check karein |

---

## Security

- `FB_PAGE_ACCESS_TOKEN` ko kabhi code ya public repo mein na daalein.
- Sirf **Space Secrets** (ya environment variables) mein rakhein.
- Token leak ho jaaye to Explorer/App dashboard se **revoke** karein aur naya banayein.