Solución de Problemas con Zapier

Errores de Autenticación

Clave API Inválida

Síntoma: Zapier muestra "Invalid API Key" o "Authentication failed" al conectar.

Soluciones:

1. Verifica que copiaste la clave completa (debe empezar con ctza_)
2. Genera una nueva clave en Configuración → Integraciones → Claves API
3. Asegúrate de no tener espacios antes o después de la clave
4. Si regeneraste la clave, actualiza la conexión en Zapier: ve a My Apps → Cotizera → Reconnect

Clave Expirada

Síntoma: Un Zap que funcionaba deja de ejecutarse con error de autenticación.

Soluciones:

1. Ve a Configuración → Integraciones → Claves API y verifica el estado de tu clave
2. Si expiró, genera una nueva y reconecta en Zapier
3. Considera crear claves sin fecha de expiración para integraciones de larga duración

Permisos Insuficientes

Síntoma: Error "Forbidden" o "Insufficient permissions" en acciones específicas.

Soluciones:

1. Verifica que tu clave API tiene los permisos necesarios (lectura, escritura)
2. Solo usuarios con rol OWNER pueden generar claves API con permisos completos
3. Los COLLABORATOR tienen acceso limitado — contacta al administrador de tu cuenta

El Trigger No Se Dispara

Verificaciones Básicas

1. ¿El Zap está encendido? — Verifica que el switch del Zap está en ON (verde)
2. ¿El evento ocurrió después de activar el Zap? — Los Zaps no capturan eventos anteriores a su activación
3. ¿El tipo de evento es correcto? — Si configuraste "Quote Status Changed" pero creaste una cotización nueva, el trigger no se dispara

El Trigger No Encuentra Datos de Prueba

Síntoma: Al configurar el trigger, Zapier dice "We couldn't find any samples".

Soluciones:

1. Crea un registro de prueba en Cotizera (una cotización, cliente o producto según el trigger)
2. Haz clic en "Find new records" en Zapier
3. Si sigue sin funcionar, verifica que tu clave API tiene permisos de lectura

Delay en la Ejecución

Síntoma: El Zap se ejecuta pero con retraso.

Explicación: Zapier verifica triggers cada 1-15 minutos según tu plan:

• Plan gratuito: cada 15 minutos
• Starter: cada 15 minutos
• Professional: cada 2 minutos
• Team/Company: cada 1 minuto

Errores en Acciones

Campos Requeridos Faltantes

Síntoma: Error "Missing required field" al ejecutar una acción.

Soluciones:

1. Revisa la tabla de campos requeridos en la guía de integración
2. Para Create Quote, necesitas clientId e items — usa la búsqueda "Find Client" para obtener el ID
3. Para Create Client, necesitas name y email
4. Para Create Product, necesitas name y price

ID de Cliente o Producto Inválido

Síntoma: Error "Client not found" o "Product not found".

Soluciones:

1. Usa las búsquedas de Cotizera ("Find Client", "Find Product") en un paso previo para obtener IDs válidos
2. No uses IDs de otras herramientas (como HubSpot) — los IDs de Cotizera son internos
3. Verifica que el cliente/producto no fue eliminado

Rate Limiting

Síntoma: Error 429 "Too Many Requests".

Explicación: Cotizera permite 30 requests por minuto por clave API.

Soluciones:

1. Si tienes Zaps de alto volumen, espacia las ejecuciones usando Delay by Zapier
2. Usa una clave API diferente para cada Zap de alto tráfico
3. Contacta soporte si necesitas un límite mayor

Códigos de Error Comunes

Pasos de Diagnóstico

1. Revisar el Historial de Tareas en Zapier

1. Ve a zapier.com/app/history
2. Busca la ejecución fallida
3. Haz clic para ver los detalles de cada paso
4. El paso con error mostrará el mensaje de error y los datos enviados

2. Revisar el Log de Actividad en Cotizera

1. Ve a Configuración → Actividad en Cotizera
2. Filtra por "API" para ver solicitudes de la API
3. Busca errores cercanos a la hora de la falla del Zap
4. El log muestra el endpoint, método, código de respuesta y detalles del error

3. Verificar Permisos de la Clave API

1. Ve a Configuración → Integraciones → Claves API
2. Verifica que la clave usada en Zapier está activa
3. Revisa los permisos asignados (lectura, escritura, admin)

4. Probar la API Directamente

Si el problema persiste, prueba la API de Cotizera directamente con cURL:

# Verificar autenticación
curl -H "Authorization: Bearer ctza_tu_clave_aqui" \
  https://cotizera.com/api/v1/quotes
 
# Crear un cliente de prueba
curl -X POST https://cotizera.com/api/v1/clients \
  -H "Authorization: Bearer ctza_tu_clave_aqui" \
  -H "Content-Type: application/json" \
  -d '{"name": "Test Client", "email": "test@example.com"}'

Si la API responde correctamente pero Zapier falla, el problema está en la configuración del Zap.

5. Reconectar la Cuenta

Si nada funciona, desconecta y reconecta tu cuenta de Cotizera en Zapier:

1. Ve a zapier.com/app/connections
2. Busca "Cotizera"
3. Haz clic en "Reconnect"
4. Ingresa tu clave API actualizada

Obtener Ayuda

Si después de seguir esta guía el problema persiste:

• Email: soporte@cotizera.com
• Documentación: Consulta la Integración con Zapier y la guía de Webhooks
• Zapier Support: Para problemas específicos de Zapier, contacta support.zapier.com