Pular para o conteúdo principal
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.
A API do Instagram tem os seguintes requisitos e restrições.
  • 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 post pode 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
Hashtags são clicáveis em publicações do Instagram, mas links não.
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 array mediaUrls, 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 em instagramOptions.
Instagram Reels Options
  • Consulte os requisitos de vídeo da API do Reels para detalhes sobre os requisitos do vídeo.
  • shareReelsFeed: Booleano definido como true para indicar que o Reel pode aparecer tanto na aba Feed quanto na Reels, ou false para indicar que o Reel 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.
Consulte os requisitos de vídeo da API do Reels ou um exemplo de uso da API do Instagram Reels. Você também pode definir uma URL de capa do Reels e tags de localização e usuário.

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. Defina trialParams.graduationStrategy em instagramOptions para publicar um Reel como um trial.
Instagram Trial Reel
O 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 .mp4 ou .mov (não diferencia maiúsculas de minúsculas). Carrosséis não são suportados.
  • instagramOptions.stories não pode ser true. Stories não podem ser trial reels.
  • graduationStrategy deve estar presente e ser exatamente “MANUAL” ou “SS_PERFORMANCE” (diferencia maiúsculas de minúsculas).
Falhas retornam um dos três códigos de erro do Ayrshare — veja Erros de trial reel do Instagram (447, 448, 449) para os payloads completos.

Instagram Stories

Você pode publicar uma única imagem ou vídeo como Story do Instagram com as seguintes instagramOptions. Os Stories do Instagram desaparecem após 24 horas.
Stories Post
Consulte os requisitos da API de Stories.
  • 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
O offset é a posição em milissegundos do frame do thumbnail do vídeo do Reel. O valor padrão é 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.
Use altText no objeto instagramOptions.
Instagram Alt Text
Cada alt text deve corresponder a uma imagem ou vídeo no array 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.
Uma imagem ou um Reel pode ser marcado com usuários do Instagram, e uma imagem, vídeo ou Reel pode ser marcado com uma localização usando o parâmetro instagramOptions.

Localização

Uma localização é especificada por um locationId, 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
Você pode consultar o 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 um userTags 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 x e y devem ser números float que se originam no canto superior esquerdo da imagem, com um intervalo de 0.01.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
O usuário @mencionado será notificado da menção. Revise as regras importantes sobre menções.

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.
Instagram Stories não suportam colaboradores.
  • Convide apenas colaboradores que você espera que aceitem seu convite.
  • Se o colaborador responder com uma solicitação de colaboração declined, não os convide novamente até entrar em contato com eles para entender o motivo da recusa.
  • Recusas repetidas do mesmo usuário ou de vários usuários colocarão suas contas do Instagram e do Ayrshare em risco de cancelamento.
  • O autor original pode adicionar ou remover um colaborador a qualquer momento.
Convide até três colaboradores com um array de nomes de usuário públicos do Instagram.
Instagram Collaborators
Esses três colaboradores receberão um convite por mensagem no aplicativo móvel do Instagram e poderão aceitar ou recusar o convite; em seguida, você pode verificar o status da solicitação do usuário convidado. Convide apenas colaboradores que você sabe que aceitarão seu pedido, caso contrário sua conta do Instagram pode ser afetada negativamente.
Observação sobre colaboradores convidados: Com poucas exceções, dados sobre mídia coautorada só podem ser acessados via API pelo usuário que publicou a mídia; colaboradores não conseguem acessar esses dados via API.

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
As imagens são redimensionadas automaticamente para 1080 x 1080 px para funcionar com o Instagram com o parâmetro 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á o usedQuota 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
Se a cota tiver sido atingida, uma mensagem de erro será retornada.

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 opcional contentIssues. 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.
CampoTipoDescrição
originMediaHostFailedbooleanA 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.
detailsarray de stringsDescrições legíveis de cada problema detectado.
Content Issues Response Example
Se você vir originMediaHostFailed em suas respostas, pode haver um problema com a hospedagem da sua mídia que impede que as redes sociais acessem sua mídia. Veja Meta Media Crawler Blocked para etapas detalhadas de solução de problemas.

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
O 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.

Adicionando quebras de linha ou rich text a uma publicação do Instagram

Quebras de linha do Instagram podem ser adicionadas a uma publicação com um caractere de nova linha especial. Rich text, como negrito ou itálico, pode ser adicionado a uma publicação do Instagram com alguns elementos HTML.

Limites de caracteres

Consulte Limites de caracteres do Instagram para mais informações.

Endpoints adicionais

Obter status da solicitação de colaborador