Genesys Cloud - Developer Community!

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 Greetings also from Brazil rss.... (lol)

Currently it is no longer necessary to contact Genesys support to activate the feature.

To activate, simply access the appfoundry link (you need to be logged into the org):  https://appfoundry.genesys.com/filter/genesyscloud/listing/0083cc1f-63a7-488e-b534-fe44debac14c

Although it's on AppFoundry, it's a free resource.

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.