PluggzyDocs

Facebook

Bandeja de entradaPáginasAmigosGruposPublicaciones
Bandeja de entradaPáginasAmigosGruposPublicaciones

Lee y responde tus mensajes de Facebook, incluidas las páginas que administras, consulta amigos y grupos, y publica desde cualquier app de IA. Cada acción va separada por 10–20 segundos, y las solicitudes de amistad se mantienen al mínimo.

Conectar Facebook
Conexión con
correo y contraseña, en tu navegador
Herramientas
24
3 / díapublicaciones, al momento o programadas
10–20 sentre acciones, al azar
10.000caracteres de texto
50 / díamensajes y respuestas

Límites

Por cada cuenta de Facebook conectada, compartidos por todas las apps de IA y claves de API que la usan. Las mismas herramientas funcionan en todas las redes: cada cuenta conserva sus propios límites.

AcciónPor díaPor semanaPor minutoSeparación mín.RitmoHerramientas
Lecturasbandeja, invitaciones, lista de publicaciones3000—30——list_chatsget_messagesget_attachmentlist_group_memberspost_optionslist_postslist_commentsfacebook_list_pagesfacebook_list_friends
Cambios en la bandejamarcar como leído, reacciones500—101 s—mark_readreactfacebook_edit_postfacebook_react_post
Visitas a perfiles50—55 s10–20 sget_profile
Mensajes50—215 s10–20 ssend_messageaccept_message_requestcomment
Conversaciones nuevas10—11 min10–20 sstart_chat
Invitacionessolicitudes de conexión156011 min10–20 sfacebook_friend_requestfacebook_follow
Publicaciones3—15 min10–20 screate_post
Publicaciones programadaslistar y cancelar—————list_scheduled_postscancel_scheduled_post
Lecturas3000/día
bandeja, invitaciones, lista de publicaciones
30/min · sin ritmo
list_chatsget_messagesget_attachmentlist_group_memberspost_optionslist_postslist_commentsfacebook_list_pagesfacebook_list_friends
Cambios en la bandeja500/día
marcar como leído, reacciones
10/min · separación mín. 1 s
mark_readreactfacebook_edit_postfacebook_react_post
Visitas a perfiles50/día
5/min · separación mín. 5 s · ritmo 10–20 s
get_profile
Mensajes50/día
2/min · separación mín. 15 s · ritmo 10–20 s
send_messageaccept_message_requestcomment
Conversaciones nuevas10/día
1/min · separación mín. 1 min · ritmo 10–20 s
start_chat
Invitaciones15/día
60/semana · solicitudes de conexión
1/min · separación mín. 1 min · ritmo 10–20 s
facebook_friend_requestfacebook_follow
Publicaciones3/día
1/min · separación mín. 5 min · ritmo 10–20 s
create_post
Publicaciones programadas—
listar y cancelar
list_scheduled_postscancel_scheduled_post
  • Archivos en mensajes: una imagen (JPEG, PNG o WebP, hasta 8 MB) o un documento (PDF, Word, Excel, PowerPoint, TXT o CSV, hasta 15 MB) por mensaje. Tu IA ve las imágenes que te envían (hasta 3.75 MB) y lee archivos PDF, Word, Excel, TXT y CSV como texto (hasta 15 MB).
  • Los límites diarios se reinician a las 00:00 UTC; los semanales, el lunes a las 00:00 UTC.

Reglas de publicación

Lo que Facebook acepta, comprobado antes de enviar nada, para que una publicación incorrecta no cueste nada.

TextoobligatorioHasta 10.000 caracteres, en text.
Archivos multimediaOpcional: una imagen (image_urls) o un video (video_url; 500 MB como máximo, de 1 segundo a 240 minutos), no ambos. Los archivos de tu dispositivo pasan antes por upload_media.
visibilityAnyone (default: everyone) or relations_only (friends; not as a Page).anyonerelations_only
as_pagePublish as this Page (page_id from facebook_list_pages) instead of the personal account
share_post_idPost_id of a post to share (text optional, no image; not schedulable)

Límites de seguridad

Lo que mantiene tu cuenta de Facebook en buen estado. Se aplican a todas las apps de IA y claves de API de esta cuenta, y no se pueden desactivar.

Ritmo humano10–20 s
Separación aleatoria entre visitas a perfiles, búsquedas, mensajes, conversaciones nuevas, invitaciones y publicaciones, en todas las apps y claves.
Límite por cuenta10 / min
Como máximo 10 llamadas por minuto por cuenta en total, sin contar lecturas, además del límite por minuto de cada acción.
Pausa si la red pone freno5 min
Tras una respuesta de límite de uso, la cuenta descansa al menos 5 minutos, 30 si lo pidió el propio Facebook. Mientras tanto, cada llamada recibe el tiempo que falta.
Las lecturas en caché son gratis1 h
Las conversaciones y los perfiles se guardan en caché y no cuestan nada. fresh: true fuerza una lectura en vivo.
Conversaciones nuevas10 / día
Los mensajes en frío son lo que lleva a que restrinjan una cuenta, así que las conversaciones nuevas se mantienen al mínimo. Las respuestas en chats existentes no se ven afectadas.
Solicitudes de amistad y seguimientos15 / día
Se mantienen bajos, 60 por semana como máximo: Facebook bloquea las cuentas que envían muchas.

Cuando se alcanza un límite

Nada se pone en cola ni se reintenta a tus espaldas: la herramienta responde con un error que tu app de IA puede leer, explicarte y reintentar en el momento justo.

gapDemasiado pronto después de la última acción. Espera retry_after_seconds.
limitSe agotó el límite diario o semanal. Indica cuándo se reinicia.
cooldownFacebook puso freno; la cuenta está descansando.
permissionEsta app no tiene permiso para hacer eso. Vuelve a conectarla y permítelo.
Ejemplo de rechazo
isError
{
  "error": "Facebook actions are spaced 10–20 s apart, at random, to look human. Wait 10s.",
  "code": "gap",
  "retry_after_seconds": 10
}

Herramientas

Exactamente lo que tu app de IA recibe de tools/list. Las herramientas de escritura envían o cambian algo en tu cuenta: los buenos asistentes te muestran el texto antes de enviarlo.

24 herramientas · 11 de lectura · 13 de escritura
Bandeja de entrada10

Reply in an existing conversation (chat_id from list_chats), on any network: 1-to-1, group, or a Facebook Page's chat (answered as the Page). Plain text. Show the user the exact text (and which file) before calling this. One file can go with the text: image_url (an https link to an image), file_url (an https link to a document) or media_id (from upload_media, for an image or a document the user has on their device or attached in the chat). Documents: PDF, Word, Excel, PowerPoint (docx, xlsx, pptx, doc, xls, ppt), TXT or CSV, at most 15 MB; WhatsApp, Telegram, LinkedIn and Facebook Messenger take PDF, Word, Excel, PowerPoint, TXT and CSV files; Instagram takes PDFs only; Instagram Business takes PDFs only and Facebook Pages any of them. Instagram Business allow replies within 24 hours of the person's last message (Instagram: at most 1000 characters, JPEG or PNG); up to 7 days after it, only a reply the user wrote or approved word for word, with user_written: true (never for text you wrote on your own).

Permiso Send messages & postsLímite Mensajes · 50/díaCon ritmo 10–20 sConfirmar primero con el usuario
Entrada7 parámetros · 2 obligatorios
accountstring
account_id from list_accounts (a listed chat's account_id). Needed only when several accounts are connected.
chat_idstringobligatorio
textstringobligatorio
máx. 8000 caracteres
image_urlstring
https link to a JPEG, PNG or WebP image (at most 8 MB) that is already online. Optional. For an image the user attached in the chat or has on their device, use media_id instead.
https://
file_urlstring
https link to a document that is already online (PDF, Word, Excel, PowerPoint (docx, xlsx, pptx, doc, xls, ppt), TXT or CSV, at most 15 MB). Optional. For a file the user has on their device or attached in the chat, use media_id instead.
https://
media_idstring
An image or a document the user uploaded: call upload_media, then pass its media_id here once the file is uploaded (the user says so, or your own upload_command answered ok).
user_writtenboolean
Instagram Business: true only when the user typed this exact text or approved it word for word: lets the reply go out up to 7 days after the person's last message instead of 24 hours
por defecto false
SalidastructuredContent
{
  "structuredContent": {
    "chat_id": "gq5Xp3bZUXCt6Zt1Z2rTsA",
    "message_id": "7mKQx2VdTnW8bLr4Yc9ey7",
    "sent": true
  },
  "content": [
    {
      "type": "text",
      "text": "Message sent."
    }
  ]
}
Qué hizo el filtroEjemplo09:41:02 → 09:41:14
  1. Recibida09:41:02
  2. Dentro de los límites14 de 50 hoy
  3. Espaciada+12 s
  4. Enviada09:41:14
Mensajes hoy: 14 de 50 usados · se reinicia a las 00:00 UTC
El contenido de texto empieza con “Message sent.” · Puede rechazar congaplimitcooldownpermission
Personas e invitaciones4
Publicar3
Publicaciones2
Comentarios y reseñas3
Publicaciones programadas2
Las mismas herramientas en cada canal de mensajeríalist_chats, get_messages, send_message, start_chat y mark_read funcionan igual en Facebook y en todos los demás canales de mensajería; cada cuenta conserva sus propios límites.
Herramientas de conversación
Generado desde pluggzy.com/api/docs · 42 herramientas¿Algo no está claro? Escribe a soporte · Estado del servicio