Passar para o conteúdo principal

Como adicionar uma organização de cobrança ao seu token de acesso pessoal.

Tenha maior governança ao configurar corretamente a organização de cobrança de um token; Neste artigo você saberá como configurar a organização de cobrança e sua importância.

Escrito por Product Team
Atualizado hoje

O que é a organização de cobrança e por que adicioná-la?

As chamadas de API são um recurso pago e limitado da sua conta Pipefy. A organização de cobrança é a que será cobrada pelas chamadas de API feitas com esse token. Você pode selecionar como organização de cobrança todas as organizações nas quais você seja membro, admin ou super admin.

Adicionar uma organização de cobrança é importante para que esteja explícito qual a organização que será cobrada pelas chamadas de API realizadas. Além disso, esta configuração permite centralizar a cobrança em uma única organização, no caso de processos que englobem múltiplas organizações. Assim você ganha mais visibilidade e controle sobre os custos das suas chamadas de API.

O que é um token de acesso pessoal e como acessá-lo?

O token de acesso pessoal é uma forma de gerar tokens, com as mesmas permissões do usuário que o criou, para se comunicar com a API GraphQL da Pipefy, permitindo criar integrações e realizar consultas. É importante ressaltar que se deve dar preferência a contas de serviço, por sua maior governança e segurança.

Para acessar seus tokens de acesso pessoal, você pode acessar esse link ou:

  1. Acessar o seu perfil. Para fazer isso, basta clicar na sua imagem de perfil, localizada no canto superior direito da tela, e, depois, no botão Meu perfil.

  2. Clicar na terceira aba da página de perfil, chamada “Token de acesso pessoal”.

  3. Com isso, você verá a listagem de tokens, como no exemplo a seguir:

    Na listagem, estão especificados os tokens que precisam da sua ação.

Por que pedir para os membros de sua organização configurarem o token de acesso pessoal? (Para admins e super admins)

É importante que você, como administrador, peça aos membros da sua organização que atualizem seus tokens de acesso pessoal. Isso vai garantir que as chamadas de API sejam devidamente cobradas e registradas no admin panel, melhorando a governança do seu consumo.

Como configurar a organização de cobrança para o seu token de acesso pessoal?

1- Configurar a organização para seu token é bastante simples. Caso você esteja criando um novo token, basta selecionar uma organização ao criar o token, como mostrado na imagem abaixo.

2- Para editar um token, basta clicar nele ou clicar no ícone das três bolinhas e depois no botão editar, como mostrado na imagem a seguir.

3- Após acessar a edição, basta selecionar a organização de cobrança, como na criação do token.

Respondeu à sua pergunta?