Developer Experience
15
min de lectura
29 de septiembre de 2020

Diseño de flujo de Onboarding del Desarrollador

Luciana Bandeira
Developer Experience
Ayudo a los desarrolladores con onboarding y las mejores prácticas de la API para garantizar la mejor Developer Experience . En mi tiempo libre me dedico a los libros, a investigar (y probar) postres y me apasiona viajar.
Más sobre el autor

Cuando las API están disponibles para el consumo de los desarrolladores, uno de los primeros puntos a tener en cuenta es el flujo de onboarding para los desarrolladores, lo que hace que la experiencia del usuario de las API disponibles sea más clara y objetiva. En el equipo de Experiencia del Desarrollador, que apoya a los clientes y socios en este contacto inicial con las API, tenemos como visión general el siguiente flujo para una comprensión inicial del viaje del usuario:

Cada uno de estos pilares refleja una acción del desarrollador, ya sea a través del uso del Portal del Desarrollador o en el proceso inicial del uso de las API reales.

Onboarding del desarrollador

En este primer paso, es el momento de reconocer y leer la información y los aportes para una mejor comprensión, tales como:

- Acceso al portal.

- Análisis de la documentación.

- Registro de desarrolladores en el portal, para acceder a la posible documentación restringida e iniciar el segundo paso (abajo).

Consumo

Es la primera experiencia del desarrollador utilizando las API disponibles y el momento de validar la comprensión de lo que se verificó inicialmente, centrándose en la usabilidad y los accesos de:

- Creación de claves de acceso (app y token).

- Ejecución/uso de las API disponibles, tanto directamente a través del Portal (si procede) como iniciando su propio desarrollo con pruebas.

- Control de las llamadas API dashboard. De esta manera, el desarrollador puede identificar las llamadas realizadas en un período específico en el Portal y apoyarlas en la identificación y validación de su propio desarrollo.

Run

A partir de este punto, entendemos que el desarrollador ya es capaz de iniciar el flujo de usuarios para las API y comprende plenamente el uso y las normas internas bien diseñadas de acuerdo con las reglas de uso.

Soporte

Además de trazar el mapa de toda la experiencia del usuario, incluida la información de apoyo y las guías de desarrollo, también es necesario proporcionar un canal de apoyo. Así pues, en cualquier momento (tanto en el desarrollador onboarding como posteriormente en el uso en producción), el desarrollador dispondrá de un canal directo con apoyo especializado de la API para responder a las preguntas y/o abordar los problemas/dificultades que puedan surgir durante el uso.

Además de estos puntos, es importante estar siempre en línea con los nuevos desarrollos de las APIs y llevar estas cuestiones a los procesos de uso de onboarding y de los desarrolladores.

Los cambios pueden reflejar la necesidad de una nueva perspectiva para comprender el flujo de onboarding de los desarrolladores, además de identificar los esfuerzos en los posibles ajustes.

Por lo tanto, hay una necesidad de:

- Constantes mejoras en el Portal del Desarrollador junto con la documentación.

- Actualizaciones del swagger y las guías de desarrollo.

Y si hay algún cambio en los API ya utilizados, también hay que prestar atención a la necesidad de comunicación. Por lo tanto, póngase en contacto con los desarrolladores para alinear el uso de nuevas revisiones, versiones o cambios implementados para los procesos. Ya hemos hablado en otros posts sobre la importancia de asegurar una buena experiencia para los desarrolladores; después de todo, ellos también forman parte de su cartera de clientes. El proceso de onboarding es sumamente importante para que los desarrolladores inicien su viaje con las mejores impresiones. Es como dice el dicho: "La primera impresión es la que perdura".

Si quieres saber más sobre Sensedia Developer Experience , contáctanos. Nuestros expertos están aquí para responder a todas sus preguntas.

¡Gracias por leer!