EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Como permitir que seus clientes conectem o Instagram ao seu app

Seu backend chama POST /connect-sessions da easyCoexistence com channel instagram e envia o cliente para a url devolvida, onde ele entra com o Instagram Login em uma conta Business ou Creator. Ele volta ao seu redirect_url com um channel_id, e GET /channels/{id}?credentials=1 devolve um token para graph.instagram.com, para que seu app possa publicar, ler comentários e responder DMs.

100 posts

Publicações pela API que uma conta do Instagram pode fazer em qualquer janela móvel de 24 horas; um carrossel conta como uma.

JPEG

O único formato de imagem que a Meta aceita para publicar no Instagram pela API.

24 hours

Janela de atendimento padrão para responder a uma DM de uma pessoa no Instagram, na maioria das ações do usuário; ela precisa escrever primeiro.

1 private reply

Mensagens que uma conta pode enviar a quem comentou, por resposta privada, em até 7 dias após o comentário.

1 hour

Tempo de validade de um link de conexão da easyCoexistence antes que a sessão expire.

O que o cliente faz para se conectar?

Basta apertar um botão. Seu app cria a sessão com channel definido como instagram, um redirect_url e o id do seu cliente como external_ref, e depois envia o cliente para a url dela. A página hospedada mostra o nome da sua empresa e Continuar com Instagram, que abre o login do próprio Instagram na mesma aba, então funciona no celular. O cliente aprova o acesso e volta ao seu redirect_url com status=connected e o channel_id, que seu backend confirma com GET /connect-sessions/{id}.

1Your appPOST /connect-sessions with channel instagram
2Hosted pageYour name and Continue with Instagram
3Instagram LoginThe professional account approves access
4Back to youredirect_url with status and channel_id

Quais contas do Instagram podem se conectar?

Contas profissionais, Business ou Creator, que são as atendidas pela API do Instagram da Meta. Uma conta já conectada por outro serviço que usa a easyCoexistence é recusada, e o last_error da sessão informa isso; o cliente remove a conta lá primeiro ou entra com outra. Para DMs, a conta também ativa Permitir acesso a mensagens no app do Instagram, e o guia de conexão do Instagram indica o caminho.

Qual token o seu app recebe?

Um token de usuário do Instagram para graph.instagram.com/v25.0, com account_id_on_meta, o ID do Instagram da conta, obtido em GET /channels/{id}?credentials=1. A easyCoexistence o renova bem antes de expirarem os 60 dias, e a renovação gera um novo token; por isso, busque as credenciais no início de cada job em vez de manter uma cópia guardada.

Como seu app publica na conta?

Com POST /channels/{id}/posts. ig_type escolhe IMAGE, CAROUSEL, REELS ou STORIES, e é deduzido da mídia quando você o omite: vários arquivos formam um carrossel e um vídeo vira um Reel. Aqui, um carrossel tem de 2 a 10 itens, as imagens devem ser JPEG, o texto aceita até 2,200 caracteres e uma publicação no Instagram não tem campo de link. Sem publish_at, ela sai agora; com ele, sai no horário indicado, com até 90 dias de antecedência.

A carousel on the customer's Instagram account
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: ig_post_2291" \
  -d '{
    "text": "Three looks for the weekend.",
    "ig_type": "CAROUSEL",
    "media": [
      { "url": "https://cdn.example.com/look-1.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-2.jpg", "type": "image" },
      { "url": "https://cdn.example.com/look-3.jpg", "type": "image" }
    ]
  }'

Como comentários e DMs chegam ao seu app?

Assim que você define um destino. PUT /channels/{id}/webhook com a sua URL devolve o segredo de assinatura daquela conta, e a partir daí seus comentários, menções e DMs são encaminhados à medida que chegam, assinados com X-EC-Signature. O corpo traz platform, account_id, external_id e a entrada de webhook da Meta sem alterações, com changes para comentários e menções e messaging para DMs.

Como seu app responde a comentários e DMs?

Pela API do Instagram da Meta em graph.instagram.com, com o token do cliente, então cada resposta sai da conta dele:

  • Responder a um comentário: POST /<IG_COMMENT_ID>/replies com uma message.
  • Responder a uma DM: POST /<IG_ID>/messages com recipient definido como o ID da pessoa e o texto da mensagem, dentro de 24 horas da última mensagem dela.
  • Resposta privada a um comentário: o mesmo edge messages com recipient comment_id, uma vez por comentário, em até 7 dias após ele.
  • Ocultar ou excluir um comentário: POST ou DELETE em /<IG_COMMENT_ID>.

O que acontece quando o acesso do cliente termina?

Sua URL de eventos recebe channel.disconnected quando o Instagram recusa o token ou o dono retira o acesso nas configurações do Instagram. Uma nova sessão de conexão para aquele cliente traz a conta de volta. Para encerrar do seu lado, DELETE /channels/{id} revoga o acesso na rede e cancela as publicações que ainda estão na fila, e a cobrança para no fim do ciclo.

Erros comuns

  • Enviar imagens PNG ou WebP ao Instagram. A Meta publica apenas JPEG, então a publicação é recusada antes de entrar na fila; converta as imagens antes.
  • Colocar um campo de link em uma publicação do Instagram. Publicações do Instagram não levam link, então a requisição é recusada; coloque a URL no texto.
  • Mostrar um botão Responder em DMs com mais de 24 horas. A Meta permite respostas dentro da janela aberta pela última mensagem da pessoa.
  • Enviar uma segunda resposta privada ao mesmo comentário. A Meta permite uma; um novo envio espera até a pessoa responder.
Fazendo isso com o EasyCoexistence

A easyCoexistence permite que seus clientes conectem o Instagram ao seu app por um único login hospedado e entrega ao seu backend um token renovado, um endpoint de publicações e os comentários e DMs deles por webhook, com cada conexão monitorada 24/7. As mesmas chamadas cobrem WhatsApp, Facebook, TikTok, YouTube, LinkedIn e mais canais. De US$ 9 a US$ 0.75 por conexão por mês, caindo à medida que você adiciona conexões, e os primeiros 3 dias grátis.

O easyCoexistence é uma API e um servidor MCP multicanal que conecta agentes de IA, como o Claude e o ChatGPT, ao WhatsApp, Instagram, TikTok, Facebook e mais. No WhatsApp, ele usa o Coexistence: a empresa continua usando o número no app WhatsApp Business enquanto a IA trabalha pela API oficial da Meta.

Perguntas frequentes

Preciso de um app próprio na Meta para conectar as contas de Instagram dos clientes?

Não. Os clientes entram pelo app da easyCoexistence, e seu backend recebe o token da API do Instagram da Meta pela chamada de credenciais.

Um cliente pode conectar várias contas do Instagram?

Sim, uma por login. Crie uma sessão de conexão para cada conta com o mesmo external_ref, e GET /channels?external_ref= lista todas as contas daquele cliente.

Meu app pode agendar Stories do Instagram?

Sim. Defina ig_type como STORIES com uma imagem ou vídeo e um horário em publish_at, e a fila publica nesse momento.

Quanto custa a easyCoexistence por conta do Instagram?

Cada conta conectada custa de US$ 9 a US$ 0.75 por mês, conforme a faixa do total de conexões, com os primeiros 3 dias grátis.

Continue lendo

Conecte seu primeiro canal em dois minutos.

Sem esperar aprovação das plataformas. Conecte o WhatsApp, o Instagram, o TikTok ou outro canal, peça para a sua IA publicar, responder ou trazer os números, e veja funcionando.

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

Verificado em