EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Como conectar uma conta do Instagram a uma API ou agente de IA

Uma conta do Instagram se conecta a uma API ou agente de IA pelo Instagram Login. O titular entra com uma conta profissional, Business ou Creator, e aprova as cinco permissões do app, que cobrem acesso básico, publicação, comentários, mensagens e insights; o app recebe então um token de 60 dias, renovável por mais 60. Para DMs, a conta também ativa Permitir acesso a mensagens no app do Instagram.

O easyCoexistence conecta uma conta Business ou Creator do Instagram em um único login com o próprio login do Instagram, mantém o acesso renovado e o verifica a cada 6 horas, para que o Claude, o ChatGPT ou sua própria plataforma possam publicar, agendar, responder a comentários e DMs e ler insights pela API oficial da Meta.

5 permissions

Lista da Meta para o produto Instagram: instagram_business_basic, content_publish, manage_comments, manage_insights e manage_messages.

1 hour

Tempo de validade do código de autorização do login do Instagram; ele só pode ser trocado uma vez.

60 days

Validade do token de acesso de longa duração do Instagram User, que pode ser renovado por mais 60.

1 hour

Por quanto tempo um link de conexão do easyCoexistence funciona antes que sua sessão expire.

Quais contas podem se conectar?

Contas profissionais do Instagram, Business ou Creator. A API da Meta atende os dois tipos da mesma forma para publicação, comentários, DMs e insights, e uma conta pessoal primeiro muda para profissional no app do Instagram, em Tipo de conta e ferramentas. Com o Instagram Login, o titular entra com as próprias credenciais do Instagram da conta, na página de login do próprio Instagram.

O que o titular vê ao entrar?

A janela de login do próprio Instagram. O app envia o titular para https://www.instagram.com/oauth/authorize com seu ID de app do Instagram, um URI de redirecionamento e as permissões que pede; o titular entra, revisa e aprova. O Instagram então devolve o app com um código, válido por uma hora e utilizável uma única vez, que o servidor do app troca por um token. Um login cancelado volta com error=access_denied.

Para que serve cada permissão?

Cada recurso precisa de instagram_business_basic mais uma permissão própria, e o titular as aprova juntas na mesma janela. O easyCoexistence solicita estas cinco, o conjunto que a Meta lista para o produto Instagram, para que um agente possa publicar, responder e medir na conta:

instagram_business_basicThe profile and media; needed with each of the others
instagram_business_content_publishPublishing photos, carousels, Reels and Stories
instagram_business_manage_commentsReading, replying to, hiding and deleting comments, private replies and mentions
instagram_business_manage_messagesReading and replying to DMs
instagram_business_manage_insightsAccount and post metrics

Como ativar as DMs?

No app do Instagram, abra Configurações, depois Mensagens e respostas de stories, Controles de mensagens e Ferramentas conectadas, e ative Permitir acesso a mensagens. A Meta exige essa opção antes que um app possa gerenciar as DMs da conta; enquanto ela estiver desativada, os envios falham mesmo com a permissão de mensagens concedida, enquanto a publicação e os comentários funcionam normalmente.

Como conectar ao easyCoexistence?

Pelo painel, em um único login: escolha Nova conexão, depois Instagram, e entre com a conta profissional. Uma conta sem cartão cadastrado é solicitada a cadastrar um primeiro, já que cada conexão é cobrada. Quando o Instagram devolve o usuário, a página do canal mostra Conectado, e o easyCoexistence inscreve a conta nos seus eventos de comentário, menção e DM, renova o acesso antes que os 60 dias terminem e o verifica a cada 6 horas.

1New connectionIn the easyCoexistence dashboard
2InstagramInstagram's own login window opens
3ApproveThe professional account and its five permissions
4ConnectedReady for Claude, ChatGPT or your code

Como uma plataforma conecta as contas dos seus clientes?

Com um link de conexão hospedado pela Partner API. Seu backend envia um POST para /api/v1/connect-sessions com channel definido como instagram e um redirect_url, depois envia o cliente para a url que ele devolve; o cliente entra com o Instagram ali, sem conta própria no easyCoexistence. O navegador volta com a sessão, o status e o novo channel_id, que seu backend confirma com GET /connect-sessions/:id antes de confiar neles.

Create a connect session for an Instagram account
curl -X POST https://easycoexistence.com/api/v1/connect-sessions \
  -H "Authorization: Bearer $EC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "channel": "instagram",
    "redirect_url": "https://app.example.com/connect/return",
    "external_ref": "customer_4821"
  }'

O que acontece depois da conexão?

A conta fica pronta para o que quer que seja feito com ela. list_social_accounts a devolve ao Claude, ao ChatGPT ou ao seu próprio agente, get_social_credentials entrega seu ID e a base da API ao seu código, e seus eventos de comentário, menção e DM chegam ao seu endpoint assim que você definir um, com set_social_webhook_destination ou PUT /api/v1/channels/:id/webhook.

Por que uma conexão pode falhar?

Geralmente por um destes quatro motivos, cada um com uma correção direta:

  • A conta é pessoal: mude para Business ou Creator no app do Instagram.
  • O titular cancelou o login: nada se conecta, e recomeçar abre uma nova janela.
  • A conta já está conectada a outra conta do easyCoexistence: remova-a lá primeiro.
  • O link de conexão foi aberto depois de uma hora: crie uma nova sessão.

Como configurar

  1. Make the account professionalIn the Instagram app, switch to a Business or Creator account under Account type and tools.
  2. Start the connectionIn the easyCoexistence dashboard, choose New connection, then Instagram.
  3. Approve the permissionsLog in with the professional account and approve the five permissions Instagram shows.
  4. Allow access to messagesTurn on Allow access to messages under Connected tools in the Instagram app, so DMs work.
  5. Point your AI at itAdd https://easycoexistence.com/api/mcp to Claude or ChatGPT, or call the account from your own code.

Erros comuns

  • Aprovar a conta errada. A janela do Instagram entra com a conta já logada naquele navegador, então troque de conta ali antes de conectar.
  • Confiar apenas no status do redirecionamento. Qualquer pessoa pode digitar status=connected em uma URL, então confirme a sessão com GET /connect-sessions/:id a partir do seu backend.
  • Enviar webhook_url em uma sessão de conexão do Instagram. A API recusa ali; defina o repasse de eventos da conta com PUT /api/v1/channels/:id/webhook assim que ela se conectar.
Fazendo isso com o EasyCoexistence

US$ 9 a US$ 0.75 por conexão por mês, caindo conforme você adiciona conexões, com 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 do meu próprio app de desenvolvedor da Meta para conectar?

Não. O app da Meta do easyCoexistence contém as permissões do Instagram, então o titular entra com o Instagram e as aprova, sem app, App Review ou Verificação de Negócios próprios.

Uma conta Creator pode se conectar?

Sim. Contas Business e Creator se conectam, e a API da Meta as trata da mesma forma para publicação, comentários, DMs e insights.

Posso conectar várias contas do Instagram?

Sim, cada uma com seu próprio login. Cada conta é uma conexão, cobrada de US$ 9 a US$ 0.75 por conexão por mês à medida que seu total cresce.

E se a conta já estiver conectada em outro lugar?

Ela não pode entrar em uma segunda conta do easyCoexistence enquanto estiver ativa na primeira, o que impede que alguém que controla o Instagram a tire de uma conta pagante. Remova-a lá e conecte-a novamente.

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