Tinkay

Django

Template base con context processor para el token y el usuario.

Antes de empezar

  • Django 4 o superior con un template base

1. Configuración

settings.py
import osTINKAY_MESSENGER_TOKEN = os.environ.get("TINKAY_MESSENGER_TOKEN", "")

2. Template base

templates/base.html
{% load static %}    <script>      window.TinkaySettings = {        token: "{{ tinkay_token }}"{% if user.is_authenticated %},        visitor: {          email: "{{ user.email|escapejs }}",          name: "{{ user.get_full_name|escapejs }}"        }{% endif %}      };    </script>    <script src="https://cdn.tinkay.app/widget.js" async></script>  </body></html>

Usá siempre el filtro escapejs en los valores del usuario para evitar romper el JavaScript.

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 aparece en las páginas que extienden `base.html`
  • El Inbox muestra al usuario logueado