Developer Experience
15
min de leitura
29 de setembro de 2020

Desenho de fluxo de Onboarding do Desenvolvedor

Luciana Bandeira
Developer Experience
Ajudo desenvolvedores no onboarding e nas melhores práticas de APIs para garantir a melhor Developer Experience. No meu tempo livre me dedico a livros, pesquisar (e degustar) sobremesas e sou apaixonada por viajar.
Mais sobre o autor

Quando as APIs estão disponíveis para consumo pelos desenvolvedores, um dos primeiros pontos a serem considerados é o fluxo do desenvolvedor onboarding, tornando assim a experiência do usuário com as APIs disponíveis mais clara e objetiva. Na equipe de Developer Experience, que apoia clientes e parceiros neste contato inicial com as APIs, temos como uma visão geral o seguinte fluxo para uma compreensão inicial da jornada do usuário:

Cada um desses pilares reflete uma ação do desenvolvedor, seja através do uso do Portal do Desenvolvedor ou no processo inicial de utilização das APIs reais.

Oboarding do desenvolvedor

Neste primeiro passo, é o momento de reconhecer e ler informações e insumos para uma melhor compreensão, como por exemplo:

- Acesso ao portal.

- Análise de documentação.

- Registro do desenvolvedor no portal, para acessar a documentação potencialmente restrita e iniciar a segunda etapa (abaixo).

Consumo

É a primeira experiência do desenvolvedor utilizando as APIs disponíveis e o momento de validar o entendimento do que foi inicialmente verificado, focando na usabilidade e acessos de:

- Criação da chave de acesso (app e token).

- Execução/utilização das APIs disponíveis, tanto diretamente através do Portal (se aplicável) como iniciando seu próprio desenvolvimento com testes.

- Controle sobre as chamadas API dashboard. Assim, o desenvolvedor pode identificar as chamadas feitas em um período específico no Portal e apoiá-las na identificação e validação de seu próprio desenvolvimento.

Rodar

A partir deste ponto, entendemos que o desenvolvedor já é capaz de iniciar o fluxo de usuários para as APIs e compreende plenamente o uso e as normas internas bem projetadas de acordo com as regras de uso.

Apoio

Além de mapear toda a experiência do usuário, incluindo informações de suporte e guias de desenvolvimento, também é necessário fornecer um canal de suporte. Assim, a qualquer momento (tanto no desenvolvedor onboarding como posteriormente no uso em produção), o desenvolvedor terá um canal direto com suporte API especializado para responder perguntas e/ou lidar com problemas/dificuldades que possam aparecer durante o uso.

Além destes pontos, é importante estar sempre alinhado com os novos desenvolvimentos de APIs e trazer estes assuntos para o onboarding e processos de uso do desenvolvedor.

As mudanças podem refletir a necessidade de uma nova perspectiva para entender o fluxo do desenvolvedor onboarding , além de identificar esforços em ajustes potenciais.

Portanto, há uma necessidade:

- Melhorias constantes no Portal do Desenvolvedor junto com a documentação.

- Swagger atualizações e guias de desenvolvimento.

E se houver alguma mudança nas APIs já utilizadas, também é necessário prestar atenção à necessidade de comunicação. Portanto, esteja em contato com os desenvolvedores para alinhar o uso de novas revisões, versões ou mudanças implementadas para processos. Já falamos em outros posts sobre a importância de garantir uma boa experiência para os desenvolvedores; afinal, eles também fazem parte de sua carteira de clientes. O processo onboarding é extremamente importante para que os desenvolvedores iniciem sua jornada com as melhores impressões. É como diz o ditado: "As primeiras impressões são impressões duradouras".

Se você quiser saber mais sobre a Sensedia Developer Experience , entre em contato conosco. Nossos especialistas estão aqui para responder a todas as suas perguntas.

Obrigado pela leitura!