JavaScript

El snippet universal para cualquier sitio HTML.

Antes de empezar

  • Acceso al HTML del sitio
  • El token público del workspace

Dónde va

Justo antes de </body>, en todas las páginas donde quieras el Messenger.

index.html
<script>  window.TinkaySettings = { token: "pk_live_xxx" };</script><script src="https://cdn.tinkay.app/widget.js" async></script>

Identificar al usuario

Si tu sitio tiene sesión, pasá los datos de la persona apenas los tengas disponibles.

JavaScript
<script>  window.TinkaySettings = {    token: "pk_live_xxx",    visitor: {      email: "[email protected]",      name: "Camila Rodríguez",      plan: "Pro",    },  };</script><script src="https://cdn.tinkay.app/widget.js" async></script>

También podés llamar a window.Tinkay.identify({ ... }) más tarde, por ejemplo después de un login por AJAX.

Abrirlo desde tu propio botón

Ocultá el lanzador y controlá la apertura desde cualquier elemento de tu página.

JavaScript
window.TinkaySettings = { token: "pk_live_xxx", hideLauncher: true };document.querySelector("#soporte").addEventListener("click", function () {  window.Tinkay.open();});

Verificar la instalación

Entrá a Configuración, Instalación en tu workspace, pegá la URL pública del sitio y tocá Probar instalación. Tinkay busca el script y valida que el dominio esté permitido.

  1. Abrí tu sitio en una pestaña nueva y confirmá que aparece el botón flotante.
  2. En la consola del navegador, escribí window.Tinkay y verificá que devuelve un objeto.
  3. Escribí un mensaje de prueba y confirmá que llega al Inbox.

Errores frecuentes

  • El widget no aparece: el dominio no está en Configuración, Dominios. Agregalo y recargá.
  • Aparece en desarrollo pero no en producción: agregá también el dominio de producción, incluida la variante con www.
  • Content Security Policy: permití https://cdn.tinkay.app en script-src y https://app.tinkay.app en frame-src y connect-src.

Cómo saber que quedó bien

  • El botón flotante aparece en el sitio
  • `window.Tinkay` existe en la consola
  • Un mensaje de prueba llega al Inbox