Iniciar sessãoIniciar teste gratuito
easyCoexistence APIs oficiais

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.

200 characters

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.

1 hour

Durante quanto tempo um link alojado de ligação funciona para o cliente que o abre.

Advanced Access

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.

ADMINISTRATOR

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.

End of cycle

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.

One client's accounts
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.
Fazer isto com a EasyCoexistence

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

easyCoexistence para agências: as contas dos seus clientes num só lugarAs agências ligam os canais dos clientes, como WhatsApp, Instagram e TikTok, com links que os clientes abrem, e gerem um agente de IA sobre todos.Como criar um agendador de redes sociais com uma API: a fila, os conteúdos multimédia e os estados das publicaçõesCrie um agendador de redes sociais na API de publicações da easyCoexistence: publish_at até 90 dias antes, multimédia copiada ao agendar, seis estados e eventos.Revender funcionalidades de redes sociais no seu SaaS: margens de US$ 9 a US$ 0.75 por ligaçãoQuanto ganha um SaaS ao revender redes sociais e WhatsApp de US$ 9 a US$ 0.75 por ligação: margens calculadas por complemento fixo e por conta.Migrar o seu SaaS da Ayrshare, Zernio ou Unipile para o easyCoexistence: o que muda no seu códigoMigrar um SaaS da Ayrshare, Zernio ou Unipile para o easyCoexistence: sessões de ligação, IDs de canal, publicações por conta, eventos assinados e a transição.Arquitetura de um SaaS de agentes de IA: chegar aos clientes dos seus clientes no WhatsApp, Instagram e TikTokArquitetura de um SaaS de agentes de IA que responde aos clientes dos seus clientes: ligações, ingestão, armazenamento de conversas, worker e envio.Como permitir que os seus utilizadores ligam contas de WhatsApp, Instagram e TikTok à sua aplicaçãoLigações alojadas para os números WhatsApp e contas sociais dos seus utilizadores: pedido de sessão, redirecionamento, estado, validade e novas tentativas.

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