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.

Por Lyntev. Actualizado el .
Unos 5 minutos de lectura.

Una solicitud con continuidadLa misma referencia acompaña a la solicitud y evita duplicados.

Traducción publicada el . Guía original en portugués; revisión de la fuente .

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.

Un recorrido que permite recuperarse de las interrupciones
  1. Recibir

    Validar y guardar la solicitud con identificador.

  2. Derivar

    Colocar el trabajo pendiente en una cola persistente.

  3. Registrar

    Asociar contacto, solicitud y responsable en el CRM.

  4. 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.

Defina un contrato para cada campo
CampoRegla propuestaDestino
submission_idÚnico por solicitud; conservado en las repeticionesReferencia externa de la solicitud
emailValidado; identidad según el CRMContacto
servicoValor de una lista controladaTipo de oportunidad
mensagemTexto con límite de tamañoDescripción de la solicitud
submitted_atFecha y hora con huso explícitoMomento 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.

Ejemplo ficticio del contrato de una solicitudjson
{
  "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.

Decida de antemano qué ocurre cuando falla
Situación de pruebaComportamiento esperado
Solicitud no válidaExplicar el campo que corregir; no crear una oportunidad incompleta.
La misma solicitud entregada dos vecesReutilizar la operación; comprobar que no se duplicó.
CRM no disponibleMantener pendiente; repetir de forma limitada y visible.
Respuesta perdida tras guardarReconciliar por el identificador antes de crear de nuevo.
Campo eliminado en el CRMSuspender 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.

Datos del escenario mensual

Cuente los casos del mismo proceso en un mes representativo.

Tiempo de trabajo del equipo, sin contar las esperas.

Trabajo humano que permanece en cada tarea automatizada.

Las demás tareas mantienen el tiempo actual.

Mantenimiento y excepciones, además de la revisión ya contada.

Tiempo potencialmente liberado: 8 h 20 min al mes.

Trabajo actual
13 h 20 minAl mes
Trabajo en el escenario
5 hAl mes

160 tareas aptas y 40 tareas mantenidas en el proceso actual.

Cómo se hace el cálculo

Tareas aptas = tareas mensuales × porcentaje apto ÷ 100.

Trabajo actual = tareas mensuales × minutos actuales ÷ 60.

Trabajo en el escenario = [(tareas no aptas × minutos actuales) + (tareas aptas × minutos de revisión)] ÷ 60 + horas de seguimiento.

La diferencia es el trabajo actual menos el trabajo en el escenario. Puede ser negativa. El cálculo admite un volumen mensual medio, por lo que la cantidad apta puede ser fraccionaria.

No incluye el esfuerzo inicial de implementación. El tiempo liberado no equivale por sí solo a dinero ahorrado: valide los tiempos y la calidad en un piloto.

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.

Wellinton Oliveira

Escrito por

CEO de Lyntev

Tecnología con contexto, análisis propio y fuentes que puede consultar.