Páginas

Las empresas pueden las reclamar páginas que les pertenecen. Esto permite a los administradores asignar fácilmente a las personas a las páginas a las que deberían tener acceso.

Reclamar páginas

Las empresas pueden reclamar la propiedad de una página que les pertenece, lo que les permite administrar todos los aspectos de la página, incluso eliminar cualquier agencia u otros negocios a los que se haya concedido acceso. De forma alternativa, las empresas también pueden solicitar acceso de agencia a una página, lo que les permitirá publicar anuncios en la página a través de cuentas publicitarias a las que tienen acceso.

Reclamar páginas como propietario

Si quieres reclamar una página para tu empresa como OWNER, necesitas el identificador de la página y el identificador de la empresa. Luego, envía una solicitud POST:

El solicitante debe tener lo siguiente:

permiso de administrador en la página
permiso del negocio propietario, o el propietario del negocio propietario debe aprobar la solicitud

Para hacer esta solicitud, debes usar el token de acceso de un usuario administrador o un usuario del sistema administrador de tu empresa. Si el usuario que realiza la llamada es un administrador de la página o un MANAGER de ella desde hace más de siete días, la propiedad de la página pasa a la empresa de inmediato. Facebook devuelve access_status en el conjunto de respuestas a CONFIRMED. Si una persona se convirtió en administrador, o MANAGER, hace siete días o menos, no aprobaremos automáticamente la solicitud a la API.

Si el usuario que realiza una llamada de reclamación OWNER no tiene los permisos adecuados en la página, la llamada falla. A diferencia de lo que sucede al reclamar una cuenta de anuncios, no se envía una solicitud a los administradores de la página para que la aprueben.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Reclamar páginas como agencia

Si quieres reclamar una página para tu empresa como AGENCY, necesitas el identificador de la página. Luego, envía una solicitud POST:

Si quien hace la solicitud tiene permiso de administración en la página, esta solicitud se aprobará de forma automática. De lo contrario, el administrador de la página tendrá que aprobar la solicitud.

La agencia no puede volver a compartir la página con otro negocio.

La agencia puede empezar a publicar anuncios en la página (a través de cuentas publicitarias a las que tiene acceso) de manera inmediata.

curl \
  -F "page_id=<PAGE_ID>" \
  -F "permitted_tasks=['ADVERTISE', 'ANALYZE']" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Si usas AGENCY:

Debes proporcionar permitted_tasks
La empresa debe ser la propietaria de la página
El token de acceso debe tener los permisos pages_manage_metadata y pages_show_list

Si realizas una reclamación como AGENCY, pero no tienes los permisos de página pertinentes, la respuesta es PENDING. El administrador de esa página puede iniciar sesión y conceder o rechazar el acceso, o reportar la reclamación como spam. Si una empresa recibe demasiados reportes de spam por solicitudes de acceso a páginas, bloquearemos a su administrador comercial.

Para ver todas las páginas de clientes a las que solicitaste acceso, pero aún están pendientes de aprobación, realiza esta llamada GET. Necesitas el token de acceso del usuario administrador del sistema:

curl -G \
-d "access_token=<ADMIN_SYSTEM_USER_ACCESS_TOKEN>" \
"https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pending_client_pages"

Ver las páginas que pertenecen al negocio o páginas que pertenecen a clientes de la empresa

Para ver todas las páginas que le pertenecen a tu negocio, usa esta llamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/owned_pages"

Para ver todas las páginas de las que tu empresa es una agencia, usa esta llamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/client_pages"

Esta acción devuelve una lista de páginas que les pertenecen a clientes de un administrador comercial.

Agregar páginas de forma masiva

Puedes agregar páginas individuales a un administrador comercial utilizando la UI del administrador comercial. Para agregar páginas de forma masiva a un administrador comercial, realiza las siguientes llamadas POST:

curl \
-F 'access_token=<ACCESS_TOKEN>' \
-F 'batch=[
  {
    "method":"POST",
    "name":"test1",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_1>"
  }, 
  {
    "method":"POST",
    "name":"test2",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_2>"
  }, 
  {
    "method":"POST",
    "name":"test3",
    "relative_url":"<BUSINESS_ID>/owned_pages",
    "body":"page_id=<PAGE_ID_3>"
  }, 
]' \
"https://graph.facebook.com/<API_VERSION>"

Donde:

<ACCESS_TOKEN> es un token de acceso con el permiso business_management.
<BUSINESS_ID> es el identificador del administrador comercial al cual deben solicitarse las páginas.
<PAGE_ID_n> son los identificadores de la página que va a reclamar.

Eliminar páginas

Para eliminar una página de la empresa, realiza esta llamada DELETE:

curl \
  -X DELETE \
  -F "page_id=<PAGE_ID>" \
  -F "access_token=<ACCESS_TOKEN>" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_ID>/pages"

Agregar personas a páginas

Cuando el negocio tenga una página, podrás asignarles tareas a las personas en ella. Las tareas incluyen las siguientes:

Nombre	Constante de API	Descripción
Administrador	`['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Puede administrar los roles de administrador, enviar mensajes y publicar en nombre de la página, crear anuncios y ver informes.
Editor	`['CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']`	Puede editar la página, enviar mensajes y publicar en nombre de la página, crear anuncios y ver informes.
Moderador	`['MODERATE', 'ADVERTISE', 'ANALYZE']`	Puede responder a comentarios en la página y eliminarlos, enviar mensajes en nombre de la página, crear anuncios y ver informes.
Anunciante	`['ADVERTISE', 'ANALYZE']`	Puede crear anuncios para la página y ver estadísticas.
Analista	`['ANALYZE']`	Puede ver informes.

Necesitas lo siguiente:

page_id: identificador de la página
user_id: identificador del usuario que se agregará
Tareas para asignar

Realiza esta llamada POST para agregar a alguien con las tareas ['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']:

El identificador de la empresa debe ser el identificador del negocio que posee la página

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['MANAGE', 'CREATE_CONTENT', 'MODERATE', 'ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Cambiar el acceso a páginas

Para cambiar las tareas de un usuario actual, usa la misma llamada POST que harías para agregar a un nuevo usuario con tareas:

curl \
  -F "user=BUSINESS_SCOPED_USER_ID" \
  -F "tasks=['ADVERTISE', 'ANALYZE']" \
  -F "business=BUSINESS_ID" \
  -F "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"

Ver permisos de página

Para ver páginas con permisos de usuario, realiza esta llamada GET:

curl -G \
  -d "access_token=ACCESS_TOKEN" \
  "https://graph.facebook.com/<API_VERSION>/<BUSINESS_SCOPED_USER_ID>/assigned_pages"

Para ver permisos específicos en una página, realiza esta llamada GET:

curl -G 
  -d "access_token=ACCESS_TOKEN"  
  "https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users?business=<BUSINESS_ID>"

Eliminar el acceso a páginas

Antes de que puedas eliminar una página del administrador comercial, también debes eliminar a los administradores de esa página de tu empresa.

Para eliminar el acceso de una persona a una página que te pertenezca, necesitas lo siguiente:

page_id: identificador de la página
user_id: identificador del usuario que se eliminará

La llamada DELETE es:

curl \
  -X DELETE \
  -F "user=BUSINESS_SCOPED_USER_ID" \
-F "access_token=ACCESS_TOKEN" \
"https://graph.facebook.com/<API_VERSION>/<PAGE_ID>/assigned_users"