Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

Como deixar os seus clientes ligarem o Instagram à sua app

O seu backend chama POST /connect-sessions da easyCoexistence com channel instagram e envia o cliente para o url devolvido, onde inicia sessão com Instagram Login numa conta Business ou Creator. Regressa ao seu redirect_url com um channel_id, e GET /channels/{id}?credentials=1 devolve um token para graph.instagram.com, para que a sua app possa publicar, ler comentários e responder a DMs.

100 posts

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

JPEG

O único formato de imagem que a Meta suporta para publicar no Instagram através da API.

24 hours

Janela padrão para responder a uma DM de um utilizador no Instagram, na maioria das ações; a pessoa tem de escrever primeiro.

1 private reply

Mensagens que uma conta pode enviar a quem comentou, através de resposta privada, no prazo de 7 dias após o comentário.

1 hour

Duração de funcionamento de uma ligação do easyCoexistence antes de a sessão expirar.

O que é que o cliente faz para ligar?

Carregue num botão. A sua 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 o url devolvido. A página alojada mostra o nome da sua app e Continuar com o Instagram, que abre o início de sessão do próprio Instagram no mesmo separador, por isso funciona nos telemóveis. O cliente aprova o acesso e chega ao seu redirect_url com status=connected e o channel_id, que o 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

Que contas de Instagram se podem ligar?

Contas profissionais, Business ou Creator, que é o que a API do Instagram da Meta suporta. Uma conta já ligada através de outro serviço que usa a easyCoexistence é recusada, e o last_error da sessão indica-o; o cliente remove-a primeiro nesse serviço ou inicia sessão com outra. Para DMs, a conta também ativa Permitir acesso às mensagens na app do Instagram, e o guia de ligação do Instagram indica o caminho.

Que token recebe a sua app?

Um token de utilizador 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 renova-o bem antes de os 60 dias terminarem, e cada renovação emite um token novo; por isso, obtenha as credenciais no início de cada tarefa, em vez de guardar uma cópia.

Como publica a sua app na conta?

Com POST /channels/{id}/posts. ig_type escolhe IMAGE, CAROUSEL, REELS ou STORIES, e é deduzido do conteúdo quando não é indicado: vários ficheiros formam um carrossel, e um vídeo forma um Reel. Aqui, um carrossel tem entre 2 e 10 elementos, as imagens têm de ser JPEG, o texto aceita até 2.200 caracteres e uma publicação no Instagram não tem campo de ligação. Sem publish_at, a publicação é feita de imediato; com publish_at, é feita nessa hora, 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 chegam os comentários e as DMs à sua app?

Depois de definir um destino. PUT /channels/{id}/webhook com o seu URL devolve o segredo de assinatura dessa conta e, a partir daí, os comentários, menções e DMs são encaminhados à medida que chegam, assinados com X-EC-Signature. O corpo contém platform, account_id, external_id e o entry do webhook da Meta sem alterações, com changes para comentários e menções e messaging para DMs.

Como responde a sua app a comentários e DMs?

Através da API do Instagram da Meta em graph.instagram.com, com o token do cliente, para que cada resposta venha da conta do cliente:

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

O que acontece quando o acesso do cliente termina?

O URL de eventos da sua app recebe channel.disconnected quando o Instagram recusa o token ou o proprietário retira o acesso nas definições do Instagram. Uma nova sessão de ligação para esse cliente volta a ligar a conta. Para a 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 faturação termina no fim do ciclo.

Erros comuns

  • Enviar imagens PNG ou WebP para o Instagram. A Meta só publica JPEG, por isso a publicação é recusada antes de entrar na fila; converta as imagens primeiro.
  • Pôr um campo de ligação numa publicação do Instagram. As publicações do Instagram não levam ligação, por isso o pedido é recusado; coloque o URL no texto.
  • Mostrar um botão de 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 só; a seguinte fica à espera até a pessoa responder.
Fazer isto com a EasyCoexistence

A easyCoexistence permite aos seus clientes ligarem o Instagram à sua app através de um único início de sessão alojado e depois dá ao seu backend um token renovado, um endpoint de publicações e os comentários e DMs através de webhook, com cada ligação monitorizada 24/7. As mesmas chamadas cobrem WhatsApp, Facebook, TikTok, YouTube, LinkedIn e mais canais. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, com os primeiros 3 dias gratuitos.

Perguntas frequentes

Preciso de uma app própria na Meta para ligar as contas de Instagram dos clientes?

Não. Os clientes iniciam sessão na app da easyCoexistence, e o seu backend recebe o token para a API do Instagram da Meta através da chamada de credenciais.

Um cliente pode ligar várias contas de Instagram?

Sim, uma por início de sessão. Crie uma sessão de ligação para cada conta com o mesmo external_ref, e GET /channels?external_ref= lista-as todas desse cliente.

A minha app pode agendar Stories do Instagram?

Sim. Defina ig_type como STORIES, com uma imagem ou um vídeo, e uma hora em publish_at; a fila publica-o nessa altura.

Quanto custa a easyCoexistence por conta de Instagram?

Cada conta ligada custa de US$ 9 a US$ 0.75 por mês, conforme a faixa do total das suas ligações, com os primeiros 3 dias gratuitos.

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