El módulo Formularios web le permite diseñar un formulario dentro de Axentra (un "contáctanos", una "solicitud de cotización", etc.), conectarlo a su propio sitio pegando una URL, y recibir cada respuesta dentro del ERP. No hace falta programar ni contratar un servicio externo de formularios: usted arma el formulario aquí, pega la URL de envío en el <form> HTML que ya tiene en su página, y las respuestas llegan protegidas contra bots por Cloudflare Turnstile y limitadas a los dominios que usted autorice.
Se administra desde Formularios en el menú principal (permiso forms.form.view).
su-empresa.axentra.com.do/e-forms/<uuid>.action de un <form> en el sitio del cliente.El endpoint /e-forms/<uuid> es una de las pocas excepciones REST del sistema (junto a /healthz, la recepción DGII y el webhook de Uber Eats). Vive en el contenedor de su empresa, así que sus respuestas nunca se mezclan con las de otro inquilino.
Contáctanos) y descripción opcional para su referencia.email, telefono). Debe ser única dentro del formulario. Se autocompleta a partir de la etiqueta la primera vez.El límite de 8 campos es intencional: un formulario web es para captar un contacto o una solicitud, no para reemplazar un Typeform. Si necesita más, considere dos formularios o el flujo de contactos del ERP.
| Tipo | Uso | Lleva opciones |
|---|---|---|
| Texto | Nombre, asunto, texto corto | No |
| Correo electrónico | No | |
| Teléfono | Número de contacto | No |
| Número | Cantidad, presupuesto | No |
| URL | Sitio web, enlace | No |
| Texto largo | Mensaje, comentario | No |
| Lista desplegable | Elegir una opción de una lista | Sí |
| Casilla | Sí/No (acepto términos) | No |
| Opciones (radio) | Elegir una opción visible | Sí |
Los valores llegan ya convertidos al tipo declarado: los campos Número se guardan como número, las Casillas como verdadero/falso, y el resto como texto.
En el detalle del formulario, la pestaña Endpoint muestra la URL de envío (POST) y un snippet de ejemplo. Copie la URL y péguela en el action de su <form>:
<form action="https://su-empresa.axentra.com.do/e-forms/UUID-DEL-FORMULARIO" method="POST">
<input name="nombre" type="text" required />
<input name="email" type="email" required />
<textarea name="mensaje"></textarea>
<!-- Widget de Cloudflare Turnstile: aporta el token anti-bot -->
<div class="cf-turnstile" data-sitekey="SU-SITE-KEY"></div>
<script src="https://challenges.cloudflare.com/turnstile/v0/api.js" async defer></script>
<button type="submit">Enviar</button>
</form>
name de cada <input> debe coincidir con la clave (key) del campo en Axentra.cf-turnstile-response con el token que Axentra valida.Cada envío se valida contra Cloudflare Turnstile antes de guardarse. Turnstile es la alternativa gratuita y sin fricción a reCAPTCHA: la mayoría de los visitantes legítimos pasan sin resolver nada.
turnstile.cloudflare.com → Add site.
data-sitekey).Mientras no configure Turnstile, el endpoint responde 503 forms_not_configured y no acepta envíos. Para probar en desarrollo, Cloudflare ofrece claves de prueba que siempre pasan (site key 1x00000000000000000000AA, secret 1x0000000000000000000000000000000AA).
Cada formulario tiene una lista de orígenes permitidos: los dominios desde los que se aceptan envíos. Axentra compara la cabecera Origin del navegador contra esta lista.
https://ejemplo.com): solo esos sitios pueden enviar; el resto se rechaza y no recibe cabecera CORS (el navegador bloquea la petición).Esto evita que alguien copie su URL de envío y bombardee su formulario desde otro sitio.
En el detalle del formulario, la pestaña Respuestas muestra cada envío recibido:
La lista está paginada (controles anterior/siguiente, "Página X de Y") - nunca carga miles de respuestas de golpe.
Cada respuesta aceptada dispara una notificación en tiempo real: la campana del ERP incrementa en el momento en que entra el envío, sin recargar. Si tiene abierta la pestaña Respuestas del formulario, la nueva fila aparece sola.
| Permiso | Qué permite |
|---|---|
forms.form.view |
Ver la lista de formularios y su detalle |
forms.form.create |
Crear formularios nuevos |
forms.form.update |
Editar un formulario y su configuración |
forms.form.delete |
Eliminar un formulario |
forms.submission.view |
Ver las respuestas recibidas |
Por defecto ADMIN tiene todos estos permisos. Puede dar solo forms.submission.view a un rol de ventas o soporte que deba leer los mensajes sin poder alterar los formularios.
Aún no ha configurado Cloudflare Turnstile. Vaya a Formularios → Configuración Turnstile y guarde su site key y secret key.
Revise que el origen de su sitio esté en la lista de orígenes permitidos del formulario (o déjela vacía mientras prueba). Recuerde que el origen incluye el esquema: https://ejemplo.com, no ejemplo.com.
El atributo name de cada <input> debe coincidir exactamente con la clave (key) del campo en Axentra (distingue mayúsculas y minúsculas).
La notificación viaja por una suscripción en tiempo real; requiere el permiso forms.submission.view. Verifique también que el formulario esté activo.