> ## Documentation Index
> Fetch the complete documentation index at: https://docs.meetzy.es/llms.txt
> Use this file to discover all available pages before exploring further.
# Acciones y Herramientas
> Configura transferencias, finalización de llamadas, webhooks y automatizaciones avanzadas
## Resumen
La sección de Acciones y Herramientas permite configurar funcionalidades avanzadas que potencian las capacidades de tu agente conversacional durante y después de las llamadas. Incluye transferencias telefónicas, detección automática de contestadores, webhooks personalizados, protocolos de rellamada y configuración de caller IDs para llamadas salientes.
Las funcionalidades configuradas aquí son clave para crear experiencias conversacionales fluidas y automatizaciones poderosas que integren con tus sistemas existentes.
## Transferencia de Llamadas
Configura cómo tu agente maneja las transferencias de llamada a agentes humanos, extensiones internas o sistemas telefónicos externos.
### Tipos de Transferencia Disponibles
Meetzy soporta dos métodos principales de transferencia:
Transferir a números telefónicos tradicionales (móvil, fijo, internacional).
**Formato requerido**: `+34600123456`
**Casos de uso comunes**:
* Escalar a agentes de soporte humano
* Conectar con departamentos específicos
* Transferir a supervisores o especialistas
* Dirigir a líneas de emergencia
Transferir a través del protocolo SIP para sistemas telefónicos empresariales.
**Formato requerido**: `sip:extensión@gateway_ip:puerto`
**Ejemplo**: `sip:100@78.136.102.246:5060`
**Casos de uso comunes**:
* Transferir a extensiones internas de PBX
* Conectar con sistemas VoIP empresariales
* Integrar con infraestructura telefónica existente
* Enrutar a grupos de agentes específicos
### Proceso de Configuración
Habilita la opción de transferencia de llamadas usando el interruptor en la interfaz de usuario.
Elige entre "Número de Teléfono" o "SIP Trunk" según tu infraestructura de comunicaciones.
* Para números telefónicos: Introduce el número en formato E.164 (+país + número)
* Para SIP: Especifica la URI completa con extensión, IP y puerto
Establece mediante prompts específicos cuándo el agente debe activar la transferencia automáticamente.
### Plantillas de Transferencia Multiidioma
El sistema incluye plantillas predefinidas optimizadas para diferentes idiomas y contextos culturales:
```text theme={null}
Se usa para transferir la llamada con una persona en los casos que se indican:
- El usuario rechaza directamente la propuesta o servicio
- El usuario solicita expresamente hablar con una persona humana
- El usuario muestra desconfianza hacia el asistente virtual
- Se necesita información específica no disponible en el sistema
- Se requiere autorización o gestión de datos personales sensibles
- El cliente expresa frustración o necesita atención personalizada
- La consulta requiere conocimiento técnico especializado
- Se solicita hablar con un supervisor o responsable
```
```text theme={null}
Used to transfer the call to a person in the following cases:
- The user directly rejects the proposal or service
- The user expressly requests to speak with a human person
- The user shows distrust towards the virtual assistant
- Specific information is needed that is not available in the system
- Authorization or management of sensitive personal data is required
- The client expresses frustration or needs personalized attention
- The query requires specialized technical knowledge
- Request to speak with a supervisor or manager
```
```text theme={null}
Utilisé pour transférer l'appel à une personne dans les cas indiqués :
- L'utilisateur rejette directement la proposition ou le service
- L'utilisateur demande expressément à parler avec une personne humaine
- L'utilisateur montre de la méfiance envers l'assistant virtuel
- Des informations spécifiques sont nécessaires qui ne sont pas disponibles
- L'utilisateur nécessite une autorisation ou gestion de données sensibles
- Le client exprime sa frustration ou a besoin d'attention personnalisée
- La demande nécessite des connaissances techniques spécialisées
- Demande de parler avec un superviseur ou responsable
```
```text theme={null}
Wird verwendet, um das Gespräch in folgenden Fällen an eine Person zu übertragen:
- Der Benutzer lehnt den Vorschlag oder Service direkt ab
- Der Benutzer möchte ausdrücklich mit einer echten Person sprechen
- Der Benutzer zeigt Misstrauen gegenüber dem virtuellen Assistenten
- Spezifische Informationen werden benötigt, die nicht verfügbar sind
- Der Benutzer benötigt Autorisierung oder sensible Datenverwaltung
- Der Kunde äußert Frustration oder benötigt persönliche Betreuung
- Die Anfrage erfordert spezialisiertes technisches Wissen
- Anfrage, mit einem Supervisor oder Manager zu sprechen
```
```text theme={null}
Si usa per trasferire la chiamata a una persona nei casi indicati:
- L'utente rifiuta direttamente la proposta o il servizio
- L'utente richiede espressamente di parlare con una persona umana
- L'utente mostra sfiducia verso l'assistente virtuale
- Sono necessarie informazioni specifiche non disponibili nel sistema
- L'utente richiede autorizzazione o gestione di dati personali sensibili
- Il cliente esprime frustrazione o necessita di attenzione personalizzata
- La richiesta richiede conoscenza tecnica specializzata
- Si richiede di parlare con un supervisore o responsabile
```
```text theme={null}
É usado para transferir a chamada para uma pessoa nos casos indicados:
- O usuário rejeita diretamente a proposta ou serviço
- O usuário solicita expressamente falar com uma pessoa humana
- O usuário mostra desconfiança em relação ao assistente virtual
- São necessárias informações específicas não disponíveis no sistema
- O usuário requer autorização ou gestão de dados pessoais sensíveis
- O cliente expressa frustração ou precisa de atenção personalizada
- A consulta requer conhecimento técnico especializado
- Solicita falar com um supervisor ou responsável
```
## Estrategia de Finalización de Llamada
Configura cómo y cuándo tu agente debe finalizar automáticamente las conversaciones para optimizar recursos y mejorar la experiencia del usuario.
### Detección Automática de Contestadores
Una funcionalidad crítica es la detección automática de contestadores telefónicos para evitar conversaciones con sistemas automatizados:
La detección de contestadores automáticos es esencial para evitar conversaciones innecesarias y optimizar costos operacionales. Esta funcionalidad previene la frustración de interacciones con buzones de voz y sistemas automatizados.
#### Frases de Detección por Idioma
El sistema AI reconoce patrones específicos en cada idioma:
```text theme={null}
Frases comunes detectadas automáticamente:
- "En este momento no podemos atenderle"
- "Deje su mensaje después de la señal"
- "El número al que llama no está disponible"
- "Ha llamado al buzón de..."
- "Este es el contestador automático de..."
- "Gracias por llamar, en estos momentos..."
- "Bienvenido al buzón de voz de..."
- "Puedes dejar tu mensaje al oír la señal"
- "Lo sentimos, pero en estos momentos..."
- "Por favor, inténtelo de nuevo más tarde"
- "No podemos atender su llamada ahora"
- "Ha contactado con el servicio de..."
```
```text theme={null}
Frases comunes detectadas automáticamente:
- "Please leave your message after the tone"
- "We're sorry, but we cannot take your call..."
- "The person you're calling is not available"
- "You have reached the voicemail of..."
- "Thank you for calling, we are currently..."
- "Your call is important to us, please hold..."
- "We cannot take your call right now"
- "Leave your message at the sound of the beep"
- "This is the answering machine of..."
- "Please try your call again later"
```
```text theme={null}
Frases comunes detectadas automáticamente:
- "Veuillez laisser votre message après le signal"
- "Nous sommes désolés, mais en ce moment..."
- "La personne que vous appelez n'est pas disponible"
- "Vous avez joint la messagerie vocale de..."
- "Merci d'avoir appelé, nous sommes actuellement..."
- "Bienvenue sur le répondeur de..."
- "Laissez votre message après le bip"
```
```text theme={null}
Frases comunes detectadas automáticamente:
- "Bitte hinterlassen Sie Ihre Nachricht nach dem Ton"
- "Es tut uns leid, aber zur Zeit können wir..."
- "Die Person, die Sie anrufen, ist nicht verfügbar"
- "Sie haben die Mailbox von... erreicht"
- "Vielen Dank für Ihren Anruf, wir sind derzeit..."
- "Willkommen beim Anrufbeantworter von..."
- "Hinterlassen Sie Ihre Nachricht nach dem Piepton"
```
```text theme={null}
Frases comunes detectadas automáticamente:
- "Per favore lasci il suo messaggio dopo il tono"
- "Ci dispiace, ma al momento non possiamo..."
- "La persona che sta chiamando non è disponibile"
- "Ha raggiunto la segreteria di..."
- "Grazie per aver chiamato, al momento siamo..."
- "Benvenuto alla segreteria telefonica di..."
- "Lasci il suo messaggio dopo il segnale acustico"
```
```text theme={null}
Frases comunes detectadas automáticamente:
- "Por favor deixe sua mensagem após o sinal"
- "Lamentamos, mas no momento não podemos..."
- "A pessoa que você está ligando não está disponível"
- "Você chegou à caixa postal de..."
- "Obrigado por ligar, no momento estamos..."
- "Bem-vindo à secretária eletrônica de..."
- "Deixe sua mensagem após o bip"
```
### Condiciones Adicionales de Finalización
Además de contestadores automáticos, el agente finalizará llamadas en estas situaciones:
* **Despedida Natural**: El usuario se despide claramente y el agente completa protocolarmente su despedida
* **Objetivos Completados**: Se han alcanzado exitosamente los objetivos específicos de la conversación
* **Timeout Configurado**: Se supera el tiempo máximo establecido para la duración de la llamada
* **Detección de Silencio Prolongado**: Períodos extendidos sin respuesta audible del interlocutor
* **Interrupción de Línea**: Llamada cortada inesperadamente por problemas técnicos o cuelgue
* **Transferencia Exitosa**: Después de completar satisfactoriamente la transferencia a un agente humano
## Herramientas Webhook Personalizadas
Crea integraciones poderosas con sistemas externos mediante webhooks que tu agente puede ejecutar durante las conversaciones en tiempo real.
### Creando una Nueva Herramienta Webhook
Haz clic en "Añadir Herramienta Webhook" para crear una nueva integración personalizada con sistemas externos.
* **Nombre de Herramienta**: Identificador único y descriptivo (ej. "consultar\_inventario", "crear\_lead\_crm")
* **Descripción Detallada**: Explica específicamente cuándo y por qué la IA debe usar esta herramienta
* **Contexto de Uso**: Define escenarios precisos que deben activar la herramienta
* **URL de Destino**: Endpoint HTTP/HTTPS que procesará las peticiones
* **Método HTTP**: Selecciona GET, POST, PUT, PATCH o DELETE según la operación
* **Encabezados**: Configura autenticación y metadatos requeridos
Configure parámetros de query string y campos del cuerpo de petición con validaciones específicas.
Ajusta timeouts, comportamiento de interrupciones, modo de ejecución y feedback de audio.
### Configuración Detallada de Parámetros
Cada parámetro webhook se puede configurar con precisión técnica:
| Propiedad | Descripción | Opciones Disponibles |
| ----------------------- | ------------------------------------------- | ----------------------------------------------- |
| **Identificador** | Nombre del parámetro en la API | string único (snake\_case recomendado) |
| **Tipo de Dato** | Formato y validación del valor | string, number, boolean, integer, array, object |
| **Campo Requerido** | Obligatoriedad para la ejecución | true (obligatorio) / false (opcional) |
| **Descripción para IA** | Contexto detallado que guía el uso correcto | texto descriptivo y ejemplos de uso |
| **Fuente del Valor** | Origen de los datos | llm\_prompt (IA genera) / static (valor fijo) |
| **Valores Enum** | Restricción a opciones predefinidas | lista cerrada de valores permitidos |
| **Validación** | Reglas adicionales de formato | regex, rangos numéricos, longitud |
### Configuración Avanzada de Webhooks
#### Control de Interrupciones Durante Ejecución
Controla si el usuario puede interrumpir al agente mientras espera la respuesta del webhook. Esta configuración es crucial para operaciones críticas que requieren completarse sin interrupciones.
* **Deshabilitar Interrupciones**: El agente no puede ser interrumpido durante la ejecución (ideal para transacciones)
* **Permitir Interrupciones**: El usuario puede interrumpir mientras se procesa (recomendado para consultas rápidas)
#### Modos de Ejecución de Webhooks
| Modo | Comportamiento | Casos de Uso Ideales | Ventajas | Desventajas |
| ------------- | --------------------------------------- | ----------------------------------------------- | ------------------------------ | ---------------------------------------- |
| **Inmediato** | Ejecuta durante la conversación | Consultas de datos, validaciones en tiempo real | Respuesta inmediata al usuario | Puede afectar fluidez si es lento |
| **Diferido** | Ejecuta después de finalizar la llamada | Logs, notificaciones, actualizaciones de CRM | No interrumpe la conversación | Usuario no recibe confirmación inmediata |
#### Configuración de Feedback de Audio
* **Sonido de Herramienta**: Reproduce efecto sonoro de "tecleado" durante ejecución para proporcionar feedback al usuario
* **Control de Audio**: Automático (siempre reproduce) o inteligente (controlado por la IA según contexto)
* **Síntesis Previa Forzada**: Garantiza que el agente termine de hablar antes de ejecutar la herramienta
### Ejemplos Avanzados de Implementación
**Caso de Uso**: Crear lead automáticamente cuando el cliente muestra interés comercial
```json theme={null}
{
"name": "crear_lead_salesforce",
"description": "Crear lead en Salesforce cuando el cliente muestra interés genuino en nuestros productos o servicios, solicita información comercial, o proporciona datos de contacto",
"api_schema": {
"url": "https://api.salesforce.com/services/data/v57.0/sobjects/Lead",
"method": "POST",
"request_headers": {
"Authorization": "Bearer YOUR_SALESFORCE_ACCESS_TOKEN",
"Content-Type": "application/json"
},
"request_body_schema": {
"type": "object",
"required": ["LastName", "Company", "Email"],
"properties": {
"FirstName": {
"type": "string",
"description": "Nombre del prospecto obtenido durante la conversación"
},
"LastName": {
"type": "string",
"description": "Apellido del prospecto (requerido por Salesforce)"
},
"Email": {
"type": "string",
"description": "Dirección de correo electrónico del prospecto"
},
"Company": {
"type": "string",
"description": "Nombre de la empresa del prospecto"
},
"Phone": {
"type": "string",
"description": "Número de teléfono desde donde llama"
},
"LeadSource": {
"type": "string",
"enum": ["Llamada Entrante", "Llamada Saliente", "Web", "Referido"],
"description": "Fuente del lead para tracking"
},
"Industry": {
"type": "string",
"description": "Sector o industria del prospecto"
},
"LeadStatus": {
"type": "string",
"enum": ["Nuevo", "Calificado", "Interesado", "No Calificado"],
"description": "Estado inicial del lead basado en la conversación"
}
}
}
},
"response_timeout_secs": 15,
"execution_mode": "immediate",
"tool_call_sound": "typing",
"disable_interruptions": true
}
```
**Caso de Uso**: Verificar disponibilidad de productos en tiempo real durante ventas
```json theme={null}
{
"name": "consultar_inventario",
"description": "Verificar disponibilidad de productos en inventario cuando el cliente pregunta por stock, disponibilidad, precios, o quiere realizar una compra",
"api_schema": {
"url": "https://api.miempresa.com/inventory/check",
"method": "GET",
"request_headers": {
"X-API-Key": "YOUR_INVENTORY_API_KEY",
"Accept": "application/json"
},
"query_params_schema": {
"properties": {
"product_id": {
"type": "string",
"description": "ID, código SKU, o nombre del producto a consultar"
},
"location": {
"type": "string",
"description": "Código de sucursal o almacén para verificar disponibilidad local",
"enum": ["MAD001", "BCN001", "VLC001", "SEV001", "ONLINE"]
},
"quantity": {
"type": "integer",
"description": "Cantidad específica que el cliente necesita",
"minimum": 1
},
"variant": {
"type": "string",
"description": "Variante del producto (color, talla, modelo) si aplica"
}
},
"required": ["product_id"]
}
},
"disable_interruptions": false,
"execution_mode": "immediate",
"response_timeout_secs": 8,
"tool_call_sound": "typing"
}
```
**Caso de Uso**: Agendar citas médicas con validación de disponibilidad
```json theme={null}
{
"name": "programar_cita_medica",
"description": "Programar nueva cita médica cuando el paciente solicita una cita, quiere reprogramar una existente, o necesita atención médica específica",
"api_schema": {
"url": "https://api.clinica.com/appointments",
"method": "POST",
"request_headers": {
"Authorization": "Bearer YOUR_CLINIC_TOKEN",
"Content-Type": "application/json"
},
"request_body_schema": {
"type": "object",
"required": ["patient_name", "preferred_date", "service_type", "contact_phone"],
"properties": {
"patient_name": {
"type": "string",
"description": "Nombre completo del paciente según documento de identidad"
},
"patient_phone": {
"type": "string",
"description": "Teléfono principal del paciente para confirmaciones"
},
"patient_email": {
"type": "string",
"description": "Email del paciente para envío de confirmaciones (opcional)"
},
"preferred_date": {
"type": "string",
"format": "date",
"description": "Fecha preferida en formato YYYY-MM-DD"
},
"preferred_time": {
"type": "string",
"enum": ["09:00", "10:00", "11:00", "12:00", "15:00", "16:00", "17:00"],
"description": "Hora preferida según disponibilidad médica"
},
"service_type": {
"type": "string",
"enum": ["Consulta General", "Especialidad", "Urgencia", "Revisión", "Telemedicina"],
"description": "Tipo de servicio médico requerido"
},
"doctor_preference": {
"type": "string",
"description": "Nombre del médico preferido si el paciente tiene preferencia"
},
"insurance_provider": {
"type": "string",
"description": "Nombre del seguro médico del paciente"
},
"reason": {
"type": "string",
"description": "Motivo de la consulta o síntomas principales"
}
}
}
},
"response_timeout_secs": 20,
"tool_call_sound": "typing",
"force_pre_tool_speech": true,
"execution_mode": "immediate"
}
```
### Mejores Prácticas para Webhooks Exitosos
* Sé específico sobre cuándo usar cada herramienta
* Incluye ejemplos de frases que deben activar la herramienta
* Proporciona contexto sobre qué información debe recopilar primero
* Especifica cómo manejar errores o respuestas inesperadas
* Implementa caching para consultas frecuentes
* Usa índices en bases de datos para consultas rápidas
* Configura timeouts realistas según tu infraestructura
* Implementa circuit breakers para manejo de fallos
* Usa HTTPS exclusivamente para todas las comunicaciones
* Implementa autenticación por tokens con renovación automática
* Valida y sanitiza todos los inputs del usuario
* Registra logs de auditoría sin exponer información sensible
* Configura rate limiting para prevenir abuso
* Define respuestas de error claras y amigables para el usuario
* Implementa reintentos automáticos para fallos temporales
* Proporciona alternativas cuando el servicio no está disponible
* Registra errores detallados para debugging técnico
## Protocolo de Rellamada Automática (Recall)
Configura un sistema inteligente de rellamadas automáticas cuando no se logran completar los objetivos de la conversación inicial o se requiere continuidad en la comunicación.
### Configuración del Sistema Recall
Habilita el sistema de rellamadas automáticas desde el panel de configuración avanzada.
Establece el número máximo de intentos de rellamada (recomendado: 2-3 para evitar molestias al cliente).
Configure intervalos progresivos entre intentos para maximizar probabilidades de éxito y minimizar intrusión.
Especifica detalladamente qué situaciones deben desencadenar una rellamada automática del sistema.
Define ventanas horarias, zonas horarias y restricciones de días para respetar preferencias del cliente.
### Estrategias de Intervalos Optimizadas
| Intervalo de Reintento | Contexto de Aplicación | Ejemplos de Uso | Tasa de Éxito Esperada |
| ----------------------- | ---------------------------- | ----------------------------------------------------- | ---------------------- |
| **5-15 minutos** | Línea ocupada, urgencia alta | Confirmaciones médicas urgentes, emergencias | 60-70% |
| **30 minutos - 1 hora** | No contestó, mismo día | Citas médicas, servicios técnicos | 45-55% |
| **2-4 horas** | Seguimiento comercial activo | Ventas consultivas, ofertas con tiempo limitado | 35-45% |
| **Siguiente día hábil** | Seguimiento profesional | Propuestas comerciales, información general | 25-35% |
| **48-72 horas** | Nurturing a largo plazo | Seguimiento de leads fríos, relaciones de largo plazo | 15-25% |
| **1 semana** | Mantenimiento de relación | Check-ins periódicos, renovaciones anuales | 10-20% |
### Condiciones de Activación Inteligente
Las rellamadas se activan automáticamente en diversos escenarios técnicos y de negocio:
**Situaciones de infraestructura que requieren reintento:**
* **No Response (Ring No Answer)**: Timbre sin respuesta después de tiempo configurado
* **Busy Signal**: Línea ocupada o todas las líneas del destino ocupadas
* **Voicemail Detection**: Se detectó contestador automático mediante análisis de patrones
* **Network Issues**: Problemas de conectividad, latencia alta, o pérdida de paquetes
* **Call Dropped**: Llamada cortada inesperadamente por problemas técnicos
* **Poor Audio Quality**: Calidad de audio insuficiente para conversación efectiva
* **Carrier Rejection**: Rechazo por parte del operador telefónico
* **Invalid Number Format**: Número mal formateado que requiere corrección automática
**Situaciones conversacionales que justifican seguimiento:**
* **Incomplete Objective**: Objetivos principales de la llamada no completados satisfactoriamente
* **Customer Request**: Cliente solicitó explícitamente ser contactado en otro momento específico
* **Information Pending**: Información crítica pendiente de confirmación o recopilación adicional
* **Follow-up Required**: El tipo de interacción requiere seguimiento por protocolo empresarial
* **Partial Completion**: Conversación interrumpida antes de completar proceso crítico
* **Appointment Confirmation**: Confirmación de cita programada según protocolo médico/empresarial
* **Payment Reminder**: Recordatorio de pago con protocolo de cobranza específico
* **Document Verification**: Verificación de documentos o información pendiente
**Configuraciones específicas del negocio:**
* **Business Hours Only**: Rellamar exclusivamente en horarios comerciales configurados
* **Customer Timezone**: Respetar automáticamente zona horaria del cliente objetivo
* **Campaign Rules**: Reglas específicas de la campaña de marketing o playbook comercial
* **Lead Score Threshold**: Basado en puntuación automática de calidad del contacto
* **Previous Interaction History**: Análisis del historial de interacciones previas del cliente
* **Seasonal Restrictions**: Evitar períodos vacacionales, festivos, o de baja actividad comercial
* **Channel Preference**: Priorizar canal de comunicación preferido por el cliente
* **Compliance Requirements**: Cumplir regulaciones específicas de telecomunicaciones
**Cumplimiento Legal Obligatorio**: El uso de protocolos de rellamada debe cumplir estrictamente con regulaciones locales e internacionales. Esto incluye respetar listas de "No Llamar", preferencias explícitas del cliente, GDPR/LOPD para protección de datos, y regulaciones específicas de telecomunicaciones. El incumplimiento puede resultar en sanciones legales y daño reputacional.
### Configuración Avanzada JSON del Sistema Recall
```json theme={null}
{
"recall": {
"enabled": true,
"max_attempts": 3,
"progressive_intervals": [
{
"attempt": 1,
"delay_value": 30,
"delay_unit": "minutes",
"conditions": ["busy", "no_answer"]
},
{
"attempt": 2,
"delay_value": 4,
"delay_unit": "hours",
"conditions": ["voicemail", "incomplete_objective"]
},
{
"attempt": 3,
"delay_value": 1,
"delay_unit": "days",
"conditions": ["customer_request", "follow_up_required"]
}
],
"success_conditions": [
"Call answered and conversation completed successfully",
"Transfer completed to human agent",
"Primary objective achieved",
"Customer explicitly requested no further contact",
"Appointment confirmed and scheduled"
],
"failure_conditions": [
"Number permanently invalid",
"Customer opted out explicitly",
"Maximum attempts exceeded",
"Legal compliance violation detected"
],
"business_rules": {
"respect_timezone": true,
"business_hours": {
"enabled": true,
"start_time": "09:00",
"end_time": "18:00",
"timezone": "Europe/Madrid"
},
"exclude_weekends": true,
"exclude_holidays": true,
"exclude_dates": ["2025-12-25", "2025-01-01"],
"compliance_checks": {
"dncl_respect": true,
"gdpr_compliance": true,
"caller_id_verification": true
}
},
"analytics": {
"track_success_rates": true,
"measure_conversion": true,
"cost_analysis": true,
"compliance_monitoring": true
}
}
}
```
## Configuración de Caller ID para Llamadas Salientes
Gestiona los números telefónicos que aparecerán como identificador de llamada cuando tu agente realice llamadas salientes, crucial para establecer confianza y cumplir regulaciones.
### Gestión de Números de Caller ID
En la sección de configuración básica, ubica el campo "From" donde se muestran los caller IDs disponibles.
Haz clic en "Añadir Caller ID" para registrar un nuevo número telefónico para llamadas salientes.
* Introduce el número telefónico en formato internacional
* Proporciona un nombre descriptivo para identificar el número
* Inicia el proceso de verificación automática
* Recibirás una llamada automática de verificación en el número proporcionado
* Introduce el código de verificación de 4-6 dígitos que escucharás
* Confirma la verificación para activar el caller ID
Una vez verificado, selecciona el caller ID validado para tu agente conversacional.
### Estados del Caller ID
| Estado | Descripción | Acciones Disponibles |
| -------------------------- | ----------------------------------- | --------------------------------- |
| **Verificación Pendiente** | Número añadido pero no verificado | Verificar, Eliminar |
| **Verificado** | Número validado y listo para usar | Usar como Caller ID, Eliminar |
| **Verificación Fallida** | Error en el proceso de verificación | Reintentar Verificación, Eliminar |
| **En Uso** | Actualmente asignado a un agente | Ver Detalles, Cambiar |
### Consideraciones Legales y Técnicas
**Compliance Caller ID**: Solo puedes usar números telefónicos que poseas legalmente o tengas autorización explícita para usar. El spoofing de caller ID sin autorización es ilegal en la mayoría de jurisdicciones y puede resultar en sanciones severas.
* **Verificación Obligatoria**: Todos los caller IDs deben ser verificados mediante llamada automática
* **Números Propios**: Solo registra números telefónicos que poseas o controles legalmente
* **Regulaciones Locales**: Cumple con regulaciones específicas de caller ID en tu jurisdicción
* **Transparencia**: Usa caller IDs que identifiquen claramente tu empresa u organización
## Integraciones de Comunicación Avanzada
### Configuración de Email Inteligente
Configura el envío automático de correos electrónicos contextuales durante o después de las conversaciones telefónicas.
Habilita la opción de envío de email automático en la sección de Acciones y Herramientas.
Define cuándo el agente debe enviar automáticamente un correo electrónico al cliente.
Configura prompts dinámicos para generar asuntos relevantes basados en la conversación.
Establece prompts para generar el cuerpo del email con información específica de la llamada.
Especifica direcciones de email adicionales que deben recibir copias del correo enviado.
#### Configuración de Prompts de Email
```text theme={null}
Enviar email automático en estos casos:
- El cliente solicita información adicional por escrito
- Se necesita confirmación de detalles importantes discutidos
- El cliente requiere documentación o enlaces de seguimiento
- Se programó una cita que requiere confirmación escrita
- Se proporcionó información técnica que debe documentarse
- El cliente expresó interés en productos/servicios específicos
```
```text theme={null}
Generar asunto de email basado en:
- Motivo principal de la llamada
- Acción o información más relevante discutida
- Nombre de la empresa o servicio mencionado
- Urgencia o importancia del seguimiento
Formato: [Empresa] - [Tema Principal] - [Fecha]
Ejemplo: "MediCare - Confirmación Cita Consulta - 23 Enero"
```
```text theme={null}
Incluir en el cuerpo del email:
- Saludo personalizado con nombre del cliente
- Resumen conciso de los puntos clave discutidos
- Información específica solicitada o prometida
- Pasos siguientes o acciones requeridas
- Información de contacto para seguimiento
- Despedida profesional y cortés
Tono: Profesional, claro, y orientado a la acción
```
### Configuración de SMS Inteligente
Establece el envío automático de mensajes SMS para confirmaciones rápidas y recordatorios.
Habilita la opción de envío de SMS automático en la configuración de acciones.
Especifica cuándo el agente debe enviar un SMS al cliente automáticamente.
Establece prompts para generar mensajes SMS concisos y relevantes.
#### Casos de Uso Típicos para SMS
* **Confirmaciones de Cita**: Envío inmediato tras programar cita médica o comercial
* **Códigos de Verificación**: Autenticación de identidad durante llamadas sensibles
* **Recordatorios Urgentes**: Información crítica que requiere confirmación rápida
* **Enlaces de Seguimiento**: URLs cortas para documentos, formularios, o recursos
* **Confirmaciones de Pedido**: Números de tracking o códigos de referencia
### Configuración de Calendario Inteligente
Integra directamente con sistemas de calendario para programación automática de citas.
#### Proveedores Soportados
**Configuración requerida:**
* **Calendar IDs de Disponibilidad**: IDs de calendarios para verificar disponibilidad
* **Calendar ID de Reserva**: ID del calendario donde se crearán las nuevas citas
* **Duración por Defecto**: Tiempo estándar de las citas en minutos
* **Horario de Trabajo**: Ventana horaria para programación de citas
* **Zona Horaria**: Zona horaria del calendario principal
**Configuración avanzada:**
```json theme={null}
{
"provider": "google-calendar",
"availability_calendar_ids": ["cal1@gmail.com", "cal2@gmail.com"],
"booking_calendar_id": "booking@empresa.com",
"default_duration_minutes": 30,
"working_hours_start": "09:00",
"working_hours_end": "17:00",
"timezone": "Europe/Madrid",
"include_attendee_email": true,
"include_location": true
}
```
**Configuración requerida:**
* **Calendarios de Disponibilidad**: IDs de calendarios de Microsoft Exchange
* **Calendario de Reserva**: Calendario de destino para nuevas citas
* **Configuración de Acceso**: Tokens de autenticación de Microsoft Graph API
* **Políticas de Reunión**: Configuraciones específicas de Outlook/Teams
**Configuración avanzada:**
```json theme={null}
{
"provider": "outlook-calendar",
"availability_calendar_ids": ["user1@empresa.onmicrosoft.com"],
"booking_calendar_id": "reservas@empresa.onmicrosoft.com",
"default_duration_minutes": 45,
"working_hours_start": "08:30",
"working_hours_end": "18:30",
"timezone": "Europe/Madrid",
"teams_integration": true,
"send_outlook_invitations": true
}
```
#### Prompts de Configuración de Calendario
| Configuración | Descripción | Ejemplo |
| ----------------------------- | --------------------------------------------- | -------------------------------------------------------------------------------------------------------- |
| **Check Availability Prompt** | Cuándo verificar disponibilidad de calendario | "Verificar disponibilidad cuando el cliente solicite programar una cita, reunión, o consulta específica" |
| **Book Appointment Prompt** | Cuándo crear automáticamente la cita | "Crear cita cuando se confirme fecha, hora, y se obtenga información de contacto del cliente" |
| **Event Title Prompt** | Cómo generar el título del evento | "Generar título descriptivo: \[Tipo de Cita] - \[Nombre Cliente] - \[Motivo/Servicio]" |
| **Event Description Prompt** | Contenido de la descripción del evento | "Incluir: motivo de la cita, información de contacto, notas especiales de la conversación" |
## Monitoreo y Análisis de Rendimiento
### Métricas Clave de Transferencias
Monitorea el rendimiento de las transferencias para optimizar la experiencia:
| Métrica | Descripción | Objetivo Recomendado | Umbral de Alerta |
| ----------------------------------- | -------------------------------------------- | -------------------- | -------------------- |
| **Tasa de Transferencia** | % de llamadas que requieren transferencia | \< 15% | > 20% |
| **Tiempo de Transferencia** | Duración desde solicitud hasta conexión | \< 30 segundos | > 45 segundos |
| **Éxito de Transferencia** | % de transferencias completadas exitosamente | > 95% | \< 90% |
| **Satisfacción Post-Transferencia** | Rating de calidad después de transferencia | > 4.0/5.0 | \< 3.5/5.0 |
| **Motivos de Transferencia** | Categorización de razones para transferir | Análisis cualitativo | Patrones repetitivos |
### Métricas de Rendimiento de Webhooks
Supervisa la performance de integraciones webhook:
| Métrica | Descripción | Umbral Óptimo | Alerta Crítica |
| --------------------------- | ------------------------------------- | --------------- | -------------------- |
| **Latencia Promedio** | Tiempo de respuesta de webhooks | \< 3 segundos | > 8 segundos |
| **Tasa de Éxito** | % de webhooks ejecutados exitosamente | > 98% | \< 95% |
| **Errores por Herramienta** | Fallos específicos por webhook | \< 1% | > 3% |
| **Throughput** | Requests por minuto procesados | Según capacidad | Límite de saturación |
| **Timeout Rate** | % de webhooks que exceden timeout | \< 0.5% | > 2% |
### Métricas de Efectividad de Recalls
Evalúa el éxito del sistema de rellamadas:
| Métrica | Descripción | Benchmark Industria | Meta Optimizada |
| ---------------------------- | ------------------------------------- | ---------------------- | ------------------ |
| **Tasa de Conexión** | % de recalls que logran contacto | 40-60% | > 55% |
| **Conversión Post-Recall** | % que completan objetivos tras recall | 20-40% | > 35% |
| **Costo por Recall Exitoso** | ROI de cada recall que convierte | Variable por industria | Positivo |
| **Opt-out Rate** | % que solicitan no más contact | \< 5% | \< 3% |
| **Compliance Score** | Cumplimiento de regulaciones | 100% | 100% (obligatorio) |
## Solución de Problemas Avanzada
**Síntoma**: Las transferencias fallan constantemente o no se conectan
**Diagnóstico paso a paso:**
```bash theme={null}
# 1. Verificar conectividad del número destino
curl -X POST "https://api.meetzy.com/test-call" \
-H "Content-Type: application/json" \
-d '{"number": "+34600123456"}'
# 2. Para SIP, verificar conectividad del gateway
telnet your-sip-gateway.com 5060
# 3. Verificar formato de número (debe ser E.164)
echo "+34600123456" | grep -E '^\+[1-9]\d{1,14}$'
```
**Soluciones comunes:**
* **Formato incorrecto**: Usar formato E.164 (+país + número sin espacios)
* **Permisos insuficientes**: Verificar permisos de transferencia en la cuenta
* **SIP mal configurado**: Validar URI SIP, IP y puerto correctos
* **Firewall bloqueando**: Abrir puertos necesarios para SIP (5060)
* **Credenciales erróneas**: Verificar autenticación SIP
* **Número inválido**: Probar con número alternativo conocido
**Síntoma**: Webhooks lentos, con fallos, o respuestas inesperadas
**Diagnóstico avanzado:**
```bash theme={null}
# Test de latencia completa
curl -w "@curl-format.txt" -o /dev/null -s \
-X POST "https://your-api.com/webhook" \
-H "Content-Type: application/json" \
-d '{"test": "data"}'
# Verificar certificados SSL
openssl s_client -connect your-api.com:443 -servername your-api.com
# Test de carga básica
for i in {1..10}; do
curl -s -o /dev/null -w "%{http_code} %{time_total}\n" \
https://your-api.com/webhook &
done
wait
```
**Optimizaciones recomendadas:**
* **Base de datos**: Optimizar queries, añadir índices apropiados
* **Caching**: Implementar Redis/Memcached para datos frecuentes
* **CDN**: Usar CDN para recursos estáticos y geolocalización
* **Connection pooling**: Reutilizar conexiones de base de datos
* **Async processing**: Procesar tareas pesadas de forma asíncrona
* **Circuit breaker**: Implementar patrón para manejo de fallos
**Síntoma**: Recalls no se ejecutan, fallan, o violan compliance
**Diagnóstico del sistema:**
```json theme={null}
// Revisar logs del sistema recall
{
"recall_id": "rec_12345",
"status": "failed",
"error_code": "INVALID_TIMEZONE",
"last_attempt": "2025-01-20T15:30:00Z",
"attempts_remaining": 1,
"failure_reason": "Outside business hours",
"next_scheduled": "2025-01-21T09:00:00Z"
}
```
**Soluciones específicas:**
* **Formato de números**: Validar E.164 antes de programar recall
* **Zonas horarias**: Configurar correctamente timezone del cliente
* **Horarios comerciales**: Revisar configuración de business hours
* **Límites excedidos**: Verificar max\_attempts y resetear si necesario
* **Compliance violations**: Auditar lista de "No Llamar" y opt-outs
* **Scheduling conflicts**: Verificar no solapamiento con holidays/weekends
## Configuración de Alertas y Monitoreo
### Sistema de Alertas Proactivo
Configura alertas automáticas para mantener el sistema funcionando óptimamente:
```json theme={null}
{
"alerts": {
"transfer_failure_rate": {
"metric": "failed_transfers_percentage",
"threshold": 5.0,
"period": "5_minutes",
"severity": "high",
"actions": ["email_admin", "slack_notification"]
},
"webhook_high_latency": {
"metric": "webhook_response_time_avg",
"threshold": 8.0,
"period": "1_minute",
"severity": "medium",
"actions": ["dashboard_warning", "email_devops"]
},
"recall_compliance_violation": {
"metric": "compliance_violations",
"threshold": 1,
"period": "1_hour",
"severity": "critical",
"actions": ["immediate_stop", "legal_notification", "ceo_alert"]
},
"caller_id_verification_failed": {
"metric": "caller_id_verification_failures",
"threshold": 3,
"period": "24_hours",
"severity": "medium",
"actions": ["admin_email", "suspend_outbound"]
}
}
}
```
### Dashboard de Métricas en Tiempo Real
Monitor clave a implementar en tu dashboard operativo:
* **Transferencias por Hora**: Gráfico de líneas mostrando tasa horaria
* **Latencia de Webhooks**: Histograma de distribución de tiempos de respuesta
* **Success Rate de Recalls**: Porcentaje de recalls exitosos vs fallidos
* **Compliance Score**: Indicador de cumplimiento normativo en tiempo real
* **Caller ID Status**: Estados de verificación de todos los caller IDs registrados
## Mejores Prácticas de Implementación
### Para Transferencias de Alto Rendimiento
* Configure múltiples números de respaldo por si la línea principal falla
* Verifique horarios de atención de todos los destinos de transferencia
* Pruebe conectividad SIP regularmente si usa transferencias internas
* Mantenga documentación actualizada de todos los destinos activos
* Transmita resumen completo de conversación al momento de transferencia
* Incluya información del cliente recopilada durante la interacción
* Proporcione motivo específico y contexto de la escalación
* Adjunte metadata relevante (caller ID, duración, objetivos alcanzados)
Defina jerarquía clara de escalación:
```
Nivel 1: Soporte Básico → Consultas generales, FAQ, procesos estándar
Nivel 2: Especialista → Consultas técnicas, casos complejos
Nivel 3: Supervisor → Quejas, decisiones comerciales, excepciones
Nivel 4: Gerencia → Casos críticos, decisiones ejecutivas
```
### Para Webhooks de Grado Empresarial
* Implemente endpoints RESTful siguiendo estándares HTTP
* Use códigos de estado HTTP apropiados (200, 400, 401, 500, etc.)
* Documente exhaustivamente todos los parámetros y responses
* Implemente versionado de API para mantener compatibilidad
* Implemente rate limiting progresivo para prevenir abuso
* Use autenticación JWT con refresh tokens y expiración
* Valide y sanitice rigurosamente todos los inputs del usuario
* Mantenga logs de auditoría detallados sin exponer datos sensibles
* Configure WAF (Web Application Firewall) para protección adicional
* Configure alertas granulares por tiempo de respuesta y tasa de error
* Implemente health checks automáticos con heartbeat
* Use APM (Application Performance Monitoring) para visibilidad profunda
* Mantenga dashboards en tiempo real para métricas clave
### Para Recalls Compliance y Efectivos
* Audite regulaciones locales de telecomunicaciones regularmente
* Mantenga y actualice listas de "Do Not Call" automáticamente
* Implemente opt-out inmediato en cada interacción
* Documente consentimiento explícito para cada contacto
* Configure auditorías de compliance automatizadas
* Analice patrones de respuesta específicos por industria y región
* Respete automáticamente zonas horarias y horarios culturales locales
* Evite días festivos, vacaciones, y períodos de baja actividad
* Implemente machine learning para optimizar horarios óptimos por perfil
* Ajuste frecuencia según historial de respuesta del contacto
* Modifique estrategia y mensaje según intentos fallidos anteriores
* Considere canal de comunicación preferido del cliente
* Implemente scoring dinámico para priorizar recalls de alto valor
## Próximas Funcionalidades
| Característica | Descripción | Estado de Desarrollo | ETA Estimada |
| ---------------------------- | ----------------------------------------- | -------------------- | ------------ |
| 📞 **Click-to-Call** | Iniciación de llamadas desde web/app | En desarrollo activo | Q1 2025 |
| 🔄 **Multi-canal Sync** | Sincronización entre llamadas, email, SMS | Planeado | Q2 2025 |
| 🎯 **Targeting Inteligente** | Selección automática de canal óptimo | Investigación | Q2 2025 |
| 📱 **WhatsApp Business** | Integración oficial con Meta API | Planeado | Q2 2025 |
| Característica | Descripción | Estado de Desarrollo | ETA Estimada |
| --------------------------- | ---------------------------------------- | -------------------- | ------------ |
| 🧠 **Análisis Emocional** | Detección de sentimientos en tiempo real | Beta cerrada | Q1 2025 |
| 🎯 **Personalización IA** | Adaptación automática por cliente | En desarrollo | Q2 2025 |
| 📈 **Auto-optimización** | Mejoras automáticas via ML | Investigación | Q3 2025 |
| 🔮 **Predicción de Intent** | Anticipación de necesidades | Concepto | Q3 2025 |
## Siguientes Pasos
Una vez configuradas las acciones y herramientas avanzadas, puedes personalizar aún más tu agente con parámetros dinámicos de entrada y configuración de datos de salida para crear workflows completos.
Configura variables dinámicas y personalización por llamada individual
Define extracción inteligente de datos y webhooks de salida post-llamada