Header Ads Widget

Ticker

6/recent/ticker-posts

Reacciones al uso de la API de Twilio

 

reacciones-a-twilio-api-voicemail-integration-part-two

Dentro del espacio de API, Developer Experience (DX) es más importante que nunca . La mejor manera de medir la usabilidad de una API es a través de la implementación real con una integración.

En un artículo anterior Creación de un mejor correo de voz con Twilio , consumimos la API de Twilio para implementar un proyecto de correo de voz y comprender mejor cómo interactúa un desarrollador con su API. Logramos terminar el proyecto con poca dificultad y también nos dimos cuenta de lo poco que implica la codificación en todo el proceso.

Pero, ¿cómo fue la experiencia del desarrollador? largo de esta integración? ¿Qué tan útil, intuitivo o fácil fue el proceso de integración con Twilio? ¿Cuáles son las conclusiones de los proveedores de API que buscan mejorar sus portales para desarrolladores?

Ahora, en este artículo, examinaremos lo que Twilio está haciendo bien, así como las áreas que creemos que podrían mejorar. Si usted es un proveedor de API, considere este caso práctico como una extensión del mundo real de nuestras 5 funciones principales para considerar ofrecer a los desarrolladores . Comencemos examinando cómo se logra una integración con Twilio y qué funcionalidades se pueden exponer.

Para más información sobre DX, lea: 5 razones por las que los desarrolladores no utilizan su API

Twilio es más que una API web "estándar"

Twilio ofrece una API REST y también TwiML , un lenguaje de marcado de nivel superior que le permite programar interacciones con su servicio. Su API REST está más enfocada en acceder a información en su cuenta e iniciar actividad saliente, por ejemplo, hacer llamadas telefónicas y enviar SMS. Por otro lado, TwiML está completamente enfocado en escuchar acciones desencadenadas por eventos entrantes como recibir una llamada telefónica.

¿Por qué Twilio eligió usar un lenguaje propietario para manejar todos los ganchos de actividad entrantes cuando podían ofrecer la misma funcionalidad usando webhooks ? Una de las razones probablemente esté relacionada con su público objetivo. Al ofrecer un lenguaje de marcado basado en XML, pueden llegar a un mayor número de desarrolladores que no necesariamente desean implementar una API de recepción de webhooks. Además, al utilizar TwiML no necesita ningún servidor web o tecnología específicos. Simplemente tiene que hacer que su archivo XML esté disponible en línea.

Proceso de registro de 5 minutos

Registrarse en Twilio es relativamente sencillo, pero hay algunas cosas que podrían mejorarse fácilmente. Lo primero que nota es que durante el registro intentan validar su número de teléfono. Usan su propia tecnología para hacerlo mientras intentan enviarte un SMS o incluso llamar a tu teléfono. Si bien esto tiene sentido para los usuarios que desean usar su número de teléfono como identificador de llamadas, no es necesario para todos los demás casos de uso.

Después de este proceso de verificación inicial, Twilio te ofrece un número de teléfono gratuito para que puedas probar el servicio. En realidad, esta es una buena decisión porque puede usar el servicio de inmediato. Lo malo, al menos durante la implementación de nuestro proyecto de correo de voz , es que no puede usar este número para recibir llamadas telefónicas. En algunos casos, sería útil tener un número que pudiera, al menos, recibir llamadas telefónicas desde el inicio.

Incluso sin la capacidad de realizar y recibir llamadas telefónicas, Twilio ya ofrece mucho más que la mayoría de las API. En menos de 5 minutos , pudimos establecer un número de teléfono real para enviar y recibir SMS y probar su API. Otros proveedores de API deberían considerar el proceso de registro fluido de Twilio como un modelo para la incorporación rápida y la retención inicial del consumidor.

Entonces, ¿qué se necesita para manejar realmente esos mensajes y llamadas entrantes? Siga leyendo para comprender cómo es interactuar con Twilio.

Consulte también: Por qué la estrategia de API debe equilibrar la experiencia del usuario y el desarrollador

Infraestructura relativamente simple

Una gran parte de la interacción con Twilio tiene que ver con la capacidad de servir archivos XML estáticos o generados. Todos sus eventos entrantes le permiten especificar las URL a las que se llamará cada vez que se active un evento. Por ejemplo, cada vez que alguien llama a su número de Twilio, se realiza una llamada a lo que llaman la URL de voz . Se POSTpasan varios parámetros a esa URL y Twilio espera recibir una respuesta TwiML que defina cómo se manejará la llamada.

Esto significa que debe poder alojar esos archivos TwiML en algún lugar. Si bien en la mayoría de las situaciones pueden ser archivos estáticos, hay casos en los que querrá generar dinámicamente la respuesta en función de uno de los POSTparámetros. Un buen ejemplo es programar una reacción para cuando alguien graba un mensaje de voz. Probablemente desee realizar una acción basada en el número de teléfono de la persona que llama y también acceder a la grabación de voz.

Para alojar archivos estáticos, puede utilizar cualquier servicio de almacenamiento en la nube que le permita alojar el contenido de los archivos sin procesar. GitHub y Dropbox son buenos candidatos porque puede generar fácilmente URL para sus archivos almacenados. Para alojar scripts dinámicos, necesitará un servidor web capaz de recibir HTTP POSTsolicitudes, analizar los datos entrantes y crear dinámicamente una respuesta XML. Esto se puede lograr fácilmente utilizando un lenguaje de programación popular como PHP y alojando su código en un servicio como Heroku .

Funciones de prueba e informes

Twilio ofrece una serie de herramientas de prueba y generación de informes para facilitarle la vida al implementar y depurar su integración. Una de estas herramientas, App Monitor, le permite analizar los errores en detalle, incluida la información de la solicitud. Puede revisar fácilmente qué solicitudes están generando errores, inspeccionar sus cargas útiles e incluso reproducir solicitudes durante la depuración. Esto es realmente útil durante el proceso de experimentación y un salvavidas cuando algo sale mal más adelante.

También ofrecen una herramienta de informes completa que le permite inspeccionar información relacionada con diferentes eventos:

  • Llamadas : un registro de llamadas completo que incluye la dirección de la llamada (entrante o saliente), identificadores de llamadas, duración y eventuales grabaciones de voz.
  • Mensajes : un informe de todos los mensajes SMS enviados y recibidos, incluido su cuerpo y la identificación de la persona que llama.
  • Grabaciones : todas las grabaciones de voz jamás realizadas, incluida su duración y fácil acceso a la llamada asociada.

Ofrecer una herramienta de informes tan detallada es muy importante porque crea un sentido de responsabilidad y le permite analizar y depurar rápidamente cualquier implementación defectuosa.

¿Es Twilio un proveedor de API de ejemplo a seguir?

Con sus herramientas orientadas al desarrollador y su facilidad de uso, Twilio es un gran servicio para que lo modelen otros proveedores de API. Es interesante ver el esfuerzo que han puesto en sus herramientas de informes, que ofrecen un nivel de detalle muy fino. Su proceso de registro también es algo a seguir, aunque podría mejorarse ligeramente al permitir un número de teléfono gratuito para recibir llamadas.

Después de leer este artículo, debería tener una comprensión más clara de lo que funciona y lo que no al ofrecer productos orientados a desarrolladores como Twilio. Nuestras principales conclusiones del uso de la API de Twilio fueron:

  1. Ofrecen un proceso de registro sencillo .
  2. Inmediatamente tendrá una caja de arena para probar su integración.
  3. Su documentación es completa y completa.
  4. Es fácil solucionar problemas de llamadas accediendo a sus herramientas de informes.
  5. Se relacionan con los desarrolladores utilizando diferentes canales de comunicación .

Estos también son los 5 puntos a los que debe prestar atención al lanzar su API.

¿Has estado usando Twilio últimamente? ¿Qué opinas de su API? ¡Deje un comentario aquí o póngase en contacto para discutir esto más!

Publicar un comentario

0 Comentarios