API de redes sociais para agências: gerencie as contas dos seus clientes a partir do seu próprio software
Uma API de redes sociais para agências permite que o software da própria agência conecte, publique, responda e gere relatórios sobre as contas de cada cliente. Com a Partner API da easyCoexistence, o número de WhatsApp e as contas de Instagram, Facebook, TikTok, YouTube e LinkedIn de um cliente entram na conta da agência por links hospedados marcados com o id do cliente, e uma única chave de API agenda, roteia e monitora todas elas.
O tamanho máximo do external_ref que uma sessão de conexão aceita, o id da agência para o cliente, mantido em cada conexão.
Por quanto tempo um link de conexão hospedado funciona para o cliente que o abre.
O que um app da Meta precisa para atender contas profissionais do Instagram que não possui nem gerencia, após App Review e Business Verification.
O papel de Página do LinkedIn que um membro precisa ter para a permissão rw_organization_admin, que gerencia Páginas e lê seus relatórios.
Quando a cobrança de uma conexão de cliente que a agência remove pela API é interrompida.
Como a API organiza os clientes de uma agência?
Pelo seu id de cliente. Envie-o como external_ref em cada sessão de conexão, e ele fica em cada número e conta criados pela sessão e volta em todo evento de status. GET /channels?external_ref=client_118 lista as contas sociais desse cliente, com &channel=instagram para restringir a uma rede, e GET /connections?external_ref=client_118 lista os números de WhatsApp dele. Cada cliente fica na conta única da agência, sob uma só chave ec_live_, o que coloca toda a contagem em uma só faixa de preço.
curl "https://easycoexistence.com/api/v1/channels?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"
curl "https://easycoexistence.com/api/v1/connections?external_ref=client_118" \
-H "Authorization: Bearer $EC_API_KEY"Como um cliente concede acesso?
Por um link que a agência envia. POST /connect-sessions com a rede como channel, o external_ref do cliente e o nome da agência como partner_name retorna uma url; o cliente a abre, faz login na tela de consentimento da própria rede, ou usa o popup da Meta e escaneia um QR code para um número de WhatsApp, e volta para o redirect_url da agência. Um login no Facebook ou no LinkedIn pode trazer várias Páginas de uma vez, cada uma como uma conexão própria, então confira a lista com o briefing do cliente.
Como a agência publica para os clientes?
Pelo seu próprio fluxo de aprovação. O software da agência mantém os rascunhos até que o cliente aprove, então envia cada post aprovado para POST /channels/:id/posts com seu publish_at, com até 90 dias de antecedência. GET /channels/:id/posts mostra o calendário de uma conta, GET /posts com um filtro de status mostra o que está aguardando entre os clientes, e post.published e post.failed informam o gestor de contas o que aconteceu. Posts do LinkedIn sempre passam pela aprovação de uma pessoa, o que a etapa de aprovação da agência já oferece.
Como a agência responde a comentários e DMs dos clientes?
De uma caixa de entrada única que roteia por conta. PUT /channels/:id/webhook define um destino para cada conta do Instagram, Página do Facebook e conta do TikTok, e todo comentário, menção ou DM encaminhado traz o account_id, que associa ao cliente. As mensagens de um número de WhatsApp vão da Meta para o webhook_url definido para ele. As respostas saem pela API de cada rede com as credenciais de GET /channels/:id?credentials=1, e a equipe da agência também pode atuar entre clientes no Claude ou no ChatGPT pelo conector MCP na mesma conta.
Como a agência monta relatórios dos clientes?
A partir das análises de cada rede, chamadas com as credenciais da conta do cliente. Os insights do Instagram e do Facebook vêm da Graph API da Meta, os do TikTok da sua API for Business, os do YouTube do YouTube Analytics, cuja base as credenciais incluem, e os do LinkedIn dos seus endpoints de estatísticas. A rotina de relatórios da agência busca credenciais novas para cada conta no início de cada execução, puxa os números do período e os arquiva sob o external_ref do cliente.
Como a agência fica sabendo que a conta de um cliente precisa de atenção?
Por eventos de status assinados. channel.disconnected e connection.disconnected trazem o external_ref do cliente, então o software da agência pode alertar o gestor de contas desse cliente e enviar ao cliente um novo link de conexão. Cada conexão é monitorada 24/7, e o dono da agência também recebe um e-mail quando uma delas cai. Um cliente que retira o acesso nas configurações da rede aparece da mesma forma.
O que acontece na API quando um cliente sai?
A rotina de offboarding da agência lista as conexões do cliente pelo external_ref e chama DELETE /channels/:id e DELETE /connections/:id em cada uma. A cobrança delas para ao fim do ciclo, posts agendados em um canal removido são cancelados, e o token de uma conta social removida é descartado. Um número de WhatsApp continua na Cloud API até que o cliente o desconecte no app do WhatsApp Business.
Erros comuns
- Colocar posts de clientes na fila antes da aprovação do cliente. Um post na fila é publicado no horário sem outra verificação, então mantenha os rascunhos na sua etapa de aprovação e envie-os só depois de aprovados.
- Colocar a chave da Partner API no front end do portal de um cliente. A chave dá acesso às credenciais de todos os clientes da conta, então mantenha-a no servidor da agência.
- Esperar eventos de comentários de um canal do YouTube ou de uma Página do LinkedIn de um cliente. A easyCoexistence não recebe nenhum deles dessas redes, então a rotina de relatórios ou de caixa de entrada os lê pela API de cada rede.
A easyCoexistence oferece ao software próprio da agência uma única API para os números de WhatsApp dos seus clientes e as contas de Instagram, Facebook, TikTok, YouTube e LinkedIn, além de outros canais que virão: links de conexão hospedados marcados por cliente, uma fila de publicação, comentários e DMs encaminhados, credenciais novas para relatórios e cada conexão monitorada 24/7. 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
Os clientes precisam de uma conta própria na easyCoexistence?
Não. O cliente abre o link hospedado e faz login, e a conexão entra na conta da agência, onde é cobrada e monitorada.
A agência pode manter os clientes em chaves de API separadas?
Uma conta tem uma chave. Chaves separadas significam contas separadas na easyCoexistence, cada uma cobrada desde a primeira faixa, por isso a maioria das agências separa os clientes pelo external_ref.
O cliente vê o nome da agência ao conectar?
Sim. A página hospedada mostra o nome enviado como partner_name. A tela de consentimento da própria rede identifica a easyCoexistence como o app que pede acesso.
Quanto custa a easyCoexistence para uma agência?
US$ 9 a US$ 0,75 por conexão de cliente por mês, caindo conforme a agência adiciona clientes, o mesmo em todas as redes, com os primeiros 3 dias 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