Si tienes problemas para conectar Instagram, consulta la guía de solución de
problemas.
Si tu contenido está alojado en un servidor o CDN que tú controlas, asegúrate de que el crawler de publicación de Meta
pueda descargarlo. Consulta Meta Media Crawler Blocked
si ves el código de error 440 de Ayrshare (“social network could not download media from this URL”) o el código 138 con “Restricted by robots.txt” en los detalles.
- Cuenta de Instagram Business o Creator conectada con una Página de Facebook: consulta aquí.
- Solo se permiten 50 publicaciones de Instagram en un período de 24 horas. Consulta a continuación
usedQuota. - El texto de
postpuede contener hasta 5 hashtags (p. ej. #wildtimes) y 3 menciones de nombre de usuario (p. ej. @natgeo). - Los usuarios de Instagram @mencionados recibirán una notificación.
- Máximo 2200 caracteres por publicación.
- Las publicaciones con varias imágenes/videos son compatibles y se envían como carrusel. Puedes enviar hasta 10 videos e imágenes.
- Instagram no admite eliminaciones a través de una API. Las eliminaciones deben realizarse manualmente en la app de Instagram.
- Si tu video de Reel no termina con una extensión de video conocida como mp4, usa el parámetro
isVideo. Consulta el endpoint /post para más detalles. - Instagram también admite el envío de medios sin texto de publicación. Si no quieres incluir texto en la publicación,
envía una cadena vacía
post: "". - Consulta las Directrices de medios de Instagram y la Autorización de Instagram para más información.
Publicar en Instagram
JSON para una publicación básica con imagen y hashtags en Instagram:Instagram Post
La relación de aspecto de las imágenes y videos y la duración del video son muy importantes para publicar correctamente en Instagram. Si no cumplen con los requisitos, la publicación será rechazada.Consulta la sección de Instagram en las Directrices de imagen y video.
Cuenta de Instagram Business o Creator
Tu cuenta de Instagram debe ser Business o Creator y estar conectada con una Página de Facebook. La configuración es gratuita y sencilla. Consulta aquí las instrucciones detalladas:Vinculación de Instagram
Carrusel de imágenes y videos
Puedes publicar varias imágenes o videos de Reel en Instagram como un carrusel; hasta un total combinado de 10 imágenes o videos en un carrusel. Simplemente agrega tus imágenes o videos adicionales al arreglomediaUrls y el carrusel se creará automáticamente.
Instagram Carousel Post
Las URLs de video deben terminar con una extensión conocida como
mp4. El parámetro isVideo no es compatible
con los carruseles de Instagram.Instagram Reels
En Instagram, una publicación de video se llama Reel. Puedes publicar un video en la API de Instagram Reels con las siguientes opciones opcionales eninstagramOptions.
Instagram Reels Options
- Consulta los requisitos de video de la API de Reels para más detalles sobre los requisitos de video.
shareReelsFeed: Boolean con valortruepara indicar que el Reel puede aparecer en las pestañas Feed y Reels, ofalsepara indicar que el Reel solo puede aparecer en la pestaña Reels. Este valor es una sugerencia para Instagram sobre dónde te gustaría que apareciera el Reel, pero ninguno de los valores determina si el Reel realmente aparece en la pestaña Reels o Feed porque puede que el Reel no cumpla con los requisitos de elegibilidad o no sea seleccionado por el algoritmo de Instagram.audioName: nombre en String del audio o música de tu Reel. Solo puedes renombrarlo una vez, ya sea al crear el reel o después desde la página de audio. Por ejemplo,"The Weeknd - Blinding Lights".thumbNail: URL en String de la imagen de portada (thumbnail) del Reel. Consulta aquí los detalles sobre thumbNail.thumbNailOffset: desplazamiento entero en milisegundos del frame de la miniatura. Consulta aquí los detalles sobre thumbNailOffset.
Trial Reels
Un trial reel es un Reel que se publica únicamente para no seguidores cuando se publica por primera vez, lo que te permite probar cómo funciona un Reel con una audiencia nueva antes de que llegue a tus seguidores existentes. EstablecetrialParams.graduationStrategy en instagramOptions para publicar un Reel como trial.
Instagram Trial Reel
graduationStrategy controla cómo un trial reel más tarde “gradúa” — es decir, se vuelve visible también para tus seguidores. Es obligatorio cuando se proporciona trialParams y debe ser uno de:
“MANUAL”— la publicación permanece como trial reel hasta que la gradúes manualmente desde la app de Instagram.“SS_PERFORMANCE”— Meta gradúa automáticamente el Reel según el rendimiento inicial frente a no seguidores.
La graduación en sí (promover un trial reel publicado a los seguidores) no está expuesta actualmente
por la API de Meta y debe realizarse manualmente en la app de Instagram. Ayrshare añadirá un endpoint
de graduación una vez que Meta lo exponga.
Restricciones de trial reels
La solicitud de trial reel se rechaza en el borde de Ayrshare — antes de cualquier llamada a Meta — cuando no se cumple alguna de estas condiciones:- Exactamente una URL de medio que termine en
.mp4o.mov(sin distinguir mayúsculas/minúsculas). Los carruseles no están admitidos. instagramOptions.storiesno debe sertrue. Las Stories no pueden ser trial reels.graduationStrategydebe estar presente y ser exactamente“MANUAL”o“SS_PERFORMANCE”(distingue mayúsculas/minúsculas).
447, 448, 449) para ver los payloads completos.
Instagram Stories
Puedes publicar una sola imagen o video como Story de Instagram con las siguientesinstagramOptions. Las Stories de Instagram desaparecen después de 24 horas.
Stories Post
- Las Stories de Instagram no admiten texto de publicación: cualquier texto proporcionado en el campo
post, incluidas las menciones, será ignorado. - Las Stories expiran después de 24 horas.
- Instagram actualmente solo admite la publicación de Stories en cuentas de Instagram Business y no en cuentas Creator.
- Las Stories de Instagram no admiten colaboradores.
- Instagram no admite la publicación de stickers (por ejemplo, enlace, encuesta, ubicación).
Miniaturas de Reels
Puedes seleccionar un frame del Reel como imagen de miniatura o tu propia imagen de portada (thumbnail) desde una URL externa.Instagram Thumbnail
0, que corresponde al primer frame del Reel.
Si especificas tanto una URL de miniatura como un offset de miniatura, el offset será ignorado.
La miniatura del Reel debe cumplir con los requisitos de miniatura de Reels.
No se garantiza que las URLs firmadas con redirecciones sean compatibles con URLs de portada.
Recomendamos usar una URL no firmada o el endpoint /media.
Texto alternativo
Añade texto alternativo de Instagram, también conocido como alt text, a una imagen. El alt text de Instagram es una función de accesibilidad utilizada para brindar información adicional al usuario y para lectores de pantalla.- El alt text admite hasta 1000 caracteres por imagen.
- Instagram no admite alt text para Reels o Stories.
altText dentro del objeto instagramOptions.
Instagram Alt Text
mediaUrls.
El alt text se aplicará a cada imagen en orden.
Etiquetas de usuario y ubicaciones
El usuario de Instagram será notificado cuando uses su nombre de usuario en una publicación. Ten cuidado de
no hacer spam a los usuarios ni publicar su nombre de usuario repetidamente. Si lo haces, Instagram podría suspender o
desactivar tu cuenta.
instagramOptions.
Ubicación
Una ubicación se especifica mediante unlocationId, que es un ID de Página de Facebook o un nombre de Página de Facebook. Por ejemplo, el ID de página de Facebook del Museo Guggenheim es 7640348500 o el nombre de página de Facebook "@guggenheimmuseum". Las páginas deben estar asociadas con una ubicación física.
Instagram Location
locationId (Page Id) con el endpoint brand. Ten en cuenta que la Página debe tener una ubicación listada o el locationId devolverá un error.
No admitido en imágenes o videos dentro de carruseles.
Etiquetas de usuario
Las etiquetas de Instagram te permiten etiquetar a otros usuarios de Instagram en tu publicación. Los usuarios se especifican medianteuserTags, que contiene un arreglo de objetos con un nombre de usuario de Instagram y coordenadas x/y (solo imagen). Las etiquetas de usuario se pueden agregar a imágenes individuales o Reels, pero no a videos normales, imágenes múltiples o Stories.
- Los nombres de usuario deben ser cuentas públicas de Instagram. No incluyas el @ del handle del usuario.
- Los valores
xeydeben ser númerosfloatque se originen desde la esquina superior izquierda de la imagen, con un rango de0.0–1.0. Solo para imágenes individuales. No incluyas con Reels o se producirá un error.
Instagram User Tags
Menciones en Instagram
Menciona a otro handle de Instagram agregando @handle en el texto de la publicación. Por ejemplo, puedes mencionar al handle @ayrshare en el texto de la publicación:Instagram Mentions
Colaboración
La colaboración de Instagram te permite ser coautor de contenido con otras cuentas de Instagram etiquetando a otros como colaboradores. Esto te permite designar a otros usuarios de Instagram como creadores en tu publicación. Al ser etiquetados, estos usuarios reciben una invitación para colaborar en la app móvil. Si aceptan, la publicación también aparecerá en su feed y será visible para sus seguidores, ampliando el alcance y el potencial de interacción de la publicación.Colaboradores
El autor original público puede etiquetar a otra cuenta pública como colaborador de Instagram. La otra cuenta recibirá un mensaje que le permitirá aceptar o rechazar la solicitud. Si la otra cuenta acepta, la publicación también aparecerá en su perfil y se distribuirá a sus seguidores en el feed de Instagram. El encabezado de la publicación atribuirá el contenido a ambas cuentas. Puedes añadir colaboradores a un Reel, imagen o carrusel. Etiquetar a un colaborador privado no está permitido a través de la API de Instagram. Aunque esta funcionalidad existe dentro de la app de Instagram, las plataformas y sus APIs a menudo no están a la paridad de funciones. Invita a hasta tres colaboradores usando un arreglo de nombres de usuario públicos de Instagram.Instagram Collaborators
Obtener el estado de la solicitud de colaborador
Después de invitar a un colaborador de Instagram, puedes verificar el estado de la solicitud usando la API para obtener el estado de la solicitud de colaborador.Redimensionamiento automático de imagen
Se requiere Max Pack
autoResize. Ten en cuenta que esto redimensionará la imagen para todas las plataformas incluidas, por lo que recomendamos hacer una llamada para Instagram y una llamada /post diferente para otras plataformas.
Instagram Auto Image Resize
Cuota utilizada
La respuesta de Instagram incluirá elusedQuota actual con el número de publicaciones de Instagram realizadas durante un período móvil de 24 horas. Instagram solo permite 50 publicaciones de Instagram en un período móvil de 24 horas.
Instagram Used Quota
Problemas de contenido
Ayrshare incluye protección de medios integrada que puede detectar y resolver ciertos problemas de entrega de medios durante la publicación. Cuando una publicación tiene éxito pero se detectó y resolvió un problema de contenido, la respuesta incluye un objeto opcionalcontentIssues. Esto te permite identificar y solucionar de forma proactiva los problemas con el hosting de tus medios.
El objeto contentIssues solo está presente cuando se detectó y resolvió un problema — las publicaciones exitosas normales no lo incluyen.
| Campo | Tipo | Descripción |
|---|---|---|
originMediaHostFailed | boolean | La red social no pudo obtener el medio desde la URL proporcionada. La protección automatizada de medios de Ayrshare resolvió el problema y completó la publicación con éxito. Considera revisar tu configuración de hosting de medios — consulta Meta Media Crawler Blocked para causas comunes. |
details | array of strings | Descripciones legibles por humanos de cada problema detectado. |
Content Issues Response Example
Detalles de errores
Cuando falla una publicación de medios en Instagram, el objeto de error ahora expone el texto de error subyacente de Meta en el campo
details, junto con el code y message de Ayrshare. Esto te permite distinguir entre distintas causas raíz (por ejemplo, un rechazo por relación de aspecto frente a un fallo de descarga de medios) sin tener que contactar con soporte.Instagram Publish Error
message es el resumen estable y legible por humanos de Ayrshare, mientras que details refleja el texto sin procesar devuelto por Meta para la publicación fallida.
