Com a API do Flux e o MCP do Flux, você conecta a sua operação de conteúdo a outros sistemas e a assistentes de IA. Assim, você consulta informações, cria e edita postagens e registra aprovações sem precisar abrir o painel a cada tarefa.
Além disso, os Webhooks do Flux avisam automaticamente outros sistemas quando algo importante acontece, como uma publicação concluída, uma falha ou uma nova aprovação.
API do Flux
A API permite que sistemas externos se conectem diretamente ao Flux. Com ela, você integra projetos, postagens e aprovações aos sistemas internos, dashboards e automações da sua agência.
Por exemplo, você pode criar uma automação que consulta, todos os dias, quais postagens ainda aguardam aprovação. Depois, ela organiza essas informações na ferramenta da sua equipe. Da mesma forma, um sistema próprio pode criar os posts direto no Flux e enviar para aprovação.
MCP do Flux
O MCP conecta o Flux a assistentes de inteligência artificial, como o Claude Code. Assim, você consulta informações e cria conteúdos usando linguagem natural, sem precisar desenvolver uma integração.
Por exemplo, você pode pedir ao assistente:
- “Quais postagens estão aguardando aprovação esta semana?”
- “O que está agendado para este cliente?”
- “Algum projeto está com uma rede social desconectada?”
- “Quem ainda precisa aprovar as postagens de amanhã?”
- “Crie um post com esta imagem e esta legenda e envie para aprovação.”
O assistente usa os dados do Flux e organiza a resposta de acordo com o seu pedido.
👉🏻 A principal diferença entre os dois: a API é indicada para integrações programadas entre sistemas. Já o MCP dá acesso às mesmas funções por meio de conversas com uma IA.
O que você pode fazer pela API e pelo MCP
Consultar informações
- Projetos: os projetos disponíveis na conta e as redes conectadas a cada um;
- Postagens: posts, legendas, mídias, status e datas de agendamento ou publicação;
- Aprovações: quantidade de aprovações, pedidos de ajuste e revisores pendentes;
- Histórico de aprovação: quem aprovou, quem pediu ajustes e os comentários registrados;
- Grupos de aprovação: as postagens agrupadas para revisão e o andamento de cada uma;
- Redes sociais: contas conectadas, desconectadas ou com autorização expirada;
- Conteúdos em múltiplas redes: as diferentes versões de um mesmo conteúdo publicado em mais de uma rede.
Criar, editar e aprovar conteúdos
- Enviar mídias: fotos e vídeos para usar em novas postagens;
- Criar postagens: você define se o post fica salvo como rascunho, vai para aprovação ou já fica agendado para publicação;
- Editar postagens: você altera a legenda, a mídia ou a data enquanto o post ainda não foi publicado;
- Registrar aprovações: você aprova uma postagem ou pede ajustes diretamente pela integração.
Como funcionam os agendamentos
Quando você agenda uma postagem pela API ou pelo MCP, o Flux publica automaticamente na data e no horário definidos. Ele não pede uma nova confirmação antes da publicação. Ou seja, funciona do mesmo jeito que um agendamento feito no próprio Flux.
Por outro lado, salvar como rascunho ou enviar para aprovação não publica o conteúdo automaticamente. Nesse caso, você precisa agendar o post depois.
Publicações no TikTok e no Pinterest pelo MCP
TikTok e Pinterest exigem algumas configurações obrigatórias na publicação. Por isso, pelo MCP, o assistente pede essas informações antes de continuar, com os mesmos cuidados do fluxo de publicação do Flux:
- Pinterest: você informa a pasta onde o post será publicado;
- TikTok: você confirma as configurações de privacidade.
O assistente só envia a postagem depois que você confirma essas informações.
🔔 Webhooks do Flux
Os Webhooks fazem o Flux avisar automaticamente um sistema externo quando determinados eventos acontecem. Assim, o sistema integrado não precisa consultar a API repetidamente para descobrir o que mudou.
Na prática, criar um Webhook é responder a uma pergunta: o que o outro sistema precisa saber sobre o Flux? O Webhook define para onde o aviso vai, e os eventos definem quando o Flux envia esse aviso.
Eventos disponíveis
- Post criado: avisa quando um novo post é criado no Flux;
- Post alterado: avisa quando um post existente sofre alguma alteração;
- Post agendado: avisa quando um post fica agendado para publicação;
- Post excluído: avisa quando um post é removido;
- Post publicado: avisa quando a publicação é concluída com sucesso;
- Falha na publicação: avisa quando o Flux tenta publicar, mas a publicação não é concluída;
- Aprovação decidida: avisa quando alguém toma uma decisão na aprovação, por exemplo, aprova o conteúdo ou pede ajustes;
- Conta desconectada: avisa quando uma rede social integrada ao Flux perde a conexão;
- Conta reconectada: avisa quando essa conexão é restabelecida.
Um exemplo prático
Imagine uma agência com um sistema próprio de gestão de tarefas. Ela pode criar um Webhook com os eventos Post publicado e Falha na publicação. Assim, sempre que um post é publicado, o sistema marca a tarefa como concluída automaticamente. Já quando a publicação falha, o sistema cria um alerta para a equipe.
Segurança e novas tentativas
Cada aviso tem uma assinatura, que permite ao sistema externo confirmar que a informação foi enviada mesmo pelo Flux.
Se o endereço configurado não responder, o Flux tenta enviar o aviso de novo, automaticamente, por alguns dias. No entanto, se as falhas continuarem, o Flux desativa o Webhook.
Limites importantes
- Cada chave tem limite de 120 requisições por minuto;
- Além disso, cada chave tem um limite próprio de 20 ações de criação ou edição por minuto;
- Cada conta pode cadastrar até 5 Webhooks;
- Os links de mídia que a API retorna expiram em 48 horas.
Como acessar
No Flux, acesse Configurações da empresa > API e escolha a opção desejada:
- Guia de integração: passo a passo para usar o MCP;
- Criar token: passo a passo para usar a API;
- Webhooks: aba para criar e gerenciar seus Webhooks e escolher os eventos de cada um.
A documentação técnica completa está disponível nestes links:
Perguntas frequentes
Dá para criar ou editar postagens pela API ou pelo MCP? Sim. Você pode enviar mídias, criar postagens, editar posts que ainda não foram publicados e registrar aprovações ou pedidos de ajuste.
Um post agendado pela API é publicado sem confirmação? Sim. Assim como no Flux, o post agendado é publicado automaticamente na data e no horário definidos. Se você quiser revisar antes, salve como rascunho ou envie para aprovação.
Qual a diferença entre usar a API e usar o MCP? A API é indicada para integrações programadas entre sistemas. Já o MCP é indicado para consultar e criar conteúdos em linguagem natural, por meio de um assistente de IA.
Para que servem os Webhooks, se já existe a API? A API responde quando o seu sistema pergunta. Os Webhooks fazem o caminho contrário: o Flux avisa o seu sistema assim que algo acontece, sem que ele precise ficar consultando.
Existe algum limite de uso? Sim. Cada chave tem limite de 120 requisições por minuto e de 20 ações de criação ou edição por minuto. Além disso, cada conta pode ter até 5 Webhooks, e os links de mídia expiram em 48 horas.
Em caso de dúvida, entre em contato com o nosso time de Suporte pelo chat. =)