Detrás de escena: Tu widget, a tu manera con la API de JavaScript

La API de JavaScript te permite crear automatizaciones y personalizaciones ilimitadas para tu widget tawk.to. En esta conversación con Mārtiņš, ingeniero principal de backend en tawk.to, descubre algunos de los casos de uso más populares de la API de JS y aprende a evitar los errores más comunes. También obtendrás una vista previa de lo que está por venir para la API en tawk.to y la oportunidad de obtener acceso ahora.

1 - ¿Qué es una API y qué puede hacer?

API son las siglas de Application Programmable Interface (Interfaz Programable de Aplicaciones). Es un medio para que dos aplicaciones de software diferentes se comuniquen entre sí. En este caso, para la API de JavaScript en particular, se utilizaría en el sitio web en el que se encuentra el widget para influir y controlar el comportamiento del mismo y sus diferentes aspectos.

2 - ¿Cuáles son algunos de los beneficios de usar la API de JavaScript tawk.to?

Con la API de JavaScript, hay cosas que puedes hacer que de otra manera podrían resultar difíciles de realizar cuando respondas a un chat en el tablero o a eventos en tu sitio web. Por ejemplo, puedes maximizar el widget desde el JavaScript de tu sitio web, o minimizarlo si es necesario.

Un caso de uso común es tener un botón que diga "Contáctanos" con el widget totalmente oculto hasta que se haga clic en el botón. Para hacer esto, deberías configurar el widget para que esté oculto en la carga inicial. Luego, simplemente maximizarías el widget y lo harías visible cuando se haga clic en el botón "Contáctanos".

También puedes reaccionar al widget de diferentes maneras. Podemos configurar eventos, por ejemplo, cuando el widget está cargado, maximizado o minimizado. Puedes modificar el contenido de tu sitio web en función del estado del widget. Realmente, la imaginación es el límite de lo que podrías hacer.

3 - ¿Podemos reemplazar la ID del usuario predeterminado con el nombre y el correo electrónico del visitante?

Ese es definitivamente uno de los casos de uso comunes. Hay un par de formas de hacerlo.

Digamos que tienes un CRM y ya tienes estos datos disponibles. Lo que puedes hacer es añadir propiedades para el nombre y el correo electrónico a un objeto visitante. A medida que el widget se inicia, automáticamente recogerá esta información y la enviará a tawk.to. Así puedes ver inmediatamente el nombre y el correo electrónico de tu visitante.

Si el widget ya está en funcionamiento, es decir, si ya se ha cargado, lo que puedes hacer, y esto nos lleva a otra función interesante, es que puedes establecer el nombre y el correo electrónico del visitante como atributos. Y no sólo estás limitado al nombre y al correo electrónico. Podrías establecer muchos atributos. Digamos que quieres establecer el plan que tiene tu cliente actualmente. Ese podría ser un atributo personalizado. Éstos se mostrarán en la barra lateral de tu chat en la pestaña Detalles.

4 - ¿Podemos agregar un número de teléfono con la API de JavaScript?

Establecerías un atributo titulado "teléfono". Actualmente, no contamos con soporte telefónico explícito. Como tal, puedes configurarlo como un atributo de texto. Tenemos algo nuevo y emocionante en camino, nuestro nuevo CRM, donde podrás configurar el teléfono. Podrás configurar varios correos electrónicos y números de teléfono y hay muchas funciones interesantes más. No quiero mostrar demasiado nuestras cartas todavía, pero está muy cerca y estamos muy emocionados por ello, lo que hará que la función de atributos sea aún más útil y poderosa.

5 - ¿Cuáles son los errores comunes que cometen las personas al utilizar la API de JavaScript?

Uno de los errores más comunes que vemos es que la gente intenta que la API haga cosas antes de que la API esté lista para aceptar comandos y enviar eventos.

Por eso, tenemos un evento que se llama onLoad. El error común es que las personas intentan enviar inmediatamente comandos que le dicen al widget que se minimice o maximice y luego se preguntan por qué no funcionan cuando el widget en sí y la API subyacente aún no se han cargado.

El segundo error que veo con mayor frecuencia es habilitar el modo seguro sin comprender realmente lo que hace el modo seguro y los requisitos previos necesarios para que funcione.

6 - ¿Hay una API REST disponible en tawk.to?

Tenemos una beta privada de la API Rest que actualmente está disponible para nuestros socios. Si eres un socio y estás interesado en acceder a la API REST, sólo tienes que ponerte en contacto con tu representante más cercano.

La API Rest está más orientada a realizar acciones en nombre de un agente. Si la API JavaScript está pensada puramente para controlar el widget en tu sitio web, entonces la API Rest está orientada a realizar acciones como un agente. Tenemos muchas cosas útiles allí ahora. Seguimos expandiéndola. Pero en este momento, los casos de uso comunes que vemos son crear propiedades para tus clientes, invitarlos automáticamente y leer el historial de conversaciones.

También puedes hacer cosas como administrar webhooks y tu base de conocimientos a través de la API REST. Entonces, digamos que creas la propiedad para tu cliente y deseas algunas entradas básicas de la Base de Conocimientos creadas desde el principio. Eso es algo que puedes automatizar con la API REST.

Y si tienes un caso de uso realmente interesante, háznoslo saber y veremos si nuestra API Rest es adecuada para ti.

Ve nuestra Documentación de la API de JavaScript en la Plataforma de Desarrolladores de tawk.to.

Solicita acceso a la API REST aquí: Obtén acceso beta a la API REST