API y MCP de Facebook: publica, atiende Messenger y recibe leads de tus formularios

28 de octubre de 2026 · Equipo Zoosial

Zoosial ofrece una API REST y un servidor MCP para operar páginas de Facebook: publicar y programar, leer y moderar comentarios, responder Messenger, recibir los leads de formularios de anuncios por webhook y consultar métricas. Funciona con las APIs oficiales de Meta sobre una Página (no sobre un perfil personal) y se puede usar desde tu código o desde un agente de IA.

Qué puedes hacer

• Publicar o programar en la Página: POST /posts. Subir media: POST /upload.
• Ver el historial con reacciones, comentarios y veces compartido: GET /accounts/:id/history. Borrar un post: DELETE /accounts/:id/posts/:objectId.
• Comentarios: GET /accounts/:id/comments?objectId=, responder con POST /accounts/:id/comments, borrar con DELETE /accounts/:id/comments/:commentId y ocultar con POST /accounts/:id/comments/hide (exclusivo de Facebook).
• Responder por privado a un comentario: POST /accounts/:id/comments/:commentId/private-reply.
• Messenger: GET /accounts/:id/conversations, GET /accounts/:id/conversations/:convId y POST /accounts/:id/messages.
• Leads de formularios: GET /accounts/:id/lead-forms, GET /accounts/:id/leads?formId= y POST /accounts/:id/lead-forms para crear un formulario.
• Embudo propio sobre cada lead: PATCH /accounts/:id/lead-states/:leadId.
• Comentario a mensaje: POST /automations con platform: "facebook".
• Métricas: GET /accounts/:id/insights y GET /accounts/:id/post-insights?objectId=.

Cómo conectar la cuenta

Un perfil de Zoosial admite una sola Página de Facebook. Para una segunda Página, crea otro perfil.

1. Crea el perfil con POST /profiles y guarda el id (prof_…); no uses un identificador inventado.
2. Para una app con tus propios usuarios, registra tu redirectUri en la API key y llama POST /connect/sessions con profileId, platform: "meta", redirectUri, clientState y endUserId. La url que devuelve es de un solo uso y caduca en 10 minutos; se abre en el navegador de tu usuario, que autoriza en Facebook.
3. Meta vuelve a tu redirectUri con un ct válido 15 minutos. GET /profiles/:id/connect/meta/available?ct= lista las Páginas y POST /profiles/:id/connect/meta con { ct, pageId } conecta una. Si el perfil ya tiene otra Página, /connect/meta/new-profile crea un perfil nuevo con ella.

Para uso interactivo, GET /connect/meta?profileId=… devuelve el authUrl. Detalle en Facebook.

Ejemplo

Publicar en la Página ahora mismo:

curl -X POST https://zoosial.com/posts \
  -H "Authorization: Bearer $SC_API_KEY" -H "Content-Type: application/json" \
  -d '{"platforms":[{"accountId":"acc_456"}],"content":"Novedades esta semana","publishNow":true}'

Por MCP

El servidor MCP vive en https://zoosial.com/mcp y se autoriza con tu cuenta. Herramientas para Facebook:

• Publicar: create_post, list_posts, account_history y delete_post (confirma).
• Comentarios y mensajes: list_comments, reply_comment, hide_comment, list_conversations y send_dm.
• Leads: lead_forms, lead_form_detail, create_lead_form, leads, lead_states y set_lead_state.
• Automatización: list_automations, create_automation y delete_automation (confirma).
• Métricas: account_insights, post_insights, analytics_summary y followers_history.

Las herramientas marcadas «escribe» crean o envían algo, y create_post publica de verdad. Con permiso de solo lectura el agente no cambia nada. Guía: servidor MCP.

Reglas y límites

• Messenger solo permite responder dentro de las 24 horas siguientes al último mensaje de la persona. Después la API responde 422. El permiso Human Agent de Meta, que lo ampliaría, todavía no lo concede a Zoosial según la página de bandeja.
• Facebook se conecta con Páginas, no con perfiles personales.
• Meta no permite editar un formulario ya creado: si cambias las preguntas, se crea otro.
• Zoosial lee los leads de formularios de Meta; no existe POST /leads para crearlos.

Los leads llegan solos por el evento lead.received, con el lead anidado en data.lead; para probar tu receptor usa POST /accounts/:id/lead-forms/:formId/test-webhook.

Precio

Publicar, bandeja, leads, comentario a mensaje, API, webhooks y MCP están incluidos en el plan gratis: 1 perfil con hasta 3 cuentas, 20 textos con IA al día, sin tarjeta. El plan por perfil cuesta $95 MXN al mes + IVA por perfil, con el primero gratis; hay tramos más baratos con más perfiles. Consulta precios.

Compáralo

¿Evaluando otras opciones? Revisa las comparativas y el artículo API para conectar redes sociales. Contrato: /llms.txt.

Preguntas frecuentes

← Todas las integraciones