Posts

Listar posts de todos os clientes pela API

GET /merchants/posts devolve os posts de todos os seus clientes de uma vez, mais recentes primeiro, usando só o token do merchant. É a visão de monitoramento: onde há posts com falha, o que foi publicado e para qual cliente.

A chamada

GET /api/merchants/posts?status=failed&per_page=50
Authorization: Bearer <merchant token>

O que dá para fazer

  • Listar os posts de todos os customers em uma chamada, sem x-customer-token.
  • Filtrar por um customer com customer, ou por uma conexão com customer_integration.
  • Filtrar por status (created, publishing, published, failed) para achar falhas.
  • Achar um post pelo id do seu sistema com external_reference.
  • Paginar com per_page, de 1 a 100.

Regras e limites

  • Só o Bearer do merchant, sem x-customer-token. Para os posts de um único cliente, use GET /posts com o x-customer-token.
  • customer e customer_integration são filtros, não credencial: o cliente e a conexão são conferidos contra o merchant do Bearer.
  • Os filtros se combinam. A lista vem com os mais recentes primeiro, 15 por página por padrão.
  • Cada post traz customer_uuid, para você saber de qual cliente ele é.

Campos principais

CampoTipoObrigatórioDescrição
customerstringNãoFiltro: o uuid de um customer do merchant.
customer_integrationstringNãoFiltro: o uuid de uma conexão de um customer do merchant.
statusstringNãoFiltro: created, publishing, published ou failed.
external_referencestringNãoFiltro: o id do post no seu sistema (até 100 caracteres).
per_pageintegerNãoItens por página, de 1 a 100. Padrão 15.
customer_uuidstringNãoEm cada post da resposta: o customer dono do post.

Para quem

  • Painel de operações

    O time de suporte vê todos os posts com falha de todos os clientes numa tela, sem consultar cliente por cliente.

  • Alertas de falha

    Um job periódico lista status failed e avisa o responsável de cada conta.

  • Agente de IA de monitoramento

    O agente resume a semana de publicações por cliente e destaca os que mais falharam.

Funciona com

  • Instagram Business
  • Facebook
  • Threads
  • LinkedIn
  • Pinterest
  • YouTube

Perguntas frequentes

Preciso do x-customer-token?

Não. Esta rota usa só o Bearer do merchant. O GET /posts, por cliente, exige o x-customer-token.

Como vejo só um cliente?

Passe customer com o uuid do customer, ou customer_integration com o uuid da conexão.

Como acho os posts com falha?

Filtre por status=failed. Para os detalhes do erro, consulte o post com GET /posts/{uuid}.

Relacionadas

Ver tudo que dá para fazer em Posts

Veja o Connect aplicado ao seu produto.

Teste por 15 dias sem cartão, ou mostre seu cenário ao nosso time.