Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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

Um agente de IA liga-se a uma rede social através da API oficial dessa rede: o titular da conta aprova uma aplicação no próprio ecrã de consentimento OAuth da rede, a aplicação recebe um token de acesso limitado às permissões aprovadas, e o agente chama a API com ele, renovando o token antes de expirar. Os agentes chegam a essas APIs através da sua própria aplicação, de uma API unificada ou de um servidor MCP.

A easyCoexistence liga as suas contas através da API oficial e do início de sessão de cada rede, mantém os tokens renovados e oferece ao Claude, ao ChatGPT ou à sua própria plataforma um único conector MCP e uma Partner API para WhatsApp, Instagram, Facebook, TikTok, YouTube, LinkedIn e mais canais, com cada ligação monitorizada 24 horas por dia, 7 dias por semana.

  • Consentimento OAuth de cada rede, sem partilhar palavra-passe
  • Tempos de vida dos tokens de 1 hora a 60 dias, rede a rede
  • A sua própria aplicação, uma API unificada ou um servidor MCP, comparados
Começar período experimental gratuito

Nada é cobrado durante 3 dias. Cancele quando quiser.

Apenas APIs oficiaisMCP para Claude e ChatGPTTodas as ligações monitorizadas 24/73 dias grátis
1 hour

Duração de um token de acesso de utilizador do Google, o tipo que as APIs do YouTube aceitam, antes de expirar.

24 hours

Duração de um token de acesso da API for Business do TikTok; o token de atualização que o renova é válido por um ano.

60 days

Validade de um token de utilizador do Instagram de longa duração, 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 que essa API emitiu, nunca o token que o assistente enviou.

3 events

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

De que precisa um agente de IA para trabalhar numa conta social?

Cinco coisas, e a rede controla cada uma delas. A primeira é uma conta que a rede abre às aplicações, como uma conta profissional do Instagram, uma Página do Facebook que a pessoa gere ou uma Página do LinkedIn onde detém uma função de administrador, acedida através de uma aplicação que a rede aprovou para as permissões que pede: a Meta concede-as uma a uma através da App Review, o TikTok analisa cada aplicação de programador e os seus âmbitos, e o LinkedIn avalia as aplicações antes do nível Standard. A segunda é o consentimento do titular, dado na página de início de sessão da própria rede. A terceira é um token de acesso, que expira e tem de ser renovado. A quarta é uma permissão, ou âmbito, 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 à medida que acontece.

Nada disto envolve uma palavra-passe. O agente detém, ou obtém 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 início de sessão OAuth e os tokens em cada rede?

No essencial, da mesma forma, com tempos de vida diferentes. A aplicação envia o titular para a página de autorização da rede, o titular inicia sessão aí e aprova as permissões listadas, e a rede reencaminha de volta com um código de curta duração: o do Instagram dura uma hora e o do TikTok 10 minutos, ambos utilizáveis uma só vez, e o do LinkedIn 30 minutos. O servidor da aplicação troca o código por um token de acesso e, em algumas redes, por um token de atualização, que emite novos tokens de acesso sem voltar a pedir ao titular.

Quando uma atualização falha, ou o titular remove a aplicação, as chamadas começam a falhar com um erro de autorização até o titular voltar a iniciar sessão. O LinkedIn não emite tokens de longa duração e oferece a renovação programática apenas a um conjunto limitado de parceiros, por isso, sem ela, a aplicação envia o membro novamente pela autorização dentro de 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

Que permissões exige cada tarefa?

Uma permissão para cada tipo de tarefa, indicada no ecrã de consentimento, e um pedido só é aceite se o token tiver a permissão que lhe corresponde. Um agente que apenas lê estatísticas precisa de muito menos do que um que publica e responde a comentários e mensagens diretas, e o LinkedIn pede às aplicações que solicitem o menor número possível de âmbitos. Os titulares também escolhem de forma diferente: o Google permite às pessoas aprovar algumas das permissões pedidas e não outras, pelo que uma aplicação tem de verificar quais recebeu, ao passo que o LinkedIn apresenta os seus âmbitos como um único conjunto que o membro aceita ou recusa por inteiro. Estas são as permissões associadas às tarefas habituais:

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 fica um agente a saber de novos comentários e mensagens?

Através de webhooks, que a rede envia: publica cada evento no endpoint HTTPS da aplicação à medida que acontece, e o endpoint responde 200 de imediato. A Meta envia comentários e mensagens diretas do Instagram, o feed de uma Página do Facebook, mensagens e menções, e mensagens do WhatsApp com os respetivos estados de entrega, voltando a tentar uma entrega falhada do WhatsApp durante até 7 dias. O TikTok dispara comment.update nos cinco minutos seguintes a uma alteração num comentário e volta a tentar durante até 72 horas. As notificações push do YouTube comunicam carregamentos e alterações de título ou descrição, não comentários, e o LinkedIn envia gostos, comentários e partilhas de uma Página apenas às aplicações do nível Standard.

Quando não chega nenhum evento, o agente lê os comentários de forma programada, e cada leitura conta para os limites de pedidos da rede.

Quais são as três formas de ligar um agente: a sua própria aplicação, uma API unificada ou um servidor MCP?

Diferem em quem detém a aplicação e os tokens. Construir sobre a API de cada rede com a sua própria aplicação dá controlo total e é o que mais trabalho dá: uma aplicação de programador e a respetiva revisão em cada rede, um redirecionamento OAuth, armazenamento e renovação de tokens, e endpoints para webhooks. Uma API unificada é um fornecedor que fez esse trabalho uma vez e coloca uma interface e uma chave única à frente de várias redes; o seu código chama-a, e ela chama as redes. Um servidor MCP empacota as mesmas chamadas como ferramentas que o Claude, o ChatGPT e outros assistentes podem usar, por trás de um início de sessão OAuth próprio.

A especificação MCP mantém as duas metades separadas. O token do assistente só é válido para o servidor MCP, e o servidor chama cada rede com um token distinto, emitido pela própria rede, sem nunca transmitir 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 se encaixa a easyCoexistence?

É, ao mesmo tempo, uma API unificada e um servidor MCP para agentes de IA. As contas ligam-se através da aplicação própria da easyCoexistence em cada rede, em que o titular inicia sessão na página da rede, pelo que não há aplicação de programador para registar nem token para guardar do seu lado. O Claude, o ChatGPT e outros clientes MCP adicionam um único conector, https://easycoexistence.com/api/mcp, com início de sessão OAuth e mais de 35 ferramentas no total; a sua própria plataforma usa a Partner API, liga as contas dos seus clientes através de ligações alojadas e pode receber as credenciais de cada conta para chamar a rede diretamente.

A easyCoexistence renova os tokens antes de expirarem, verifica cada ligação social de 6 em 6 horas e reencaminha os eventos do Instagram, Facebook e TikTok para o seu endpoint, assinados por conta. O que um agente pode fazer continua a depender de cada rede: responde a mensagens diretas no WhatsApp, Instagram e Messenger, e trabalha nos comentários do TikTok, YouTube e LinkedIn. Estão a chegar mais redes, cada uma a juntar-se ao mesmo conector e à mesma API, ao mesmo preço por ligaçã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

  • Entregar a um agente a sua palavra-passe. Os termos do Facebook dizem às pessoas que não a partilhem, os do Instagram proíbem recolher credenciais de início de sessão de outros utilizadores, e uma sessão iniciada em nome do titular pode fazer tudo o que ele pode, ao passo que um token carrega apenas as permissões aprovadas.
  • Guardar um token uma vez e reutilizá-lo durante meses. O token de acesso do TikTok dura 24 horas e um token do Instagram caduca ao fim de 60 dias sem renovação, por isso renove-o na data prevista ou obtenha credenciais novas antes de cada tarefa.
  • Consultar por sondagem os novos comentários a toda a hora. Os webhooks enviam-nos nas redes que os enviam, e cada consulta gasta chamadas dos limites da conta, como as 40 por minuto do TikTok em cada endpoint.
  • Pedir âmbitos que o agente não vai usar. A Meta analisa cada permissão que uma aplicação pede, e os membros do LinkedIn aceitam ou recusam o conjunto inteiro de uma vez, por isso peça apenas o que as tarefas do agente exigem.
Fazer isto com a EasyCoexistence

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 conta de programador em cada rede para ligar um agente de IA?

Só quando constrói com a sua própria aplicação. Através de uma API unificada ou de um servidor MCP, como a easyCoexistence, as contas ligam-se pela aplicação do fornecedor em cada rede, e o titular apenas inicia sessão e aprova as permissões.

O Claude e o ChatGPT podem usar a mesma ligação às minhas contas?

Sim, através de um só servidor MCP. Cada assistente inicia sessão nele com um token próprio e acede às mesmas contas ligadas, enquanto os tokens das redes ficam no servidor.

O que acontece quando um token expira?

As chamadas falham com um erro de autorização até o token ser renovado. Se também o token de atualização tiver caducado, como um do TikTok ao fim de um ano ou um do Google que ficou sem uso durante seis meses, o titular volta a iniciar sessão.

Quanto custa a easyCoexistence para ligar um agente de IA às redes sociais?

De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que acrescenta ligações, igual em todas as redes. O conector MCP e a Partner API estão incluídos, sem licenças de utilizador, e os primeiros 3 dias são 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