API de redes sociais para agências: gira 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 ligue, publique, responda e crie relatórios sobre as contas de cada cliente. Com a Partner API da easyCoexistence, o número de WhatsApp de um cliente e as contas de Instagram, Facebook, TikTok, YouTube e LinkedIn passam a fazer parte da conta da agência através de links alojados marcados com o id do cliente, e uma só chave de API agenda, encaminha e monitoriza todas elas.
O comprimento máximo do external_ref que uma sessão de ligação aceita, o id próprio da agência para o cliente, guardado em cada ligação.
Durante quanto tempo um link alojado de ligação funciona para o cliente que o abre.
O que uma app da Meta precisa para servir contas profissionais de Instagram que não possui nem gere, após App Review e verificação da empresa.
O papel na Página do LinkedIn de que um membro precisa para a permissão rw_organization_admin, que gere as Páginas e lê os seus relatórios.
Quando a faturação cessa para uma ligação de cliente que a agência remove através da API.
Como é que a API organiza os clientes de uma agência?
Pelo seu id de cliente. Envie-o como external_ref em cada sessão de ligação, e fica guardado em cada número e conta que a sessão cria e regressa em cada evento de estado. GET /channels?external_ref=client_118 lista as contas sociais desse cliente, com &channel=instagram para as restringir a uma rede, e GET /connections?external_ref=client_118 lista os respetivos números de WhatsApp. Todos os clientes ficam na única conta da agência, sob uma só chave ec_live_, o que coloca toda a contagem numa 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 é que um cliente entrega o acesso?
Através de 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 devolve um url; o cliente abre-o, inicia sessão no ecrã de consentimento da própria rede, ou usa a janela pop-up da Meta e lê um código QR para um número de WhatsApp, e regressa ao redirect_url da agência. Um início de sessão no Facebook ou no LinkedIn pode trazer várias Páginas de uma vez, cada uma com a sua ligação, pelo que convém confirmar a lista com o briefing do cliente.
Como é que a agência publica para os clientes?
A partir do seu próprio fluxo de aprovação. O software da agência mantém os rascunhos até que o cliente dê o seu aval, e depois envia cada publicação aprovada para POST /channels/:id/posts com o respetivo publish_at, até 90 dias à frente. GET /channels/:id/posts devolve o calendário de uma conta, GET /posts com um filtro de estado mostra o que está à espera em todos os clientes, e post.published e post.failed dizem ao gestor de conta o que aconteceu. As publicações no LinkedIn passam sempre pela aprovação de uma pessoa, que a etapa de aval da agência já assegura.
Como é que a agência responde a comentários e DMs dos clientes?
A partir de uma caixa de entrada única que encaminha por conta. PUT /channels/:id/webhook define um destino para cada conta de Instagram, Página do Facebook e conta do TikTok, e cada comentário, menção ou DM encaminhado traz o account_id, que corresponde ao cliente. As mensagens de um número de WhatsApp seguem da Meta para o webhook_url definido para ele. As respostas saem pela API de cada rede, com as credenciais obtidas em GET /channels/:id?credentials=1, e a equipa da agência pode também trabalhar em todos os clientes no Claude ou no ChatGPT através do conector MCP da mesma conta.
Como é que a agência cria relatórios dos clientes?
A partir das análises de cada rede, chamadas com as credenciais da conta do cliente. As métricas de Instagram e Facebook vêm da Graph API da Meta, as do TikTok da sua API for Business, as do YouTube do YouTube Analytics, cuja base as credenciais incluem, e as do LinkedIn dos seus endpoints de estatísticas. A tarefa de relatórios da agência obtém credenciais novas por conta no início de cada execução, recolhe os números do período e guarda-os sob o external_ref do cliente.
Como é que a agência sabe que a conta de um cliente precisa de atenção?
Através de eventos de estado assinados. channel.disconnected e connection.disconnected trazem o external_ref do cliente, para que o software da agência possa alertar o gestor de conta desse cliente e enviar-lhe um link de ligação novo. Cada ligação é monitorizada 24 horas por dia, e o titular da agência também recebe um e-mail quando uma delas cai. Um cliente que retire o acesso nas definições da rede aparece da mesma forma.
O que acontece na API quando um cliente sai?
A tarefa de desligamento da agência lista as ligações do cliente por external_ref e chama DELETE /channels/:id e DELETE /connections/:id em cada uma. A faturação dessas ligações cessa no fim do ciclo, as publicações agendadas num canal removido são canceladas, e o token de uma conta social removida é esquecido. Um número de WhatsApp continua na Cloud API até que o cliente o desligue na app do WhatsApp Business.
Erros comuns
- Colocar publicações de clientes em fila antes de o cliente dar o seu aval. Uma publicação em fila é publicada à hora marcada sem outra verificação, por isso mantenha os rascunhos na etapa de aprovação e envie-os só depois de aprovados.
- Pôr 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, por isso mantenha-a no servidor da agência.
- Esperar eventos de comentários do canal de YouTube de um cliente ou da Página do LinkedIn. A easyCoexistence não recebe eventos de nenhum dos dois, por isso o trabalho de relatórios ou de caixa de entrada lê-os através da API de cada rede.
A easyCoexistence dá ao software próprio de uma agência uma só API para os números de WhatsApp dos seus clientes e para as suas contas de Instagram, Facebook, TikTok, YouTube e LinkedIn, e mais canais a caminho: links alojados de ligação marcados por cliente, uma fila de publicação, comentários e DMs encaminhados, credenciais novas para relatórios e cada ligação monitorizada 24 horas por dia. De US$ 9 a US$ 0.75 por ligação por mês, a descer à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Os clientes precisam de uma conta própria na easyCoexistence?
Não. O cliente abre o link alojado e inicia sessão, e a ligação passa a fazer parte da conta da agência, onde é faturada e monitorizada.
A agência pode manter os clientes em chaves de API separadas?
Uma conta tem uma só chave. Chaves separadas significam contas separadas na easyCoexistence, cada uma faturada desde a primeira faixa, por isso a maioria das agências separa os clientes pelo external_ref.
O cliente consegue ver o nome da agência ao ligar?
Sim. A página alojada mostra o nome enviado como partner_name. O ecrã de consentimento da própria rede indica a easyCoexistence como a aplicação que pede acesso.
Quanto custa a easyCoexistence para uma agência?
De US$ 9 a US$ 0.75 por ligação de cliente por mês, a descer à medida que a agência adiciona clientes, igual em todas as redes, com os primeiros 3 dias 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