Como construir um agendador de redes sociais com API: a fila, a mídia e os status dos posts
Para criar um agendador de redes sociais com a API Partner da easyCoexistence, seu backend envia cada post para POST /channels/:id/posts, com texto, mídia e um publish_at de 1 minuto a 90 dias à frente. A easyCoexistence copia a mídia de imediato e publica o post no horário definido no Instagram, Facebook, TikTok ou LinkedIn, informando cada etapa como status e pelos eventos post.published e post.failed.
Até quando a API de posts agenda no Instagram, Facebook, TikTok e LinkedIn; o horário mais próximo é a 1 minuto.
Maior imagem e maior vídeo que a easyCoexistence copia ao agendar um post; um arquivo maior é recusado naquele momento.
Quando um post que a rede limitou por taxa é repetido, antes de ser marcado como falho.
Posts publicados pela API que uma conta do Instagram pode fazer em qualquer janela de 24 horas; um carrossel conta como um.
Limite do TikTok para posts de vídeo por conta por meio do seu endpoint de publicação, com no máximo seis em um minuto.
O que um agendador precisa da API?
Cinco coisas: um lugar para enviar arquivos, uma chamada que coloca um post na fila de uma conta, uma fila que publica no horário, uma forma de mudar de ideia e a informação do que aconteceu. A API de posts oferece cada uma delas com a mesma chave ec_live_ que conecta seus clientes, então o calendário, o fluxo de aprovação e o editor continuam no seu produto.
Como agendar um post?
Com um POST por conta para https://easycoexistence.com/api/v1/channels/:id/posts, em que :id é o channel_id da sessão de conexão do cliente. publish_at está no formato ISO 8601, com Z ou um offset; omita o campo para publicar agora. A resposta é 201 com o post, ou 422 quando um post para agora falha. Um cabeçalho Idempotency-Key é respeitado, então uma requisição repetida após um timeout não coloca o post na fila duas vezes. O corpo aceita:
- text: a legenda, mensagem ou comentário; media: uma lista de {url, type} ou {
media_id}. - link: um post de link no Facebook ou um artigo no LinkedIn, com título no LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS ou STORIES, inferido pela mídia quando omitido.- title e
disable_commentpara posts de foto no TikTok;image_altpara uma imagem no LinkedIn.
curl -X POST https://easycoexistence.com/api/v1/channels/$CHANNEL_ID/posts \
-H "Authorization: Bearer $EC_API_KEY" \
-H "Idempotency-Key: campaign-311-ig" \
-H "Content-Type: application/json" \
-d '{
"text": "Three looks for the weekend",
"media": [
{ "url": "https://cdn.example.com/looks/1.jpg", "type": "image" },
{ "url": "https://cdn.example.com/looks/2.jpg", "type": "image" }
],
"ig_type": "CAROUSEL",
"publish_at": "2026-11-20T09:00:00-05:00"
}'Como o agendador trata a mídia?
Por link ou por upload. Um link HTTPS público vai direto para media; um arquivo que seus usuários enviam vai para POST /media, como corpo da requisição com seu Content-Type e Content-Length, ou como {"url"}, e o media_id retornado entra no post. Quando um post é agendado, a easyCoexistence copia os arquivos, então seu link só precisa funcionar naquele momento. Uma página web no lugar de um arquivo, um 404, o tipo errado ou um arquivo acima de 30 MB para imagens ou 1 GB para vídeos é recusado nesse momento, e não na manhã da publicação.
O que o post de cada rede pode conter?
A fila verifica cada post contra as regras da rede antes de aceitá-lo, e um post que quebra alguma regra é recusado com uma mensagem que indica a regra, para que seu editor mostre o problema enquanto o usuário ainda está editando. Cada rede aceita:
Por quais status um post passa?
Seis, que GET /posts/:id e GET /posts informam junto com publish_at, o link do post depois de publicado e o erro da rede quando falhou:
- scheduled: na fila, aguardando o horário.
- publishing: enviado à rede.
- processing: a rede ainda está processando, como acontece com um vídeo do TikTok ou um container do Instagram.
- published: no ar, com o link.
- failed: recusado ou não confirmado;
may_be_publishedmarca um post que a rede pode ter recebido. - canceled: removido antes de sair, por você ou porque o canal foi removido ou suspenso.
Como editar, cancelar ou repetir um post?
PATCH /posts/:id altera o horário ou o texto de um post agendado, e o título de um post de foto no TikTok; para trocar a mídia, cancele e agende um novo. DELETE /posts/:id cancela o post. POST /posts/:id/retry publica de novo um post que falhou, agora. Um post que a rede limitou por taxa é repetido sozinho após 5 minutos, 30 minutos e 2 horas, e um post marcado como may_be_published precisa de uma verificação na conta antes de qualquer repetição.
Como o agendador fica sabendo do que aconteceu?
Pelos eventos e pela listagem. A URL de eventos de status configurada em Perfil, Developers recebe post.published e post.failed, assinados com X-EC-Signature como todos os outros eventos, com o post e seu canal, para que seu calendário marque cada um como publicado ou sinalize o problema. GET /posts aceita status, from, to e limit para visões de calendário, e GET /channels/:id/posts lista uma conta. Um post que falha em segundo plano também envia e-mail ao dono da conta, no máximo uma vez por canal a cada 3 horas.
Como os posts do LinkedIn se encaixam em um agendador?
Com uma pessoa aprovando cada um. Os Termos de API do LinkedIn restringem o uso de suas APIs para automatizar publicações, então um agendador mantém cada post do LinkedIn como rascunho no seu produto até que uma pessoa identificada o aprove, e só então o envia com seu publish_at. Regras recorrentes, feeds e importações em massa devem apontar para as outras redes, deixando o LinkedIn para posts que alguém revisou.
Erros comuns
- Enviar publish_at sem offset. Um horário local sem Z ou offset é recusado, então envie 2026-11-20T09:00:00-05:00 em vez do horário simples escolhido pelo usuário.
- Repetir de imediato um post marcado como may_be_published. A rede pode já exibi-lo, então verifique a conta primeiro, ou o post sai duas vezes.
- Repetir um POST que deu timeout sem Idempotency-Key. Dê a cada post sua própria chave, para que uma requisição repetida devolva o post já na fila em vez de agendar uma segunda cópia.
- Vincular arquivos PNG para o Instagram. A API de publicação do Instagram aceita somente JPEG, e o post é recusado no momento do agendamento, então converta as imagens na etapa de upload.
A easyCoexistence oferece ao seu agendador uma fila única para as contas do Instagram, Facebook, TikTok e LinkedIn dos seus clientes, e mais canais, por meio das APIs oficiais de cada rede: mídia copiada ao agendar, seis status, repetições para limites de taxa e eventos de post assinados, com cada conexão monitorada 24/7. De US$ 9 a US$ 0,75 por conexão por mês, com redução 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
Uma única requisição pode agendar um post em várias redes?
Cada requisição tem como alvo um canal, então envie uma por conta, cada uma com sua própria Idempotency-Key, e adapte o texto aos limites de cada rede.
A API de posts agenda vídeos do YouTube?
O YouTube agenda nativamente. Envie o vídeo pela API do YouTube como privado com publishAt, usando o token de GET /channels/:id?credentials=1, e o YouTube o torna público nesse horário.
Meus usuários podem ver os posts agendados no painel da easyCoexistence?
A tela de Posts pertence à sua conta, então sua equipe vê ali Precisa de atenção, Próximos e Publicados, com Cancelar, Repetir e Descartar. Seus usuários veem o calendário que o seu produto monta a partir de GET /posts.
Quanto custa a easyCoexistence para um agendador de redes sociais?
De US$ 9 a US$ 0,75 por conta conectada por mês, com redução conforme seus usuários conectam mais, com agendamento incluído e 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