Olá @Shintaro Tsutsumi, saudações do Brasil.
Sim, existe uma forma nativa e documentada de filtrar chamadas por atributos de participante no Genesys Cloud, mas isso depende de um recurso específico estar habilitado no tenant. A Genesys disponibiliza o endpoint Conversation Participant Attribute Search, descrito em Conversation participant attributes search, que permite consultar diretamente conversações com base nos valores armazenados em participant.attributes. Quando esse recurso está ativo, o desenvolvedor não precisa buscar todas as conversas para depois filtrar manualmente; basta utilizar o endpoint POST /api/v2/conversations/participants/attributes/search, informando os atributos desejados. A API retorna apenas as conversas cujos participantes possuem esses atributos, reduzindo significativamente a necessidade de pós-processamento.
No entanto, esse recurso não é habilitado por padrão em todas as organizações. É comum que a API retorne o erro "Conversation participant attribute search is not enabled for organization, missing product", indicando que o tenant não possui o módulo ativado. Nesses casos, é necessário solicitar habilitação à Genesys ou verificar se o licenciamento contratado inclui essa funcionalidade. A documentação também registra um limite de aproximadamente 20 KB para o conjunto total de atributos indexados por participante; se os atributos excederem esse tamanho, eles não serão indexados e não poderão ser buscados por esse endpoint.
Caso o recurso não esteja disponível, a abordagem correta e documentada passa a ser utilizar a Analytics Conversation Details Query para recuperar as conversações e, em seguida, aplicar a lógica de filtragem na aplicação, avaliando participant.attributes e outros dados de participante que desejar, e selecionando apenas as conversas que atendem à condição desejada. Portanto, a solução recomendada depende diretamente da disponibilidade do recurso de Attribute Search no tenant: quando habilitado, a busca pode ser feita diretamente pela API; quando não habilitado, a filtragem deve ser feita no próprio código do desenvolvedor.
------------------------------
Fernando Sotto dos Santos
Consultor Grupo Casas Bahia
------------------------------
Original Message:
Sent: 12-10-2025 03:56
From: Shintaro Tsutsumi
Subject: API to extract only calls with specific participant data
The customer wants to use the API to get retrieve only call information that contains specific participant data.
If there is an API that allows you to specify particular participant data, could you please let us know？
#PlatformAPI
------------------------------
Shintaro Tsutsumi
------------------------------