Sincronizar contactos

Mantener tus usuarios y sus atributos alineados con Tinkay.

Estrategia recomendada

No sincronices en bloque cada noche. Hacé dos cosas: identificá en el navegador a quien usa tu producto y empujá cambios desde el backend cuando pasa algo relevante (upgrade, baja, cambio de plan).

En el navegador

JavaScript

window.Tinkay.identify({  email: user.email,  name: user.fullName,  plan: user.plan,  company: user.company,  created_at: user.createdAt,  seats: user.seats,});

Esto crea el contacto si no existe y actualiza los atributos si ya existía. Para la mayoría de los productos alcanza con esto.

Desde el backend

Cuando cambia algo importante fuera de la sesión (un pago, una baja), empujalo por API.

public async Task SyncContactAsync(User user){    var payload = new    {        name = user.FullName,        email = user.Email,        company = user.Company,        tags = user.IsChurnRisk ? new[] { "riesgo" } : Array.Empty<string>(),        custom_fields = new { plan = user.Plan, mrr = user.Mrr, seats = user.Seats }    };    var res = await http.PostAsJsonAsync("https://api.tinkay.app/v1/contacts", payload);    // 409 significa que ya existe: no es un error para una sincronización.    if (res.StatusCode is not (HttpStatusCode.Created or HttpStatusCode.Conflict))        res.EnsureSuccessStatusCode();}

Carga inicial

Para la primera importación, usá el CSV de Contactos, Importar CSV: valida, muestra una vista previa y detecta duplicados por email.

Cómo saber que quedó bien

Un usuario nuevo aparece en Tinkay en menos de un minuto
Los atributos se ven en el panel del contacto