Uso de ações do monday.com em fluxos de ação

Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Qual é o meu plano?

Suite, todas as versões

Team, Growth, Professional, Enterprise ou Enterprise Plus

Support

Team, Professional ou Enterprise

Resumo: ◀▼

Você pode conectar fluxos de ação a monday.com usando um token de API para automatizar tarefas como criar, atualizar e apagar itens, adicionar comentários e gerenciar status do item ou propriedade. Essa integração ajuda a otimizar fluxos de trabalho sincronizando dados entre plataformas, melhorando o gerenciamento de tarefas e colaboração entre equipes sem atualizações manuais.

Ao conectar o criador de ações a sistemas externos, como o monday.com, os administradores podem integrar o Zendesk a sistemas externos em fluxos de trabalho automatizados, melhorando a colaboração e mantendo uma experiência contínua em várias plataformas.

Observação: as etapas associadas aos sistemas externos em fluxos de ação são chamadas coletivamente de ações externas.

Este artigo contém os seguintes tópicos:

• Conexão do monday.com ao criador de ações
• Uso de ações do monday.com em fluxos de ação

Conexão do monday.com ao criador de ações

Antes de incluir ações externas nos seus fluxos de ação, é preciso conectar o criador de ações ao sistema externo.

Ao se conectar a sistemas externos para uso em fluxos de ação, as seguintes práticas recomendadas devem ser observadas:

• Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.
• Todas as integrações solicitam acesso aos escopos necessários. No entanto, é importante que você avalie e valide os escopos antes de autorizar a conexão com o sistema externo.
• Ao gerenciar credenciais para ferramentas baseadas em chave de API, como a OpenAI, recomendamos armazenar as chaves em um cofre seguro ou em um gerenciador de credenciais.

Como gerar um token da API

A conexão do monday.com requer uma chave da API para autenticação. Mantenha seu token da API seguro e nunca o compartilhe publicamente. Trate-o como uma senha.

1. Acesse sua imagem do perfil em monday.com.
2. Clique em Desenvolvedores.
3. Navegue até Token da API.
4. Gere um novo token.
5. Salve o token ou mantenha a janela aberta para poder copiá-lo e colá-lo no Zendesk.

   Você precisará dela ao conectar o monday.com ao criador de ações.

Você também pode visitar https://[sua-conta].monday.com/apps/manage/tokens para gerenciar seus tokens. Consulte a documentação de autenticação do monday.com para obter detalhes.

Como conectar o criador de ações ao monday.com

1. Na Central de administração, clique em Aplicativos e integrações na barra lateral e selecione Ações > Fluxos de ação.
2. Crie ou edite um fluxo de ação.
3. Abra a barra lateral da etapa.
4. Em Ações externas, clique em monday.com.
5. Clique em Conectar.
6. Siga as solicitações do monday.com para inserir seu token da API e concluir a conexão.
   Observação: Todas as ações externas realizadas por um fluxo de ação são atribuídas ao usuário que conectou o sistema externo. Portanto, é uma prática recomendada usar uma conta de serviço dedicada em vez de credenciais pessoais ao se conectar a cada sistema externo.

Depois de se conectar ao sistema, você verá um indicador de conexão e detalhes sobre a instância à qual está conectado, bem como as ações disponíveis para monday.com.

Uso de ações do monday.com em fluxos de ação

As seguintes ações do monday.com estão disponíveis:

• Criar item
• Pesquisar item
• Atualizar item
• Atualizar status do item
• Atualizar responsável pelo item
• Criar subitem
• Adicionar comentário
• Mover item para o grupo
• Apagar item
• Listar todos os itens
• Pesquisar painel
• Pesquisar usuário

Criação de um item

Use a ação Criar item para criar um novo item em um painel de monday.com com valores de coluna personalizados.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Board, Item name Opcionais: Group, colunas específicas do painel Depois de selecionar um painel, os campos de entrada adicionais são exibidos para as colunas personalizadas desse painel. Você pode definir valores pra texto, status, data, pessoas e outros tipos de coluna que têm suporte em monday.com. Os valores de coluna são retornados como uma matriz com ID, texto, valor e tipo para cada coluna.
Saída	Detalhes do item, incluindo item_id, board_id, group_id, item_name, item_url, board_name, group_title, created_at, creator_id, status e matriz column_values.

Pesquisa de um item

Use a ação Pesquisar item para recuperar detalhes de um item específico por seu ID.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatória: Item ID
Saída	Detalhes do item, incluindo item_id, item_name, item_url, status, painel (com id e nome), grupo (com id e título), matriz column_values, criador (com id e nome), created_at e updated_at.

Atualização de um item

Use a ação Atualizar item para modificar valores de coluna de um item existente.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Board, Item ID Opcionais: colunas específicas do painel Depois de selecionar um painel, os campos de entrada adicionais são exibidos para as colunas personalizadas desse painel. Forneça valores somente para as colunas que deseja atualizar. Os valores existentes para as colunas que você não especificar permanecerão inalterados.
Saída	Detalhes do item, incluindo item_id, item_name, item_url, board_id, board_name, group_id, group_title, status, updated_at e matriz column_values.

Atualização do status de um item

Use a ação Atualizar status do item para alterar o rótulo de status em uma coluna de status.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Item ID, Board, Status column, Status label
Saída	Detalhes do item, incluindo item_id, item_name, item_url, board_id, board_name, group_id, group_title, status, updated_at e a matriz column_values.

Atualização do responsável por um item

Use a ação Atualizar responsável pelo item para atribuir um usuário à coluna de pessoas de um item.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Item ID, Board, People column, User O campo Coluna de pessoas é preenchido dinamicamente com base nas colunas de tipo de pessoas do painel selecionado. O campo Usuário permite que você pesquise e selecione entre os usuários de seu espaço de trabalho.
Saída	Detalhes do item, incluindo item_id, item_name, item_url, board_id, board_name, group_id, group_title, status, people_column_id, people_column_value e assignee_user_id.

Criação de um subitem

Use a ação Criar subitempara criar um subitem em um item pai existente. Os subitens são criados no painel de subitens do item pai e herdam o contexto do painel do pai.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Parent item ID, Item name
Saída	Detalhes do subitem, incluindo subitem_id, subitem_name, subitem_url, parent_item_id, parent_item_name, board_id, board_name, group_id, group_title, status, created_at e matriz column_values. O subitem_url fornece um link direto para visualizar o subitem em monday.com.

Adição de comentários

Use a ação Adicionar comentário para publicar um comentário ou atualização de um item.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Item ID, Comment
Saída	Detalhes de comentário, incluindo update_id, item_id, comment_text, created_at e objeto de criador (com id e nome).

Movimentação de um item para um grupo

Use a ação Mover item para o grupo para mover um item para um grupo diferente no mesmo painel.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatórias: Item ID, Board, Group O campo Grupo é preenchido dinamicamente com base nos grupos disponíveis do painel selecionado. Você pode mover itens somente entre grupos do mesmo painel.
Saída	Detalhes do item, incluindo item_id, item_name, item_url, board_id, board_name, destination_group_id, destination_group_title e status.

Exclusão de um item

Use a ação Apagar item para apagar permanentemente um item de monday.com.

Importante: essa ação apaga permanentemente o item e não pode ser desfeita. Use com cuidado.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Obrigatória: Item ID
Saída	ID do item apagado e status de confirmação da exclusão.

Listagem de todos os itens

Use a ação Listar todos os itens para recuperar itens de um painel ou entre todos os painéis.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Opcionais: Board, Limit Se nenhum painel for especificado, a ação pesquisará em todos os painéis acessíveis em seu espaço de trabalho. O campo Limite controla o número máximo de itens retornados (padrão: 25).
Saída	Matriz de itens contendo objetos de item (cada um com item_id, item_name, item_url, status, board_id, board_name, group_id, group_title e a matriz column_values) e a marcação de booliano has_more. A marcação has_more indica se há itens adicionais disponíveis além do limite especificado.

Pesquisa de painel

Use a ação Pesquisar painel para recuperar detalhes sobre um painel específico. Use essa ação para descobrir a estrutura de um painel, incluindo todos os grupos e colunas disponíveis e seus tipos. Essas informações são úteis ao criar fluxos de trabalho dinâmicos.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Opcional: Board ID
Saída	Detalhes do painel, incluindo board_id, board_name, descrição, status, board_kind, objeto de espaço de trabalho (com id e nome), matriz de grupos (cada uma com id e título) e matriz de colunas (cada uma com id, título e tipo).

Pesquisa de usuário

Use a ação Pesquisar usuário para recuperar informações do usuário por ID ou endereço de e-mail do usuário.

As entradas e saídas dessa ação são:

	Variáveis
Entradas	Opcionais: User ID, Email Forneça o ID de usuário ou o e-mail para localizar um usuário. Caso ambos sejam fornecidos, o ID do usuário terá prioridade.
Saída	Detalhes do usuário, incluindo user_id, nome, e-mail, título, photo_url e objeto da conta (com id e nome). O photo_url fornece um link direto para a imagem do perfil do usuário em monday.com.