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 o papel do 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. O conector e a conta de serviço precisam pertencer ao mesmo projeto. 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 informações sobre como criar um espaço de trabalho do Slack, consulte 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
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, faça o seguinte:
- No console do Cloud, acesse a página Integration Connectors > Conexões e selecione ou crie um projeto do Google Cloud.
- Clique em + CRIAR NOVO para abrir a página Criar conexão.
- Na seção Local, escolha o local da conexão.
- Região: selecione um local na lista suspensa.
Para conferir a lista de todas as regiões com suporte, consulte Locais.
- Clique em PRÓXIMA.
- Região: selecione um local na lista suspensa.
- Na seção Detalhes da conexão, faça o seguinte:
- Conector: selecione Slack na lista suspensa de conectores disponíveis.
- Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
- 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 49 caracteres.
- Como opção, insira uma Descrição para a instância de conexão.
- Se quiser, ative o Cloud Logging e selecione um nível de registro. Por padrão, o nível de registro é definido como
Error
. - Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
- 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.
- Outra opção é clicar em + ADICIONAR MARCADOR para adicionar um rótulo à conexão na forma de um par de chave-valor.
- Clique em PRÓXIMA.
-
Na seção Autenticação, insira os detalhes da autenticação.
- Selecione um Tipo de autenticação e insira os detalhes relevantes.
A conexão do Slack aceita os seguintes tipos de autenticação:
- OAuth2.0: código de autorização
- Autenticação de token do usuário
- Clique em PRÓXIMA.
Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.
- Selecione um Tipo de autenticação e insira os detalhes relevantes.
- Revisão: revise os detalhes de conexão e autenticação.
- Clique em Criar.
Configurar a autenticação
Digite os detalhes com base na autenticação que você quer usar.
-
OAuth2.0: código de autorização
Para autenticar usando o OAuth 2.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 selecionado acima.
-
Autenticação de token do usuário
Para autenticar 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 selecionado acima.
Para o tipo de autenticação Authorization code
, depois de criar a conexão, execute 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 depois de criar a conexão:
- Na página "Conexões",
localiza a conexão recém-criada.
O Status do novo conector será Autorização necessária.
- Clique em Autorização necessária.
O painel Editar autorização é exibido.
- Copie o valor de URI de redirecionamento para seu aplicativo externo.
- Verifique os detalhes da autorização.
- 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 configuração no aplicativo,
será necessário autorizar novamente a conexão do OneDrive. Para reautorizar uma conexão, siga estas etapas:
- Clique na conexão desejada na página "Conexões".
A página de detalhes da conexão será aberta.
- Clique em Editar para mudar os detalhes da conexão.
- Verifique os detalhes do Código de autorização do OAuth 2.0 na seção Autenticação.
Se necessário, faça as mudanças necessárias.
- Clique em Salvar. Isso leva você à página de detalhes da conexão.
- Clique em Editar autorização na seção Autenticação. O painel Autorizar é exibido.
- Clique em Autorizar.
Se a autorização for concluída, 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 amostra 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 | my-service-account@my-project.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 de 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 | my-service-account@my-project.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, o Integration Connectors aloca 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 "Conectores" na integração da Apigee, consulte Tarefa "Conectores".
- 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 for compatível com nenhuma das operações de entidade, essas operações 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ções.
Ação InviteUser
Essa ação convida 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ário. |
Para ver um exemplo de como configurar a ação InviteUser
,
consulte Exemplo de InviteUser.
Ação CloseChannel
Essa ação fecha uma mensagem direta ou em grupo.
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 ver um exemplo de como configurar a ação CloseChannel
,
consulte Exemplo de CloseChannel.
Ação JoinChannel
Essa ação permite que um usuário participe de uma conversa em andamento.
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 acessado. |
Para ver um exemplo de como configurar a ação JoinChannel
,
consulte 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 a ser abandonada. |
Para ver um exemplo de como configurar a ação LeaveChannel
,
consulte Exemplo de LeaveChannel.
Ação OpenChannel
Essa ação abre ou retoma uma mensagem direta ou em grupo.
Parâmetros de entrada de OpenChannel
Nome do parâmetro | Tipo de dados | Obrigatório | Descrição |
---|---|---|---|
ChannelId | String | Verdadeiro | Retome uma conversa fornecendo o ID da mensagem instantânea ou da mensagem instantânea para várias pessoas ou especifique os IDs de usuário. |
Usuários | String | Verdadeiro | Listas de usuários separadas por vírgulas. Se apenas um usuário for especificado, uma mensagem direta individual será criada. Se você não especificar nenhum usuário, especifique um ID de canal para retomar uma conversa. |
Para ver um exemplo de como configurar a ação OpenChannel
,
consulte Exemplo de OpenChannel.
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 fluxos de saída | Descrição |
---|---|---|---|
FileId | String | Falso | O ID do arquivo a ser baixado |
FileLocation | String | Falso | O local onde o arquivo será baixado |
FileStream | String | Verdadeiro | Uma instância de um fluxo de saída em que os dados do arquivo serão gravados. Esse 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 ver um exemplo de como configurar a ação DownloadFile
,
consulte Exemplo de DownloadFile.
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 ver um exemplo de como configurar a ação EndDnd
,
consulte Exemplo de 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 ver um exemplo de como configurar a ação SetSnooze
,
consulte Exemplo de SetSnooze.
Ação EndSnooze
Essa ação encerra o modo soneca do usuário.
Parâmetros de entrada da ação EndSnooze
Transmita um JSON vazio, como {}.
Para ver um exemplo de como configurar a ação EndSnooze
,
consulte Exemplo de EndSnooze.
Ação SendScheduleMessage
Essa ação programa uma mensagem para ser enviada a um canal.
Parâmetros de entrada da ação SendScheduleMessage
Transmita um JSON vazio, como {}.
Para ver um exemplo de como configurar a ação SendScheduleMessage
,
consulte Exemplo de SendScheduleMessage.
Exemplos de ações
Exemplo: InviteUser
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
InviteUser
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "ChannelId": "C06Q6NTRNA2", "Users": "U070MCLRREW" }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
CloseChannel
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "ChannelId": "C075U92TU4U" }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
JoinChannel
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "ChannelId": "C06UMDTL1EH" }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
LeaveChannel
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "ChannelId": "C06UME4PM2R" }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
OpenChannel
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "Users": "U06VCS3NDNC,U06NE4KAL0G", "ChannelId": "C071CU9UXFF" }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
DownloadFile
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "FileId": "F075UHEMSN8", "HasBytes": true }
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 baixar 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 no formato txt, defina "HasBytes" como "True" e baixe o conteúdo do arquivo como bytes. Para fazer o download do conteúdo real do arquivo, defina "HasBytes" como "False".
Exemplo: EndDnd
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
EndDnd
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{}
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
SetSnooze
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "NumOfMinutes": "60" }
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
EndSnooze
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{}
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
- Na caixa de diálogo
Configure connector task
, clique emActions
. - Selecione a ação
SendScheduleMessage
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "Channel": "C07AMLB39JN", "PostAt": "2024-08-27 14:15:00.0", "Text": "Hello, World!", "ReplyBroadCast": false }
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
Nesta seção, mostramos como realizar algumas das operações de entidade neste conector.
Exemplo: listar registros da entidade "Messages"
Este exemplo lista os registros da entidade Messages
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Messages
na listaEntity
. - Selecione a operação
List
e clique em Concluído.
Também é possível realizar a operação 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 "Calls"
Este exemplo busca os registros da entidade Calls
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Calls
na listaEntity
. - Selecione a operação
Get
e clique em Concluído. - 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 Conectores, clique em EntityId e
insira
R070LKL3YKX
no campo Valor padrão.
O valor do ID da entidade precisa ser transmitido diretamente. Neste exemplo, R070LKL3YKX é o valor exclusivo da chave primária e é transmitido diretamente.
Também é possível realizar operações de recebimento nas seguintes entidades: Calls, MessageReplies, Messages, Reactions, TeamInfo, Reminders, Users e Channels.
Exemplo: excluir registros da entidade "Chamadas"
Este exemplo exclui os registros da entidade Calls
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Calls
na listaEntity
. - Selecione a operação
Delete
e clique em Concluído. - 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 Conectores, 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 filterClause como
Id='R074DSKVDSS'
.
Também é possível realizar operações de exclusão nas seguintes entidades: Files, MessageReplies, Messages, Pins, Reactions e Reminders.
Exemplo: criar registros da entidade "Calls"
Este exemplo cria registros da entidade Calls
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Calls
na listaEntity
. - Selecione a operação
Create
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault 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 tarefaConnector
terá um valor semelhante a este:{ "Id": "R074LBCFBU3" }
Exemplo: criar registros da entidade "Messages"
Este exemplo cria registros da entidade Messages
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Messages
na listaEntity
. - Selecione a operação
Create
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "ChannelId": "C06UF15CB0V", "Text": "This is google cloud created Message" }
Se a integração for bem-sucedida, o parâmetro de resposta
connectorOutputPayload
da tarefaConnector
terá um valor semelhante a :{ "Id": "1723008314.867479", "ChannelId": "C06UF15CB0V" }
Exemplo: criar um registro da entidade "Pins"
Este exemplo cria um registro da entidade Pins
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Pins
na listaEntity
. - Selecione a operação
Create
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "ChannelId": "C06UF15CB0V", "Id": "1723008314.867479", "Type": "message" }
Se a integração for bem-sucedida, o parâmetro de resposta
connectorOutputPayload
da tarefaConnector
terá um valor semelhante a :{ "Id": "1723008314.867479", "Type": "message", "ChannelId": "C06UF15CB0V" }
Exemplo: criar um registro da entidade "Reactions"
Este exemplo cria um registro da entidade Reactions
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Reactions
na listaEntity
. - Selecione a operação
Create
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault 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 tarefaConnector
terá um valor semelhante a este:{ "Success": true }
Exemplo: criar um registro da entidade "Lembretes"
Este exemplo cria um registro da entidade Reminders
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Reminders
na listaEntity
. - Selecione a operação
Create
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault 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 tarefaConnector
terá um valor semelhante a este:{ "Id": "Rm074P0X9JCV" }
Exemplo: criar um registro da entidade "Canais"
Este exemplo cria um registro da entidade Channels
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Channels
na listaEntity
. - Selecione a operação
Create
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "Name": "googlecloudcreatedchannel", "IsPublic": true }
Se a integração for bem-sucedida, o parâmetro de resposta
connectorOutputPayload
da tarefaConnector
terá um valor semelhante a este:{ "Id": "C074MBW5N2G" }
Exemplo: criar um registro da entidade "MessageReplies"
Este exemplo cria um registro da entidade MessageReplies
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
MessageReplies
na listaEntity
. - Selecione a operação
Create
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault 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 tarefaConnector
terá um valor semelhante a este:{ "Id": "1717659183.033599", "ChannelId": C076HCY07UN, "ParentMessageId": "1717659095.881619" }
Exemplo: atualizar um registro da entidade "Calls"
Este exemplo atualiza um registro da entidade Calls
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Calls
na listaEntity
. - Selecione a operação
Update
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "JoinURL": "https://example55.com/call/google-cloud", "Title": "title" }
- 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 tarefaConnector
terá um valor semelhante a este:{ "Id": "null" }
Exemplo: atualizar um registro da entidade "Messages"
Este exemplo atualiza um registro da entidade Messages
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Messages
na listaEntity
. - Selecione a operação
Update
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "Text": "Google Cloud Updated Message" }
- Defina filterClause como ChannelId = 'C06UPA4KRD0' e Id = '1716369465.000129'. Para definir a filterClause,
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 tarefaConnector
terá um valor semelhante a este:{ "Id": null, "ChannelId": null }
Exemplo: atualizar um registro da entidade "Users"
Este exemplo atualiza um registro da entidade Users
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Users
na listaEntity
. - Selecione a operação
Update
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "ProfileDisplayName": "Vaibhav" }
- 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 tarefaConnector
terá um valor semelhante a este:{ "Id": null }
Exemplo: atualizar um registro da entidade "Canais"
Este exemplo atualiza um registro da entidade Channels
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
Channels
na listaEntity
. - Selecione a operação
Update
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "Purpose": "This is the one channel that will always include everyone." }
- 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 tarefaConnector
terá um valor semelhante a este:{ "Id": "C06MAP1JDSB" }
Exemplo: atualizar um registro da entidade "MessageReplies"
Este exemplo atualiza um registro da entidade MessageReplies
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
MessageReplies
na listaEntity
. - Selecione a operação
Update
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault Value
:{ "Text": "Updated Text" }
- Defina filterClause como ChannelId = 'C06UPA4KRD0' e Id = '1716369465.000129'. Para definir a filterClause,
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 tarefaConnector
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
.
- Na caixa de diálogo
Configure connector task
, clique emEntities
. - Selecione
UserProfile
na listaEntity
. - Selecione a operação
Update
e clique em Concluído. - Na seção Entrada da tarefa da tarefa Connectors, clique em
connectorInputPayload
e insira um valor semelhante ao seguinte no campoDefault 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 tarefaConnector
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
- Entenda como suspender e retomar uma conexão.
- Entenda como monitorar o uso do conector.
- Saiba como ver os registros do conector.