API de comentários e respostas

Os recursos de comentários disponíveis dependem da rede social conectada e das permissões atuais da conta.

Endpoints de Comentários

Método	Caminho	Finalidade
`GET`	`/v1/brand/comments`	Listar comentários
`GET`	`/v1/brand/comments/{comment_id}`	Obter detalhes do comentário
`POST`	`/v1/brand/comments`	Postar um comentário de nível superior em uma postagem
`POST`	`/v1/brand/comment-refresh-jobs`	Solicitar uma atualização de comentário
`GET`	`/v1/brand/comment-refresh-jobs/{id}`	Verificar o status da tarefa de atualização
`POST`	`/v1/brand/comments/{comment_id}/moderation-actions`	Solicitar ação de ocultar ou excluir

Postar um comentário de nível superior:

{
  "idempotency_key": "comment-001",
  "target": { "content_id": "<content_id>" },
  "text": "Thank you for checking out our post."
}

Os valores atuais de action para moderação são hide (ocultar) ou delete (excluir). A execução real depende da plataforma e do estado do comentário.

Tarefas de resposta (Reply Jobs)

Método	Caminho	Finalidade
`POST`	`/v1/brand/reply-jobs`	Criar uma tarefa de resposta
`GET`	`/v1/brand/reply-jobs`	Listar tarefas de resposta
`GET`	`/v1/brand/reply-jobs/{reply_job_id}`	Obter o status de uma tarefa de resposta

{
  "comment_id": "<comment_id>",
  "idempotency_key": "reply-001",
  "text": "Thank you for reaching out."
}

Um código HTTP 202 na criação da resposta significa que a tarefa foi validada, armazenada e colocada na fila. Verifique o status final por meio do reply_job_id.

Estados de Disponibilidade e Recuperação

As respostas podem incluir os seguintes indicadores de disponibilidade e recuperação:

permission_required: Permissão necessária ausente; pode ser recuperada via reautenticação
permission_unverified: O status da permissão não pode ser determinado conclusivamente
review_disabled: O recurso está desativado sob as políticas atuais de revisão de aplicativos
unsupported: A plataforma não suporta esta operação
reauthorize: Reautentique a conexão SNS
contact_support: Necessário contato com o suporte

🔗 Documentação Relacionada