ConsumeSlackConversation 2025.5.31.15

Pacote

com.snowflake.openflow.runtime | runtime-slack-processors-nar

Descrição

Recupera mensagens de conversas do Slack disponíveis para o aplicativo. Novas conversas são obtidas com base na “Frequência do monitoramento de resposta”. As mensagens ingeridas são gravadas no formato JSON. Consulte Uso/detalhes adicionais para obter mais informações sobre como configurar esse processador e habilitá-lo para recuperar mensagens do Slack.

Tags

conversation, conversation.history, slack, social media, team, text, unstructured

Requisito de entrada

FORBIDDEN

Oferece suporte a propriedades dinâmicas confidenciais

falso

Propriedades

Propriedade

Descrição

Token de acesso

Token de acesso OAuth usado para autenticar/autorizar a solicitação do Slack enviada por NiFi. Pode ser um token de usuário ou um token de bot. Ele deve receber o escopo channels:history, groups:history, im:history ou mpim:history, dependendo do tipo de conversa que estiver sendo usada.

Tamanho do lote

O número máximo de mensagens a serem recuperadas em uma única solicitação ao Slack. A resposta inteira será analisada na memória, portanto, é importante que você tenha isso em mente ao definir esse valor.

Frequência do monitor de resposta

Após consumir todas as mensagens em um determinado canal, esse processador pesquisará periodicamente todas as “mensagens encadeadas”, também conhecidas como respostas, cujo carimbo de data/hora esteja entre agora e o período de tempo especificado pela propriedade <Janela de monitoramento de resposta>. Essa propriedade determina a frequência com que essas mensagens são pesquisadas. Definir o valor para uma duração mais curta pode fazer com que as respostas às mensagens sejam capturadas mais rapidamente, proporcionando uma latência menor. No entanto, isso também resultará em uso adicional de recursos e poderá acionar a ocorrência de limitação de taxa. Isso também determina a frequência com que os canais recém-adicionados são verificados.

Janela de monitoramento de resposta

Após consumir todas as mensagens em um determinado canal, esse processador pesquisará periodicamente todas as “mensagens encadeadas”, também conhecidas como respostas, cujo carimbo de data/hora esteja entre agora e esse período de tempo no passado, a fim de verificar se há novas respostas. A configuração desse valor como um valor maior pode resultar em uso adicional de recursos e pode resultar em limitação de taxa. No entanto, se um usuário responder a um tópico antigo iniciado fora dessa janela, a resposta poderá não ser capturada.

Resolução de nomes de usuário

Especifica se os IDs de usuário devem ou não ser resolvidos para nomes de usuário. Por padrão, as mensagens do Slack fornecem o ID do usuário que envia uma mensagem, como U0123456789, mas não o nome de usuário, como NiFiUser. O nome de usuário pode ser resolvido, mas isso pode exigir chamadas adicionais para a Slack API e requer que o token usado receba o escopo users:read. Se definido como verdadeiro, os nomes de usuário serão resolvidos com uma política de melhor esforço: se um nome de usuário não puder ser obtido, ele será ignorado. Além disso, observe que, quando um nome de usuário é obtido, o campo <username> da mensagem é preenchido e o campo <text> é atualizado de forma que qualquer menção seja emitida como “Hi @user” em vez de “Hi <@U1234567>”.

Gerenciamento do estado

Escopos

Descrição

CLUSTER

Mantém um mapeamento dos IDs de canal Slack para o carimbo de data/hora da última mensagem recuperada para esse canal. Isso permite que o processador recupere apenas as mensagens que foram postadas desde a última vez em que o processador foi executado. Esse estado é armazenado no cluster para que, se o nó primário mudar, o novo nó continue de onde o nó anterior parou.

Relações

Nome

Descrição

success

As mensagens do Slack que forem recebidas com sucesso serão encaminhadas para esse relacionamento

Grava atributos

Nome

Descrição

slack.channel.id

O ID do canal Slack do qual as mensagens foram recuperadas

slack.message.count

O número de mensagens do Slack que estão incluídas no FlowFile

mime.type

Defina como application/json, pois a saída estará sempre no formato JSON