> ## Documentation Index
> Fetch the complete documentation index at: https://docs.landerlab.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Configura la integración con Phonexa

> Aprende a conectar Phonexa con LanderLab para enviar leads directamente a tus campañas de Phonexa en tiempo real desde cualquier landing page o embudo de quiz.

> Conecta Phonexa a tus landing pages en LanderLab para enviar los datos de los leads directamente a tus campañas de Phonexa en tiempo real. Solo necesitas tus credenciales de la Publisher API de la plataforma Phonexa.

## Qué es Phonexa

Phonexa es una plataforma todo en uno de performance marketing que usan generadores de leads, publishers y anunciantes para gestionar la distribución de leads, el seguimiento de llamadas, el email marketing y mucho más. Su producto LMS Sync se encarga del envío de leads y permite a los publishers enviar leads mediante HTTP POST a las campañas de Phonexa en tiempo real.

Cuando conectas Phonexa a tu landing page en LanderLab, cada lead que se recoge se envía automáticamente a tu campaña de Phonexa con tus credenciales de la Publisher API. LanderLab se encarga de la conexión con la API, así que no tienes que escribir código personalizado ni crear integraciones en el servidor a mano.

<Note>
  Las integraciones de Phonexa **no** se guardan de forma global. Cada integración se configura por landing page, así que tendrás que crear una conexión nueva con Phonexa en cada landing page desde la que quieras enviar leads.
</Note>

***

## Cómo añadir Phonexa

La configuración de Phonexa se hace con un asistente de 3 pasos: configurar la conexión, mapear los campos y revisar la carga final antes de conectar.

### Paso 1: configura la conexión

<Steps>
  <Step title="Ve a tu landing page">
    Ve a **Landing Pages** y haz clic en el **nombre de la landing page** en la que quieres añadir la integración con Phonexa.
  </Step>

  <Step title="Abre la pestaña de integraciones">
    Haz clic en **Add Integration** para abrir el panel de integraciones.
  </Step>

  <Step title="Selecciona Phonexa integration">
    En la lista de integraciones disponibles, busca **Phonexa integration** (con la etiqueta "Send leads to Phonexa in real time") y haz clic en ella. Se abrirá el asistente de configuración.
  </Step>

  <Step title="Rellena los datos de la conexión">
    Introduce estos datos:

    | Campo            | Descripción                                                                                                                                                  |
    | :--------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------- |
    | **Name**         | Una etiqueta para identificar esta integración (por ejemplo, "Phonexa préstamos de coche"). Te ayuda a reconocerla en la lista de integraciones.             |
    | **API URL**      | La URL del endpoint de envío de tu producto de Phonexa (por ejemplo, `api.phonexa.com/...`). Aparece en las especificaciones de la Publisher API de Phonexa. |
    | **API ID**       | Tu Publisher API ID numérico (por ejemplo, `12345`). Es el identificador único asignado a tu cuenta de publisher en Phonexa.                                 |
    | **API Password** | La contraseña de API asociada a tu Publisher API ID. Se define y se gestiona dentro de Phonexa.                                                              |

    <Tip>
      Para encontrar tu **API URL**, tu **API ID** y tu **API Password**, inicia sesión en tu cuenta de Phonexa, ve a **LMS Sync** y abre **Publisher Products API**. Selecciona el producto al que quieres enviar los leads. La URL de envío, el API ID y la API Password aparecen en la sección Lead Specs de la documentación de tu API. También puedes encontrarlos en tu perfil de publisher, dentro de los ajustes de API Access.
    </Tip>
  </Step>

  <Step title="Haz clic en Continue">
    Haz clic en **Continue** para pasar al mapeo de campos.
  </Step>
</Steps>

***

### Paso 2: mapea tus campos

En este paso eliges qué campos de datos incluir en la petición y con qué nombre deben enviarse a Phonexa.

<Steps>
  <Step title="Selecciona y configura los campos">
    LanderLab incluye automáticamente un conjunto de campos predeterminados. Cada campo tiene una casilla para incluirlo o excluirlo y una columna **Sent As** en la que puedes cambiar el nombre de la clave para que coincida con lo que espera Phonexa.

    Los campos predeterminados de LanderLab son:

    | Campo                      | Sent As (clave predeterminada) | Descripción                                                       |
    | :------------------------- | :----------------------------- | :---------------------------------------------------------------- |
    | **LL Lander URL**          | `ll_lander_url`                | La URL completa de la landing page en la que estaba el visitante. |
    | **LL Visitor IP**          | `ll_visitor_ip`                | La dirección IP del visitante.                                    |
    | **LL Visitor User Agent**  | `ll_visitor_user_agent`        | La información del navegador y del dispositivo del visitante.     |
    | **LL Submission Time UTC** | `ll_submission_time_utc`       | La fecha y hora en que se envió el lead (en UTC).                 |
    | **LL Variant ID**          | `ll_variant_id`                | El ID de la variante del test A/B que vio el visitante.           |

    Usa las casillas para activar o desactivar cualquier campo. Edita el valor de **Sent As** para que coincida con los nombres de campo de las especificaciones de la API de Phonexa.

    <Tip>
      Si tu landing page incluye un **embudo de quiz** o un **formulario**, todos los campos que hayas añadido (como nombre, email, teléfono, dirección y cualquier campo personalizado) aparecerán automáticamente en esta lista junto a los campos predeterminados de LanderLab. Puedes activarlos, desactivarlos o cambiarles el nombre igual que a los predeterminados. Asegúrate de que los valores de **Sent As** coinciden exactamente con los nombres de campo de las especificaciones de la API de Phonexa. Phonexa rechaza los leads que incluyen campos con un formato incorrecto o a los que les faltan valores obligatorios.
    </Tip>
  </Step>

  <Step title="Añade campos personalizados (opcional)">
    En la sección **Additional fields**, haz clic en **+ Add field** para incluir pares clave-valor adicionales en la petición. Es útil para enviar valores fijos como sub IDs, identificadores de la fuente de tráfico o cualquier parámetro personalizado que necesite tu campaña de Phonexa.
  </Step>

  <Step title="Haz clic en Continue">
    Haz clic en **Continue** para pasar a la revisión.
  </Step>
</Steps>

***

### Paso 3: revisa y conecta

<Steps>
  <Step title="Revisa tu integración con Phonexa">
    El último paso muestra un resumen completo de lo que se enviará a Phonexa con cada lead. Verás:

    * El **tipo de envío** y el nombre de la integración
    * La sección de **configuración**, con tu API URL, tu API ID y tu API Password
    * La sección de **mapeo de campos**, con todos los campos y sus variables de plantilla correspondientes (por ejemplo, `{{LL Lander URL}}`, `{{LL Visitor IP}}`)

    Revísalo todo con atención para asegurarte de que la configuración y los nombres de los campos coinciden con lo que espera tu campaña de Phonexa. Si algo no cuadra, haz clic en **Back** para volver a los pasos anteriores.
  </Step>

  <Step title="Haz clic en Connect Phonexa">
    Si todo está bien, haz clic en el botón **Connect Phonexa** para guardar y activar la integración.
  </Step>
</Steps>

***

## Dónde encontrar tus credenciales de la API de Phonexa

Si no sabes dónde encontrar tu API URL, tu API ID y tu API Password, sigue estos pasos:

1. Inicia sesión en tu cuenta de [Phonexa](https://app.phonexa.com).
2. Ve a **LMS Sync** en la barra lateral izquierda.
3. Haz clic en **Publisher Products API**.
4. Selecciona el producto al que quieres conectarte.
5. En la sección **Lead Specs** encontrarás la **URL de envío** (tu API URL), el **API ID** y la **API Password**.

También puedes encontrar tu API ID y tu API Password en tu perfil de publisher, dentro de los ajustes de **API Access**. Haz clic en el botón **Show** junto al campo API Password para ver el valor.

<Warning>
  Si cambias o restableces tu API Password en Phonexa, la contraseña anterior dejará de funcionar. Asegúrate de actualizarla también en LanderLab si la restableces.
</Warning>

***

## Consejos para la integración con Phonexa

* **Haz coincidir exactamente los nombres de los campos**: Phonexa valida todos los campos entrantes con las especificaciones de la API de tu producto. Usa la columna **Sent As** del paso 2 para que los nombres de los campos coincidan exactamente con los de tu documentación de Phonexa.
* **Revisa los campos obligatorios**: las especificaciones de la API de tu producto de Phonexa indican claramente qué campos son obligatorios. Los leads a los que les falten campos obligatorios o que tengan valores con un formato incorrecto se rechazarán.
* **Usa el modo de prueba durante la configuración**: Phonexa admite un modo de prueba si añades `testMode=1` a la carga. Puedes usar la sección **Additional fields** del paso 2 para añadirlo como un par clave-valor fijo mientras haces pruebas. Quítalo antes de ponerlo en vivo.
