ES
Guía para desarrolladores

Guía de la API de Facebook: Graph API, acceso, límites y cuentas conectadas

Qué cubren las API de Facebook de Meta en 2026, cómo obtener los access tokens y superar el App Review, qué ya no permite la API oficial y cómo una app SaaS puede conectar, en su lugar, las propias cuentas de Facebook de sus usuarios.

Su app En vivo
FacebookAnna LeePersonal FacebookNorthwind BakeryPágina
Publicación
Northwind BakeryComo Página · Ahora

Nuestro menú de otoño llega el lunes.

243
Julia Nash¡Vuelve el pan de calabaza!
Mensajes
Maya RossA Northwind Bakery
¿Hacen entregas los domingos?
Sí, de 9 a 12 h.
Visto
Webhooks Nuevo mensaje Nueva reacción
GETchats POSTmessages/send POSTposts 200 OK
Respuesta corta

Sí, Facebook tiene una API: la Graph API, la interfaz HTTP de Meta para leer y escribir datos de Facebook. Productos como la Pages API, la Messenger Platform y la Marketing API se basan en ella. Se accede a través de una app de Meta, de access tokens concedidos por usuarios o Páginas y de permisos aprobados en el App Review.

Esta guía relaciona cada API de Facebook con el tipo de cuenta al que sirve, explica el acceso y los límites, enumera lo que Meta ha eliminado y muestra otro modelo para las apps SaaS: que cada usuario conecte su propia cuenta de Facebook a través de la API de Facebook Messenger de Unipile.

Definición

¿Existe una API de Facebook?

Sí. Meta expone los datos de Facebook a los desarrolladores a través de la Graph API, una API HTTP versionada. Todos los demás productos de Facebook para desarrolladores, desde la gestión de Páginas hasta Messenger y los anuncios, son conjuntos de endpoints de la Graph API con sus propios permisos y su propia revisión.

No existe una clave de API única. Lo que obtiene depende de a quién pertenecen los datos: una persona que inicia sesión en su app, una Página de Facebook que gestiona o una cuenta publicitaria. Cada caso tiene su propio tipo de token y su propia revisión por parte de Meta.

Facebook ¿De quién son los datos que lee?
Un usuarioUser access token obtenido con Facebook Login, limitado a los permisos que concede la persona.
Una PáginaPage access token, para alguien que tiene una tarea asignada en esa Página.
Una cuenta publicitariaAcceso a la Marketing API a través de una empresa y sus usuarios del sistema.
Graph API

¿Qué es la Graph API de Facebook?

La Graph API es la API HTTP que hay detrás de cualquier integración con Facebook. Todas las solicitudes van a graph.facebook.com y casi todos los endpoints requieren un access token. Los datos se organizan como un grafo de nodos (nodes), conexiones (edges) y campos (fields).

Nodes

Objetos

Un objeto individual con un ID: un usuario, una Página, una publicación, un comentario, una foto. Ejemplo: GET /{page-id}.

Edges

Conexiones

Colecciones vinculadas a un nodo, como las publicaciones de una Página o los comentarios de una publicación. Ejemplo: GET /{page-id}/feed.

Fields

Propiedades

Los datos que solicita de un nodo, seleccionados con el parámetro fields. Ejemplo: ?fields=id,message,created_time.

Versiones y Graph API Explorer

Cada solicitud puede indicar una versión en su ruta, como /v27.0/, publicada el 4 de noviembre de 2026. Meta publica varias versiones al año y mantiene cada una durante al menos dos años, así que conviene planificar las actualizaciones: el changelog indica hasta qué fecha sigue disponible cada versión. El Graph API Explorer permite probar las llamadas antes de escribir código, y la pestaña Meta Graph API del ejemplo de código más abajo muestra una primera solicitud: leer el feed de una Página.

Fuente: el changelog de la Graph API de Meta, que indicaba la v27.0 (introducida el 4 de noviembre de 2026) como la versión más reciente. Última verificación: 17 de noviembre de 2026.

Mapa

Las API de Facebook de un vistazo

Cada API de Facebook sirve a un tipo de cuenta. Elegir la adecuada empieza con una pregunta sencilla: ¿actúa en nombre de una persona, de una Página o de un anunciante?

APIQué haceCuenta a la que sirveAcceso necesario
Graph APILeer y escribir objetos de FacebookUsuarios, Páginas, empresasApp de Meta, access token, permisos
Pages APIPublicar contenido, moderar comentarios, leer datos de la Página. Guía: API de publicaciones de FacebookPáginas de FacebookPage access token, tareas en la Página, App Review
Messenger PlatformEnviar y recibir conversaciones de la PáginaPáginas de Facebook y cuentas profesionales de InstagramToken de Página, permiso de mensajería, App Review
Marketing APICrear anuncios y consultar su rendimientoCuentas publicitariasVerificación de la empresa, permisos de anuncios
Conversions APIEnviar eventos web y offline para los anunciosEmpresas que publican anunciosPíxel o dataset, token de usuario del sistema
Facebook LoginPermitir que las personas inicien sesión en su appUsuarios de FacebookApp de Meta con Facebook Login
Graph API
Qué haceLeer y escribir objetos de Facebook
CuentaUsuarios, Páginas, empresas
AccesoApp de Meta, access token, permisos
Pages API
Qué hacePublicar contenido, moderar comentarios, leer datos de la Página. Guía: API de publicaciones de Facebook
CuentaPáginas de Facebook
AccesoPage access token, tareas en la Página, App Review
Messenger Platform
Qué haceEnviar y recibir conversaciones de la Página
CuentaPáginas de Facebook y cuentas profesionales de Instagram
AccesoToken de Página, permiso de mensajería, App Review
Marketing API
Qué haceCrear anuncios y consultar su rendimiento
CuentaCuentas publicitarias
AccesoVerificación de la empresa, permisos de anuncios
Conversions API
Qué haceEnviar eventos web y offline para los anuncios
CuentaEmpresas que publican anuncios
AccesoPíxel o dataset, token de usuario del sistema
Facebook Login
Qué hacePermitir que las personas inicien sesión en su app
CuentaUsuarios de Facebook
AccesoApp de Meta con Facebook Login

La mensajería de Instagram pasa por la misma Messenger Platform: consulte nuestra guía de la Messenger API para Instagram. WhatsApp tiene su propia plataforma, tratada en la guía de la API de WhatsApp.

Decisión

¿Qué API de Facebook necesita?

Parta de lo que hace su producto, no de la lista de API. Cada situación remite a una API y a sus requisitos de acceso.

Publica en su propia Página

Pages API

Page access token de un administrador de la Página, tareas en la Página, App Review. Guía de la API de Páginas de Facebook.

Responde a quienes escriben a su Página

Messenger Platform

Token de Página, pages_messaging, ventana de mensajería de 24 horas.

Gestiona o mide anuncios

Marketing API y Conversions API

Acceso a la cuenta publicitaria, verificación de la empresa, usuarios del sistema.

Permite iniciar sesión con Facebook

Facebook Login

Una app de Meta con Facebook Login configurado.

Sus usuarios conectan sus propias cuentas en su SaaS

API de Unipile

Cuentas personales y las Páginas que gestionan, mediante autenticación alojada (Hosted Auth).

Acceso

Cómo obtener acceso a la API de Facebook

No existe una clave de API independiente. Usted crea una app de Meta, las personas le conceden access tokens mediante Facebook Login y Meta revisa los permisos que solicita su app antes de que pueda abrirse al público.

1

Cree una cuenta de desarrollador de Meta

Regístrese en Meta for Developers con su cuenta de Facebook.

2

Cree una app de Meta

Elija el tipo de app y el caso de uso, y anote el App ID y el App Secret.

3

Añada Facebook Login for Business

Los usuarios y los administradores de Páginas inician sesión y conceden permisos a su app.

4

Solicite los permisos

Por ejemplo, pages_show_list, pages_manage_posts o pages_messaging.

5

Supere el App Review

Se necesita Advanced Access para que puedan usarla personas sin un rol en su app.

Access tokens: de usuario, de Página, de app y de usuario del sistema

TokenActúa en nombre deUso habitual
User access tokenUna persona que ha iniciado sesión en su appDe corta duración por defecto, se puede cambiar por un token de larga duración
Page access tokenUna Página, se obtiene en /me/accountsNecesario para la mayoría de los endpoints de la Pages API y de Messenger
App access tokenLa propia appConfiguración de la app y algunos datos públicos
System user tokenUna empresa, sin intervención de una personaTareas de servidor a servidor, anuncios y Páginas propiedad de la empresa
User access token
Actúa en nombre deUna persona que ha iniciado sesión en su app
Uso habitualDe corta duración por defecto, se puede cambiar por un token de larga duración
Page access token
Actúa en nombre deUna Página, se obtiene en /me/accounts
Uso habitualNecesario para la mayoría de los endpoints de la Pages API y de Messenger
App access token
Actúa en nombre deLa propia app
Uso habitualConfiguración de la app y algunos datos públicos
System user token
Actúa en nombre deUna empresa, sin intervención de una persona
Uso habitualTareas de servidor a servidor, anuncios y Páginas propiedad de la empresa

La duración de vida varía según el tipo. Según Meta, los tokens de usuario de corta duración suelen durar entre una y dos horas y los de larga duración unos 60 días, mientras que los tokens de usuario del sistema pueden configurarse para que no caduquen con el tiempo; Meta advierte de que estas duraciones pueden cambiar sin previo aviso. El recorrido completo, desde generar un token hasta intercambiarlo y depurarlo, está en nuestra guía del token de acceso de la API de Facebook, y el Page access token de Facebook se trata en la guía de la API de Páginas.

Permisos, tareas en la Página y App Review

La mayoría de los endpoints de la Pages API requieren un Page access token de una persona que pueda realizar una tarea en la Página, como CREATE_CONTENT o MODERATE. En modo de desarrollo, solo las personas con un rol en su app pueden usarla. Para dar servicio a otros usuarios, cada permiso necesita Advanced Access, que se concede tras el App Review, y las apps empresariales suelen requerir además la verificación de la empresa.

Fuentes: la guía de access tokens y la presentación de la Pages API de Meta. Última verificación: 17 de noviembre de 2026.

Tiempo real

Webhooks de la API de Facebook: reciba eventos en tiempo real

En lugar de consultar periódicamente (polling), Meta envía los eventos a un endpoint HTTPS de su propiedad: nuevos mensajes de la Página, confirmaciones de lectura y reacciones. La configuración se hace en cuatro pasos.

1

Verifique su endpoint

Meta envía una solicitud GET con hub.mode, hub.verify_token y hub.challenge. Compruebe el token y devuelva el challenge.

2

Suscriba la Página

Llame a POST /{page-id}/subscribed_apps con un Page access token y los campos que necesite, como messages.

3

Valide cada payload

Cada evento incluye un encabezado X-Hub-Signature-256, una firma SHA256 generada con su App Secret.

4

Responda rápido

Devuelva un 200 OK cuanto antes. Para Messenger, Meta exige una respuesta en menos de 5 segundos y desactiva la suscripción tras una hora de fallos.

Facebook Campos de webhook de Messenger
messagesUna persona envía un mensaje a la Página
message_readsLa persona ha leído su mensaje
message_deliveriesSu mensaje se ha entregado
message_reactionsLa persona ha reaccionado a un mensaje
messaging_postbacksLa persona ha pulsado un botón o una opción del menú
POST /{page-id}/subscribed_apps éxito

Con Unipile, registra una sola URL de webhook y recibe los mensajes nuevos, editados y eliminados, las confirmaciones de lectura y las reacciones de todas las cuentas de Facebook conectadas, con el mismo formato que sus demás canales.

Fuentes: la guía de inicio de Webhooks y la documentación de webhooks de Messenger de Meta. Última verificación: noviembre de 2026.

Límites

Lo que la API oficial de Facebook no le permite hacer

Varias funciones que se esperan de una API de Facebook se han eliminado o nunca se ofrecieron a las apps de terceros. Conocerlas desde el principio ahorra semanas de trabajo de diseño.

  • Publicar en un perfil personal. El permiso publish_actions quedó obsoleto el 24 de abril de 2018 y las apps lo perdieron el 1 de agosto de 2018. Las apps pueden publicar en Páginas, no en la biografía de una persona.
  • Usar los grupos de Facebook. Meta retiró la Groups API con la Graph API v19.0 el 23 de enero de 2024, incluido el permiso publish_to_groups.
  • Enviar mensajes desde una cuenta personal. La Messenger Platform permite que una Página de Facebook o una cuenta profesional de Instagram responda a las personas. La ventana de mensajería estándar es de 24 horas desde el último mensaje de la persona. Descubra cómo funciona con una API de Facebook Messenger para cuentas personales.

Fuentes: el changelog de Facebook Login, el anuncio de la Graph API v19.0 y la presentación de la Messenger Platform de Meta. Última verificación: noviembre de 2026.

¿Necesita las conversaciones de sus propios usuarios?

Si su app necesita los mensajes de Messenger, las publicaciones y los comentarios de las cuentas que sus usuarios conectan ellos mismos, consulte la API de Facebook Messenger de Unipile.

Rate limits

Rate limits y versiones de la API de Facebook

La Graph API contabiliza las llamadas con dos sistemas, según el token que utilice.

Platform rate limit 200 x usuarios llamadas por hora Llamadas realizadas con un token de usuario o de app, calculadas según el número de usuarios de su app.
Business Use Case, Páginas 4800 x usuarios activos llamadas cada 24 horas Llamadas a los endpoints de Páginas con un token de Página o de usuario del sistema.

Lea los encabezados de uso que Meta devuelve con cada respuesta, reduzca el ritmo antes de alcanzar el límite y actualice su versión de la Graph API antes de que se retire la que utiliza.

Fuente: la guía de rate limiting de Meta. Última verificación: noviembre de 2026.

Errores

Errores frecuentes de la API de Facebook y cómo solucionarlos

Los errores de la Graph API llegan con un code, a menudo un error_subcode, y un fbtrace_id que puede compartir con el soporte de Meta. Lea el código antes de reintentar: solo algunos errores desaparecen con el tiempo.

CódigoQué significaQué hacer
190Access token caducado o no válido (subcódigos 463, 467)Obtenga un nuevo token; pida al usuario que vuelva a iniciar sesión. Consulte la guía del token de acceso de la API de Facebook
10, 200 a 299Permiso no concedido o retiradoVuelva a solicitar el permiso, revise el App Review
4, 17, 613Demasiadas llamadas para la app o el usuarioHaga una pausa y reintente con backoff
100Parámetro o ID no válidoCompruebe el ID y el token que envía
368Bloqueo temporal por infringir las políticasEspere y revise lo que se envió
506Publicación duplicadaModifique el contenido antes de volver a publicar
10 / 2018278Mensaje enviado fuera de la ventana permitidaResponda solo mientras la ventana de mensajería esté abierta
Código 190
Qué significaAccess token caducado o no válido (subcódigos 463, 467)
Qué hacerObtenga un nuevo token; pida al usuario que vuelva a iniciar sesión. Consulte la guía del token de acceso de la API de Facebook
Código 10, 200 a 299
Qué significaPermiso no concedido o retirado
Qué hacerVuelva a solicitar el permiso, revise el App Review
Código 4, 17, 613
Qué significaDemasiadas llamadas para la app o el usuario
Qué hacerHaga una pausa y reintente con backoff
Código 100
Qué significaParámetro o ID no válido
Qué hacerCompruebe el ID y el token que envía
Código 368
Qué significaBloqueo temporal por infringir las políticas
Qué hacerEspere y revise lo que se envió
Código 506
Qué significaPublicación duplicada
Qué hacerModifique el contenido antes de volver a publicar
Código 10 / 2018278
Qué significaMensaje enviado fuera de la ventana permitida
Qué hacerResponda solo mientras la ventana de mensajería esté abierta

Fuentes: la documentación de Meta sobre gestión de errores de la Graph API y los códigos de error de Messenger. Última verificación: noviembre de 2026.

Precios

¿Es gratuita la API de Facebook?

En general, sí. Meta no cobra por el acceso a la Graph API. Lo que tiene un coste es la publicidad, algunos tipos de mensajes y el tiempo de ingeniería necesario para crear y mantener una integración.

Acceso a la Graph APISin costeMeta no cobra por llamar a la Graph API. Su coste es la configuración de la app, el App Review y el mantenimiento.
Conversaciones de MessengerUso gratuitoMeta presenta la Messenger Platform como de uso gratuito; los mensajes de marketing se facturan a través de su cuenta publicitaria.
AnunciosSu inversión publicitariaLlamar a la Marketing API es gratuito, pero las campañas que crea se pagan como cualquier otro anuncio.

Los costes por tipo de mensaje, los cambios de facturación de 2026 y el coste real de mantener una app de Meta se detallan en nuestra guía de precios, que responde en detalle a la pregunta ¿es gratuita la API de Facebook?. Si sus usuarios conectan sus propias cuentas a través de Unipile, usted paga a Unipile por cuenta conectada: consulte los precios de la API.

Documentación

Dónde encontrar la documentación de la API de Facebook

Toda la documentación oficial está en Meta for Developers. Meta está trasladando sus páginas a developers.facebook.com/documentation/, y varios enlaces antiguos de /docs/ ya redirigen allí. Estas seis páginas responden a la mayoría de las preguntas de integración; para Instagram, WhatsApp, Threads, anuncios e IA, consulte nuestra guía de la API de Meta.

Con Unipile

Otro modelo: conecte las propias cuentas de Facebook de sus usuarios

Los CRM, los helpdesks, los agentes de IA y las inbox multicanal necesitan las conversaciones y publicaciones de sus propios usuarios. Con Unipile, cada usuario vincula su cuenta de Facebook a través de una página de autenticación alojada y su app llama a una única REST API en su nombre, sin app de Meta ni App Review por su parte.

Su app Sincronizado
Cuentas vinculadas
FacebookAnna LeeCuenta personal
FacebookNorthwind BakeryPágina
Vincular cuenta
Inbox 2PáginaPersonal
Leo Martin¿La tienda abre hoy?Página
Sara KimFoto enviadaPersonal
Club de lecturaTom: Nos vemos a las 7Grupo
Omar HaddadVistoPágina
Publicado como Página
Northwind BakeryAhora mismo

Nuestro menú de otoño empieza el lunes.

24 reacciones2 comentarios
Julia Nash¡Vuelve el pan de calabaza!
Ben Torres¿Aceptan reservas?
GET api.unipile.com/v2/{ACCOUNT_ID}/chats 200 OK
ÁmbitoLo que cubre la API de Unipile para Facebook
ConexiónHosted Auth o Custom Auth, con las credenciales del usuario y autenticación de dos factores, cookies del navegador o la extensión UniLogin
MensajeríaListar chats y mensajes, iniciar un chat, enviar mensajes y archivos adjuntos, editar, eliminar, reenviar, reacciones, confirmaciones de lectura, chats de grupo
Publicaciones y comentariosLeer, crear, editar y eliminar publicaciones; listar, añadir, responder, editar y eliminar comentarios; reacciones en publicaciones y comentarios
Usuarios y relacionesPerfiles, seguidores y seguidos, solicitudes de amistad (enviar, aceptar, rechazar, cancelar)
WebhooksMensajes nuevos, actualizados y eliminados, confirmaciones de lectura y de entrega, nuevas reacciones, actualizaciones de chats
Páginas de FacebookLeer y responder a los mensajes de una Página que gestiona el usuario, y publicar como la Página. Una Página no puede iniciar una conversación ni eliminar sus mensajes
No compatibleHistorias, mensajes fijados, bloqueo de usuarios
Conexión
Hosted Auth o Custom Auth, con las credenciales del usuario y autenticación de dos factores, cookies del navegador o la extensión UniLogin
Mensajería
Listar chats y mensajes, iniciar un chat, enviar mensajes y archivos adjuntos, editar, eliminar, reenviar, reacciones, confirmaciones de lectura, chats de grupo
Publicaciones y comentarios
Leer, crear, editar y eliminar publicaciones; listar, añadir, responder, editar y eliminar comentarios; reacciones en publicaciones y comentarios
Usuarios y relaciones
Perfiles, seguidores y seguidos, solicitudes de amistad (enviar, aceptar, rechazar, cancelar)
Webhooks
Mensajes nuevos, actualizados y eliminados, confirmaciones de lectura y de entrega, nuevas reacciones, actualizaciones de chats
Páginas de Facebook
Leer y responder a los mensajes de una Página que gestiona el usuario, y publicar como la Página. Una Página no puede iniciar una conversación ni eliminar sus mensajes
No compatible
Historias, mensajes fijados, bloqueo de usuarios

Los usuarios pueden conectar una cuenta personal de Facebook, y las Páginas que gestionan quedan disponibles a través de los mismos endpoints. La misma API cubre también LinkedIn, WhatsApp, Instagram, Telegram, el email y los calendarios. Lista completa en la tabla de funciones por proveedor.

Listar los chats y enviar un mensaje

Cuando un usuario ha conectado su cuenta, usted obtiene un account_id. Cada llamada utiliza su clave de API de Unipile en el encabezado X-API-KEY. La segunda pestaña muestra, a modo de comparación, una primera llamada a la Graph API de Meta: leer las últimas publicaciones de una Página con un Page access token.

# 1. Listar los chats de Facebook de una cuenta conectada
curl --request GET \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats" \
  --header "X-API-KEY: {YOUR_API_KEY}"

# 2. Responder en uno de esos chats
curl --request POST \
  --url "https://api.unipile.com/v2/{ACCOUNT_ID}/chats/{CHAT_ID}/messages/send" \
  --header "X-API-KEY: {YOUR_API_KEY}" \
  --header "content-type: application/json" \
  --data '{ "text": "Gracias por su mensaje, su pedido sale hoy." }'
# Leer las 3 últimas publicaciones de una Página (Graph API v27.0)
# Requiere un Page access token con pages_read_engagement y pages_read_user_content
curl "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?fields=id,message,created_time&limit=3&access_token={PAGE_ACCESS_TOKEN}"

# Respuesta (resumida)
{ "data": [ {
    "id": "{PAGE_ID}_{POST_ID}",
    "message": "Nuestro menú de otoño empieza el lunes.",
    "created_time": "2026-11-16T09:30:00+0000"
  } ],
  "paging": {
    "cursors": { "before": "{CURSOR}", "after": "{CURSOR}" },
    "next": "https://graph.facebook.com/v27.0/{PAGE_ID}/feed?..."
  } }
200 OK · mensaje enviado desde la cuenta del usuario
200 OK · publicaciones de una Página, un token de Página por Página

Configuración paso a paso en el quickstart de Facebook. Solicitud de la Graph API verificada con la referencia del feed de Página de Meta el 17 de noviembre de 2026.

Cumplimiento

Cada usuario conecta su propia cuenta

Unipile es una empresa independiente, no una app oficial de Meta ni un Meta Partner. Actúa en nombre de usuarios autenticados, y sus usuarios siguen sujetos a las condiciones de Meta. Utilícela para casos legítimos como la atención al cliente, el CRM y las conversaciones directas.

Referencia de la API

Endpoints de la API de Facebook con Unipile

En resumen

Unipile expone Facebook a través de una sola API REST. Sus endpoints V2 cubren los chats y mensajes de Messenger, las publicaciones, los comentarios, las reacciones, los perfiles, las solicitudes de amistad, las Páginas de Facebook y los webhooks. Cada llamada apunta a una cuenta conectada mediante su account_id, de modo que una sola integración sirve para una cuenta personal y para las Páginas que gestiona, sin ninguna app de Meta por su parte.

AcciónMétodo y rutaPersonal / PáginaGuía
Mensajería
Listar los chatsGET/v2/{account_id}/chatsPersonalMessenger para cuentas personales
Listar los mensajes de un chatGET/v2/{account_id}/chats/{chat_id}/messagesPersonal + Página
Descargar un archivo adjuntoGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Personal + Página
Iniciar un nuevo chatPOST/v2/{account_id}/chats/sendPersonalCómo enviar un mensaje de Messenger
Enviar un mensaje, texto o archivos adjuntosPOST/v2/{account_id}/chats/{chat_id}/messages/sendPersonal + Página
Listar, añadir o eliminar reacciones a mensajesGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsPersonal
Marcar un mensaje como leídoPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readPersonal
Publicaciones
Listar las publicaciones de un usuario o de una PáginaGET/v2/{account_id}/users/{user_id}/postsPersonal + PáginaGuía de la API de publicaciones de Facebook
Obtener una publicaciónGET/v2/{account_id}/posts/{post_id}Personal + Página
Crear una publicaciónPOST/v2/{account_id}/postsPersonal + Página
Editar o eliminar una publicaciónPATCHDELETE/v2/{account_id}/posts/{post_id}Personal + Página
Comentarios
Listar los comentarios de una publicaciónGET/v2/{account_id}/posts/{post_id}/commentsPersonalLeer y responder comentarios
Listar las respuestas a un comentarioGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesPersonal
Añadir un comentarioPOST/v2/{account_id}/posts/{post_id}/commentsPersonal
Responder a un comentarioPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personal
Editar o eliminar un comentarioPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personal
Reacciones
Listar, añadir o eliminar reacciones a publicacionesGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsPersonalLas reacciones en la guía de comentarios
Listar, añadir o eliminar reacciones a comentariosGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsPersonal
Perfiles y relaciones
Obtener un perfilGET/v2/{account_id}/users/{user_id}PersonalSincronizar los contactos con su CRM
Listar los amigosGET/v2/{account_id}/users/me/relationsPersonal
Listar seguidores o seguidosGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingPersonal
Enviar o listar solicitudes de amistadPOSTGET/v2/{account_id}/users/me/relation-requestsPersonal
Aceptar, rechazar o cancelar una solicitudPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelPersonal
Páginas de Facebook
Encontrar las Páginas de la cuentaGET/v2/{account_id}/inboxesPáginaRecorrido por la API de Páginas de Facebook
Listar los chats de una PáginaGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsPágina
Responder como la PáginaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendPágina
Publicar como la PáginaPOST/v2/{account_id}/posts con post_asPágina
Webhooks
Registrar un endpoint de webhookPOST/v2/webhooks/endpointsPersonal + PáginaSincronización del CRM en tiempo real con webhooks
Eventos de mensajesmessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newPersonal + Página
Eventos de chatschat.update, chat.deletePersonal
Mensajería
Listar los chatsGET/v2/{account_id}/chatsPersonal
Listar los mensajes de un chatGET/v2/{account_id}/chats/{chat_id}/messagesPersonal + Página
Descargar un archivo adjuntoGET/v2/{account_id}/chats/{chat_id}/messages/{message_id}/attachments/{attachment_id}Personal + Página
Iniciar un nuevo chatPOST/v2/{account_id}/chats/sendPersonal
Enviar un mensaje, texto o archivos adjuntosPOST/v2/{account_id}/chats/{chat_id}/messages/sendPersonal + Página
Listar, añadir o eliminar reacciones a mensajesGETPOSTDELETE/v2/{account_id}/chats/{chat_id}/messages/{message_id}/reactionsPersonal
Marcar un mensaje como leídoPOST/v2/{account_id}/chats/{chat_id}/messages/{message_id}/readPersonal
Publicaciones
Listar las publicaciones de un usuario o de una PáginaGET/v2/{account_id}/users/{user_id}/postsPersonal + Página
Obtener una publicaciónGET/v2/{account_id}/posts/{post_id}Personal + Página
Crear una publicaciónPOST/v2/{account_id}/postsPersonal + Página
Editar o eliminar una publicaciónPATCHDELETE/v2/{account_id}/posts/{post_id}Personal + Página
Comentarios
Listar los comentarios de una publicaciónGET/v2/{account_id}/posts/{post_id}/commentsPersonal
Listar las respuestas a un comentarioGET/v2/{account_id}/posts/{post_id}/comments/{comment_id}/repliesPersonal
Añadir un comentarioPOST/v2/{account_id}/posts/{post_id}/commentsPersonal
Responder a un comentarioPOST/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personal
Editar o eliminar un comentarioPATCHDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}Personal
Reacciones
Listar, añadir o eliminar reacciones a publicacionesGETPOSTDELETE/v2/{account_id}/posts/{post_id}/reactionsPersonal
Listar, añadir o eliminar reacciones a comentariosGETPOSTDELETE/v2/{account_id}/posts/{post_id}/comments/{comment_id}/reactionsPersonal
Perfiles y relaciones
Obtener un perfilGET/v2/{account_id}/users/{user_id}Personal
Listar los amigosGET/v2/{account_id}/users/me/relationsPersonal
Listar seguidores o seguidosGET/v2/{account_id}/users/{user_id}/followersGET/v2/{account_id}/users/{user_id}/followingPersonal
Enviar o listar solicitudes de amistadPOSTGET/v2/{account_id}/users/me/relation-requestsPersonal
Aceptar, rechazar o cancelar una solicitudPOST/v2/{account_id}/users/me/relation-requests/{request_id}/acceptPOST/v2/{account_id}/users/me/relation-requests/{request_id}/cancelPersonal
Páginas de Facebook
Encontrar las Páginas de la cuentaGET/v2/{account_id}/inboxesPágina
Listar los chats de una PáginaGET/v2/{account_id}/inboxes/PAGE_{page_id}_INBOX/chatsPágina
Responder como la PáginaPOST/v2/{account_id}/chats/PAGE_{page_id}_{thread_key}/messages/sendPágina
Publicar como la PáginaPOST/v2/{account_id}/posts con post_asPágina
Webhooks
Registrar un endpoint de webhookPOST/v2/webhooks/endpointsPersonal + Página
Eventos de mensajesmessage.new, message.update, message.delete, message.receipt.read, message.receipt.delivery, message.reaction.newPersonal + Página
Eventos de chatschat.update, chat.deletePersonal

Autenticación. Cada solicitud lleva su clave de API de Unipile en el encabezado X-API-KEY. Sus usuarios conectan su propia cuenta de Facebook mediante Hosted Auth, así que nunca crea una app de Meta, no pasa por App Review ni almacena un token de Página. Compárelo con un token de acceso de la API de Facebook y consulte el desglose de precios de la API de Messenger para los costes.

Endpoints extraídos de la documentación V2 de Facebook de Unipile y de su tabla de funcionalidades por proveedor. Última verificación: 17 de noviembre de 2026.

Casos de uso

La API de Facebook por caso de uso

La mayoría de las integraciones con Facebook entran en una de estas familias. Así se ve cada una dentro de un producto.

Su CRM
ContactosOportunidades
ContactoEtapa
Julia Chen¿Sigue en pie la demo?CualificadoFacebook
Lucas MeyerEnvíeme el presupuestoPropuestaFacebook
Sofia Rivera¡Firmado, gracias!GanadoFacebook
Daniel MoreauHablamos el lunesNuevoFacebook

Integración de Facebook Messenger con un CRM

Sincronice las conversaciones con las fichas de contacto para que los equipos de ventas y soporte respondan desde el CRM. Vea la integración de Facebook Messenger con un CRM.

Cada conversación guardada en el contacto correcto, sin copiar y pegar.

Su helpdesk
TicketsClientes
SolicitudEstado
Mia Owens¿Dónde está mi pedido? #4521AbiertoFacebook
Elena GarciaReembolso recibido #4498ResueltoFacebook
Gabriel LopezFoto adjunta #4530PendienteFacebook
Anna RossiNo puedo iniciar sesión #4476AbiertoFacebook

Chat de Facebook y Messenger

Responda a quienes escriben a una Página a través de la Messenger Platform, o a los contactos de una cuenta conectada. Vea cómo enviar un mensaje.

Las solicitudes de Facebook se responden en la herramienta de soporte habitual.

Su herramienta social
Publicar comoFacebookNorthwind BakeryFacebookAnna Lee
Pan de masa madre recién hecho cada mañana desde las 7:00.
Publicar
Nuestro menú de otoño empieza el lunesPágina · HoyPublicado
¡Gracias por 10 años increíbles!Página · 2 oct.Editado

API de publicaciones de Facebook

Cree, edite y lea publicaciones. La API oficial solo publica en Páginas, mientras que una cuenta conectada puede publicar como su usuario. Lea la guía de la API de publicaciones de Facebook.

Publicaciones redactadas, publicadas y editadas desde su propio producto.

Su herramienta de comunidad
Comentarios en la publicación de Anna Lee Nuestro menú de otoño empieza el lunes
ComentarioTema
Ben Torres¿Aceptan reservas?PreguntaFacebook
Julia Nash¡Vuelve el pan de calabaza!OpiniónFacebook
Kai Okafor¿Es sin gluten?PreguntaFacebook
Priya Rao¿Podemos reservar para 20 personas?VentasFacebook

API de comentarios de Facebook

Liste los comentarios de una publicación y después responda, edite o elimine desde la propia cuenta conectada del usuario. Los comentarios siempre provienen de esa cuenta, nunca de una Página: comentar como Página pasa por la Pages API de Meta. Lea la guía de la API de comentarios de Facebook.

Las preguntas bajo una publicación se detectan y se envían al equipo adecuado.

API de Páginas de Facebook

Publique y modere el contenido de una Página de Facebook, con un Page access token y las tareas adecuadas en la Página. Lea la guía de la API de Páginas de Facebook.

Precio de la API de Facebook Messenger

Meta presenta la Messenger Platform como de uso gratuito, mientras que los mensajes de marketing se facturan a través de los anuncios. El coste real es el tiempo de integración y de revisión. Vea el análisis completo.

¿Está creando una inbox única para varias redes? Descubra cómo funciona una API de mensajería unificada y consulte nuestra guía de la API de Instagram para la otra red de Meta.

Elija la API adecuada para su producto

La Graph API de Meta es la herramienta adecuada cuando su app gestiona sus propias Páginas o anuncios. Cuando su producto necesita las conversaciones y publicaciones de la cuenta de cada usuario, conéctelas a través de Unipile y use una sola API para Facebook y sus demás canales.

Comisión Europea
Regulado por la UE Digital Markets Act (DMA)

Cada usuario conecta su propia cuenta, sin almacenamiento de perfiles. Unipile no es Meta Partner. Nuestro enfoque de la Ley de Mercados Digitales

Preguntas frecuentes sobre la API de Facebook

Respuestas rápidas sobre claves, versiones, niveles de acceso, relación con Meta, cumplimiento y grupos.

La usan para gestionar Páginas de Facebook (publicaciones, comentarios, estadísticas), responder a las conversaciones de una Página a través de la Messenger Platform, gestionar y medir anuncios, y permitir el inicio de sesión con Facebook Login. Cada uso se basa en un producto de la Graph API con sus propios permisos.

No existe una clave única. Cree una app de Meta en Meta for Developers para obtener un App ID y un App Secret, y después consiga los access tokens: tokens de usuario con Facebook Login y tokens de Página en /me/accounts. Los permisos usados por el público necesitan Advanced Access tras el App Review.

La Graph API es la API HTTP básica para los objetos de Facebook, como usuarios, Páginas, publicaciones y comentarios. La Marketing API es un conjunto de endpoints de la Graph API para cuentas publicitarias, campañas, audiencias e informes, con sus propios permisos y requisitos empresariales.

No con la API oficial de Meta: las apps perdieron el permiso publish_actions el 1 de agosto de 2018 y solo pueden publicar en Páginas. Con Unipile, un usuario que conecta su propia cuenta de Facebook puede crear publicaciones desde ella mediante los endpoints Posts, dentro de las condiciones de Meta.

No. Meta retiró la Groups API con la Graph API v19.0 en enero de 2024, incluido el permiso publish_to_groups. Unipile tampoco cubre los grupos de Facebook.

En noviembre de 2026, el changelog de Meta indicaba la v27.0 como la versión más reciente de la Graph API. Meta publica varias versiones al año y mantiene cada una disponible durante al menos dos años, así que consulte el changelog de la Graph API antes de fijar una.

No. Unipile es una empresa independiente que trabaja junto a la Graph API de Meta, no para Meta. No es un Meta Partner ni una app oficial de Meta, y no cuenta con el respaldo, el patrocinio ni la aprobación de Meta. Facebook y Messenger son marcas comerciales de Meta Platforms, Inc.

No. Los pasos de app de Meta, Facebook Login y App Review descritos en esta guía se aplican a la API oficial de Meta. Con Unipile, cada usuario vincula su propia cuenta de Facebook, y las Páginas que gestiona, mediante una página de autenticación alojada, así que usted se ahorra esos pasos.

Está diseñada en el espíritu de la Digital Markets Act (Ley de Mercados Digitales): en lugar de que una sola app lea muchas cuentas, cada usuario conecta su propia cuenta y Unipile actúa en su nombre, sin almacenar perfiles de usuario. Detalles en nuestra página sobre la Digital Markets Act.

Sí. Tanto si llama a la Graph API como a Unipile, las cuentas de Facebook siguen sujetas a las Condiciones de servicio de Meta. Limítese a usos legítimos como la atención al cliente, el CRM y las conversaciones que las personas esperan; el spam y la automatización no autorizada pueden provocar la restricción de una cuenta.

Su app sigue limitada a las personas que tienen un rol en ella. Con Standard Access, los permisos solo pueden solicitarse a los administradores, desarrolladores y testers de la app. Para dar servicio a las Páginas de otras personas, cada permiso necesita Advanced Access, aprobado mediante el App Review, y Meta exige para ello la verificación de la empresa (Business Verification).

¿Aún tiene preguntas? Nuestro equipo está aquí para ayudarle.

Hable con un experto