Migrar desde Intercom
Conversaciones, contactos, artículos y el dominio del centro de ayuda.
Antes de empezar
- Acceso de administrador en Intercom
- Un workspace de Tinkay creado
1. Exportar desde Intercom
- En Intercom, entrá a Settings, Data, Export y pedí la exportación de contactos y conversaciones.
- Descargá los artículos del Help Center desde Articles, Export.
- Anotá el dominio del centro de ayuda actual y la lista de URLs publicadas.
2. Importar contactos
Podés subir el CSV desde Contactos, Importar CSV o hacerlo por API si necesitás mapear atributos propios.
JavaScript
import { parse } from "csv-parse/sync";import { readFileSync } from "node:fs";const rows = parse(readFileSync("intercom-contacts.csv"), { columns: true });for (const row of rows) { const res = await fetch("https://api.tinkay.app/v1/contacts", { method: "POST", headers: { Authorization: `Bearer ${process.env.TINKAY_API_KEY}`, "Content-Type": "application/json", }, body: JSON.stringify({ name: row.name, email: row.email, company: row.company, tags: row.tags ? row.tags.split(",") : [], custom_fields: { intercom_id: row.id, signed_up_at: row.signed_up_at }, }), }); if (res.status === 409) continue; // ya existía if (!res.ok) console.error(row.email, await res.text());}Guardá el id de Intercom en custom_fields: sirve para reconciliar si tenés que repetir la importación.
3. Migrar el centro de ayuda
Creá las colecciones equivalentes en Conocimiento, Colecciones y publicá los artículos manteniendo el mismo slug. Así las URLs viejas siguen funcionando.
Después apuntá tu dominio (por ejemplo help.tuempresa.com) a Tinkay con un CNAME hacia tinkay.help. Ver dominio propio.
4. Cambiar el widget
Sacá el snippet de Intercom y poné el de Tinkay en el mismo lugar. Podés convivir unos días, pero no conviene: los clientes ven dos burbujas.
HTML
<!-- quitar --><script>window.intercomSettings = { app_id: "abc123" };</script><!-- poner --><script>window.TinkaySettings = { token: "pk_live_xxx" };</script><script src="https://cdn.tinkay.app/widget.js" async></script>5. Ventana de migración
- Hacelo un viernes a la tarde: el volumen baja y tenés el fin de semana de colchón.
- Dejá las conversaciones abiertas de Intercom hasta cerrarlas ahí; las nuevas entran por Tinkay.
- Avisale al equipo el día anterior y dejá el Inbox de Tinkay abierto en paralelo.
Cómo saber que quedó bien
- Los contactos aparecen en Tinkay con sus atributos
- Los artículos conservan sus URLs
- El widget viejo ya no carga
