Webchatclient API
Es posible embeber el webchatclient de uContact mediante la adición de los siguientes scripts en su sitio o aplicación web. Para embeber el Webchat en un sitio web creado con WordPress consultar el siguiente enlace: Cliente Webchat
<script src="https://example.ucontactcloud.com/webchatclient/integrawebchat.js"></script>
<script>
initwebchat({
ip: "example.ucontactcloud.com",
campaign: "nombreCampaña",
buttonMessage: "Chatea con Nosotros!"
});
</script >
example.ucontactcloud.com
hace referencia a la dirección de la instancia de uContact, se deberá sustituir con la dirección en donde se encuentra la campaña.
buttonMessage
mensaje flotante que se desplegará arriba del botón de abrir el chat, puede colocarse un texto o HTML. Si no se envía el parámetro, no se mostrará.
Los scripts y la conexión del webchatclient van a apuntar directamente al servidor de uContact. En caso de que la instancia de uContact se encuentre en sitio y no en la nube hay que asegurarse de:
Habilitar el puerto 443 para la conexión HTTPS hacia uContact.
Habilitar el puerto 8089 TCP (señalización SIP por websocket) hacia el servidor de telefonía para poder realizar llamadas.
La página o aplicación web deben usar HTTPS para poder realizar llamadas. Esto es debido a las restricciones de los navegadores cuando no se usa encriptación.
Uso de los métodos
La ejecución del método initwebchat
devuelve una instancia de un objeto a cuál es posible ejecutarle algunos métodos.
<script src="https://example.ucontactcloud.com/webchatclient/integrawebchat.js"></script>
<script>
let chat = initwebchat({
ip: "example.ucontactcloud.com",
campaign: "nombreCampaña",
buttonMessage: "Chatea con Nosotros!"
});
chat.startInteraction('John', 'johndoe@company.com', 'Hi there!!', '+59898765432');
</script >
Método | Parámetros | Descripción |
---|---|---|
|
| Permite ocultar o mostrar el chat según sea el estado |
| message | Muestra al usuario final un mensaje. Al clickear en el botón del webchat el mensaje desaparece. |
| name, email, message, number | Con los datos proporcionados inicia una nueva interacción. Hay que tener en cuenta que este método no tiene en cuenta si se había iniciado alguna previamente. |
|
| Al ejecutar este método el webchatclient envía a uContact la URL y el título de la página en ese momento para que el agente la pueda visualizar. El mismo comportamiento se tiene por defecto cuando se recarga una página. Este método es útil para aplicaciones o páginas SPA (single page application). |