PluggzyDocs

Messenger

Bandeja de entradaSolicitudes de mensajesPáginas
Bandeja de entradaSolicitudes de mensajesPáginas

Messenger es tu inicio de sesión de Facebook con nombre propio: lee y responde tus chats, solicitudes de mensajes y conversaciones de páginas desde cualquier app de IA, con 10–20 segundos de separación. Usa las mismas herramientas de conversación que todos los canales.

Conectar Messenger
Conexión con
correo y contraseña, en tu navegador
Herramientas
10
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 Messenger 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 minutoSeparación mín.RitmoHerramientas
Lecturasbandeja, invitaciones, lista de publicaciones300030——list_chatsget_messagesget_attachmentlist_group_membersfacebook_list_pages
Cambios en la bandejamarcar como leído, reacciones500101 s—mark_readreact
Mensajes50215 s10–20 ssend_messageaccept_message_request
Conversaciones nuevas1011 min10–20 sstart_chat
Lecturas3000/día
bandeja, invitaciones, lista de publicaciones
30/min · sin ritmo
list_chatsget_messagesget_attachmentlist_group_membersfacebook_list_pages
Cambios en la bandeja500/día
marcar como leído, reacciones
10/min · separación mín. 1 s
mark_readreact
Mensajes50/día
2/min · separación mín. 15 s · ritmo 10–20 s
send_messageaccept_message_request
Conversaciones nuevas10/día
1/min · separación mín. 1 min · ritmo 10–20 s
start_chat
  • 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 Messenger 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.
visibilityLinkedIn: anyone (default) or relations_only (connections). Facebook: anyone (default: everyone) or relations_only (friends; not as a Page). YouTube: public (default), private or unlistedanyonerelations_onlypublicprivateunlisted
as_pageFacebook: publish as this Page (page_id from facebook_list_pages) instead of the personal account
share_post_idFacebook: post_id of a post to share (text optional, no image; not schedulable)

Límites de seguridad

Lo que mantiene tu cuenta de Messenger 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 Messenger. 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.
cooldownMessenger 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

Messenger usa las herramientas de chat de Facebook: el mismo inicio de sesión, los mismos límites.

10 herramientas · 5 de lectura · 5 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
Las mismas herramientas en cada canal de mensajeríalist_chats, get_messages, send_message, start_chat y mark_read funcionan igual en Messenger 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