Agente de voz IA

Plantillas de manejo de errores

Plantillas para recuperación de errores en Zapier y Make.com cuando las automatizaciones de agentes de voz E-Smart360 fallan.

Plantillas para que tu agente de voz E-Smart360 responda con naturalidad cuando una automatización falla, en lugar de quedarse en silencio o cortar la conversación.

Recuperación de errores en Zapier

Añade este paso como Code by Zapier después de las acciones que pueden fallar (calendario, correo, SMS, CRM):

// Añadir como paso Code by Zapier
const handleAutomationError = (error, context) => {
  const fallbackResponses = {
    calendar_conflict: "Esa franja no está disponible. ¿Busco otro horario?",
    email_bounce: "Parece que el correo no es correcto. ¿Puedes deletrearlo?",
    sms_failed: "No se pudo enviar el mensaje. ¿Prefieres que lo envíe por correo?",
    crm_duplicate: "Encontré tu registro existente. Actualizo tu información.",
    api_timeout: "Está tardando un poco más de lo habitual. Un momento, por favor."
  };

  return {
    "E-Smart360_response":
      fallbackResponses[error.type] ||
      "Tengo un problema técnico. ¿Puedo llamarte de nuevo en 5 minutos?",
    retry_action: error.retryable || false,
    log_error: true
  };
};

Cómo usarlo:

  1. Coloca el paso Code después de la acción que puede fallar.
  2. Mapea el objeto error desde el paso anterior (tipo de error, si es reintentable).
  3. Devuelve E-Smart360_response al callback del agente para que lo diga en voz.
  4. Si retry_action es true, configura un reintento condicional en Zapier.

Tipos de error soportados

TipoCuándo ocurreRespuesta del agente
calendar_conflictLa franja ya está ocupadaOfrece buscar otro horario
email_bounceCorreo inválido o rechazadoPide deletrear el correo
sms_failedFallo en envío SMSOfrece alternativa por correo
crm_duplicateContacto ya existe en CRMConfirma actualización del registro
api_timeoutLa API tarda demasiadoPide esperar un momento

Módulo de manejo de errores en Make.com

Configuración JSON de referencia para validación, timeouts y reintentos en escenarios Make:

{
  "error_handler": {
    "timeout": {
      "max_wait": 5000,
      "fallback_message": "Sigo trabajando en eso..."
    },
    "validation": {
      "email": "regex:^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\\.[a-zA-Z]{2,}$",
      "phone": "regex:^[+]?[(]?[0-9]{3}[)]?[-\\s\\.]?[0-9]{3}[-\\s\\.]?[0-9]{4,6}$",
      "date": "future_date_only"
    },
    "retry_policy": {
      "max_attempts": 3,
      "backoff": "exponential"
    }
  }
}

Secciones del módulo:

SecciónFunción
timeoutTiempo máximo de espera (ms) y mensaje de voz mientras la automatización responde
validationReglas regex para correo y teléfono; fechas solo futuras
retry_policyHasta 3 reintentos con backoff exponencial ante fallos transitorios

Buenas prácticas

  • Siempre devuelve una respuesta hablada al agente cuando falle una acción externa.
  • Registra los errores (log_error: true) para depurar en Zapier/Make sin interrumpir la llamada.
  • Limita los reintentos a errores transitorios (timeout, 503); no reintentes conflictos de calendario sin cambiar la franja.
  • Prueba cada tipo de error en staging antes de producción.

Guías relacionadas