# Gadinet Social V24 — Meta Facebook Pages

## Primeiro adapter oficial real
Adapter: `meta_facebook_page`

Alvo permitido:
- Facebook Pages autorizadas pelo administrador via OAuth.

Não implementado:
- perfil pessoal
- Facebook Groups
- cookie/session scraping
- automação de navegador
- qualquer mecanismo de evasão de limites ou anti-spam

## Graph API
Padrão: `v26.0`.
Pode ser alterado com `META_GRAPH_VERSION`.

## Ambiente
```env
APP_URL=https://social.seudominio.com
META_APP_ID=...
META_APP_SECRET=...
META_GRAPH_VERSION=v26.0
APP_KEY=uma-chave-forte-com-mais-de-32-caracteres
```

Redirect URI:
`https://social.seudominio.com/integrations/meta/callback`

## OAuth
A tela `/integrations` possui `Conectar Facebook Pages`.

Scopes solicitados:
- pages_show_list
- pages_read_engagement
- pages_manage_posts

O fluxo:
1. gera state aleatório e grava somente SHA-256;
2. redireciona para Facebook OAuth;
3. valida state de uso único e expiração de 10 minutos;
4. troca code por user token;
5. tenta trocar por long-lived user token;
6. consulta `/me/accounts`;
7. salva somente Page Access Tokens necessários, criptografados por AES-256-GCM;
8. descarta o user token da aplicação.

## Teste de conexão
`GET /{page_id}?fields=id,name`

## Publicação
Texto/link:
`POST /{page_id}/feed`

Foto pública:
`POST /{page_id}/photos`

A integração nunca aceita `page_id` vindo do payload de publicação; usa somente a Page configurada e autorizada.

## App Review
Para operação pública/produção, permissões da Meta podem exigir Advanced Access/App Review e requisitos adicionais da plataforma.

## Upgrade V23 -> V24
`database/migrate_v23_to_v24.sql`

## Fresh install
`database/schema_v24_clean.sql`
