API de comentarios y respuestas

Las funciones disponibles para los comentarios dependen de la red social conectada y de los permisos actuales de la cuenta.

Puntos finales de comentarios

Método	Ruta	Propósito
`GET`	`/v1/brand/comments`	Listar comentarios
`GET`	`/v1/brand/comments/{comment_id}`	Obtener detalles de un comentario
`POST`	`/v1/brand/comments`	Publicar un comentario de nivel superior en una publicación
`POST`	`/v1/brand/comment-refresh-jobs`	Solicitar una actualización de comentarios
`GET`	`/v1/brand/comment-refresh-jobs/{id}`	Verificar el estado de la tarea de actualización
`POST`	`/v1/brand/comments/{comment_id}/moderation-actions`	Solicitar una acción de ocultar o eliminar

Publicación de un comentario de nivel superior:

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

Los valores actuales de action para la moderación son hide o delete. La ejecución real depende de la plataforma y del estado del comentario.

Tareas de respuesta

Método	Ruta	Propósito
`POST`	`/v1/brand/reply-jobs`	Crear una tarea de respuesta
`GET`	`/v1/brand/reply-jobs`	Listar las tareas de respuesta
`GET`	`/v1/brand/reply-jobs/{reply_job_id}`	Obtener el estado de una tarea de respuesta

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

Un código HTTP 202 al crear una respuesta significa que la tarea se validó, se almacenó y se agregó a la cola. Verifique el estado final mediante reply_job_id.

Estados de disponibilidad y recuperación

Las respuestas pueden incluir los siguientes indicadores de disponibilidad y recuperación:

permission_required: Falta el permiso requerido; se puede recuperar mediante la reautenticación.
permission_unverified: El estado del permiso no se puede determinar de forma concluyente.
review_disabled: La función está deshabilitada según las políticas actuales de revisión de aplicaciones.
unsupported: La plataforma no admite esta operación.
reauthorize: Reautenticar la conexión de SNS.
contact_support: Se requiere contacto con el soporte técnico.

🔗 Documentación relacionada