Obtener lista de preguntas y respuestas

Se obtiene la lista de preguntas y respuestas (Q&A) del historial de chat del agente.

Método de la solicitud

GET

URL de solicitud

https://api.gptbots.ai/v1/message/qa/record/page

Autenticación de la solicitud

Los detalles de autenticación se describen en Visión general (Overview).

Solicitud

Ejemplo de solicitud

curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/message/qa/record/page?page=1&page_size=10&start_time=1732982400000&end_time=1735660799999&user_feedback=ALL' \ -H 'Authorization: Bearer ${API Key}'

                      
                      curl -X GET 'https://api-${endpoint}.gptbots.ai/v1/message/qa/record/page?page=1&page_size=10&start_time=1732982400000&end_time=1735660799999&user_feedback=ALL' \
-H 'Authorization: Bearer ${API Key}'

Este bloque de código en una ventana flotante

Encabezado de solicitud

Campo	Tipo	Descripción
Authorization	String	Token de acceso en formato `Bearer ${API Key}`. La API Key se obtiene en la página API Key.

Cuerpo de la solicitud

Campo	Tipo	Obligatorio	Descripción
user_feedback	String	Sí	Valoración del usuario. ALL: Todas. NONE: Sin valoración. GOOD: Valoración positiva, “Me gusta”, elogios. BAD: Valoración negativa, “No me gusta”, quejas.
start_time	Long	Sí	Hora de inicio del rango de consulta (timestamp). El objeto de la consulta es la hora de las preguntas (Q) en Q&A.
end_time	Long	Sí	Hora de fin del rango de consulta (timestamp). El objeto de la consulta es la hora de las preguntas (Q) en Q&A.
page	Integer	Sí	Número de página, a partir de 1.
page_size	Integer	Sí	Número de registros por página. Introducir un valor en el rango 10–100.

Respuesta

Ejemplo de respuesta

{ "qa": [ { "id": "xxxxxx", "q_time": 1699891200, "q": "xxxxxx", "a": "xxxxxx", "user_feedback": "GOOD", "convo_id": "xxxxxx", "convo_type": "API", "aid": "xxxxxx", "user_id": "xxxxxx" }, { "id": "xxxxxx", "q_time": 1699891214, "q": "xxxxxx", "a": "xxxxxx", "user_feedback": "BAD", "convo_id": "xxxxxx", "convo_type": "API", "aid": "xxxxxx", "user_id": "xxxxxx" } ] }

                      
                      {
    "qa": [
        {
            "id": "xxxxxx",
            "q_time": 1699891200,
            "q": "xxxxxx",
            "a": "xxxxxx",
            "user_feedback": "GOOD",
            "convo_id": "xxxxxx",
            "convo_type": "API",
            "aid": "xxxxxx",
            "user_id": "xxxxxx"
        },
        {
            "id": "xxxxxx",
            "q_time": 1699891214,
            "q": "xxxxxx",
            "a": "xxxxxx",
            "user_feedback": "BAD",
            "convo_id": "xxxxxx",
            "convo_type": "API",
            "aid": "xxxxxx",
            "user_id": "xxxxxx"
        }
    ]
}

Este bloque de código en una ventana flotante

Respuesta correcta

Nombre del campo	Tipo	Descripción
qa	Array<Object>	Lista de preguntas y respuestas (Q&A).
qa[].id	String	ID del registro de preguntas y respuestas.
qa[].q_time	Long	Marca de tiempo de emisión de la pregunta (Q).
qa[].q	String	Contenido de la pregunta.
qa[].a	String	Contenido de la respuesta.
qa[].user_feedback	String	Valoración del usuario.
qa[].convo_id	String	ID de la conversación asociada.
qa[].convo_type	String	Tipo de la conversación asociada.
qa[].aid	String	ID del agente.
qa[].user_id	String	ID de usuario. ID personalizado marcado por el desarrollador del agente mediante medios de terceros, utilizado para identificar la identidad específica del usuario.

Respuesta de error

Campo	Tipo	Descripción
code	Int	Código de error.
message	String	Detalles del error.