Si tus clientes viven en otro sistema (tu tienda online, un CRM, un ERP, una planilla que se actualiza sola), puedes copiarlos a eltick con la API. Así armas segmentos con datos siempre frescos: “compraron en los últimos 30 días”, “viven en Córdoba”, “clientes VIP”.

Cómo funciona POST /contacts

Un solo endpoint crea o actualiza, según si el teléfono ya existe:
  • Responde 201 si lo creó y 200 si ya existía y lo actualizó.
  • attributes se combina: solo cambian las claves que mandas; el resto queda igual.
  • tags reemplaza la lista entera. Si mandas ["vip"], el contacto queda solo con vip.
  • name y tags solo cambian si los mandas. Si no los incluyes, quedan como estaban.
  • Un atributo que todavía no existe se crea como campo de texto. Desde ese momento puedes filtrar por él y usarlo como variable en tus plantillas.
Los valores de attributes siempre son texto: manda "45000", no 45000. Si el campo es de tipo número o fecha en Contactos › Campos, eltick lo convierte al guardarlo. Para fechas, usa AAAA-MM-DD.

Carga inicial

Recorre tus clientes y manda uno por uno. Es seguro volver a correrlo: los que ya existen solo se actualizan.
¿Son muchos miles y es una sola vez? Es más rápido exportarlos a Excel o CSV e importarlos desde la app. Usa la API para mantenerlos al día después.

Mantenerlos al día

Después de la carga inicial, llama a POST /contacts cada vez que algo cambia en tu sistema:
  • Se registra un cliente nuevo.
  • Un cliente hace una compra (actualiza ultima_compra y total_gastado).
  • Cambia de categoría (por ejemplo, pasa a VIP: actualiza tags).
Si tu plataforma avisa con webhooks (Tiendanube, Shopify y WooCommerce lo hacen), conecta esos avisos a una función como sincronizar().

Sumar una etiqueta sin perder las demás

Como tags reemplaza la lista, primero lee el contacto y después manda la lista combinada:

Y al revés: de eltick a tu sistema

Límite de contactos

Cada plan tiene un máximo de contactos. Si al crear uno nuevo te pasas, la API responde 402 con cause.reason: "limit". Actualizar contactos existentes siempre funciona.