Slack

Com o conector do Slack, você realiza operações de inserção, exclusão, atualização e leitura nos dados do Slack.

Antes de começar

Antes de usar o conector do Slack, faça o seguinte:

  • No seu projeto do Google Cloud, faça o seguinte:
    • Verifique se a conectividade de rede está configurada. Para informações sobre padrões de rede, consulte Conectividade de rede.
    • Conceda a função IAM roles/connectors.admin ao usuário que está configurando o conector.
    • Conceda os seguintes papéis de IAM à conta de serviço que você quer usar para o conector:
      • roles/secretmanager.viewer
      • roles/secretmanager.secretAccessor

      Uma conta de serviço é um tipo especial de Conta do Google destinada a representar um usuário não humano que precisa ser autenticado e autorizado a acessar dados nas APIs do Google. Se você não tiver uma conta de serviço, será necessário criar uma. Para mais informações, consulte Como criar uma conta de serviço.

    • Ative os seguintes serviços:
      • secretmanager.googleapis.com (API Secret Manager)
      • connectors.googleapis.com (API Connectors)

      Para entender como ativar os serviços, consulte Como ativar serviços.

    Se esses serviços ou permissões não tiverem sido ativados no seu projeto, você precisará ativá-los ao configurar o conector.

  • Para saber como criar um espaço de trabalho do Slack, consulte o Guia de início rápido do Slack. Para informações sobre a plataforma Slack, consulte Visão geral da plataforma Slack.

Configurar o conector

Para configurar o conector, crie uma conexão com a fonte de dados (sistema de back-end). Uma conexão é específica a uma fonte de dados. Isso significa que, se você tiver muitas fontes de dados, precisará criar uma conexão separada para cada uma. Para criar uma conexão, siga estas etapas:

  1. No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.

    Acessar a página "Conexões"

  2. Clique em + CRIAR NOVO para abrir a página Criar conexão.
  3. Na seção Local, escolha o local da conexão.
    1. Região: selecione um local na lista suspensa.

      Para conferir a lista de todas as regiões com suporte, consulte Locais.

    2. Clique em PRÓXIMA.
  4. Na seção Detalhes da conexão, faça o seguinte:
    1. Conector: selecione Slack na lista suspensa de conectores disponíveis.
    2. Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
    3. No campo Nome da conexão, insira um nome para a instância de conexão

      Os nomes de conexão precisam atender aos seguintes critérios:

      • Os nomes de conexões podem usar letras, números ou hifens.
      • As letras precisam ser minúsculas.
      • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
      • Os nomes das conexões não podem exceder 63 caracteres.
    4. Como opção, insira uma Descrição para a instância de conexão.
    5. Como opção, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como Error.
    6. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
    7. Opcionalmente, defina as Configurações do nó de conexão:

      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir qualquer valor, por padrão, os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

    8. Outra opção é clicar em + ADICIONAR MARCADOR para adicionar um rótulo à conexão na forma de um par de chave-valor.
    9. Clique em PRÓXIMA.
  5. Na seção Autenticação, insira os detalhes da autenticação.
    1. Selecione um Tipo de autenticação e insira os detalhes relevantes.

      A conexão do Slack oferece suporte aos seguintes tipos de autenticação:

      • OAuth2.0: código de autorização
      • Autenticação de token do usuário

      2. Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

    2. Clique em PRÓXIMA.
  6. Revisão: revise os detalhes de conexão e autenticação.
  7. Clique em Criar.

Configurar a autenticação

Digite os detalhes com base na autenticação que você quer usar.

  • Código de autorização OAuth2.0

    Para fazer a autenticação usando o OAuth2.0, insira os seguintes detalhes:

    • ID do cliente: o ID do cliente fornecido pelo conector para o app que você criou.
    • Escopos: uma lista separada por vírgulas do escopo desejado.
    • Chave secreta do cliente: o secret do Secret Manager que contém a chave secreta do cliente para o app conectado que você criou.
    • Versão do secret: versão do secret selecionada acima.
  • Autenticação de token do usuário

    Para fazer a autenticação usando o token do usuário, insira os seguintes detalhes:

    • Token do usuário: o token usado para autenticar o usuário.
    • Versão do secret: versão do secret selecionada acima.

Para o tipo de autenticação Authorization code, depois de criar a conexão, você precisa seguir mais algumas etapas para configurar a autenticação. Para mais informações, consulte Etapas adicionais após a criação da conexão.

Etapas adicionais após a criação da conexão

Se você selecionou OAuth 2.0 - Authorization code para autenticação, siga estas etapas adicionais após criar a conexão:

  1. Na página "Conexões", localize a conexão recém-criada.

    O Status do novo conector será Autorização necessária.

  2. Clique em Autorização necessária.

    O painel Editar autorização é mostrado.

  3. Copie o valor do URI de redirecionamento para seu aplicativo externo.
  4. Verifique os detalhes da autorização.
  5. Clique em Autorizar.

    Se a autorização for bem-sucedida, o status da conexão será definido como Ativo na página "Conexões".

Reautorização do código de autorização

Se você estiver usando o tipo de autenticação Authorization code e tiver feito alterações de cofiguração no aplicativo, será necessário autorizar novamente a conexão do OneDrive. Para autorizar novamente uma conexão, siga estas etapas:

  1. Clique na conexão necessária na página "Conexões".

    A página de detalhes da conexão será aberta.

  2. Clique em Editar para editar os detalhes da conexão.
  3. Verifique os detalhes do OAuth 2.0: código de autorização na seção Autenticação.

    Se necessário, faça as mudanças necessárias.

  4. Clique em Salvar. Isso leva você à página de detalhes da conexão.
  5. Clique em Edit authorization na seção Authentication. O painel Authorize é mostrado.
  6. Clique em Autorizar.

    Se a autorização for bem-sucedida, o status da conexão será definido como Ativo na página "Conexões".

Exemplos de configuração de conexão

Esta seção lista os valores de exemplo para os vários campos que você configura ao criar a conexão.

Slack: tipo de conexão de autenticação UserToken

Nome do campo Detalhes
Local us-central1
Conector Slack
Versão do conector 1
Nome da conexão slack-usertoken-connection
Ativar Cloud Logging Sim
Conta de serviço SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Nível de verbosidade 5
Número mínimo de nós 2
Número máximo de nós 50
Autenticação de token do usuário Sim
Token do usuário USER_TOKEN
Versão do secret 1

Slack: tipo de conexão de autenticação OAuth 2.0

Nome do campo Detalhes
Local us-central1
Conector Slack
Versão do conector 1
Nome da conexão slack-google-cloud-oauth-conn
Ativar Cloud Logging Sim
Conta de serviço SERVICE_ACCOUNT_NAME@PROJECT_ID.iam.gserviceaccount.com
Nível de verbosidade 5
Número mínimo de nós 2
Número máximo de nós 50
Código de autorização OAuth 2.0 Sim
ID do cliente CLIENT_ID
Escopos channels:read, groups:read, im:read, mpim:read, channels:write, groups:write,
im:write,mpim:write, channels:history, groups:history, im:history, mpim:history,
search:read, chat:write:user, chat:write:bot, files:read, files:write:user, pins:read,
pins:write,usergroups:read, usergroups:write, reminders:read, reminders:write,
users:read, users.profile:write
Chave secreta do cliente CLIENT_SECRET
Versão do secret 2

Limitações do sistema

O conector do Slack pode processar no máximo uma transação por segundo, por nó, e limita qualquer transação além desse limite. Por padrão, os Integration Connectors alocam dois nós (para melhor disponibilidade) para uma conexão.

Para informações sobre os limites aplicáveis aos Integration Connectors, consulte Limites.

Usar a conexão do Slack em uma integração

Depois de criar a conexão, ela fica disponível na integração da Apigee e Application Integration. É possível usar a conexão em uma integração pela tarefa de conectores.

  • Para entender como criar e usar a tarefa "Connectors" na integração da Apigee, consulte Tarefa Connectors.
  • Para entender como criar e usar a tarefa "Conectores" na Application Integration, consulte Tarefa "Conectores".

Entidades, operações e ações

Todos os Integration Connectors fornecem uma camada de abstração para os objetos do aplicativo conectado. Só é possível acessar os objetos de um aplicativo por esta abstração. A abstração é exposta a você como entidades, operações e ações.

  • Entidade: uma entidade pode ser considerada um objeto ou um conjunto de propriedades no aplicativo ou serviço conectado. A definição de uma entidade difere de um conector para outro. Por exemplo, em um conector de banco de dados, as tabelas são as entidades, em um conector de servidor de arquivos, as pastas são as entidades e, em um conector de sistema de mensagens, as filas são as entidades.

    No entanto, é possível que um conector não aceite ou não tenha entidades. Nesse caso, a lista Entities estará vazia.

  • Operação: uma operação é a atividade que pode ser realizada em uma entidade. É possível executar qualquer uma das seguintes operações em uma entidade:

    Selecionar uma entidade na lista disponível gera uma lista de operações disponíveis para ela. Para uma descrição detalhada das operações, consulte as operações de entidades da tarefa "Conectores". No entanto, se um conector não oferecer suporte a nenhuma das operações de entidade, essas operações sem suporte não serão listadas na lista Operations.

  • Ação: uma ação é uma função de primeira classe disponibilizada para a integração por meio da interface do conector. Uma ação permite fazer alterações em uma ou mais entidades e varia de um conector para outro. Normalmente, uma ação tem alguns parâmetros de entrada e um parâmetro de saída. No entanto, é possível que o conector não ofereça suporte a nenhuma ação. Nesse caso, a lista Actions estará vazia.

Ações

Esta seção lista as ações compatíveis com o conector do Slack. Para entender como configurar as ações, consulte Exemplos de ação.

Ação InviteUser

Essa ação convida os usuários para um canal.

Parâmetros de entrada da ação InviteUser

Nome do parâmetro Tipo de dados Obrigatório Descrição
ChannelId String Verdadeiro O ID do canal público ou privado para convidar usuários.
Usuários String Verdadeiro Uma lista de IDs de usuários separados por vírgulas. É possível especificar até 30 IDs de usuários.

Para saber como configurar a ação InviteUser, consulte o exemplo de InviteUser.

Ação CloseChannel

Essa ação fecha uma mensagem direta ou uma mensagem direta para várias pessoas.

Parâmetros de entrada de CloseChannel

Nome do parâmetro Tipo de dados Obrigatório Descrição
ChannelId String Verdadeiro ID da conversa a ser encerrada.

Para saber como configurar a ação CloseChannel, consulte o exemplo de fechamento de canal.

Ação JoinChannel

Essa ação permite que um usuário participe de uma conversa.

Parâmetros de entrada de JoinChannel

Nome do parâmetro Tipo de dados Obrigatório Descrição
ChannelId String Verdadeiro O ID do canal a ser adicionado.

Para saber como configurar a ação JoinChannel, consulte o exemplo de JoinChannel.

Ação LeaveChannel

Essa ação permite que um usuário saia de uma conversa.

Parâmetros de entrada de LeaveChannel

Nome do parâmetro Tipo de dados Obrigatório Descrição
ChannelId String Verdadeiro ID da conversa que você quer sair.

Para saber como configurar a ação LeaveChannel, consulte o exemplo de saída do canal.

Ação OpenChannel

Essa ação abre ou retoma uma mensagem direta ou uma mensagem direta para várias pessoas.

Parâmetros de entrada do OpenChannel

Nome do parâmetro Tipo de dados Obrigatório Descrição
ChannelId String Verdadeiro Retomar uma conversa fornecendo o ID da mensagem instantânea ou da mensagem instantânea para várias pessoas ou especificando os IDs dos usuários.
Usuários String Verdadeiro Listas de usuários separadas por vírgulas. Se apenas um usuário for especificado, uma mensagem direta será criada. Se você não especificar nenhum usuário, especifique um ID de canal para retomar uma conversa.

Para saber como configurar a ação OpenChannel, consulte o exemplo de canal aberto.

Ação DownloadFile

Essa ação faz o download de um arquivo.

Parâmetros de entrada de DownloadFile

Nome do parâmetro Tipo de dados Aceita streams de saída Descrição
FileId String Falso O ID do arquivo a ser transferido
FileLocation String Falso O local em que o arquivo será transferido
FileStream String Verdadeiro Uma instância de um fluxo de saída em que gravar os dados do arquivo. Este campo é usado se o FileLocation não for especificado.
Codificação String Falso O tipo de codificação do FileData. É possível especificar BASE64 ou NONE. O valor padrão é BASE64.

Para saber como configurar a ação DownloadFile, consulte o exemplo de download de arquivo.

Ação EndDnd

Essa ação encerra o modo "Não perturbe" de um usuário.

Parâmetros de entrada da ação EndDnd

Transmita um JSON vazio, como {}.

Para saber como configurar a ação EndDnd, consulte o exemplo EndDnd.

Ação SetSnooze

Essa ação ativa o modo "Não perturbe" para o usuário ou muda a duração dele.

Parâmetros de entrada da ação SetSnooze

Nome do parâmetro Tipo de dados Obrigatório Descrição
NumOfMinutes String 60 Número de minutos para adiar o usuário.

Para saber como configurar a ação SetSnooze, consulte o exemplo de SetSnooze.

Ação "EndSnooze"

Essa ação encerra o modo de suspensão do usuário.

Parâmetros de entrada da ação EndSnooze

Transmita um JSON vazio, como {}.

Para saber como configurar a ação EndSnooze, consulte o exemplo EndSnooze.

Ação SendScheduleMessage

Esta ação programa o envio de uma mensagem para um canal.

Parâmetros de entrada da ação SendScheduleMessage

Transmita um JSON vazio, como {}.

Para saber como configurar a ação SendScheduleMessage, consulte Exemplo de SendScheduleMessage.

Exemplos de ação

Exemplo: InviteUser

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação InviteUser e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ChannelId": "C06Q6NTRNA2",
  "Users": "U070MCLRREW"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa InviteUser terá um valor semelhante a este:

     
 [{
  "Success": "true"
}]

Exemplo: CloseChannel

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação CloseChannel e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ChannelId": "C075U92TU4U"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa CloseChannel terá um valor semelhante a este:

     
 [{
  "Success": "true"
}]

Exemplo: JoinChannel

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação JoinChannel e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ChannelId": "C06UMDTL1EH"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa JoinChannel terá um valor semelhante a este:

     
 [{
  "Success": "true"
}]

Exemplo: LeaveChannel

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação LeaveChannel e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ChannelId": "C06UME4PM2R"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa LeaveChannel terá um valor semelhante a este:

     
 [{
  "Success": "true"
}]

Exemplo: OpenChannel

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação OpenChannel e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
"Users": "U06VCS3NDNC,U06NE4KAL0G",
"ChannelId": "C071CU9UXFF"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa OpenChannel terá um valor semelhante a este:

     
[{
"Success": "true"
}]

Exemplo: DownloadFile

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação DownloadFile e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "FileId": "F075UHEMSN8",
  "HasBytes": true
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa DownloadFile terá um valor semelhante a este:

    [{
  "Success": "True",
  "ContentBytes": "JVBERi0xLjMKJcTl8uXrp/Og0MTGCjQgMCBvYmoKPDwgL0xlbmd0aCA1IDAgUiAvRmlsdGVyIC9GbGF0ZURlY29kZSA"
}]

Outras considerações

  • Defina "HasBytes" como "True" para fazer o download de outros formatos de arquivo, como PDF ou xlsx, que fornecem o conteúdo no formato codificado em Base64.
  • Para fazer o download de um arquivo em formato txt, defina "HasBytes" como "True" e faça o download do conteúdo do arquivo como bytes. Para fazer o download do conteúdo real do arquivo, defina "HasBytes" como "False".

Exemplo: EndDnd

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação EndDnd e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa EndDnd terá um valor semelhante a este:

     
 [{
  "Success": "true"
}]

Exemplo: SetSnooze

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação SetSnooze e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
     {
  "NumOfMinutes": "60"
}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa SetSnooze terá um valor semelhante a este:

     
 [{
  "Success": "true",
  "SnoozeEnabled": "true",
  "SnoozeEndTime": "1722842455",
  "SnoozeRemaining": "3600",
  "SnoozeIsIndefinite": "false"
}]

Exemplo: EndSnooze

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação EndSnooze e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {}

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa EndSnooze terá um valor semelhante a este:

     
  [{
  "Success": "true",
  "DndEnabled": "true",
  "NextDndStartTime": "1722875400",
  "NextDndEndTime": "1722911400",
  "SnoozeEnabled": "false"
}]

Exemplo: SendScheduleMessage

  1. Na caixa de diálogo Configure connector task, clique em Actions.
  2. Selecione a ação SendScheduleMessage e clique em Concluído.
  3. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
     {
  "Channel": "C07AMLB39JN",
  "PostAt": "2024-08-27 14:15:00.0",
  "Text": "Hello, World!",
  "ReplyBroadCast": false
 }

    4. Se a ação for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa SendScheduleMessage terá um valor semelhante a este:

     
   [{
  "Success": "true",
  "ok": "true",
  "scheduled_message_id": "Q07KD4YSG72",
  "channel": "C07AMLB39JN",
  "post_at": "1724768100",
  "message_user": "U071FD3TS8P",
  "message_type": "message",
  "message_bot_id": "B076304QR9V",
  "message_app_id": "A076HCDGHT5",
  "message_text": "Hello, World!",
  "message_team": "T071W04MGV8",
  "message_bot_profile_id": "B076304QR9V",
  "message_bot_profile_deleted": "false",
  "message_bot_profile_name": "Googlecloud_OAuth_Slack",
  "message_bot_profile_updated": "1717513424",
  "message_bot_profile_app_id": "A076HCDGHT5",
  "message_bot_profile_icons_image_36": "https://a.slack-edge.com/80588/img/plugins/app/bot_36.png",
  "message_bot_profile_icons_image_48": "https://a.slack-edge.com/80588/img/plugins/app/bot_48.png",
  "message_bot_profile_icons_image_72": "https://a.slack-edge.com/80588/img/plugins/app/service_72.png",
  "message_bot_profile_team_id": "T071W04MGV8",
  "message_blocks_type": "rich_text",
  "message_blocks_block_id": "MYA",
  "message_blocks_elements_type": "rich_text_section",
  "message_blocks_elements_elements_type": "text",
  "message_blocks_elements_elements_text": "Hello, World!"
}]

Exemplos de operações de entidade

Esta seção mostra como realizar algumas das operações de entidade neste conector.

Exemplo: listar registros da entidade "Mensagens"

Este exemplo lista os registros da entidade Messages.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Messages na lista Entity.
  3. Selecione a operação List e clique em Concluído.

Também é possível realizar operações de lista nas seguintes entidades: Files, MessageReplies, Pins, Reactions, Reminders, TeamInfo, UserGroups, Users, Channels, DND, Teams, UserProfile, ScheduledMessages, TeamProfileFields e TeamProfileSections.

Exemplo: receber registros da entidade "Ligações"

Este exemplo busca os registros da entidade Calls.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calls na lista Entity.
  3. Selecione a operação Get e clique em Concluído.
  4. Defina o ID da entidade como R070LKL3YKX, que é a chave a ser transmitida. Para definir o ID da entidade, na seção Entrada da tarefa da tarefa Connectors, clique em EntityId e insira R070LKL3YKX no campo Valor padrão.

O valor de ID da entidade precisa ser transmitido diretamente. Neste exemplo, R070LKL3YKX é o valor da chave primária exclusiva e é transmitido diretamente.

Também é possível realizar operações de recebimento nas seguintes entidades: Chamadas, Respostas de mensagens, Mensagens, Reações, Informações da equipe, Lembretes, Usuários e Canais.

Exemplo: excluir registros da entidade "Chamadas"

Este exemplo exclui os registros da entidade Calls.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calls na lista Entity.
  3. Selecione a operação Delete e clique em Concluído.
  4. Defina o ID da entidade como R074DSKVDSS, que é a chave a ser transmitida. Para definir o ID da entidade, na seção Entrada da tarefa da tarefa Connectors, clique em EntityId e insira R074DSKVDSS no campo Valor padrão.

    Se a entidade tiver duas chaves primárias ou de negócios compostas, defina a filterClause como Id='R074DSKVDSS'.

Também é possível realizar operações de exclusão nas seguintes entidades: arquivos, respostas a mensagens, mensagens, fixações, reações e lembretes.

Exemplo: criar registros da entidade "Ligações"

Este exemplo cria registros da entidade Calls.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calls na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ExternalUniqueId": "c249a48c-a154-43d6-a286-791df11927a4",
  "JoinURL": "https://example55.com/call"
}

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

     
{
  "Id": "R074LBCFBU3"
}

Exemplo: criar registros da entidade "Mensagens"

Este exemplo cria registros da entidade Messages.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Messages na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ChannelId": "C06UF15CB0V",
  "Text": "This is google cloud created Message"
}

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este :

     
{
"Id": "1723008314.867479",
"ChannelId": "C06UF15CB0V"
}

Exemplo: criar um registro da entidade "Pins"

Este exemplo cria um registro da entidade Pins.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Pins na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
"ChannelId": "C06UF15CB0V",
"Id": "1723008314.867479",
"Type": "message"
}

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este :

     
{
"Id": "1723008314.867479",
"Type": "message",
"ChannelId": "C06UF15CB0V"
}

Exemplo: criar um registro da entidade Reactions

Este exemplo cria um registro da entidade Reactions.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Reactions na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ChannelId": "C06UPA4KRD0",
  "Id": "1716375032.038669",
  "Type": "message",
  "Name": "raised_hands"
}

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

     
{
  "Success": true
}

Exemplo: criar um registro da entidade "Lembretes"

Este exemplo cria um registro da entidade Reminders.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Reminders na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "Text": "this is a reminder",
  "Time": "2025-10-15 14:30:00"
}

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

     
{
  "Id": "Rm074P0X9JCV"
}

Exemplo: criar um registro da entidade "Canais"

Este exemplo cria um registro da entidade Channels.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Channels na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
"Name": "googlecloudcreatedchannel",
"IsPublic": true
}

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

     
{
"Id": "C074MBW5N2G"
}

Exemplo: criar um registro da entidade MessageReplies

Este exemplo cria um registro da entidade MessageReplies.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione MessageReplies na lista Entity.
  3. Selecione a operação Create e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
"ChannelId": "C076HCY07UN",
"Text": "This is generated text",
"ParentMessageId": "1717659095.881619"
}

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

     
{
"Id": "1717659183.033599",
"ChannelId": C076HCY07UN,
"ParentMessageId": "1717659095.881619"
}

Exemplo: atualizar um registro da entidade "Chamadas"

Este exemplo atualiza um registro da entidade Calls.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Calls na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "JoinURL": "https://example55.com/call/google-cloud",
  "Title": "title"
}
  5. Defina o ID da entidade como R074LB76Q5R. Para definir o ID da entidade, clique em entityId e insira R074LB76Q5R no campo Valor padrão.

    Em vez de especificar o entityId, você também pode definir a filterClause como R074LB76Q5R.

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

    {
  "Id": "null"
}

Exemplo: atualizar um registro da entidade "Mensagens"

Este exemplo atualiza um registro da entidade Messages.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Messages na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "Text": "Google Cloud Updated Message"
}
  5. Defina a cláusula de filtro como ChannelId = 'C06UPA4KRD0' e Id = '1716369465.000129'. Para definir a cláusula de filtro, clique em filterClause e insira ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129' no campo Valor padrão.

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

    {
  "Id": null,
  "ChannelId": null
}

Exemplo: atualizar um registro da entidade "Usuários"

Este exemplo atualiza um registro da entidade Users.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Users na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
  "ProfileDisplayName": "Vaibhav"
}
  5. Defina o ID da entidade como U06Q6VDJYSU. Para definir o ID da entidade, clique em entityId e insira U06Q6VDJYSU no campo Valor padrão.

    Em vez de especificar o entityId, você também pode definir a filterClause como U06Q6VDJYSU.

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

    {
"Id": null
}

Exemplo: atualizar um registro da entidade "Canais"

Este exemplo atualiza um registro da entidade Channels.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione Channels na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
"Purpose": "This is the one channel that will always include everyone."
}
  5. Defina o ID da entidade como C06MAP1JDSB. Para definir o ID da entidade, clique em entityId e insira C06MAP1JDSB no campo Valor padrão.

    Em vez de especificar o entityId, você também pode definir a filterClause como C06MAP1JDSB.

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

    {
"Id": "C06MAP1JDSB"
}

Exemplo: atualizar um registro da entidade MessageReplies

Este exemplo atualiza um registro da entidade MessageReplies.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione MessageReplies na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
    {
"Text": "Updated Text"
}
  5. Defina a cláusula de filtro como ChannelId = 'C06UPA4KRD0' e Id = '1716369465.000129'. Para definir a cláusula de filtro, clique em filterClause e insira ChannelId = 'C06UPA4KRD0' and Id = '1716369465.000129' no campo Valor padrão.

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

    {
"Id": null,
"ChannelId": null,
"ParentMessageId": null
}

Exemplo: atualiza um registro da entidade UserProfile

Este exemplo atualiza um registro da entidade UserProfile.

  1. Na caixa de diálogo Configure connector task, clique em Entities.
  2. Selecione UserProfile na lista Entity.
  3. Selecione a operação Update e clique em Concluído.
  4. Na seção Entrada da tarefa da tarefa Connectors, clique em connectorInputPayload e insira um valor semelhante ao seguinte no campo Default Value: 
     {
  "CustomFields": "{\"Xf079082Q70B\": {\"value\": \"Patna Bihar\",\"alt\": \"\"}}",
  "Phone": "8767787654",
  "StatusText": "Long train Journey to work"
 }

    Se a integração for bem-sucedida, o parâmetro de resposta connectorOutputPayload da tarefa Connector terá um valor semelhante a este:

    {

}

Receber ajuda da comunidade do Google Cloud

Poste suas dúvidas e converse sobre esse conector na comunidade do Google Cloud em Fóruns do Cloud.

A seguir