Cómo conectar un formulario de la web al CRM sin perder solicitudes
Conectar un formulario al CRM debe transformar cada solicitud válida en un registro que alguien pueda seguir. El trabajo incluye definir campos, distinguir contactos y solicitudes, tratar interrupciones y confirmar la entrega. Esta guía ayuda a preparar la conexión con el equipo técnico, tanto con un conector existente como con una integración a medida.
Al terminar, podrá:
- Definir el contrato de los datos
- Probar repetición y recuperación
- Estimar el tiempo con las excepciones incluidas
Dibuje el recorrido completo de una solicitud
Elija un formulario y un destino. Por ejemplo: solicitud de presupuesto, creación o identificación del contacto, apertura de oportunidad y asignación a una persona responsable. Confirme primero si el CRM ofrece una conexión que cubra ese recorrido, los campos necesarios y un historial de fallos consultable.
Separe el acuse al visitante de la conclusión en el CRM. En una integración con procesamiento posterior, «solicitud recibida» solo debe aparecer después de guardar la solicitud de forma recuperable. El equipo debe distinguir recibido, pendiente, concluido y por revisar. Un correo de aviso, por sí solo, no demuestra que el CRM haya recibido todo.
- Recibir
Validar y guardar la solicitud con identificador.
- Derivar
Colocar el trabajo pendiente en una cola persistente.
- Registrar
Asociar contacto, solicitud y responsable en el CRM.
- Confirmar
Guardar el resultado y hacer visibles las excepciones.
Propuesta de arquitectura que adaptar al conector y a las garantías del proveedor.
Defina un contrato para cada campo
Escriba el nombre, tipo, obligatoriedad y destino de los campos antes de conectar aplicaciones. Una solicitud y un contacto son entidades distintas: la misma persona puede enviar dos solicitudes legítimas. El identificador del envío acompaña a la solicitud; el identificador del CRM acompaña al contacto.
La API de contactos de HubSpot documenta operaciones con correo o propiedades únicas, según la operación utilizada. Confirme la regla de su proveedor y la política de actualización. No una personas solo por tener el mismo nombre ni sustituya datos ya confirmados por campos vacíos de un formulario.
| Campo | Regla propuesta | Destino |
|---|---|---|
| submission_id | Único por solicitud; conservado en las repeticiones | Referencia externa de la solicitud |
| Validado; identidad según el CRM | Contacto | |
| servico | Valor de una lista controlada | Tipo de oportunidad |
| mensagem | Texto con límite de tamaño | Descripción de la solicitud |
| submitted_at | Fecha y hora con huso explícito | Momento de recepción |
Valide en el servidor y limite los accesos
La validación en el navegador ayuda a corregir errores al rellenar. MDN explica por qué esa validación también debe existir en el servidor: el envío puede llegar por otra vía. Valide tipos, campos permitidos y tamaños; devuelva mensajes que permitan corregir la solicitud.
Las credenciales del CRM quedan en el servidor con los permisos necesarios para la operación. Defina protección contra abusos y el plazo de conservación de los datos de diagnóstico. En los registros técnicos, prefiera identificadores y estados a copiar íntegramente mensajes personales. Una solicitud de presupuesto tampoco debe cambiar automáticamente las preferencias de marketing.
{
"version": 1,
"submission_id": "demo-00042",
"submitted_at": "2026-11-17T10:15:00Z",
"contacto": { "nome": "Ana Exemplo", "email": "ana@example.com" },
"pedido": { "servico": "manutencao", "mensagem": "Solicitud ficticia." }
}Haga que una repetición produzca el mismo resultado
Una interrupción puede producirse después de que el CRM guarde el registro, pero antes de que la confirmación llegue a la web. Reenviar sin comprobar puede crear un duplicado. La documentación de webhooks de Stripe describe repeticiones y eventos duplicados; es un ejemplo de comportamiento que debe confirmar en el contrato del proveedor utilizado.
Pida un mecanismo de idempotencia: reconocer una operación ya aplicada y devolver el resultado existente. La reserva del identificador debe soportar dos intentos simultáneos. Si la operación tiene varias etapas, guarde el progreso y señale la conclusión solo después de las etapas obligatorias. Cuando el destino no ofrece una clave única adecuada, hay que definir cómo reconciliar resultados inciertos.
Decida de antemano qué ocurre cuando falla
Los intentos automáticos necesitan intervalos, límite y una salida para revisión humana. Respete las indicaciones del proveedor sobre límites de uso. Defina quién recibe la alerta, dónde consulta la solicitud y cómo retoma el procesamiento sin volver a introducir los datos.
En el piloto, compare las solicitudes válidas recibidas con las concluidas, pendientes y derivadas a revisión. Cada identificador debe tener un estado explicable. Haga también una prueba de recuperación: restablecer la conexión debe permitir concluir las solicitudes pendientes sin crear otras nuevas.
| Situación de prueba | Comportamiento esperado |
|---|---|
| Solicitud no válida | Explicar el campo que corregir; no crear una oportunidad incompleta. |
| La misma solicitud entregada dos veces | Reutilizar la operación; comprobar que no se duplicó. |
| CRM no disponible | Mantener pendiente; repetir de forma limitada y visible. |
| Respuesta perdida tras guardar | Reconciliar por el identificador antes de crear de nuevo. |
| Campo eliminado en el CRM | Suspender el intento no válido y avisar al responsable. |
Estime el tiempo incluyendo las excepciones
En este escenario ficticio, 200 tareas al mes de 4 minutos representan 13 horas y 20 minutos. Si el 80% es apto, quedan 160 tareas que revisar durante 0,5 minutos y 40 tareas manuales de 4 minutos. Sumando una hora mensual de seguimiento, el nuevo total es de 5 horas: la diferencia potencial es de 8 horas y 20 minutos.
Use el simulador con mediciones de su proceso. La estimación no incluye automáticamente configuración inicial, aprendizaje ni incidentes extraordinarios, ni convierte tiempo en dinero. La diferencia puede ser negativa. Compare la proyección con el piloto y ajuste el porcentaje apto cuando descubra excepciones reales.
Entregue una ficha que permita implementar y comprobar
Cumplimente esta ficha antes de implementar. Después del piloto, añada los resultados de las pruebas y la persona responsable de la continuidad. Una conexión es más fácil de mantener cuando el equipo conoce los campos, estados y procedimiento de recuperación.
Ficha para su proyecto
Ficha de conexión formulario–CRM Formulario de origen y finalidad: CRM, objeto de destino y responsable: Campos obligatorios y reglas de actualización: Identificador único de cada solicitud: Regla para encontrar o crear el contacto: Estados: recibido / pendiente / concluido / por revisar Dónde se guarda una solicitud todavía no entregada: Límite de intentos y destino de las alertas: Cómo reconciliar una respuesta perdida: Plazo de conservación de los datos técnicos: Pruebas: válido / repetido / simultáneo / indisponibilidad / recuperación Recuento de solicitudes recibidas y destino de cada una: Tiempo manual medido, excepciones y seguimiento: Responsable de la aprobación y fecha:
Estime el tiempo de trabajo
Compare el esfuerzo actual con un escenario que incluye revisión humana, tareas no automatizadas y seguimiento. Los valores iniciales son un ejemplo ficticio.
Los cálculos se hacen en este navegador. Los valores no se envían ni se guardan.
Fuentes y criterios
Contenido elaborado con ayuda de IA e investigación en fuentes técnicas, con comprobación de los ejemplos y cálculos pertinentes. Las referencias fundamentan las decisiones de la guía; los ejemplos identificados como ficticios permiten probar el método.
