Ir para o conteúdo

Atividade Slack Send Message no Jitterbit Studio

Introdução

Uma atividade Send Message do Slack, usando sua conexão Slack, envia uma mensagem para um usuário, múltiplos usuários, conversa ou canal no Slack e é destinada a ser usada como destino para consumir dados em uma operação.

Criar uma atividade Slack Send Message

Uma instância de uma atividade Send Message do Slack é criada a partir de uma conexão Slack usando seu tipo de atividade Send Message.

Para criar uma instância de uma atividade, arraste o tipo de atividade para a tela de design ou copie o tipo de atividade e cole-o na tela de design. Para detalhes, consulte Criar uma instância de atividade ou ferramenta em Reutilização de componentes.

Uma atividade Send Message do Slack existente pode ser editada a partir destes locais:

Configurar uma atividade Slack Send Message

Siga estas etapas para configurar uma atividade Send Message do Slack:

Etapa 1: Insira um nome e configure o roteamento de mensagens

Nesta etapa, forneça um nome para a atividade e configure como as mensagens serão roteadas para os destinatários. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Menu Endpoint: Se você tiver múltiplos endpoints do mesmo tipo de conector configurados, um menu na parte superior da tela exibe o nome do endpoint atual. Clique no menu para alternar para um endpoint diferente. Para mais informações, consulte Alterar o endpoint atribuído em Telas de configuração.

    • Edit endpoint: Aparece quando você passa o mouse sobre o nome do endpoint atual. Clique para editar a configuração de conexão do endpoint selecionado.

  • Name: Insira um nome para identificar a atividade. O nome deve ser único para cada atividade Send Message do Slack e não deve conter barras / ou dois-pontos :.

  • Message type: Selecione como rotear a mensagem:

    • Direct or Multi-Person: Envie uma mensagem direta para um usuário ou uma mensagem de grupo direto para múltiplos usuários (até 8).

    • Channel: Envie uma mensagem para um canal Slack existente.

  • Conversation type: Este campo aparece quando você seleciona Direct or Multi-Person para Message type. Selecione como você deseja identificar ou criar a conversa:

    • Create New Conversation: Crie uma nova conversa de mensagem direta ou de grupo direto.

    • Select Existent Conversation: Selecione a partir de conversas existentes.

  • Next: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Finished na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 2: Configurar destinatários de mensagens

Nesta etapa, escolha como especificar os destinatários da mensagem. A interface exibida depende do tipo de seleção escolhido e das seleções feitas na Etapa 1.

  • Tipo de seleção de mensagens diretas/canais: Selecione como especificar os destinatários da sua mensagem:

    • Fornecer ID de Conversa Manualmente: Digite manualmente o ID da conversa ou ID do canal.

    • Selecionar da Lista: Selecione os destinatários de uma lista de usuários, conversas ou canais disponíveis.

    • Pular: Pule a seleção de destinatários nesta etapa e forneça as informações do destinatário por meio de uma transformação. Ao selecionar esta opção, mapeie os IDs de usuário do Slack para o nó users no esquema de solicitação.

      Para obter IDs de usuário, configure uma atividade Usuários do Slack com o tipo de objeto Lista de usuários, execute a operação e recupere os IDs de usuário da carga de resposta. Você pode usar esses IDs de usuário em sua transformação para especificar os destinatários da mensagem.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Fornecer ID de Conversa Manualmente

Ao selecionar Fornecer ID de Conversa Manualmente, você pode inserir diretamente o identificador de conversa ou canal.

  • Fornecer ID de Conversa/ID de Canal: Digite o ID da conversa ou ID do canal onde deseja enviar a mensagem. O formato do ID depende da seleção do tipo de mensagem da Etapa 1:

    • Para mensagens diretas ou multipessoais, digite um ID de conversa.
    • Para mensagens de canal, digite um ID de canal.

Selecionar da Lista

Ao selecionar Selecionar da Lista, a interface exibe opções para selecionar destinatários com base nas seleções de tipo de mensagem e tipo de conversa da Etapa 1.

Criar uma nova conversa direta ou multipessoal

Quando você define Tipo de Mensagem como Direto ou Multipessoal e Tipo de Conversa como Criar Nova Conversa na Etapa 1, selecione até 8 usuários para criar uma nova conversa.

  • Lista de Usuários (Selecione 1 até 8): Selecione os usuários que serão incluídos na nova conversa.

    • Usuários disponíveis: Lista todos os usuários disponíveis no seu espaço de trabalho do Slack. Use a caixa de pesquisa para filtrar a lista digitando um nome de usuário. Clique no ícone de atualização para recarregar a lista de usuários do Slack.

    • Usuários Selecionados: Exibe os usuários que foram selecionados para serem incluídos na conversa. Use os botões de seta para mover usuários entre as listas Usuários disponíveis e Usuários Selecionados.

      • Clique na seta para a direita para adicionar um usuário selecionado da lista Usuários disponíveis para a lista Usuários Selecionados.

      • Clique na seta para a esquerda para remover um usuário selecionado da lista Usuários Selecionados.

Selecionar uma conversa existente

Quando você define Tipo de Mensagem como Direto ou Multipessoal e Tipo de Conversa como Selecionar Conversa Existente na Etapa 1, selecione uma conversa existente.

  • Selecionar Chat Existente: Escolha a conversa existente onde a mensagem será enviada. Use a caixa de pesquisa para filtrar a lista de conversas. Clique no ícone de atualização para recarregar as conversas do Slack.

    • Chat Selecionado: Após uma conversa ser selecionada, ela é listada aqui.

  • Pesquisar: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de conversas. A pesquisa não diferencia maiúsculas de minúsculas. Se as conversas já estiverem exibidas na tabela, os resultados da tabela serão filtrados em tempo real a cada digitação. Para recarregar conversas do endpoint ao pesquisar, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

  • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar conversas do endpoint do Slack. Isso pode ser útil se conversas foram adicionadas ao Slack. Esta ação atualiza todos os metadados usados para construir a tabela de conversas exibida na configuração.

  • Selecionar uma conversa: Na tabela, clique em qualquer lugar de uma linha para selecionar uma conversa. Apenas uma conversa pode ser selecionada. As informações disponíveis para cada conversa são obtidas do endpoint do Slack.

Dica

Se a tabela não for preenchida com conversas disponíveis, a conexão do Slack pode não ter sido bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais.

Selecionar um canal

Quando você define Tipo de Mensagem como Canal na Etapa 1, selecione um canal existente.

  • Selecionar Canal do Slack: Escolha o canal do Slack para o qual a mensagem será enviada. Use a caixa de pesquisa para filtrar a lista de canais. Clique no ícone de atualização para recarregar canais do Slack.

    • Canal do Slack Selecionado: Após um canal do Slack ser selecionado, ele é listado aqui.

    • Pesquisar: Digite o valor de qualquer coluna na caixa de pesquisa para filtrar a lista de canais. A pesquisa não diferencia maiúsculas de minúsculas. Se os canais já estiverem exibidos na tabela, os resultados da tabela serão filtrados em tempo real a cada digitação. Para recarregar canais do endpoint ao pesquisar, digite os critérios de pesquisa e depois atualize, conforme descrito abaixo.

    • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para recarregar canais do endpoint do Slack. Isso pode ser útil se canais foram adicionados ao Slack. Esta ação atualiza todos os metadados usados para construir a tabela de canais exibida na configuração.

    • Selecionar um canal do Slack: Na tabela, clique em qualquer lugar de uma linha para selecionar um canal do Slack. Apenas um canal do Slack pode ser selecionado. As informações disponíveis para cada canal do Slack são obtidas do endpoint do Slack.

    Dica

    Se a tabela não for preenchida com canais disponíveis, a conexão do Slack pode não ter sido bem-sucedida. Certifique-se de estar conectado reabrindo a conexão e testando novamente as credenciais.

Etapa 3: Configurar o conteúdo da mensagem

Nesta etapa, forneça o conteúdo da mensagem a ser enviada. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Conteúdo da mensagem: Digite o conteúdo de texto da mensagem a ser enviada aos destinatários selecionados. Este campo suporta texto simples e formatação Slack Markdown.

  • Continuar em caso de erro: Selecione para continuar a execução da atividade se um erro for encontrado para um conjunto de dados em uma solicitação em lote. Se algum erro for encontrado, ele será gravado no log de operações.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Próximo: Clique para armazenar temporariamente a configuração desta etapa e continuar para a próxima etapa. A configuração não será salva até que você clique no botão Concluído na última etapa.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Etapa 4: Revisar os esquemas de dados

Todos os esquemas de solicitação ou resposta são exibidos. Cada elemento da interface do usuário desta etapa é descrito abaixo.

  • Esquemas de Dados: Esses esquemas de dados são herdados por transformações adjacentes e são exibidos novamente durante o mapeamento de dados.

Nota

Os dados fornecidos em uma transformação têm precedência sobre a configuração da atividade.

O conector do Slack usa a API REST do Slack. Consulte a documentação da API para obter informações sobre os nós de esquema e campos.

  • Atualizar: Clique no ícone de atualização ou na palavra Atualizar para regenerar esquemas do endpoint do Slack. Esta ação também regenera um esquema em outros locais do projeto onde o mesmo esquema é referenciado, como em uma transformação adjacente.

  • Voltar: Clique para armazenar temporariamente a configuração desta etapa e retornar à etapa anterior.

  • Concluído: Clique para salvar a configuração de todas as etapas e fechar a configuração da atividade.

  • Descartar alterações: Após fazer alterações, clique para fechar a configuração sem salvar as alterações feitas em nenhuma etapa. Uma mensagem solicita que você confirme que deseja descartar as alterações.

Próximas etapas

Após configurar uma atividade Enviar Mensagem do Slack, conclua a configuração da operação adicionando e configurando outras atividades ou ferramentas como etapas da operação. Você também pode configurar as definições da operação, que incluem a capacidade de encadear operações que estão no mesmo fluxo de trabalho ou em fluxos de trabalho diferentes.

As ações de menu de uma atividade são acessíveis no painel do projeto e na tela de design. Para obter detalhes, consulte Menu de ações da atividade em Noções básicas do conector.

As atividades Enviar Mensagem do Slack podem ser usadas como destino com estes padrões de operação:

Para usar a atividade com funções de script, escreva os dados em um local temporário e use esse local temporário na função de script.

Quando estiver pronto, implante e execute a operação e valide o comportamento verificando os logs da operação.