Como criar um agendador de redes sociais com uma API: a fila, os conteúdos multimédia e os estados das publicações
Para criar um agendador de redes sociais na Partner API da easyCoexistence, o seu backend envia cada publicação para POST /channels/:id/posts com o texto, os conteúdos multimédia e um publish_at de 1 minuto a 90 dias à frente. A easyCoexistence copia logo os conteúdos e publica a publicação na hora marcada no Instagram, Facebook, TikTok ou LinkedIn, indicando cada passo como um estado e através dos eventos post.published e post.failed.
Até onde a API de publicações agenda no Instagram, Facebook, TikTok e LinkedIn; o prazo mínimo é de 1 minuto.
Maior imagem e maior vídeo que a easyCoexistence copia ao agendar uma publicação; um ficheiro maior é recusado nesse momento.
Quando se volta a tentar uma publicação que a rede limitou por excesso de pedidos, antes de ser marcada como falhada.
Publicações pela API que uma conta do Instagram pode fazer em 24 horas deslizantes; um carrossel conta como uma.
Limite do TikTok para publicações de vídeo por conta através do seu endpoint de publicação, com no máximo seis num minuto.
De que precisa um agendador da API?
Cinco coisas: um local para carregar ficheiros, uma chamada que coloca uma publicação em fila para uma conta, uma fila que publica à hora certa, uma forma de a alterar e informação sobre o que aconteceu. A API de publicações oferece cada uma delas com a mesma chave ec_live_ que liga os seus clientes, para que o calendário, o fluxo de aprovação e o editor de publicações fiquem no seu produto.
Como se agenda uma publicação?
Com um POST por conta para https://easycoexistence.com/api/v1/channels/:id/posts, em que :id é o channel_id da sessão de ligação do cliente. publish_at é ISO 8601 com um Z ou um desvio horário; omita-o para publicar já. A resposta é 201 com a publicação, ou 422 quando uma publicação marcada para agora falha. É respeitado o cabeçalho Idempotency-Key, pelo que um pedido repetido após um tempo limite não coloca a publicação em fila duas vezes. O corpo aceita:
- text: a legenda, a mensagem ou o comentário; media: uma lista de {url, type} ou {
media_id}. - link: uma publicação com hiperligação no Facebook ou um artigo no LinkedIn, com título no LinkedIn.
ig_type: IMAGE, CAROUSEL, REELS ou STORIES, deduzido dos conteúdos multimédia quando é omitido.- title e
disable_commentpara publicações de fotografia 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 os conteúdos multimédia?
Por ligação ou por carregamento. Uma ligação HTTPS pública vai diretamente para media; um ficheiro que os seus utilizadores carregam vai para POST /media, como corpo do pedido com o respetivo Content-Type e Content-Length, ou como {"url"}, e o media_id devolvido entra na publicação. Quando uma publicação é agendada, a easyCoexistence copia os seus ficheiros, pelo que a sua ligação só tem de funcionar nesse momento. Uma página web em vez de um ficheiro, um 404, o tipo errado ou um ficheiro acima de 30 MB para imagens ou 1 GB para vídeos é recusado nessa altura, e não na manhã da publicação.
O que pode conter a publicação de cada rede?
A fila verifica cada publicação contra as regras da rede antes de a aceitar, e uma publicação que as infrinja é recusada com uma mensagem que indica a regra, para que o seu editor mostre o problema enquanto o utilizador ainda está a editar. Cada rede aceita:
Por que estados passa uma publicação?
Seis, que GET /posts/:id e GET /posts indicam, juntamente com publish_at, a hiperligação da publicação depois de publicada e o erro da rede quando falhou:
- scheduled: na fila, à espera da sua hora.
- publishing: entregue à rede.
- processing: a rede ainda a está a processar, como acontece com um vídeo do TikTok ou um contentor do Instagram.
- published: publicada, com a sua hiperligação.
- failed: recusada ou não confirmada;
may_be_publishedassinala uma que a rede pode ter recebido. - canceled: removida antes de sair, por si ou porque o seu canal foi removido ou suspenso.
Como se edita, cancela ou volta a tentar uma publicação?
PATCH /posts/:id altera a hora ou o texto de uma publicação agendada, e o título de uma publicação de fotografia no TikTok; para alterar os conteúdos multimédia, cancele-a e agende uma nova. DELETE /posts/:id cancela-a. POST /posts/:id/retry volta a publicar uma publicação falhada, agora. Uma publicação que uma rede limitou por excesso de pedidos volta a ser tentada automaticamente ao fim de 5 minutos, 30 minutos e 2 horas, e uma publicação marcada como may_be_published precisa de ser verificada na conta antes de qualquer nova tentativa.
Como é que o agendador toma conhecimento do que aconteceu?
Através de eventos e da lista. O URL de eventos de estado definido em Perfil, Programadores recebe post.published e post.failed, assinados com X-EC-Signature como todos os outros eventos, com a publicação e o seu canal, para que o calendário a marque como publicada ou a assinale. GET /posts aceita status, from, to e limit para vistas de calendário, e GET /channels/:id/posts lista uma conta. Uma publicação que falha em segundo plano envia também um e-mail ao titular da sua conta, no máximo uma vez por canal a cada 3 horas.
Como encaixam as publicações do LinkedIn num agendador?
Com uma pessoa a aprovar cada uma. As Condições da API do LinkedIn restringem a utilização das suas APIs para automatizar publicações, pelo que um agendador mantém cada publicação do LinkedIn como rascunho no seu produto até que uma pessoa nomeada a aprove, e só então a envia com o respetivo publish_at. Regras recorrentes, feeds e importações em massa devem visar as outras redes, e deixar o LinkedIn para publicações que alguém tenha revisto.
Erros comuns
- Enviar publish_at sem desvio horário. Uma hora local sem Z nem desvio é recusada, por isso envie 2026-11-20T09:00:00-05:00 em vez da hora simples que o seu utilizador escolheu.
- Voltar a tentar de imediato uma publicação marcada como may_be_published. A rede pode já a mostrar, por isso verifique a conta primeiro, ou a publicação sai duas vezes.
- Repetir um POST que excedeu o tempo limite sem Idempotency-Key. Dê a cada publicação a sua própria chave, para que um pedido repetido devolva a publicação já em fila em vez de agendar uma segunda cópia.
- Usar ficheiros PNG para o Instagram. A API de publicação do Instagram aceita apenas JPEG, e a publicação é recusada quando é agendada, por isso converta as imagens no seu passo de carregamento.
A easyCoexistence dá ao seu agendador uma fila para as contas do Instagram, Facebook, TikTok e LinkedIn dos seus clientes, e mais canais, através da API oficial de cada rede: os conteúdos multimédia copiados ao agendar, seis estados, novas tentativas para limites de pedidos e eventos de publicação assinados, com cada ligação monitorizada 24/7. De US$ 9 a US$ 0.75 por ligação por mês, descendo à medida que adiciona ligações, com os primeiros 3 dias gratuitos.
Perguntas frequentes
Um pedido pode agendar uma publicação em várias redes?
Cada pedido é dirigido a um canal, por isso envie um por conta, cada um com a sua própria Idempotency-Key, e adapte o texto aos limites de cada rede.
A API de publicações agenda vídeos do YouTube?
O YouTube agenda nativamente. Carregue o vídeo pela API do YouTube como privado com publishAt, usando o token de GET /channels/:id?credentials=1, e o YouTube torna-o público nessa hora.
Os seus utilizadores podem ver as publicações agendadas no painel da easyCoexistence?
O ecrã de Publicações pertence à sua conta, por isso a sua equipa vê lá Requer atenção, Próximas e Publicadas, com Cancelar, Voltar a tentar e Dispensar. Os seus utilizadores veem o calendário que o seu produto constrói a partir de GET /posts.
Quanto custa a easyCoexistence para um agendador de redes sociais?
De US$ 9 a US$ 0.75 por conta ligada por mês, descendo à medida que os seus utilizadores ligam mais contas, com o agendamento incluído e 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