Si tus clientes viven en otro sistema (tu tienda online, un CRM, un ERP, una planilla que se actualiza sola), puedes copiarlos a MINDO 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.
name solo cambia si lo mandas. Si no lo incluyes, queda como estaba.
- 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, MINDO 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 el atributo
categoria).
Si tu plataforma avisa con webhooks (Tiendanube, Shopify y WooCommerce lo hacen), conecta esos avisos a una función como sincronizar().
Y al revés: de MINDO 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.