Tinkay

Introducción

Qué es Tinkay, cómo está compuesto y por dónde empezar según lo que necesites.

Tinkay es una plataforma de atención al cliente: un Messenger que instalás en tu sitio, un Inbox donde tu equipo responde, una IA que resuelve sola lo que ya está documentado y un centro de ayuda público.

Para integrarlo solo necesitás conocer cuatro piezas.

Las cuatro piezas

  • Messenger: un script de dos líneas que inyecta un botón flotante y un iframe aislado. No toca el CSS de tu sitio.
  • API REST v1: crear y leer contactos, conversaciones, mensajes, tickets y artículos desde tu backend.
  • Webhooks: eventos firmados que Tinkay envía a tu servidor cuando algo pasa.
  • Acciones de Tinkay AI: endpoints tuyos que la IA puede llamar durante una conversación para responder con datos reales.

Arquitectura

El loader (widget.js) corre en el sitio del cliente y solo hace tres cosas: pide la configuración pública, dibuja el botón y monta un iframe con la app del Messenger. Toda la lógica y los datos viven dentro del iframe, en el dominio de Tinkay.

Por eso el widget no puede romper tu sitio ni tu sitio puede leer las conversaciones: se comunican con postMessage sobre un contrato acotado.

Flujo
Tu sitio                    Tinkay--------                    ----widget.js  ──── GET /api/v1/widget/config?token=pk_live_xxx ───▶           ◀─── { branding, modules, navigation } ────────────  iframe   ──── app del Messenger (app.tinkay.app/widget) ──────▶           ◀─── postMessage: tinkay:ready / tinkay:unread ────────

Por dónde seguir