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 com o Notion para automatizar tarefas, como criar, atualizar e procurar páginas, adicionar comentário e inserir blocos de conteúdo. Use uma conta de serviço dedicada para as conexões e revise as permissões com cuidado. Essas ações ajudam a integrar fluxos de trabalho em plataformas, melhorando a colaboração e o gerenciamento de conteúdo em seus processos de suporte.

Ao conectar o criador de ações a sistemas externos, como o Notion, 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 Notion ao criador de ações
  • Uso de ações do Notion em fluxos de ação

Conexão do Notion 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 conectar o criador de ações ao Notion
  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 Notion.
  5. Clique em Conectar.
  6. Siga os comandos do Notion para se autenticar e concluir a conexão.

    Quando você autoriza a conexão, é redirecionado para o Notion para conceder permissões à sua conta do Zendesk.

    A conexão do Notion usa OAuth 2.0 com o tipo de concessão de código de autorização. Revise as permissões com atenção antes de autorizar a conexão. Essas permissões permitem fluxos de ação para criar e modificar páginas, adicionar comentários, gerenciar itens de banco de dados e atualizar conteúdo no espaço de trabalho do Notion em seu nome.

    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 o Notion.

Uso de ações do Notion em fluxos de ação

As seguintes ações do Notion estão disponíveis:
  • Criar página
  • Atualizar página
  • Pesquisar página
  • Adicionar comentário
  • Adicionar bloco à página

Criação de página

Use a ação Criar página para criar uma nova página no Notion em uma página principal ou no nível do espaço de trabalho.

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

  Variáveis
Entradas Obrigatória: Title

Opcionais: Parent page, Create at workspace level, Content

A Página principal deve ser especificada ou Criar no nível do espaço de trabalho deve ser definido como verdadeiro. As páginas no nível do espaço de trabalho estão disponíveis apenas para integrações públicas. O campo Página principal permite pesquisar suas páginas do Notion por nome.

Saída Detalhes da página, incluindo ID, URL e carimbo de data/hora de criação.

Atualização de uma página

Use a ação Atualizar página para atualizar o título de uma página do Notion existente ou o status de arquivamento.
Observação: não há suporte para arquivamento de páginas no nível do espaço de trabalho por API do Notion.

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

  Variáveis
Entradas Obrigatória: Page ID

Opcionais: Title, Archived

Saída Detalhes da página, incluindo ID, URL e carimbo de data/hora da última edição.

Pesquisa de página

Use a ação Pesquisar página para recuperar uma página do Notion por seu ID ou título exato.

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

  Variáveis
Entradas

Opcionais: Page ID, Title

O ID da página ou o título é obrigatório. Forneça um desses campos para identificar a página a ser recuperada.

Saída Detalhes da página, incluindo ID, URL, título, ícone, carimbo de data/hora de criação, carimbo de data/hora da última edição e status arquivado.

Adição de comentários

Use a ação Adicionar comentário para adicionar um comentário a uma página ou bloco do Notion.

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

  Variáveis
Entradas

Obrigatórias: Page ID or Block ID, Comment text

O ID da página ou o título é obrigatório. Forneça um desses campos para identificar a página a ser recuperada.

Saída ID do comentário, carimbo de data/hora de criação e informações do criador.

Adição de bloco a uma página

Use a ação Adicionar bloco à página para adicionar um bloco de conteúdo (como parágrafo, título ou citação) a uma página do Notion.

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

  Variáveis
Entradas

Opcionais: Page ID ou Block type, Content

Os tipos de bloco disponíveis incluem: Parágrafo, Cabeçalho 1, Cabeçalho 2, Cabeçalho 3 e Citação.

Saída ID do bloco, tipo e carimbo de data/hora de criação.
Powered by Zendesk