Fluxo de integração - API de consulta de Feedbacks

Acesse o endpoint Consulta dos feedbacks dos instrumentos para consultar os feedbacks dados em um instrumento dentro de um período específico.

Parâmetros da requisição

Nome do campo	Descrição	Obrigatório/regra de negócio
instrument	UID do instrumento	Obrigatório. O UID do instrumento pode ser encontrado na área de administração de instrumentos no endereço da página de edição do instrumento.
startDate	Data de início do filtro (formato YYYY-MM-DD)	Obrigatório.
endDate	Data final do filtro (formato YYYY-MM-DD)	Obrigatório.
leaders	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o id do atributo.	Não
groups	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o id do atributo.	Não
positions	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.	Não
genders	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.	Não
sexes	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar "F" para Feminino e "M" para Masculino.	Não
unitBusinesses	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.	Não
unitGeographies	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.	Não
tags	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.	Não
scholarities	Quando enviado, filtraremos os comentários de acordo com os valores inseridos naquele atributo. Para envio, deve-se considerar o nome do atributo.	Não

📘
ATENÇÃO
O uid_instrument pode ser obtido através da requisição para obter todos os instrumentos

Exemplo de requisição:

curl --location 'https://www.pulses.com.br/api/engage/v1/feedbacks' \
--header 'Authorization: Bearer XXXXXXXXXXXXXXXXXX' \
--header 'Cookie: PHPSESSID=746h8innd3jk81itjvqfi63tbv' \
--header 'Content-Type: application/x-www-form-urlencoded' \
--data-urlencode 'instrument=XXXXXXX-XXXX-XXXX-XXXX-XXXXXXXX' \
--data-urlencode 'startDate=2025-01-01' \
--data-urlencode 'endDate=2025-05-14' \
--data-urlencode 'sexes%5B0%5D=M'

Exemplo de response:

[
    {
        "Recebido em": //DATA DE RECEBIMENTO (formato: DD/MM/YYY),
        "Dimensão": //NOME DA DIMENSÃO,
        "Pergunta do Fator": //TEXTO DA PERGUNTA,
        "Pergunta do Feedback": //TEXTO DA PERGUNTA DE FEEDBACK,
        "Nota": //NOTA VINCULADA À PERGUNTA QUE GEROU FEEDBACK,
        "Feedback": //TEXTO DO FEEDBACK RECEBIDO,
        "Enviado por": //NOME DE QUEM ENVIOU O FEEDBACK,
        "Lido": //VISUALIZADO PELO ADMINISTRADOR,
        "Resposta": //ÚLTIMA RESPOSTA ENVIADA,
        "Respondido por": //NOME DE QUEM RESPONDEU,
        "Respondido em": //DATA DE RESPOSTA (formato: DD/MM/YYY)
        "Atribuído ao Líder": // QUANDO FILTRADO POR LIDER APARECE O NOME DO LIDER,
				"GRUPO": // GRUPOS ASSOCIADOS AQUELE FEEDBACK (separados por vírgula).

    }
]

❗️
ATENÇÃO
Os feedbacks estão disponíveis para alguns instrumentos. NPS, e-NPS e engajamento não possuem feedbacks.