# Clientify

## ¿Qué es Clientify?

Clientify es un CRM hispanohablante orientado a equipos de ventas. La integración con Anunzi te permite que cada lead que llega por un formulario web aparezca automáticamente como contacto en Clientify, sin que tengas que hacer nada.

***

## ¿Qué hace la integración?

Cada vez que alguien completa un formulario en uno de tus sitios web de Anunzi:

1. Anunzi crea el lead en tu cuenta (como siempre).
2. Anunzi envía el contacto a Clientify de forma inmediata y automática.
3. El contacto aparece en Clientify con nombre, email, teléfono y los campos adicionales que hayas mapeado.

No necesitas Make, Zapier ni ningún intermediario. La conexión es directa entre Anunzi y la API de Clientify.

***

## Cómo activarla

### 1. Obtén tu API key de Clientify

Accede a tu cuenta de Clientify → **Configuración** → **API** → copia tu token de acceso.

### 2. Conéctala en Anunzi

1. En el panel, ve a **Integraciones** → **Clientify** → **Conectar**.
2. Pega tu API key.
3. Elige la versión de API:
   * **V1** (recomendada) — para la mayoría de las cuentas.
   * **V2** — para cuentas con acceso a la nueva API Plus de Clientify.
4. Haz clic en **Probar conexión** para verificar que las credenciales son correctas.
5. Activa el evento **Lead creado — Formulario web**.
6. Guarda la configuración.

A partir de este momento, cada formulario enviado en tus sitios web creará el contacto en Clientify.

***

## Datos que se sincronizan

| Campo de Anunzi                     | Campo en Clientify       |
| ----------------------------------- | ------------------------ |
| Nombre (primer parte)               | `first_name`             |
| Apellido (segunda parte del nombre) | `last_name`              |
| Email                               | `email`                  |
| Teléfono                            | `phone`                  |
| Nombre de empresa ¹                 | `company`                |
| Mensaje / consulta ¹                | `description`            |
| Fuente                              | `contact_source: Anunzi` |
| Campos adicionales                  | Tags o `custom_fields`   |

> El nombre se divide automáticamente: "María García" → first\_name: María, last\_name: García.
>
> ¹ Detección automática: si el formulario tiene un campo cuyo nombre o placeholder incluye palabras como *empresa*, *company*, *organización*, *mensaje*, *message* o *consulta*, su valor se envía directamente al campo estándar de Clientify — sin necesidad de configurar ningún mapeo.

***

## Campos adicionales del formulario

Si tus formularios tienen campos más allá de nombre, email y teléfono, Anunzi los procesa en este orden:

### Campos auto-detectados → Campos estándar de Clientify

Anunzi reconoce automáticamente los campos de **empresa** y **mensaje** aunque no estén mapeados:

* Un campo cuyo nombre/placeholder contenga *empresa*, *company* u *organiz* → va a `company` en Clientify.
* Un campo cuyo nombre/placeholder contenga *mensaje*, *message*, *consulta*, *notas* o *descripcion* → va a `description` en Clientify.

No necesitas configurar nada extra para que esto funcione.

### Sin mapeo → Etiqueta

El valor del campo se envía como **etiqueta (tag)** en Clientify. Por ejemplo, si el campo `cargo` tiene el valor "Directora", Clientify recibirá la etiqueta `Directora`.

### Con mapeo → Campo personalizado

Si en Clientify tienes campos personalizados definidos (como "Cargo", "Tipo de consulta"), puedes vincularlos con los campos de tus formularios desde la sección **Campos personalizados** dentro de la configuración de la integración.

**Cómo configurar el mapeo:**

1. Ve a **Integraciones** → **Clientify** → sección **Campos personalizados**.
2. Verás la lista de campos detectados en los formularios recientes de tu cuenta.
3. Frente a cada campo, escribe el nombre exacto del campo personalizado en Clientify (por ejemplo: `Empresa`, `Cargo`).
4. Los campos que dejes en blanco seguirán enviándose como etiquetas.
5. Guarda la configuración.

> **V2 únicamente:** si usas la API V2, puedes hacer clic en **Sugerir campos de Clientify V2** para que Anunzi consulte automáticamente la lista de campos personalizados de tu cuenta y los proponga como autocompletado.

***

## Versiones de la API

| Versión | URL base                     | Cuándo usarla                                                                              |
| ------- | ---------------------------- | ------------------------------------------------------------------------------------------ |
| V1      | `api.clientify.net/v1/`      | Recomendada. Compatible con todas las cuentas.                                             |
| V2      | `api-plus.clientify.com/v2/` | Cuentas con acceso a la API Plus. Permite consultar campos personalizados automáticamente. |

Si no sabes cuál usar, elige **V1**.

***

## Prueba de conexión

Antes de activar la integración, puedes verificar que la API key es válida con el botón **Probar conexión**. Si la clave es correcta, Anunzi mostrará cuántos contactos tiene tu cuenta en Clientify. Si hay un error, se muestra el código HTTP devuelto por Clientify.

***

## Desconectar la integración

Desde **Integraciones** → **Clientify** → botón **Desconectar**. Los contactos ya enviados a Clientify no se eliminan. Solo se dejan de sincronizar los nuevos leads.

***

## Preguntas frecuentes

**¿Qué pasa si el contacto ya existe en Clientify?**\
La integración usa el endpoint de creación de contactos de Clientify. Si el contacto ya existe, Clientify puede crear un duplicado o actualizarlo según la configuración de tu cuenta en Clientify.

**¿Se sincronizan leads existentes o solo los nuevos?**\
Solo los leads nuevos, creados a partir del momento en que activas la integración.

**¿Funciona con formularios de cualquier página?**\
Sí, incluyendo páginas creadas fuera del constructor de Anunzi (con otro editor o IA). Anunzi corrige automáticamente los formularios al servirlos: apunta el envío al sistema, asigna nombres a los campos sin nombre y garantiza que los datos lleguen aunque el JavaScript de la página tenga lógica propia. Si quieres aplicar la corrección de forma permanente al HTML guardado, usa el botón **🎯 Forms** en la sección de páginas de tu proyecto.

**¿Qué pasa si falla el envío a Clientify?**\
El lead se guarda igualmente en Anunzi. El error queda registrado en los logs internos del sistema. El formulario del visitante funciona con normalidad.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.anunzi.net/integraciones/integraciones/clientify.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.