Conectar página de Facebook

POST

/facebook-session/connect

curl --request POST \
  --url https://api.matiasimpulso.com/facebook-session/connect \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "code": "AQBx8r3...", "state": "v1.eyJjIjoxLCJ1Ijo0MiwibiI6Ii4uLiIsImUiOjB9.firma", "selectionToken": "example", "redirectUri": "http://localhost:7902/admin/connections/callback", "pageIds": [ "123456789" ], "channel": "facebook" }'

• Servidor de Producción (Cloud)
• Entorno de Desarrollo Local

Ejecuta el flujo completo de conexión: OAuth → obtener páginas → suscribir webhooks → crear conexión en BD.

Authorizations

• bearer

Request Body^required

Media type application/json

object

code

Código de autorización de Facebook OAuth 2.0 (obligatorio si no se envía selectionToken)

string

Example

AQBx8r3...

state

State firmado devuelto por GET /facebook-session/oauth/url (obligatorio si no se envía selectionToken)

string

Example

v1.eyJjIjoxLCJ1Ijo0MiwibiI6Ii4uLiIsImUiOjB9.firma

selectionToken

Token efímero devuelto cuando el usuario administra múltiples páginas y debe elegir cuáles conectar

string

redirectUri

URL de redirección OAuth (debe coincidir con la registrada en Facebook)

string

Example

http://localhost:7902/admin/connections/callback

pageIds

IDs de páginas específicas a conectar (si vacío y solo hay 1 candidata, se conecta directo)

Array<string>

Example

[
  "123456789"
]

channel

Qué se conecta: la página de Facebook (por defecto) o la cuenta de Instagram vinculada a ella

string

default: facebook

Allowed values: facebook instagram

Responses

201

Página(s) conectada(s) exitosamente

Media type application/json

Array<object>

object

id

required

number

name

required

string

pageId

required

string

pageName

required

string

status

required

string

isActive

required

boolean

companyId

required

number

Example

[
  {
    "id": 1,
    "name": "Facebook - Mi Página",
    "pageId": "123456789012345",
    "pageName": "Mi Empresa",
    "status": "CONNECTED",
    "isActive": true,
    "companyId": 1
  }
]

400

State inválido, alterado o caducado, o sin páginas disponibles

403

El state pertenece a otra empresa u otro usuario

409

La página o cuenta ya está conectada en otra empresa