Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Publicações em colaboração no Instagram através da API

A API do Instagram publica uma publicação em colaboração quando o contentor multimédia inclui collaborators, uma lista de até 3 nomes de utilizador do Instagram, numa foto do Feed, num Reel ou num carrossel; não há suporte para Stories. Cada conta convidada recebe um pedido que pode aceitar ou recusar, e a publicação aparece no seu perfil depois de ser aceite. A Meta documenta as etiquetas de colaboradores apenas para o Facebook Login for Business.

A easyCoexistence publica fotos, carrosséis e Reels com publish_instagram_post a partir do Claude, do ChatGPT ou do seu próprio código, através do Instagram Login, e os colaboradores são depois adicionados à publicação na aplicação do Instagram, onde cada um aceita.

3

Nomes de utilizador do Instagram que o parâmetro collaborators aceita num único contentor multimédia.

5

Contas que a referência de collaborators da Meta indica que podem ser adicionadas como colaboradores numa publicação.

Facebook Login

As etiquetas de colaboradores na API estão documentadas apenas para o Facebook Login for Business.

Pending

O invite_status de um colaborador que ainda não aceitou; passa a Accepted quando aceitar.

50 a day

Chamadas de aceitar ou recusar que uma conta convidada pode fazer através da Collaboration API, em 24 horas.

Como se publica uma publicação em colaboração através da API?

Com as duas chamadas habituais e um parâmetro extra. Crie o contentor com POST /<IG_ID>/media, adicionando collaborators com até 3 nomes de utilizador do Instagram a um contentor de imagem, Reel ou carrossel, e depois publique-o com media_publish. A referência da Meta mostra a chamada em graph.facebook.com, com as permissões instagram_basic e instagram_content_publish do Facebook Login.

A photo container with two collaborators
POST https://graph.facebook.com/<IG_ID>/media
  ?image_url=https://www.example.com/images/launch.jpg
  &caption=<CAPTION>
  &collaborators=['username1','username2']
  &access_token=<ACCESS_TOKEN>

Que publicações podem ter colaboradores?

Fotos do Feed, Reels e carrosséis. A referência da Meta lista o parâmetro collaborators para esses três tipos e indica que não é suportado nos Stories. Num carrossel, a sintaxe do pedido da Meta coloca-o no contentor do carrossel, ao lado da legenda, e a publicação conta uma vez para as 100 publicações publicadas pela API por conta em 24 horas.

Quem tem de aceitar?

Cada conta convidada. O Instagram envia-lhe um pedido para aceitar ou recusar; depois de aceitar, a publicação aparece também no seu perfil, chega aos feeds dos seus seguidores e fica atribuída às duas contas no cabeçalho. O Centro de Ajuda do Instagram acrescenta que o autor pode adicionar ou remover colaboradores a qualquer momento e que um colaborador pode sair sempre que quiser.

Como se verifica se um colaborador aceitou?

Com GET /<IG_MEDIA_ID>/collaborators, documentado para o Facebook Login. Lista o id, o nome de utilizador e o invite_status de cada conta convidada, Accepted ou Pending, e devolve apenas contas que tenham ativado a etiquetagem de colaboradores. A referência da Meta para este endpoint diz que podem ser adicionadas até 5 contas como colaboradores; o parâmetro do contentor aceita até 3.

GET /<IG_MEDIA_ID>/collaborators
{
  "data": [
    { "id": "<ID>", "username": "username1", "invite_status": "Accepted" },
    { "id": "<ID>", "username": "username2", "invite_status": "Pending" }
  ]
}

Pode uma conta convidada aceitar através da API?

Sim, com a Collaboration API da Meta, disponível com o Facebook Login e o Unified Login. GET /<IG_USER_ID>/collaboration_invites lista os convites pendentes, até 300 chamadas por utilizador por dia, e POST /<IG_USER_ID>/collaboration_invites, com media_id e accept definido como true ou false, responde a um convite, até 50 chamadas por utilizador por dia. Ambos exigem instagram_basic.

O que pode um colaborador ver sobre a publicação?

Pouco, por desenho. A Meta diz que os dados de conteúdo em coautoria só podem, com poucas exceções, ser lidos pela API pela conta que a publicou. Desde abril de 2026, GET /<IG_USER_ID>/collaborative_media lista os conteúdos em que o utilizador é colaborador aceite, com o Facebook Login, e um colaborador removido pelo proprietário perde o acesso à publicação.

Como se faz uma publicação em colaboração com a easyCoexistence?

Em dois passos. publish_instagram_post publica a foto, o carrossel ou o Reel a partir do Claude, do ChatGPT ou do seu próprio código; não aceita colaboradores, porque a easyCoexistence liga o Instagram com o Instagram Login, que as etiquetas de colaboradores da Meta não cobrem. Depois, adicione os colaboradores à publicação na aplicação do Instagram, onde o autor pode adicioná-los a qualquer momento e cada um aceita da forma habitual.

Erros comuns

  • Adicionar colaboradores a um contentor de Stories. A Meta suporta-os apenas em fotos do Feed, Reels e carrosséis.
  • Indicar mais de 3 nomes de utilizador num só contentor. O parâmetro collaborators aceita até 3.
  • Esperar que a publicação apareça de imediato no perfil do colaborador. Só aparece depois de a conta convidada ter aceite.
  • Enviar colaboradores com um token do Instagram Login. A Meta documenta o parâmetro para configurações com o Facebook Login for Business, não para o Instagram Login.
Fazer isto com a EasyCoexistence

Entre US$ 9 e US$ 0.75 por número ligado por mês, descendo à medida que se adicionam números, com os primeiros 3 dias grátis.

Perguntas frequentes

Pode a API do Instagram criar publicações em colaboração?

Sim, com o Facebook Login for Business: adicione colaboradores, até 3 nomes de utilizador, a um contentor de foto do Feed, Reel ou carrossel antes de o publicar.

Quantos colaboradores pode ter uma publicação do Instagram?

Até 3 através do parâmetro collaborators num contentor. A referência da Meta para collaborators indica que podem ser adicionadas até 5 contas a uma publicação.

Os colaboradores têm de aceitar?

Sim. Cada conta convidada aceita ou recusa, e a publicação só aparece no perfil depois de ter sido aceite.

Pode uma publicação em Stories ser feita em colaboração através da API?

Não. A Meta indica colaboradores para fotos do Feed, Reels e carrosséis, e marca os Stories como não suportados.

Continue a ler

Ligue o seu primeiro canal em dois minutos.

Sem revisões de plataformas para esperar. Ligue o WhatsApp, o Instagram, o TikTok ou outro canal, peça depois à sua IA que publique, responda ou faça um relatório, e veja-a trabalhar.

  • 3 dias grátis
  • Cancele quando quiser
  • Só APIs oficiais
  • Monitorizado 24/7

Verificado em