Instagram Business
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.
Límites
- 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.
text.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 ReelLí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.
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.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.{ "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.
overview 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.followers El número de seguidores día a día (suscriptores en YouTube), con los seguidores ganados y perdidos.audience Seguidores por país y ciudad, y por edad y género cuando la red lo reporta.top_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.timing 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.inbox Mensajes recibidos y enviados, la mediana del tiempo hasta la primera respuesta y las horas de más actividad.post 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.
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).
accountstringaccount_id from list_accounts (a listed chat's account_id). Needed only when several accounts are connected.chat_idstringobligatoriotextstringobligatorioimage_urlstringmedia_id instead.file_urlstringmedia_id instead.media_idstringupload_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{ "structuredContent": { "chat_id": "gq5Xp3bZUXCt6Zt1Z2rTsA", "message_id": "7mKQx2VdTnW8bLr4Yc9ey7", "sent": true }, "content": [ { "type": "text", "text": "Message sent." } ] }
- Recibida09:41:02
- Dentro de los límites56 de 200 hoy
- Espaciada+2 s
- Enviada09:41:04