Integrações Privadas permitem que você crie integrações personalizadas poderosas entre sua conta e qualquer outro aplicativo de terceiros.
Se você está procurando integrar sua conta com um aplicativo de terceiros, você tem duas opções:
1. Encontrar e instalar o aplicativo relevante no App Marketplace
2. Criar sua própria integração privada sozinho ou com a ajuda de um desenvolvedor usando APIs.
Integrações Privadas ajudam você a alcançar a opção #2 com segurança.
As principais vantagens de usar Integrações Privadas são:
Simples: Gere tokens de Integração Privada nas configurações da sua conta e gerencie-os com facilidade.
Seguro: Você pode restringir os escopos/permissões que um desenvolvedor pode acessar na sua conta
Integrações Privadas, em resumo, são uma alternativa mais poderosa e segura às Chaves de API.
Por padrão, todos os administradores de conta podem criar e gerenciar Integrações Privadas.
No entanto, você pode restringir essa permissão a nível de usuário. Para fazer isso, navegue até Configurações > Minha Equipe > Edite o usuário específico da conta > Funções e Permissões, e habilite/desabilite Integrações Privadas para o usuário.
Para gerenciar Integrações Privadas, vá para Configurações e role para baixo até a seção 'Outras Configurações' no menu de navegação à esquerda.
Se você não encontrar a configuração, certifique-se de que ativou o recurso no Labs.
Passo 1: Clique em "Criar nova Integração"
Passo 2: Dê um nome e uma descrição para sua Integração Privada para ajudar você e sua equipe a identificar para que ela serve.
Passo 3: Selecione os escopos/permissões que você deseja que a integração privada tenha acesso em sua conta. Certifique-se de selecionar apenas os escopos necessários para uma melhor segurança dos dados.
Passo 4: Copie o token gerado e compartilhe-o com o desenvolvedor do seu aplicativo de terceiros.
Certifique-se de compartilhar o token apenas com partes confiáveis. Não o compartilhe publicamente.
Nota: Não se esqueça de copiar o token gerado, pois você não poderá fazê-lo novamente mais tarde.
Recomendamos que você rotacione seus tokens de Integração Privada a cada 90 dias.
Veja como você pode fazer isso.
Passo 1: Navegue até Integrações Privadas nas configurações e clique na Integração Privada que você criou.
Passo 2: Clique em "Girar e expirar este token mais tarde".
Passo 3: Clique em "Continuar" em resposta à mensagem de aviso se você tiver certeza de que deseja prosseguir com a rotação.
Passo 4: Copie o novo token e atualize-o no seu aplicativo de terceiros. Você terá uma janela de 7 dias onde tanto o token antigo quanto o novo continuarão a funcionar. Após 7 dias, o token antigo expirará. Nesta janela de 7 dias, você terá a opção de:
1. "Cancelar rotação" se, por exemplo, seu desenvolvedor precisar de mais tempo para atualizar o token no aplicativo de terceiros.
2. "Expirar agora", se, por exemplo, o aplicativo de terceiros foi atualizado com o novo token.
Nota: Não se esqueça de copiar o token gerado, pois você não poderá fazê-lo novamente mais tarde.
Passo 1: Navegue até Integrações Privadas nas configurações e clique na Integração Privada que você criou.
Passo 2: Clique em "Rotacionar e expirar este token agora".
Passo 3: Clique em "Continuar" em resposta à mensagem de aviso se você tiver certeza de que deseja prosseguir com a rotação.
Passo 4: Copie o novo token e atualize-o no seu aplicativo de terceiros.
Nota: Não se esqueça de copiar o token gerado, pois você não poderá fazê-lo novamente mais tarde.
Sim, você pode editar o nome, descrição e escopos/permissões da Integração Privada a qualquer momento após criá-la.
Veja como você pode fazer isso.
Passo 1: Navegue até Integrações Privadas nas configurações e selecione "Editar" no menu de três pontos.
Passo 2: Atualize o nome e descrição da Integração Privada, se necessário. Clique em "Próximo".
Passo 3: Se necessário, atualize os escopos/permissões que você deseja que a integração privada tenha acesso em sua conta. Certifique-se de selecionar apenas os escopos necessários para melhor segurança dos dados. Clique em "Atualizar" para salvar as atualizações feitas.
Nota: Atualizar os detalhes da Integração Privada não gera um novo token. O token existente continuará funcionando.
Você pode excluir a Integração Privada quando não estiver mais usando o aplicativo de terceiros.
Para fazer isso, navegue até Integrações Privadas nas configurações e selecione "Excluir" no menu de três pontos.
