Parámetros de Entrada

¿Qué son los Parámetros de Entrada?

Los Parámetros de Entrada son variables dinámicas que te permiten personalizar cada llamada con información específica del cliente. Al iniciar una llamada saliente o recibir una llamada entrante a través de tu API, puedes pasar estas variables para personalizar el comportamiento y conocimiento del agente.

Los Parámetros de Entrada se pasan vía API al iniciar llamadas, haciendo cada conversación única y personalizada.

Sugerencias del Copiloto de IA

El Copiloto de IA puede analizar tu prompt del sistema y sugerir automáticamente parámetros de entrada relevantes para mejorar la personalización de tu agente.

Cómo Funciona

Cuando escribes o modificas el prompt del sistema, el Copiloto de IA:

Analiza el Contexto - Examina las tareas y responsabilidades descritas en el prompt
Identifica Variables - Detecta información que podría variar entre llamadas
Sugiere Parámetros - Propone parámetros con nombres, tipos y descripciones apropiadas

Cuando hay sugerencias pendientes, aparecerá un banner púrpura en la parte superior de la sección:

Copiloto Sugerencias - Muestra el número de parámetros sugeridos con opciones para “Aceptar Todo” o “Rechazar”

Tipos de Sugerencias

Operación	Descripción	Ejemplo
Agregar	Nuevos parámetros sugeridos	`nombre_cliente`, `numero_pedido`
Modificar	Cambios a parámetros existentes	Cambiar tipo de `string` a `number`
Remover	Parámetros que ya no son necesarios	Parámetros obsoletos o duplicados

Casos de Uso Comunes

Caso de Uso	Parámetros de Ejemplo
Identificación del Cliente	`nombre_cliente`, `id_cliente`
Reserva de Citas	`fecha_cita`, `hora_cita`, `tipo_servicio`
Estado de Pedido	`numero_pedido`, `estado_pedido`, `fecha_entrega`
Gestión de Cuenta	`saldo_cuenta`, `fecha_vencimiento_pago`
Calificación de Lead	`fuente_lead`, `interes_producto`

Configurando Parámetros de Entrada

Añadiendo un Parámetro

Abrir Sección de Parámetros de Entrada

Navega a la sección de Parámetros de Entrada en el panel izquierdo.

Añadir Nuevo Parámetro

Haz clic en “Añadir Parámetro” para crear una nueva variable.

Configurar Propiedades

Establece el nombre, tipo y descripción.

Usar Plantillas

Las plantillas te ayudan a añadir rápidamente conjuntos comunes de parámetros:

Abrir Plantillas

Haz clic en el botón “Plantillas” para ver las opciones disponibles.

Seleccionar Plantilla

Elige una plantilla que se ajuste a tu caso de uso (ej., “Información del Cliente”).

Aplicar Plantilla

Los parámetros se añadirán automáticamente a tu configuración.

Propiedades del Parámetro

Propiedad	Descripción	Requerido
Nombre	Identificador de variable (ej., `nombre_cliente`)	Sí
Tipo	Tipo de dato: string, number, boolean	Sí
Descripción	Qué representa este parámetro	Sí
Valor por Defecto	Respaldo si no se proporciona	No

Tipos de Datos

String
Number
Boolean

Valores de texto como nombres, direcciones o identificadores.

{
  "nombre_cliente": "Juan García",
  "id_pedido": "PED-12345"
}

Valores numéricos como cantidades, importes o IDs.

{
  "saldo_cuenta": 1250.50,
  "cantidad_pedidos": 3
}

Valores verdadero/falso para flags y condiciones.

{
  "es_cliente_premium": true,
  "tiene_pago_pendiente": false
}

Usando Parámetros en Prompts

Una vez definidos, puedes referenciar parámetros de entrada en tu prompt del sistema y saludos usando la sintaxis {{nombre_parametro}}.

Ejemplo: Saludo Personalizado

Prompt del Sistema:

Eres un agente de servicio al cliente para Acme Corp.
Estás hablando con {{nombre_cliente}}.
El estado de su cuenta es {{estado_cuenta}}.

Saludo (Saliente):

Hola {{nombre_cliente}}, soy Sara de Acme Corp. 
Le llamo sobre su pedido {{numero_pedido}}.

Ejemplo: Comportamiento Condicional

{{#if es_cliente_premium}}
Trata a este cliente como VIP. Ofrece soporte prioritario y ofertas exclusivas.
{{else}}
Proporciona soporte estándar. Menciona opciones de mejora si es relevante.
{{/if}}

Integración API

Al hacer llamadas API para iniciar llamadas, incluye parámetros de entrada en tu petición:

curl -X POST https://api.meetzy.io/v1/calls \
  -H "Authorization: Bearer TU_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "agent_id": "agente_123",
    "phone_number": "+34612345678",
    "input_params": {
      "nombre_cliente": "Juan García",
      "numero_pedido": "PED-12345",
      "es_cliente_premium": true,
      "saldo_cuenta": 1250.50
    }
  }'

Probando Parámetros de Entrada

Usa el Playground para probar cómo tu agente maneja diferentes valores de parámetros:

Abrir Playground

Navega al Playground en el panel derecho.

Abrir Variables de Contexto

Haz clic en el panel “Variables de Contexto”.

Establecer Valores de Prueba

Ingresa valores para cada parámetro de entrada.

Iniciar Conversación

Prueba cómo el agente usa estos valores.

Mejores Prácticas

Usa nombres descriptivos y descripciones claras para que la IA entienda el contexto de cada parámetro.

Usa Nombres Claros - nombre_cliente es mejor que nc
Proporciona Descripciones - Ayuda a la IA a entender el contexto
Establece Valores por Defecto - Previene errores cuando no se proporcionan parámetros
Valida Antes de Enviar - Asegura que los parámetros tienen valores válidos
Documenta para el Equipo - Mantén una referencia de todos los parámetros y sus propósitos
Acepta Sugerencias del Copiloto - Las sugerencias de IA pueden mejorar la personalización

Plantillas de Parámetros Comunes

Información del Cliente

{
  "nombre_cliente": "string",
  "telefono_cliente": "string", 
  "email_cliente": "string",
  "id_cliente": "string"
}

Detalles de Cita

{
  "fecha_cita": "string",
  "hora_cita": "string",
  "tipo_servicio": "string",
  "ubicacion": "string"
}

Información de Pedido

{
  "numero_pedido": "string",
  "total_pedido": "number",
  "cantidad_articulos": "number",
  "fecha_entrega": "string"
}

Datos de Cuenta

{
  "saldo_cuenta": "number",
  "tipo_cuenta": "string",
  "fecha_vencimiento": "string",
  "es_cliente_premium": "boolean"
}

Flujo de Trabajo con IA Copiloto

Escribir Prompt del Sistema

Comienza escribiendo o editando tu prompt del sistema en el editor principal.

Obtener Sugerencias

El Copiloto analizará el prompt y sugerirá parámetros automáticamente.

Revisar Sugerencias

Examina las sugerencias en el banner púrpura - verifica nombres, tipos y descripciones.

Aceptar o Rechazar

Acepta las sugerencias útiles o recházalas si no son relevantes.

Ajustar si es Necesario

Edita manualmente los parámetros después de aceptar las sugerencias.

Siguientes Pasos

Después de configurar tus parámetros de entrada:

Configura Parámetros de Salida - Define qué información extraer de las conversaciones
Prueba en el Playground - Simula llamadas con diferentes valores de parámetros
Configura Webhooks - Recibe los datos extraídos en tu sistema

Primeros Pasos

Agentes

Editor Avanzado

Biblioteca de Voces

Llamadas

CRM

Cuenta

Parámetros de Entrada

¿Qué son los Parámetros de Entrada?

Sugerencias del Copiloto de IA

Cómo Funciona

Banner de Sugerencias

Tipos de Sugerencias

Casos de Uso Comunes

Configurando Parámetros de Entrada

Añadiendo un Parámetro

Usar Plantillas

Propiedades del Parámetro

Tipos de Datos

Usando Parámetros en Prompts

Ejemplo: Saludo Personalizado

Ejemplo: Comportamiento Condicional

Integración API

Probando Parámetros de Entrada

Mejores Prácticas

Plantillas de Parámetros Comunes

Información del Cliente

Detalles de Cita

Información de Pedido

Datos de Cuenta

Flujo de Trabajo con IA Copiloto

Siguientes Pasos

Primeros Pasos

Agentes

Editor Avanzado

Biblioteca de Voces

Llamadas

CRM

Cuenta

​¿Qué son los Parámetros de Entrada?

​Sugerencias del Copiloto de IA

​Cómo Funciona

​Banner de Sugerencias

​Tipos de Sugerencias

​Casos de Uso Comunes

​Configurando Parámetros de Entrada

​Añadiendo un Parámetro

​Usar Plantillas

​Propiedades del Parámetro

​Tipos de Datos

​Usando Parámetros en Prompts

​Ejemplo: Saludo Personalizado

​Ejemplo: Comportamiento Condicional

​Integración API

​Probando Parámetros de Entrada

​Mejores Prácticas

​Plantillas de Parámetros Comunes

​Información del Cliente

​Detalles de Cita

​Información de Pedido

​Datos de Cuenta

​Flujo de Trabajo con IA Copiloto

​Siguientes Pasos

¿Qué son los Parámetros de Entrada?

Sugerencias del Copiloto de IA

Cómo Funciona

Banner de Sugerencias

Tipos de Sugerencias

Casos de Uso Comunes

Configurando Parámetros de Entrada

Añadiendo un Parámetro

Usar Plantillas

Propiedades del Parámetro

Tipos de Datos

Usando Parámetros en Prompts

Ejemplo: Saludo Personalizado

Ejemplo: Comportamiento Condicional

Integración API

Probando Parámetros de Entrada

Mejores Prácticas

Plantillas de Parámetros Comunes

Información del Cliente

Detalles de Cita

Información de Pedido

Datos de Cuenta

Flujo de Trabajo con IA Copiloto

Siguientes Pasos