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

  1. En Intercom, entrá a Settings, Data, Export y pedí la exportación de contactos y conversaciones.
  2. Descargá los artículos del Help Center desde Articles, Export.
  3. 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