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
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.