EntrarComeçar teste grátis
easyCoexistence APIs oficiais

Como agentes de IA se conectam ao Instagram, TikTok e outras redes sociais: OAuth, MCP e APIs oficiais explicados

Um agente de IA se conecta a uma rede social pela API oficial dessa rede: o dono da conta aprova um app na própria tela de consentimento OAuth da rede, o app recebe um token de acesso limitado às permissões aprovadas, e o agente chama a API com ele, renovando o token antes que expire. Os agentes acessam essas APIs pelo próprio app, por uma API unificada ou por um servidor MCP.

O easyCoexistence conecta suas contas pela API oficial e pelo login de cada rede, mantém os tokens renovados e oferece a Claude, ChatGPT ou à sua própria plataforma um conector MCP e uma Partner API para WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, com cada conexão monitorada 24/7.

  • Consentimento OAuth de cada rede, sem compartilhar senha
  • Duração dos tokens de 1 hora a 60 dias, conforme a rede
  • Seu próprio app, uma API unificada ou um servidor MCP, comparados
Começar teste grátis

Nada é cobrado por 3 dias. Cancele quando quiser.

Só APIs oficiaisMCP para Claude e ChatGPTToda conexão monitorada 24/73 dias grátis
1 hour

Por quanto tempo um token de acesso de usuário do Google, o tipo que as APIs do YouTube aceitam, vale antes de expirar.

24 hours

Validade de um token de acesso da API for Business do TikTok; o refresh token que o renova vale por um ano.

60 days

Validade de um token de longa duração de usuário do Instagram, renovável por mais 60 dias depois de ter pelo menos 24 horas.

Separate token

O que um servidor MCP deve usar para uma API de origem: um token emitido por essa própria API, nunca o token que o assistente enviou.

3 events

O que as notificações push do YouTube informam sobre um canal: um novo upload, um novo título ou uma nova descrição.

De que um agente de IA precisa para trabalhar em uma conta de rede social?

Cinco coisas, e a rede controla cada uma delas. A primeira é uma conta que a rede abre para apps, como uma conta profissional do Instagram, uma Página do Facebook que a pessoa administra ou uma Página do LinkedIn em que ela tem papel de administrador, acessada por um app que a rede aprovou para as permissões que pede: a Meta concede cada uma delas pela App Review, o TikTok analisa cada app de desenvolvedor e seus escopos, e o LinkedIn avalia os apps antes do nível Standard. A segunda é o consentimento do dono, dado na própria página de login da rede. A terceira é um token de acesso, que expira e precisa ser renovado. A quarta é uma permissão, ou escopo, para cada tarefa que o agente vai executar. A quinta são os webhooks, para que o agente saiba de um novo comentário ou mensagem assim que acontece.

Nada disso envolve senha. O agente guarda, ou pega emprestado de um serviço, um token que a rede pode limitar, renovar ou revogar.

1Approved appRegistered with the network and cleared for its permissions
2ConsentThe owner signs in on the network's own page
3TokenLimited to the approved scopes, renewed before it expires
4API callsPublish, reply, message, read insights
5WebhooksNew comments and messages pushed as they happen

Como funcionam o login OAuth e os tokens em cada rede?

O mesmo em linhas gerais, com durações diferentes. O app envia o dono para a página de autorização da rede, ele faz login ali e aprova as permissões listadas, e a rede o redireciona de volta com um código de vida curta: o do Instagram dura uma hora, o do TikTok 10 minutos, cada um usável uma única vez, e o do LinkedIn 30 minutos. O servidor do app troca o código por um token de acesso e, em algumas redes, por um refresh token, que gera novos tokens de acesso sem pedir ao dono de novo.

Quando a renovação falha, ou o dono remove o app, as chamadas passam a dar erro de autorização até que o dono entre de novo. O LinkedIn não emite tokens de longa duração e oferece renovação programática só para um grupo limitado de parceiros; sem ela, o app precisa enviar o membro para autorização de novo em até 60 dias.

Sign-inAccess token
WhatsAppMeta's Embedded SignupA business token scoped to the onboarded business
InstagramInstagram Login60 days, refreshable for 60 more once a day old
FacebookFacebook Login for BusinessLong-lived Page tokens have no expiration date
TikTokTikTok's authorization page24 hours, renewed by a refresh token valid for a year
YouTubeGoogle's consent screen1 hour, renewed by a refresh token
LinkedInLinkedIn's consent screen60 days; refresh tokens for a limited set of partners

Quais permissões cada tarefa exige?

Uma permissão para cada tipo de tarefa, nomeada na tela de consentimento, e uma chamada só passa se o token tiver a permissão correspondente. Um agente que apenas lê insights precisa de muito menos do que outro que publica e responde a comentários e DMs, e o LinkedIn pede que os apps solicitem o menor número de escopos possível. Os donos também escolhem de forma diferente: o Google permite aprovar algumas das permissões pedidas e não outras, então o app precisa verificar quais recebeu, enquanto o LinkedIn apresenta os escopos como um conjunto único que o membro aceita ou recusa por inteiro. Estas são as permissões por trás das tarefas mais comuns:

WhatsAppwhatsapp_business_messaging to send and receive messages; whatsapp_business_management for numbers, templates and account webhooks
Instagraminstagram_business_basic, with instagram_business_content_publish, instagram_business_manage_comments, instagram_business_manage_messages or instagram_business_manage_insights
Facebookpages_manage_posts to publish, pages_manage_engagement for comments, pages_messaging for Messenger, read_insights for insights
TikTokTikTok Accounts permissions such as Video Publish, and comment.list to read comments
YouTubeyoutube.upload to upload, youtube.force-ssl to moderate comments, yt-analytics.readonly and youtube.readonly for Analytics reports
LinkedInw_organization_social to post and comment as a Page, r_organization_social to read, w_member_social for a member

Como um agente fica sabendo de novos comentários e mensagens?

Pelos webhooks, enviados pela própria rede: ela envia cada evento ao endpoint HTTPS do app assim que acontece, e o endpoint responde 200 imediatamente. A Meta envia comentários e DMs do Instagram, o feed de uma Página do Facebook, mensagens e menções, e mensagens do WhatsApp com seus status de entrega, repetindo uma entrega com falha do WhatsApp por até 7 dias. O TikTok dispara comment.update em até cinco minutos após um comentário mudar e repete por até 72 horas. As notificações push do YouTube informam uploads e mudanças de título ou descrição, não comentários, e o LinkedIn envia curtidas, comentários e compartilhamentos de uma Página somente para apps do nível Standard.

Quando nenhum evento chega, o agente lê os comentários em uma agenda, e cada leitura conta nos limites de taxa da rede.

Quais são as três formas de conectar um agente: app próprio, API unificada ou servidor MCP?

Elas diferem em quem guarda o app e os tokens. Construir sobre a API de cada rede com um app próprio dá controle total e é o caminho de mais trabalho: um app de desenvolvedor e sua análise em cada rede, um redirecionamento OAuth, armazenamento e renovação de tokens, e endpoints de webhook. Uma API unificada é um provedor que fez esse trabalho uma vez e oferece uma interface e uma chave para várias redes; seu código chama o provedor, e ele chama as redes. Um servidor MCP empacota as mesmas chamadas como ferramentas que Claude, ChatGPT e outros assistentes podem usar, atrás de um login OAuth próprio.

A especificação MCP separa as duas partes. O token do assistente vale somente para o servidor MCP, e o servidor chama cada rede com um token separado, emitido pela própria rede, sem repassar o token do assistente.

What you buildWho holds the network tokens
Your own appAn app and its review per network, OAuth, token refresh, webhooksYou
A unified APICalls to one API with one key; accounts connect through its hosted sign-inThe provider, which may hand them to your code
An MCP serverA connector URL added to the assistant, with OAuth sign-inThe server; the assistant holds only a token for the server

Onde entra o easyCoexistence?

Ele é ao mesmo tempo uma API unificada e um servidor MCP para agentes de IA. As contas se conectam pelo próprio app do easyCoexistence em cada rede, com o dono fazendo login na página da rede, então não há app de desenvolvedor para registrar nem token para guardar do seu lado. Claude, ChatGPT e outros clientes MCP adicionam um conector, https://easycoexistence.com/api/mcp, com login OAuth e mais de 35 ferramentas no total; sua própria plataforma usa a Partner API, conecta as contas de seus clientes por links hospedados e pode pegar as credenciais de cada conta para chamar a rede diretamente.

O easyCoexistence renova os tokens antes que expirem, verifica cada conexão social a cada 6 horas e encaminha eventos do Instagram, Facebook e TikTok para o seu endpoint, assinados por conta. O que um agente pode fazer ainda segue cada rede: ele responde DMs no WhatsApp, Instagram e Messenger, e atua nos comentários do TikTok, YouTube e LinkedIn. Mais redes estão chegando, cada uma entrando no mesmo conector e na mesma API pelo mesmo preço por conexão.

WhatsAppReplies within 24 hours, approved templates after them, number health
InstagramPosts, Reels and Stories, comment replies, DM replies within 24 hours, insights
FacebookPage posts, comment replies, Messenger replies within 24 hours, insights
TikTokVideos and photo posts, public comment replies, insights
YouTubeUploads with YouTube's scheduling, comment replies and moderation, Analytics
LinkedInPage and profile posts, comments, statistics

Erros comuns

  • Dar sua senha a um agente. Os termos do Facebook dizem às pessoas para não compartilhá-la, os do Instagram proíbem coletar credenciais de login de outros usuários, e uma sessão logada como você pode fazer tudo o que você pode, enquanto um token carrega apenas as permissões que você aprovou.
  • Guardar um token uma vez e reutilizá-lo por meses. O token de acesso do TikTok dura 24 horas, e um token do Instagram expira após 60 dias sem renovação, então renove no cronograma ou busque credenciais novas antes de cada tarefa.
  • Consultar novos comentários o tempo todo. Os webhooks os enviam nas redes que fazem isso, e cada consulta gasta chamadas dos limites da conta, como as 40 por minuto em cada endpoint do TikTok.
  • Pedir escopos que o agente não vai usar. A Meta analisa cada permissão que um app solicita, e os membros do LinkedIn aceitam ou recusam o conjunto inteiro de uma vez, então peça somente o que as tarefas do agente exigem.
Fazendo isso com o EasyCoexistence

De US$ 9 a US$ 0.75 por conexão por mês, com preço caindo conforme 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 uma conta de desenvolvedor em cada rede para conectar um agente de IA?

Só quando você constrói com um app próprio. Por uma API unificada ou um servidor MCP como o easyCoexistence, as contas se conectam pelo app do provedor em cada rede, e o dono apenas faz login e aprova as permissões.

Claude e ChatGPT podem usar a mesma conexão com minhas contas?

Sim, por um único servidor MCP. Cada assistente faz login nele com um token próprio e acessa as mesmas contas conectadas, enquanto os tokens das redes ficam com o servidor.

O que acontece quando um token expira?

As chamadas falham com erro de autorização até que o token seja renovado. Se o refresh token também tiver vencido, como o do TikTok após um ano ou o do Google sem uso por seis meses, o dono faz login de novo.

Quanto custa o easyCoexistence para conectar um agente de IA às redes sociais?

De US$ 9 a US$ 0.75 por conexão por mês, com preço caindo conforme você adiciona conexões, igual em todas as redes. O conector MCP e a Partner API estão incluídos, sem assentos, e os primeiros 3 dias são 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