PluggzyDocs

Instagram Business

Bandeja de entradaComentariosMétricasPublicacionesReels e historias
Bandeja de entradaComentariosMétricasPublicacionesReels e historias

Para cuentas profesionales y de creador, con la API oficial de Instagram: responde mensajes directos dentro de la ventana de respuesta de Meta, gestiona comentarios, consulta métricas y publica posts, Reels e historias desde cualquier app de IA.

Conexión con
tu inicio de sesión de Instagram, en tu navegador
Herramientas
16
25 / díapublicaciones, al momento o programadas
2–5 sentre acciones, al azar
2200caracteres de descripción
200 / díamensajes y respuestas

Límites

AcciónPor díaPor minutoSeparación mín.RitmoHerramientas
Lecturasopciones de publicación y listas de cuentas300030——list_chatsget_messagespost_optionslist_postslist_commentsget_insights
Cambios en la bandejamarcar como leído, reacciones500101 s—mark_readreact
Mensajes200102 s2–5 ssend_messagecommentprivate_reply
Publicaciones25230 s2–5 screate_post
Eliminacionescomentarios3035 s—moderate_comment
Publicaciones programadaslistar y cancelar————list_scheduled_postscancel_scheduled_post
Lecturas3000/día
opciones de publicación y listas de cuentas
30/min · sin ritmo
list_chatsget_messagespost_optionslist_postslist_commentsget_insights
Cambios en la bandeja500/día
marcar como leído, reacciones
10/min · separación mín. 1 s
mark_readreact
Mensajes200/día
10/min · separación mín. 2 s · ritmo 2–5 s
send_messagecommentprivate_reply
Publicaciones25/día
2/min · separación mín. 30 s · ritmo 2–5 s
create_post
Eliminaciones30/día
comentarios
3/min · separación mín. 5 s
moderate_comment
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 (solo PDF, hasta 15 MB) por mensaje. Los archivos que te envían llegan como enlaces.
  • Los límites diarios se reinician a las 00:00 UTC; los semanales, el lunes a las 00:00 UTC.
  • Listar y cancelar publicaciones programadas se hace en Pluggzy y no consume ninguna llamada a Instagram Business.

Reglas de publicación

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

DescripciónobligatorioHasta 2200 caracteres, en text.
Archivos multimediaobligatorioObligatorio: hasta 20 imágenes (image_urls) o un video (video_url), no ambos. Los archivos de tu dispositivo pasan antes por upload_media.
storyPublish as a Story (one image, or one video ≤60 s) instead of a feed post or Reel.
share_to_feedInstagram Business, Reels: also show the Reel in the feed (default true)
first_commentInstagram Business, Facebook and LinkedIn Pages: posted as the first comment right after publishing (the place for links; not for Stories)
collaboratorsUp to 3 usernames of public Business or Creator accounts invited as collaborators (not for Stories)
thumbnail_urlCover of a Reel

Límites de seguridad

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

Ritmo2–5 s
Separación aleatoria entre acciones de Instagram Business, en todas las apps y claves de esta cuenta.
Sin publicaciones duplicadas10 min
La misma publicación en la misma cuenta en menos de 10 minutos devuelve la primera respuesta en lugar de publicar dos veces.
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 Instagram Business. Mientras tanto, cada llamada recibe el tiempo que falta.
Ventana de programación1 año
publish_at debe ser al menos un minuto en el futuro, y como máximo un año. Los enlaces deben seguir funcionando hasta entonces; los archivos subidos se guardan con la publicación.
Eliminación de comentarios30 / día
Muchas menos de las que se pueden ocultar, para que un bucle erróneo no pueda borrar los comentarios de una publicación.
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.

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.

invalid_postLa publicación incumple una regla de Instagram Business. El mensaje dice cuál.
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.
cooldownInstagram Business 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": "Instagram Business actions are spaced 2–5 s apart, at random, to look human. Wait 2s.",
  "code": "gap",
  "retry_after_seconds": 2
}

Analíticas

Lo que get_insights lee en Instagram Business. Pregunta con tus propias palabras; tu app de IA elige el informe.

Resumenoverview predeterminadoVistas, alcance, interacción y seguidores en los últimos days, con los términos de cada red más un resumen común a todas. Sin account, todas las cuentas con analíticas lado a lado.
Seguidoresfollowers El número de seguidores día a día (suscriptores en YouTube), con los seguidores ganados y perdidos.
Audienciaaudience Seguidores por país y ciudad, y por edad y género cuando la red lo reporta.
Mejores publicacionestop_posts Tus mejores publicaciones del periodo, ordenadas por interacción o por sort (vistas, alcance, me gusta, comentarios, compartidos, fecha). Sin account, en todas las cuentas con analíticas.
Mejor hora para publicartiming Los días de la semana y franjas horarias que mejor funcionan para tus publicaciones (en UTC), con qué frecuencia publicas frente a la interacción que recibes y lo rápido que llegan a su pico. Instagram: cuándo están conectados tus seguidores.
Actividad de la bandejainbox Mensajes recibidos y enviados, la mediana del tiempo hasta la primera respuesta y las horas de más actividad.
Una publicaciónpost Las cifras de una publicación, por el post_id de list_posts, de las mejores publicaciones o de create_post. details: true añade su curva día a día y los datos extra de la red.

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.

16 herramientas · 7 de lectura · 9 de escritura
Bandeja de entrada5

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 · 200/díaCon ritmo 2–5 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:04
  1. Recibida09:41:02
  2. Dentro de los límites56 de 200 hoy
  3. Espaciada+2 s
  4. Enviada09:41:04
Mensajes hoy: 56 de 200 usados · se reinicia a las 00:00 UTC
El contenido de texto empieza con “Message sent.” · Puede rechazar congaplimitcooldownpermission
Publicar3
Publicaciones1
Comentarios y reseñas4
Publicaciones programadas2
Analíticas1
Generado desde pluggzy.com/api/docs · 42 herramientas¿Algo no está claro? Escribe a soporte · Estado del servicio