API Tutorial
Cómo enviar mensajes de Facebook por API
Para enviar mensajes de Facebook por API, conecta Facebook a través de Modiva y luego llama a `messages_send` con el destinatario y el texto — lee la conversación con `messages_list` para impulsar bandejas de entrada y respuestas automáticas con IA.
La mensajería programática en Facebook suele implicar abrirse paso entre APIs de mensajería específicas de cada plataforma y sus aprobaciones. Modiva lo abstrae en `messages_send`, `messages_list` y `messages_inbox`, de modo que una bandeja de entrada unificada o un respondedor de IA funcionan en Facebook igual que en cualquier otro sitio.
Paso a paso
Crea una cuenta de Modiva y una clave MCP
Regístrate gratis y genera una clave MCP (`mk_live_…`) en el panel. La misma clave autentica tanto el servidor MCP alojado (para agentes de IA) como la API REST (para tu backend), así que solo gestionas una credencial.
Conecta tu cuenta de Facebook
En el panel, haz clic en Conectar y elige Facebook. Modiva ejecuta el flujo de OAuth y solicita los scopes adecuados por ti, luego guarda los tokens de acceso y de actualización en una bóveda cifrada y los mantiene al día — nunca manipulas las credenciales de API sin procesar de Facebook. La conexión recibe un `connectionId` estable al que haces referencia en cada llamada.
Envía un mensaje con messages_send
Llama a `messages_send` con el ID de conexión, un `recipient_id` y tu texto. Modiva lo entrega a través de Facebook y devuelve el ID del mensaje, respetando las ventanas y reglas de mensajería de Facebook.
Construye una bandeja de entrada o un respondedor de IA
Usa `messages_inbox` y `messages_list` para traer las conversaciones a una sola vista. A través de MCP, un agente puede leer un mensaje entrante de Facebook, decidir una respuesta y contestar con `messages_send` — un ciclo completo de soporte con IA.
Solicitud de ejemplo
Llama a la herramienta messages_send a través de la API REST de Modiva. La misma herramienta está disponible para los agentes de IA en el servidor MCP en https://mcp.modiva.ai/v1.
curl -X POST https://api.modiva.ai/v1/tools/invoke \
-H "Authorization: Bearer mk_live_…" \
-H "Content-Type: application/json" \
-d '{
"tool": "messages_send",
"connectionId": "conn_…",
"args": { "recipient_id": "u_456", "text": "Hi! How can we help today?" }
}'Pruébalo con Facebook
Empieza gratisPreguntas frecuentes
¿Puedo construir una bandeja de entrada unificada que incluya Facebook?
Sí. `messages_inbox` devuelve las conversaciones de Facebook en la misma forma que cualquier otro canal, de modo que una única interfaz de bandeja de entrada las cubre todas.
¿Respeta Modiva las reglas de mensajería de Facebook?
Sí — Modiva aplica las ventanas de mensajería y los requisitos de política de Facebook, para que tus envíos sigan siendo conformes.