Como ligar uma conta do Instagram a uma API ou agente de IA
Uma conta do Instagram liga-se a uma API ou agente de IA através do Instagram Login. O titular inicia sessão com uma conta profissional, Business ou Creator, e aprova as cinco permissões da aplicação, que cobrem acesso básico, publicação, comentários, mensagens e estatísticas; a aplicação recebe depois um token de 60 dias, renovável por mais 60. Para mensagens diretas, a conta ativa também Permitir acesso a mensagens na aplicação do Instagram.
O easyCoexistence liga uma conta Business ou Creator do Instagram com um só início de sessão no próprio login do Instagram, mantém o acesso renovado e verifica-o de 6 em 6 horas, para que o Claude, o ChatGPT ou a sua própria plataforma possam publicar, agendar, responder a comentários e mensagens diretas e ler estatísticas através da API oficial da Meta.
A lista da Meta para o produto Instagram: instagram_business_basic, content_publish, manage_comments, manage_insights e manage_messages.
Prazo de validade do código de autorização do início de sessão no Instagram; só pode ser trocado uma vez.
Validade do token de acesso de longa duração do utilizador do Instagram, renovável por mais 60 dias.
Prazo de funcionamento de um link de ligação do easyCoexistence antes de a sessão expirar.
Que contas se podem ligar?
Contas profissionais do Instagram, Business ou Creator. A API da Meta serve os dois tipos da mesma forma para publicação, comentários, mensagens diretas e estatísticas. Uma conta pessoal passa primeiro a profissional na aplicação do Instagram, em Tipo de conta e ferramentas. Com o Instagram Login, o titular inicia sessão com as credenciais da própria conta do Instagram, na página de início de sessão do próprio Instagram.
O que vê o titular ao iniciar sessão?
A janela de início de sessão do próprio Instagram. A aplicação envia o titular para https://www.instagram.com/oauth/authorize com o seu ID de aplicação do Instagram, um URI de redirecionamento e as permissões pedidas; o titular inicia sessão, revê-as e aprova. O Instagram devolve depois a aplicação com um código, válido durante uma hora e utilizável uma só vez, que o servidor da aplicação troca por um token. Um início de sessão cancelado regressa com error=access_denied.
Para que serve cada permissão?
Cada funcionalidade precisa de instagram_business_basic mais uma permissão própria, e o titular aprova-as todas juntas na mesma janela. O easyCoexistence pede estas cinco, o conjunto que a Meta indica para o produto Instagram, para que um agente possa publicar, responder e medir a conta:
Como ativar as mensagens diretas?
Na aplicação do Instagram, abra Definições, depois Mensagens e respostas a stories, Controlos de mensagens e Ferramentas ligadas, e ative Permitir acesso a mensagens. A Meta exige este interruptor antes de uma aplicação gerir as mensagens diretas da conta; enquanto estiver desligado, os envios falham mesmo com a permissão de mensagens concedida, ao passo que a publicação e os comentários funcionam normalmente.
Como ligar à easyCoexistence?
No painel, num único início de sessão: escolha Nova ligação, depois Instagram, e inicie sessão com a conta profissional. Se a conta não tiver cartão registado, é pedido primeiro um, já que cada ligação é faturada. Quando o Instagram devolve o controlo, a página do canal mostra Ligado, e o easyCoexistence subscreve a conta aos seus eventos de comentários, menções e mensagens diretas, renova o acesso antes de os 60 dias terminarem e verifica-o de 6 em 6 horas.
Como liga uma plataforma as contas dos seus clientes?
Com um link de ligação alojado, a partir da Partner API. O seu backend envia um pedido POST para /api/v1/connect-sessions com channel definido como instagram e um redirect_url, e depois envia o cliente para o url devolvido; o cliente inicia sessão no Instagram ali mesmo, sem conta própria no easyCoexistence. O navegador regressa com a sessão, o estado e o novo channel_id, que o seu backend confirma com GET /connect-sessions/:id antes de confiar nele.
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 de ligar?
A conta fica pronta para o que a utilizar. list_social_accounts devolve-a ao Claude, ao ChatGPT ou ao seu próprio agente, get_social_credentials entrega o seu ID e a base da API ao seu código, e os eventos de comentários, menções e mensagens diretas seguem para o seu endpoint assim que definir um, com set_social_webhook_destination ou PUT /api/v1/channels/:id/webhook.
Porque pode falhar uma ligação?
Geralmente por uma de quatro razões, cada uma com uma solução direta:
- A conta é pessoal: passe-a a Business ou Creator na aplicação do Instagram.
- O titular cancelou o início de sessão: nada fica ligado, e recomeçar abre uma janela nova.
- A conta já está ligada a outra conta do easyCoexistence: remova-a primeiro aí.
- O link de ligação foi aberto depois de a hora expirar: crie uma sessão nova.
Como configurar
- Make the account professionalIn the Instagram app, switch to a Business or Creator account under Account type and tools.
- Start the connectionIn the easyCoexistence dashboard, choose New connection, then Instagram.
- Approve the permissionsLog in with the professional account and approve the five permissions Instagram shows.
- Allow access to messagesTurn on Allow access to messages under Connected tools in the Instagram app, so DMs work.
- 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 inicia sessão com a conta que já tem sessão iniciada nesse navegador, por isso troque de conta aí antes de ligar.
- Confiar apenas no estado do redirecionamento. Qualquer pessoa pode escrever status=connected num URL, por isso confirme a sessão com GET /connect-sessions/:id a partir do seu backend.
- Enviar webhook_url numa sessão de ligação do Instagram. A API recusa-o aí; defina o encaminhamento de eventos da conta com PUT /api/v1/channels/:id/webhook assim que ligar.
A partir de US$ 9 por ligação por mês, descendo até US$ 0.75 à medida que acrescenta ligações, com os primeiros 3 dias grátis.
Perguntas frequentes
Preciso da minha própria aplicação de programador da Meta para ligar?
Não. A aplicação da Meta do easyCoexistence detém as permissões do Instagram, por isso o titular inicia sessão com o Instagram e aprova-as, sem aplicação própria, sem análise da aplicação nem verificação da empresa.
Pode ligar-se uma conta Creator?
Sim. As contas Business e Creator ligam-se ambas, e a API da Meta trata-as da mesma forma para publicação, comentários, mensagens diretas e estatísticas.
Posso ligar várias contas do Instagram?
Sim, cada uma com o seu próprio início de sessão. Cada conta é uma ligação, faturada a partir de US$ 9 e descendo até US$ 0.75 por ligação por mês, à medida que o total cresce.
E se a conta já estiver ligada noutro lado?
Não pode ser ligada a uma segunda conta do easyCoexistence enquanto estiver ativa na primeira, o que impede que alguém que controla o Instagram a retire de uma conta paga. Remova-a aí e volte a ligá-la.
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