# Tinkay

> Plataforma de atención al cliente: Messenger embebible, Inbox para equipos, IA que resuelve con tu base de conocimiento, centro de ayuda y API REST.

La documentación completa en un solo archivo está en https://tinkay.app/docs/llms-full.txt

## Empezar

- [Introducción](https://tinkay.app/docs/introduccion): Qué es Tinkay, cómo está compuesto y por dónde empezar según lo que necesites.
- [Conceptos](https://tinkay.app/docs/conceptos): Workspace, token público, API key y dominios permitidos.
- [Instalación rápida](https://tinkay.app/docs/instalacion-rapida): El Messenger andando en cinco minutos, en cualquier sitio.

## Instalar el Messenger

- [JavaScript](https://tinkay.app/docs/javascript): El snippet universal para cualquier sitio HTML.
- [React](https://tinkay.app/docs/react): Cargar el loader una sola vez y sincronizar la identidad con tu estado de sesión.
- [Next.js](https://tinkay.app/docs/nextjs): App Router con next/script y identificación desde la sesión del servidor.
- [ASP.NET Core](https://tinkay.app/docs/aspnet-core): Razor Pages y MVC, con identificación desde los claims del usuario.
- [Blazor](https://tinkay.app/docs/blazor): Server y WebAssembly, con JS interop para identificar desde C#.
- [Angular](https://tinkay.app/docs/angular): Servicio inyectable que carga el loader y sincroniza la identidad.
- [Vue y Nuxt](https://tinkay.app/docs/vue-nuxt): Plugin de Nuxt o composable de Vue 3.
- [Laravel](https://tinkay.app/docs/laravel): Blade layout con identificación desde el usuario autenticado.
- [Django](https://tinkay.app/docs/django): Template base con context processor para el token y el usuario.
- [Ruby on Rails](https://tinkay.app/docs/rails): Layout ERB con credenciales cifradas e identificación del current_user.
- [WordPress](https://tinkay.app/docs/wordpress): Con el tema hijo o con un snippet en functions.php.
- [Shopify](https://tinkay.app/docs/shopify): En theme.liquid, con los datos del cliente logueado.
- [WooCommerce](https://tinkay.app/docs/woocommerce): Sobre WordPress, sumando datos de pedidos del cliente.
- [Webflow](https://tinkay.app/docs/webflow): Código personalizado antes del cierre del body.
- [Wix](https://tinkay.app/docs/wix): Mediante el gestor de código personalizado de Wix.
- [Squarespace](https://tinkay.app/docs/squarespace): Con la inyección de código del sitio.
- [PrestaShop](https://tinkay.app/docs/prestashop): En la plantilla del tema, con los datos del cliente.
- [Google Tag Manager](https://tinkay.app/docs/google-tag-manager): Instalarlo sin tocar el código del sitio.
- [Apps móviles](https://tinkay.app/docs/apps-moviles): Embeber el Messenger en una WebView de Flutter, React Native, Swift o Kotlin.

## Widget

- [API de JavaScript](https://tinkay.app/docs/widget-api): Opciones de configuración, métodos, eventos y el contrato de postMessage.

## API REST v1

- [API REST v1](https://tinkay.app/docs/api): Autenticación, formato de respuestas, errores, paginación y límites.
- [Convenciones de la API](https://tinkay.app/docs/api-convenciones): Paginación, filtros, expansión, límites, errores, idempotencia y versionado.
- [Contacts](https://tinkay.app/docs/api-contacts): Crear, listar y leer las personas que escriben a tu equipo.
- [Conversations](https://tinkay.app/docs/api-conversations): Leer conversaciones del Inbox y sus mensajes.
- [Messages](https://tinkay.app/docs/api-messages): Leer y enviar mensajes dentro de una conversación.
- [Tickets](https://tinkay.app/docs/api-tickets): Crear casos con SLA desde tu propio sistema.
- [Articles](https://tinkay.app/docs/api-articles): Leer los artículos del centro de ayuda.
- [Events](https://tinkay.app/docs/api-events): Feed de lo que pasó en el workspace.
- [Webhooks (API)](https://tinkay.app/docs/api-webhooks): Crear y listar suscripciones de webhook.
- [Teams y Members](https://tinkay.app/docs/api-teams): Equipos, integrantes, roles y disponibilidad.
- [Collections y Knowledge sources](https://tinkay.app/docs/api-knowledge): Colecciones del centro de ayuda y fuentes que alimentan a Tinkay AI.
- [Learned answers](https://tinkay.app/docs/api-learned-answers): Lo que Tinkay AI ya aprendió y responde sin llamar al modelo.
- [Automations e Integrations](https://tinkay.app/docs/api-automations): Flujos automáticos y apps conectadas.
- [Usage](https://tinkay.app/docs/api-usage): Consumo de IA, costo, ahorro por memoria y proyección del período.
- [Search](https://tinkay.app/docs/api-search): Búsqueda de texto libre en conversaciones, contactos, tickets y artículos.

## Eventos

- [Referencia de eventos](https://tinkay.app/docs/eventos): Los 147 eventos que emite Tinkay, con su payload y cuándo se disparan.
- [Eventos de conversaciones](https://tinkay.app/docs/eventos-conversation): Todo el ciclo de vida de una conversación: apertura, asignación, prioridad, etiquetas, SLA y cierre.
- [Eventos de mensajes](https://tinkay.app/docs/eventos-message): Cada mensaje que entra o sale, incluidas notas internas, entregas y lecturas.
- [Eventos de tinkay ai](https://tinkay.app/docs/eventos-ai): Lo que hace Tinkay AI: cuándo responde, con qué fuente, cuándo deriva, qué aprende y cuánto consume.
- [Eventos de tickets](https://tinkay.app/docs/eventos-ticket): Casos con seguimiento: creación, estado, responsable, SLA y resolución.
- [Eventos de contactos](https://tinkay.app/docs/eventos-contact): Personas que escriben: alta, identificación, atributos, segmentos y bajas.
- [Eventos de empresas](https://tinkay.app/docs/eventos-company): Empresas agrupadas a partir de sus contactos.
- [Eventos de conocimiento](https://tinkay.app/docs/eventos-knowledge): Artículos, colecciones, fuentes de conocimiento y brechas detectadas.
- [Eventos de datos de tu empresa](https://tinkay.app/docs/eventos-data): Los cuatro niveles con los que Tinkay lee datos de tu negocio: atributos firmados del Messenger, conectores HTTP en vivo, sincronización de clientes y acceso directo por réplica de solo lectura.
- [Eventos de equipo](https://tinkay.app/docs/eventos-team): Miembros, equipos, roles, disponibilidad y permisos.
- [Eventos de automatizaciones](https://tinkay.app/docs/eventos-automation): Ejecuciones de tus flujos, con sus pasos y errores.
- [Eventos de canales](https://tinkay.app/docs/eventos-channel): Canales y apps conectadas: altas, bajas y fallas de token.
- [Eventos de messenger](https://tinkay.app/docs/eventos-widget): Comportamiento del Messenger en el sitio del cliente.
- [Eventos de facturación](https://tinkay.app/docs/eventos-billing): Suscripción, facturas y límites de consumo.
- [Eventos de seguridad](https://tinkay.app/docs/eventos-security): API keys, webhooks, accesos y sesiones.
- [Eventos de workspace](https://tinkay.app/docs/eventos-workspace): Configuración general, dominios y publicaciones.

## Webhooks

- [Webhooks](https://tinkay.app/docs/webhooks): Recibir eventos firmados en tu servidor, con reintentos y verificación HMAC.
- [Verificar la firma](https://tinkay.app/docs/webhooks-firma): HMAC SHA-256 con el signing secret, en Node, C#, Python, PHP y Go.
- [Reintentos, orden y versionado](https://tinkay.app/docs/webhooks-fiabilidad): Cómo entregamos, qué garantizamos y cómo escribir un consumidor a prueba de fallas.

## Tinkay AI

- [Acciones de Tinkay AI](https://tinkay.app/docs/ai-acciones): Endpoints tuyos que la IA llama durante la conversación para responder con datos reales.
- [Fuentes de conocimiento](https://tinkay.app/docs/ai-fuentes): Qué usa Tinkay AI para responder y cómo mantenerlo actualizado.
- [Escalación](https://tinkay.app/docs/ai-escalacion): Cuándo la IA deja de responder y pasa la conversación a una persona.

## SDKs

- [SDK de C#](https://tinkay.app/docs/sdk-csharp): Cliente tipado para .NET 8 sobre HttpClient.
- [SDK de Node](https://tinkay.app/docs/sdk-node): Cliente para Node 20 y TypeScript.
- [SDK de Python](https://tinkay.app/docs/sdk-python): Cliente para Python 3.11 con requests.
- [SDK de PHP](https://tinkay.app/docs/sdk-php): Cliente para PHP 8.2 con Guzzle o curl.

## Guías

- [Migrar desde Intercom](https://tinkay.app/docs/migrar-desde-intercom): Conversaciones, contactos, artículos y el dominio del centro de ayuda.
- [Sincronizar contactos](https://tinkay.app/docs/sincronizar-contactos): Mantener tus usuarios y sus atributos alineados con Tinkay.
- [Crear tickets desde tu sistema](https://tinkay.app/docs/crear-tickets): Abrir casos en Tinkay cuando algo falla en tu producto.
- [Mostrar tus datos en el panel](https://tinkay.app/docs/datos-propios): Que tu equipo vea plan, uso y estado del cliente junto a la conversación.
- [Dominio propio para el centro de ayuda](https://tinkay.app/docs/dominio-propio): Publicar la ayuda en ayuda.tuempresa.com o el subdominio que elijas.
- [Seguridad](https://tinkay.app/docs/seguridad): Credenciales, dominios permitidos, CSP y datos sensibles.
- [Recibir eventos en tiempo real](https://tinkay.app/docs/eventos-en-tiempo-real): De cero a un consumidor de eventos en producción, con cola y reintentos.
- [Sincronizar tu CRM con webhooks](https://tinkay.app/docs/sincronizar-crm): Mantener contactos y empresas al día en los dos sentidos, sin polling.
- [Migrar de polling a webhooks](https://tinkay.app/docs/migrar-de-polling): Dejar de consultar la API cada minuto sin perder eventos en la transición.
- [Auditoría y cumplimiento](https://tinkay.app/docs/auditoria-cumplimiento): Llevar el registro de actividad a tu SIEM y responder pedidos de privacidad.
- [Construir una acción para Tinkay AI](https://tinkay.app/docs/accion-tinkay-ai): Exponer un endpoint propio para que la IA consulte tu sistema durante la conversación.
- [Usar tu propio proveedor de IA](https://tinkay.app/docs/proveedor-ia-propio): Conectar tu API de OpenAI, Anthropic, Azure o un modelo compatible.

## Opcional

- [Centro de ayuda de ejemplo](https://tinkay.app/help/tinkay): documentación de producto para usuarios finales.

## Blog

El índice del blog está en https://tinkay.app/blog y el feed en https://tinkay.app/blog/rss.xml.

### WhatsApp y costos

- [Qué cambia el 1 de octubre de 2026 en WhatsApp Business, y a quién le pega](https://tinkay.app/blog/whatsapp-business-1-octubre-2026): Desde el 1/10/2026 los mensajes de servicio y utilidad dentro de la ventana de 24 h se facturan. Tarifas estimadas para Argentina y a quién le pega.
- [Cuánto cuesta atender por WhatsApp en Argentina, con números](https://tinkay.app/blog/cuanto-cuesta-atender-por-whatsapp-argentina): Una consulta entrante cuesta USD 0,059 desde octubre de 2026. El modelo abierto, con supuestos, tarifas estimadas y la cuenta a la vista.
- [La ventana de 24 horas de WhatsApp, explicada sin vueltas](https://tinkay.app/blog/ventana-de-24-horas-whatsapp): La ventana se cuenta desde el último mensaje del cliente y dura 24 h. Qué podés mandar adentro, qué cuesta afuera y cómo no dejarla vencer.
- [Plantillas de WhatsApp: cuáles se cobran, cuáles no y por qué](https://tinkay.app/blog/plantillas-de-whatsapp-cuales-se-cobran): Las cuatro categorías de WhatsApp Business, qué cuesta cada una en Argentina y cómo evitar que una plantilla de utilidad se recategorice como marketing.

### Integraciones

- [Cómo conectar Tinkay con la base de datos de tu empresa](https://tinkay.app/blog/conectar-tinkay-con-tu-base-de-datos): Los cuatro niveles para que tu atención al cliente vea los datos de tu sistema, sin darle acceso a tu base de producción.

### Atención al cliente

- [Qué puede hacer una IA de atención al cliente que sabe quién le está escribiendo](https://tinkay.app/blog/ia-que-sabe-quien-le-escribe): La diferencia entre atender a un desconocido y atender a alguien de quien ya sabés el plan, el último pedido y el historial.
- [Qué mirar antes de elegir un software de atención al cliente](https://tinkay.app/blog/elegir-software-de-atencion-al-cliente): Modelo de precio, precio real en pesos, exportación de datos y las cinco cosas que hay que probar sí o sí antes de firmar.

### Producto

- [Cómo poner un centro de ayuda en tu propio dominio](https://tinkay.app/blog/centro-de-ayuda-en-tu-propio-dominio): tusitio.com/ayuda hereda la autoridad de tu dominio; ayuda.tusitio.com arranca de cero. Cómo se configura cada uno y cómo mudar con 301.