Solución de problemas
Casos reales del pipeline de Farvane, no una lista genérica. Si necesitas el detalle técnico exacto de un código de respuesta, revisa la referencia de la API.
El email no me llega
Primero revisa la carpeta de spam o promociones del cliente de email — es la causa más frecuente. Si no está ahí, entra en tu formulario en el dashboard, pestaña Ajustes, y confirma que los emails de destino son correctos: un error de tecleo ahí hace que el envío se procese pero nunca llegue a ningún sitio. Si tu plan exige restricción de dominio y tu formulario tiene una lista de dominios permitidos configurada, comprueba que el dominio desde el que envías esté en esa lista — si no lo está, la API responde 403 en vez de aceptar el envío, y el email nunca llega a enviarse.
Mi envío se marca como spam
El campo oculto botcheck es la trampa anti-spam (honeypot): debe llegar siempre vacío. Un motivo muy frecuente de falso positivo es un gestor de contraseñas que autorrellena todos los campos del formulario, incluido este. Todos los snippets de Farvane ya incluyen autocomplete="off" y tabindex="-1" en ese campo precisamente para evitarlo — si copiaste el formulario hace tiempo o lo modificaste a mano, comprueba que esos dos atributos sigan presentes.
Recibo un error 429
Este código cubre dos límites distintos, según el mensaje. "Demasiadas peticiones" es el límite de 20 envíos por minuto para el mismo access_key + IP — una protección anti-abuso que se resuelve sola esperando un minuto. "Límite de envíos mensuales alcanzado" significa que tu formulario agotó la cuota de envíos de tu plan este mes.
Recibo "access_key inválido o ausente" o "Formulario no encontrado"
La API devuelve 400 con uno de estos mensajes en dos casos: el access_key no es un UUID válido (revisa que lo copiaste completo, sin espacios ni caracteres de más) o corresponde a un formulario que ya no existe, por ejemplo si lo borraste desde el dashboard. Copia el access_key de nuevo desde la pestaña Ajustes del formulario correspondiente.