Class CommentsResource

Hierarchy

  • Resource
    • CommentsResource

Constructors

Methods

  • Qué se puede hacer con los comentarios de cada red: responder, ocultar, borrar el propio, borrar el ajeno.

    Es lo que decide qué botones se pintan, y no se deduce de social_capabilities: que una red tenga comentarios no dice nada de lo que deja hacer con ellos. Sin argumento devuelve la matriz entera; con una red, sus cuatro banderas (o undefined si esa red no tiene comentarios). Cacheado con el resto del catálogo.

    Parameters

    Returns Promise<
        Record<
            string,
            {
                delete_others: boolean;
                delete_own: boolean;
                hide: boolean;
                reply: boolean;
            },
        >,
    >

  • Qué se puede hacer con los comentarios de cada red: responder, ocultar, borrar el propio, borrar el ajeno.

    Es lo que decide qué botones se pintan, y no se deduce de social_capabilities: que una red tenga comentarios no dice nada de lo que deja hacer con ellos. Sin argumento devuelve la matriz entera; con una red, sus cuatro banderas (o undefined si esa red no tiene comentarios). Cacheado con el resto del catálogo.

    Parameters

    Returns Promise<
        | undefined
        | {
            delete_others: boolean;
            delete_own: boolean;
            hide: boolean;
            reply: boolean;
        },
    >

  • LA BANDEJA de toda la organización, ordenada por la fecha de la red.

    Sale de la base de datos: no llama a ninguna red, no gasta créditos y no falla porque una cuenta esté desconectada. Es una FOTO —collected_date dice de cuándo—, así que para ver el estado de ahora mismo de una conversación hay que abrir thread.

    Lo que escribimos nosotros no sale aquí: nuestras respuestas se guardan (el hilo las necesita) pero no son correo entrante.

    Aquí, y sólo aquí, id_account e id_publication vienen POBLADOS.

    const { data } = await pv.comments.list(orgId, { unread: true, rating: [1, 2] });
    

    Parameters

    Returns Promise<Paginated<Comment>>

  • Borra el comentario en la red social.

    Sólo donde la red deja: delete_own y delete_others de actions son dos permisos distintos, y en Google Business lo único borrable es nuestra propia respuesta a una reseña. La fila se conserva marcada como borrada para que la siguiente lectura no la resucite.

    Parameters

    Returns Promise<void>

  • Las RESPUESTAS de un comentario, también en vivo (y también de pago en X).

    En la primera página —y sólo en la primera— se cuelan las respuestas NUESTRAS que la red todavía no lista: acabamos de escribirlas y la indexación tarda. Sin eso, refrescar el hilo justo después de responder no enseñaría nada y parecería que no se envió.

    Parameters

    Returns Promise<CommentThread>

  • Responde EN PÚBLICO, colgando de ese comentario.

    No es un mensaje privado: para escribirle al comentarista por el chat está pv.messages.send(), y no todas las redes lo permiten. El texto no puede ir vacío y tiene su propio límite, comment_characters, que no es el de una publicación (Facebook admite 60.000 en un post y 8.000 en un comentario); pasarse devuelve el error 948.

    Deja el comentario marcado como leído y respondido.

    Parameters

    • idOrganization: string
    • idComment: string
    • text: string
    • options: RequestOptions = {}

    Returns Promise<CommentReplyResult>

  • EL HILO de una publicación, leído EN VIVO contra la red.

    La red manda: el texto, los contadores y la existencia salen de ella, y de lo guardado sólo sobreviven _id, read y replied. Un comentario que la red ya no devuelve se marca borrado y deja de aparecer en la bandeja.

    En X cuesta un crédito por comentario devuelto (credits_consumed lo dice después). Una publicación que nunca llegó a enviarse devuelve el error 936: no hay hilo que leer.

    Parameters

    Returns Promise<CommentThread>

  • EL HILO de una CUENTA, gemelo del anterior, para las redes cuyos comentarios no cuelgan de una publicación nuestra.

    Hoy es Google Business: una reseña cuelga de la FICHA, no de un post, así que esa cuenta no tiene ninguna publicación con la que llamar a thread. Ojo con total: es el número de RESEÑAS, que no es la longitud de comments — nuestras respuestas viajan en el mismo array, colgando de la reseña que contestan.

    Parameters

    Returns Promise<CommentThread>

  • Cuántos quedan sin leer en la organización. Es el número del badge.

    Los nuestros no cuentan: un comentario que escribimos nosotros no está pendiente de leer.

    Parameters

    Returns Promise<number>

  • Cambia read (nuestro) y/o hidden (de la red) en una sola llamada.

    Se pueden mandar los dos porque la pantalla los cambia desde el mismo sitio, pero no son lo mismo: read no sale de PlanVortex y hidden va a la red y puede no estar permitido.

    Parameters

    Returns Promise<Comment>