Laravel

Blade layout con identificación desde el usuario autenticado.

Antes de empezar

  • Laravel 10 o superior con un layout Blade compartido

1. Variable de entorno

.env
TINKAY_MESSENGER_TOKEN=pk_live_xxx

2. Componente Blade

resources/views/components/tinkay.blade.php
@php    $settings = ['token' => config('services.tinkay.token')];    if (auth()->check()) {        $settings['visitor'] = [            'email' => auth()->user()->email,            'name' => auth()->user()->name,            'plan' => auth()->user()->plan ?? 'Free',            'created_at' => auth()->user()->created_at->toDateString(),        ];    }@endphp<script>    window.TinkaySettings = @json($settings);</script><script src="https://cdn.tinkay.app/widget.js" async></script>

@json escapa el contenido correctamente: no armes el objeto concatenando strings.

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.
  • El token queda vacío: corré php artisan config:clear después de editar el .env.

Cómo saber que quedó bien

  • El botón aparece en las vistas que extienden el layout
  • Con sesión iniciada el Inbox muestra al usuario