Se você tiver problemas para conectar o Instagram, consulte o guia de
solução de problemas.
Se sua mídia estiver hospedada em um servidor ou CDN que você controla, certifique-se de que o crawler de publicação da Meta
consiga acessá-la. Consulte Meta Media Crawler Blocked
se você vir o código de erro 440 do Ayrshare (“social network could not download media from this URL”) ou o código de erro 138 com “Restricted by robots.txt” nos detalhes.
- Conta Business ou Creator do Instagram conectada a uma Facebook Page - veja aqui.
- Apenas 50 publicações no Instagram são permitidas em um período de 24 horas. Veja abaixo
usedQuota. - O texto de
postpode conter até 5 hashtags (por exemplo, #wildtimes) e 3 menções a usuários (por exemplo, @natgeo). - Menções (@mention) a usuários do Instagram receberão uma notificação.
- Máximo de 2.200 caracteres na publicação.
- Publicações com múltiplas imagens/vídeos são suportadas e enviadas como carrossel. Você pode enviar até 10 vídeos e imagens.
- O Instagram não suporta exclusões via API. As exclusões devem ocorrer manualmente usando o aplicativo do Instagram.
- Se seu vídeo de Reel não terminar em uma extensão de vídeo conhecida, como mp4, use o parâmetro
isVideo. Consulte o endpoint /post para detalhes. - O Instagram também suporta envio de mídia sem texto de publicação. Se você não quiser incluir texto na publicação,
envie uma String vazia
post: "". - Consulte as Diretrizes de mídia do Instagram e a Autorização do Instagram para mais informações.
Publicando no Instagram
JSON para uma publicação básica com imagem e hashtags no Instagram:Instagram Post
A proporção de aspecto de imagens e vídeos e a duração dos vídeos são muito importantes para publicar com sucesso no Instagram. Se não atenderem aos requisitos, a publicação será rejeitada.Consulte a seção do Instagram nas Diretrizes de imagem e vídeo.
Conta Business ou Creator do Instagram
Sua conta do Instagram deve ser uma Conta Business ou Creator e estar conectada a uma Facebook Page. A configuração é gratuita e fácil. Consulte aqui as instruções detalhadas:Vinculação do Instagram
Carrossel de imagens e vídeos
Você pode publicar várias imagens ou vídeos de Reel no Instagram como um carrossel; um total combinado de até 10 imagens ou vídeos pode ser usado em um carrossel. Basta adicionar suas imagens ou vídeos adicionais ao arraymediaUrls, e o carrossel será criado automaticamente.
Instagram Carousel Post
URLs de vídeo devem terminar em uma extensão conhecida, como
mp4. O parâmetro isVideo não é suportado
para carrosséis do Instagram.Instagram Reels
No Instagram, uma publicação de vídeo é chamada de Reel. Você pode publicar um vídeo na API do Instagram Reels com as seguintes opções opcionais eminstagramOptions.
Instagram Reels Options
- Consulte os requisitos de vídeo da API do Reels para detalhes sobre os requisitos do vídeo.
shareReelsFeed: Booleano definido comotruepara indicar que o Reel pode aparecer tanto na aba Feed quanto na Reels, oufalsepara indicar que o Reel só pode aparecer na aba Reels. Este valor é uma dica ao Instagram sobre onde você gostaria que o Reel aparecesse, mas nenhum valor determina se o Reel realmente aparecerá nas abas Reels ou Feed, pois o Reel pode não atender aos requisitos de elegibilidade ou pode não ser selecionado pelo algoritmo do Instagram.audioName: String com o nome do áudio/música da sua mídia de Reels. Você só pode renomear uma vez, seja ao criar um reel ou depois, na página de áudio. Por exemplo,"The Weeknd - Blinding Lights".thumbNail: String com a URL da imagem de capa (thumbnail) do Reel. Veja aqui detalhes sobre thumbNail.thumbNailOffset: Deslocamento inteiro em milissegundos do frame do thumbnail. Veja aqui detalhes sobre thumbNailOffset.
Trial Reels
Um trial reel é um Reel que é publicado apenas para não seguidores quando é postado pela primeira vez, permitindo que você teste como o Reel se comporta com um público novo antes de alcançar seus seguidores existentes. DefinatrialParams.graduationStrategy em instagramOptions para publicar um Reel como um trial.
Instagram Trial Reel
graduationStrategy controla como um trial reel posteriormente “gradua” — ou seja, torna-se visível para seus seguidores também. É obrigatório quando trialParams é fornecido e deve ser um dos seguintes:
“MANUAL”— a publicação permanece como trial reel até que você a gradue manualmente de dentro do aplicativo do Instagram.“SS_PERFORMANCE”— a Meta gradua automaticamente o Reel com base no desempenho inicial entre não seguidores.
A graduação em si (promover um trial reel publicado para os seguidores) atualmente não é exposta pela
API da Meta e deve ser feita manualmente no aplicativo do Instagram. O Ayrshare adicionará um endpoint de graduação
assim que a Meta expuser um.
Restrições de trial reel
A requisição de trial reel é rejeitada na borda do Ayrshare — antes de qualquer chamada à Meta — quando qualquer uma dessas condições não é atendida:- Exatamente uma URL de mídia terminando em
.mp4ou.mov(não diferencia maiúsculas de minúsculas). Carrosséis não são suportados. instagramOptions.storiesnão pode sertrue. Stories não podem ser trial reels.graduationStrategydeve estar presente e ser exatamente“MANUAL”ou“SS_PERFORMANCE”(diferencia maiúsculas de minúsculas).
447, 448, 449) para os payloads completos.
Instagram Stories
Você pode publicar uma única imagem ou vídeo como Story do Instagram com as seguintesinstagramOptions. Os Stories do Instagram desaparecem após 24 horas.
Stories Post
- Instagram Stories não suportam texto de publicação — qualquer texto fornecido no campo
post, incluindo menções, será ignorado. - Stories expiram após 24 horas.
- O Instagram atualmente suporta a publicação de Stories apenas em contas Business do Instagram e não em contas Creator.
- Instagram Stories não suportam colaboradores.
- Publicar stickers (por exemplo, link, enquete, localização) não é suportado pelo Instagram.
Thumbnails de Reels
Você pode selecionar um frame do Reel como imagem de thumbnail ou sua própria imagem de capa (thumbnail) a partir de uma URL externa.Instagram Thumbnail
0, que é o primeiro frame do Reel.
Se você especificar tanto uma URL de thumbnail quanto um offset, o offset será ignorado.
A thumbnail do Reel deve seguir os requisitos de thumbnail do Reels.
URLs assinadas com redirecionamentos não são garantidas como compatíveis com URLs de capa.
Recomendamos uma URL não assinada ou o uso do endpoint /media.
Texto alternativo
Adicione texto alternativo (alt text) do Instagram a uma imagem. O alt text do Instagram é um recurso de acessibilidade usado para fornecer informações adicionais ao usuário e para leitores de tela.- O alt text suporta até 1.000 caracteres por imagem.
- O Instagram não suporta alt text para Reels ou Stories.
altText no objeto instagramOptions.
Instagram Alt Text
mediaUrls.
O alt text será aplicado a cada imagem na ordem.
Tags de usuário e localização
O usuário do Instagram será notificado quando você usar seu nome de usuário em uma publicação. Tenha cuidado para
não spammar usuários nem publicar com seu nome de usuário repetidamente. Se fizer isso, o Instagram poderá suspender ou
desativar sua conta.
instagramOptions.
Localização
Uma localização é especificada por umlocationId, que é um ID de Facebook Page ou nome de Facebook Page. Por exemplo, o Page ID do Guggenheim Museum é 7640348500 ou o nome da Facebook Page "@guggenheimmuseum". As Pages devem estar associadas a uma localização física.
Instagram Location
locationId (Page Id) com o endpoint brand. Observe que a Page deve ter uma localização listada, ou o locationId retornará um erro.
Não suportado em imagens ou vídeos em carrosséis.
Tags de usuário
As tags do Instagram permitem marcar outros usuários do Instagram na sua publicação. Os usuários são especificados por umuserTags contendo um Array de objetos com um nome de usuário do Instagram e coordenadas x/y (apenas para imagens). As tags de usuário podem ser adicionadas para imagens únicas ou Reels, mas não para vídeos regulares, múltiplas imagens ou Stories.
- Os nomes de usuário devem ser contas públicas do Instagram. Não inclua o @ do handle do usuário.
- Os valores
xeydevem ser númerosfloatque se originam no canto superior esquerdo da imagem, com um intervalo de0.0–1.0. Imagens únicas. Não inclua com Reels ou ocorrerá um erro.
Instagram User Tags
Menções no Instagram
Mencione outro usuário do Instagram adicionando @handle no texto da publicação. Por exemplo, você pode mencionar o handle @ayrshare no texto da publicação:Instagram Mentions
Colaboração
A colaboração no Instagram permite que você seja coautor de conteúdo com outras contas do Instagram marcando outros como colaboradores. Isso permite designar outros usuários do Instagram como criadores em sua publicação. Quando marcados, esses usuários recebem um convite para colaborar no aplicativo móvel. Se aceitarem, a publicação também aparecerá no feed deles e será visível para seus seguidores, ampliando o alcance e o potencial de engajamento da publicação.Colaboradores
O autor público original pode marcar outra conta pública como colaborador do Instagram. A outra conta receberá uma mensagem, permitindo aceitar ou recusar a solicitação. Se a outra conta aceitar, a publicação também aparecerá no perfil dela e será distribuída aos seus seguidores no feed do Instagram. O cabeçalho da publicação atribuirá o conteúdo a ambas as contas. Você pode adicionar colaboradores a um Reel, imagem ou carrossel. Marcar um colaborador privado não é permitido via API do Instagram. Embora essa funcionalidade exista dentro do aplicativo do Instagram, plataformas e suas APIs frequentemente não estão em paridade de recursos. Convide até três colaboradores com um array de nomes de usuário públicos do Instagram.Instagram Collaborators
Obter status da solicitação de colaborador
Depois de convidar um colaborador do Instagram, você pode verificar o status da solicitação usando a API Get Collaborator Request Status.Redimensionamento automático de imagem
Max Pack necessário
autoResize. Observe que isso redimensionará a imagem para todas as plataformas incluídas, portanto recomendamos fazer uma chamada para o Instagram e outra chamada /post para as plataformas adicionais.
Instagram Auto Image Resize
Cota utilizada
A resposta do Instagram incluirá ousedQuota atual para o número de publicações do Instagram feitas em um período móvel de 24 horas. Apenas 50 publicações no Instagram são permitidas pelo Instagram em um período móvel de 24 horas.
Instagram Used Quota
Problemas de conteúdo
O Ayrshare inclui proteção de mídia integrada que pode detectar e resolver certos problemas de entrega de mídia durante a publicação. Quando uma publicação é bem-sucedida, mas um problema de conteúdo foi detectado e resolvido, a resposta inclui um objeto opcionalcontentIssues. Isso permite identificar e corrigir problemas com sua hospedagem de mídia de forma proativa.
O objeto contentIssues só está presente quando um problema foi detectado e resolvido — publicações bem-sucedidas normais não o incluem.
| Campo | Tipo | Descrição |
|---|---|---|
originMediaHostFailed | boolean | A rede social não conseguiu recuperar a mídia da URL fornecida. A proteção automatizada de mídia do Ayrshare resolveu o problema e concluiu a publicação com sucesso. Considere revisar a configuração da sua hospedagem de mídia — veja Meta Media Crawler Blocked para causas comuns. |
details | array de strings | Descrições legíveis de cada problema detectado. |
Content Issues Response Example
Detalhes de erro
Quando uma publicação de mídia do Instagram falha, o objeto de erro agora expõe o texto de erro subjacente da Meta no campo
details, ao lado do code e message do Ayrshare. Isso permite distinguir entre diferentes causas-raiz (por exemplo, uma rejeição por proporção de aspecto versus uma falha no download da mídia) sem contatar o suporte.Instagram Publish Error
message é o resumo estável e legível do Ayrshare, enquanto details reflete o texto bruto retornado pela Meta para a publicação com falha.
