Gerenciamento de empresas e desenvolvedores usando o portal do desenvolvedor (autoatendimento)

Você está lendo a documentação do Apigee Edge.
Acesse a documentação da Apigee X.
info

Como provedor de API, gerenciar as empresas e os desenvolvedores que participam do ecossistema de APIs monetizadas pode ser demorado se você tiver que fazer tudo sozinho. Há perfis para gerenciar; detalhes bancários, fiscais e de faturamento para manter; papéis para atribuir e assim por diante. O portal do desenvolvedor permite que essas tarefas de gerenciamento sejam processadas pelas próprias empresas e desenvolvedores, ao mesmo tempo em que oferece visibilidade total do ecossistema na interface de gerenciamento e na API.

Antes de começar

Antes de ativar o autoatendimento no portal do desenvolvedor, entenda os conceitos básicos do portal e execute as principais etapas de configuração. Por exemplo, é importante saber que você pode controlar se os usuários são ativados automaticamente no registro ou se exigem aprovação manual. Se ainda não fez isso, familiarize-se com os tópicos do portal do desenvolvedor em Criar seu portal usando o Drupal.

Além de revisar e executar a configuração do ambiente principal do portal do desenvolvedor, revise e execute os seguintes tópicos específicos de monetização:

Sobre o autoatendimento de empresas e desenvolvedor no portal do desenvolvedor

Com a monetização ativada na sua organização, além de qualquer configuração do portal do desenvolvedor que você já tenha feito, o portal pode estar pronto para o autoatendimento. As tarefas de autoatendimento que os desenvolvedores podem realizar incluem:

Tarefa Informações de configuração
Registrar-se
Criar empresas Ativar o gerenciamento de empresas no portal
Convidar desenvolvedores para participar de empresas (e remover desenvolvedores de empresas) Ativar o gerenciamento de empresas no portal
Mudar as funções do usuário Configurar a monetização
Manter os próprios detalhes de faturamento, impostos, bancos e outros detalhes do perfil Configurar a monetização
Concordar com os Termos de Serviço Configurar os Termos de monetização no portal do desenvolvedor (opcional)
Registrar novos apps, selecionar os pacotes/planos de API que querem usar e acessar as chaves de API Configurar o registro de apps
Adicionar dinheiro (recargas) a contas pré-pagas Configurar a monetização
Gerar extratos e relatórios (faturamento e receita) Configurar a monetização

Exemplo de interações de autoatendimento no portal do desenvolvedor

Confira abaixo exemplos de interações de autoatendimento no portal do desenvolvedor:

  • Quando os desenvolvedores se registram no portal (clicando no link Registrar), eles fazem login automaticamente (a menos que você queira aprovar manualmente primeiro) e podem criar a própria empresa. Eles se tornam automaticamente um administrador de monetização da empresa e eles podem inserir todas as informações de perfil, faturamento e bancárias da empresa.

  • Quando os desenvolvedores navegam e realizam tarefas no portal do desenvolvedor (aceitando convites, registrando apps, e assim por diante), eles fazem isso no contexto da própria conta ou da associação da empresa. Há um menu suspenso para selecionar a empresa em que eles querem trabalhar. Por exemplo, se um usuário selecionar uma empresa e registrar um app, ele será de propriedade da empresa.

    Para gerenciar os detalhes da empresa (se tiverem direitos de administrador), os usuários selecionam Gerenciar empresas no menu suspenso e escolhem a empresa que querem gerenciar (ou o nome de usuário, se estiverem funcionando como um desenvolvedor independente).

  • Um administrador da empresa também pode convidar desenvolvedores para participar da empresa. Os desenvolvedores já precisam ter contas da Apigee. A figura a seguir mostra o campo "Convidar usuário" no portal do desenvolvedor, na página Configurações > Usuários da empresa.

  • Os desenvolvedores convidados recebem uma notificação por e-mail sobre o convite da empresa e podem fazer log in no portal para aceitar o convite na página "Gerenciar empresas", conforme mostrado na figura a seguir.

  • Os administradores da empresa podem cancelar convites para desenvolvedores na página Configurações > Usuários da empresa.
  • Os administradores da empresa podem mudar as funções dos desenvolvedores na página Configurações > Usuários da empresa. Por exemplo, eles podem tornar um desenvolvedor um administrador de monetização para permitir direitos de administração da empresa.

Ativar o gerenciamento de empresas no portal

Por padrão, a capacidade de gerenciar empresas está disponível no portal se você estiver usando o tema responsivo da Apigee. O menu suspenso "Empresa" poderá ficar oculto se você estiver usando a configuração de posição da barra de navegação superior fixa. Para garantir que o menu suspenso "Gerenciar empresas" seja exibido, mude para a configuração de posição da barra de navegação superior estática, da seguinte maneira:

  1. Faça login no portal do desenvolvedor como administrador.
  2. Selecione Aparência > Configurações > Apigee responsivo na barra de administração.
  3. Selecione Componentes em "Configurações do Bootstrap".
  4. Clique em Barra de navegação.
  5. Selecione Estático superior no menu suspenso "Posição da barra de navegação".
  6. Clique em Salvar configuração para salvar as alterações.

Se você estiver usando seu próprio tema personalizado, adicione o bloco "Mudar empresa" ao tema selecionando Estrutura > Blocos na barra de administração e arrastando o bloco Mudar empresa para a região desejada da página. Clique em Salvar blocos para salvar a configuração.