Páginas públicas
Dos primitivas permiten que alguien sin usuario en tu workspace interactúe con tus datos de forma controlada: los Public Forms (un formulario en una URL que crea registros) y las Public Pages (un link con token para ver y actuar sobre algo concreto, como aprobar una cotización o pagar una donación). Esta página es para administradores. Ambas viven en Configuración → Integraciones y API y ambas dependen de que el plan del workspace las incluya.
| Public Forms | Public Pages | |
|---|---|---|
| Quién la abre | Cualquiera con la URL del form (pública) | Quien reciba el link, único por registro |
| Qué hace | Crea (o actualiza) registros | Muestra un componente con datos en vivo y permite acciones |
| Identidad | Anónimo, con anti-spam | Token de 256 bits, opcional contraseña y vencimiento, normalmente de un solo uso |
| Permiso | manage_public_forms | manage_public_links |
| Caso típico | Formulario de contacto o de donación en tu sitio | ”Revisá y aceptá tu cotización”, recibo, estado de un pedido |
Public Forms
Crear un formulario
Identidad
Public Forms → Nuevo form: etiqueta, nombre técnico y una descripción interna.
Entidades
Qué entidades llena el form, en orden. Un form puede crear registros en varias (un Donante y una Donación que lo referencia): se procesan de arriba hacia abajo, así una entidad puede linkear a cualquiera que esté antes.
Acción al enviar
Mostrar mensaje (HTML de agradecimiento, con vista previa) o Redirigir a URL. Los paquetes pueden traer una tercera: redirigir al checkout de un procesador de pago generado al momento (es lo que usa el formulario de donación recurrente de Fundraising).
Campos
En el detalle, pestaña Fields: una tarjeta por entidad donde elegís qué campos del registro expone el form, con label, ayuda, obligatorio y orden propios. El form no inventa campos: solo expone los de la entidad, y los autonuméricos y automáticos quedan afuera. Cada campo puede tener un Valor por defecto: el visitante lo ve precargado y lo puede cambiar.
Modo de cada entidad
En el encabezado de cada tarjeta elegís qué hace el form con esa entidad:
| Modo | Qué hace | Cuándo usarlo |
|---|---|---|
| Crear siempre | Crea un registro nuevo en cada envío. | Donaciones, consultas, inscripciones. |
| Buscar y vincular | Busca un registro por un campo clave (por ejemplo, el email). Si existe, lo usa para vincular lo que sigue sin modificarlo; si no, lo crea. | Contactos y cuentas: es lo recomendado para un formulario público. |
| Buscar y actualizar | Igual, pero si existe lo actualiza con lo que mandó el visitante. | Sólo si el campo clave no lo puede adivinar un tercero. |
Buscar y actualizar muestra un aviso en rojo, y con razón: cualquiera que conozca un email que ya existe puede cambiar los datos de ese registro desde el formulario, sin loguearse. Para un formulario de contacto usá Buscar y vincular. En un sitio público un form en este modo directamente no se puede usar.
Tipo de registro y valores fijos
Debajo de los campos de cada tarjeta:
- Record Type del registro que se crea:
- El default de la entidad.
- Siempre el mismo: elegís uno.
- Lo elige el visitante: el form muestra una pregunta (por ejemplo, “¿Qué necesitás?”) con opciones que escribís vos, y cada opción crea el registro con su Record Type. El visitante sólo puede elegir entre esas opciones.
- Valores fijos: campos que el visitante no ve, con el valor con el que se crea el registro (por ejemplo, Origen = Sitio web o Asunto = Consulta desde el sitio). Elegís si se aplican Al crear o Al crear y al actualizar. Un campo no puede ser a la vez pregunta del form y valor fijo.
Ejemplo: el formulario de consulta del paquete Real Estate busca al Contacto por email (Buscar y vincular) y crea un Caso vinculado, con la pregunta “¿Qué necesitás?” que lo crea como Consulta de propiedad o Pedido de tasación.
Si después borrás o desactivás el Record Type que usa un form, los envíos se crean con el tipo por defecto de la entidad. Revisá tus formularios cuando cambies los tipos.
Origen del lead
Debajo de los valores fijos de cada entidad está Origen del lead: elegí en qué campos de texto del registro se guarda de dónde vino la visita: la fuente, el medio y la campaña de un link con UTM, el clic de un anuncio de Google o Meta, el sitio que la mandó y la página por la que entró.
Sólo aplica cuando el formulario se envía desde un sitio público y sólo al crear el registro. Si la entidad no tiene un campo de texto para eso, creá uno (por ejemplo, “Origen”) y volvé.
Publicar
En el detalle, Embed code te da la URL alojada (/public/forms/<token>) y un iframe para pegar en tu sitio. El form tiene el toggle Activo — aceptando submits; inactivo, la URL devuelve “no encontrado”. Rotar token invalida la URL actual al instante.
Qué pasa al enviar
Cada envío crea los registros con el mismo pipeline que una carga manual: validación de campos, automations, sharing, historial (ver Qué pasa al guardar un registro). El dueño de los registros es el Owner por defecto del form, si lo configurás. La pestaña Submissions lista cada envío con su estado (éxito, validación fallida, rate limit, captcha, honeypot) y los registros que creó.
Anti-spam
- Rate limit por IP por minuto y un tope diario por form.
- Honeypot: un campo oculto que los bots completan; si viene con valor, el envío se descarta en silencio.
- reCAPTCHA v3 opcional, con score mínimo (requiere que Nxar tenga configurada la clave secreta; la pública la cargás vos).
Permisos y límites
manage_public_forms para administrarlos. Los forms no permiten subir archivos ni tienen pasos múltiples; para eso, un Visual Component publicado (abajo).
Public Pages
Una Public Page es un Visual Component que su autor marcó como publicable: puede mostrarse en una URL /public/<slug>/<token> sin login. Los verticales traen las suyas (CPQ: la vista de aprobación de la cotización; Fundraising: el recibo) y tu equipo puede crear otras (Visual Components).
Cómo funciona
- Los datos se leen en vivo en cada apertura: si la cotización cambió, el cliente ve la versión actual.
- Las acciones (aceptar, firmar, pagar) corren del lado del servidor y pueden revocar el link al completarse: el siguiente intento de abrirlo da “no encontrado”. Por eso la mayoría son de un solo uso.
- Cada vista y cada acción quedan en el audit log del link (fecha, IP), aunque el link ya esté revocado.
Administrar
Public Pages lista, en dos niveles:
- Páginas — una fila por componente publicable, con su ruta
/public/<slug>y cuántos links tiene (y cuántos activos). Las que trae un paquete aparecen como Managed. - Links de una página — token, fecha, vistas, si tiene contraseña, estado (Activo, Usado, Revocado, Expirado) y acciones: Copiar URL, Ver audit log, Revocar.
Nuevo public link genera uno a mano: elegís la página, completás sus inputs (por ejemplo, qué cotización), opcionalmente Expira en y Password. En la práctica, los links los generan las automations de los paquetes al enviar (CPQ crea el de aprobación al mandar la cotización y lo pone en el email), así que el wizard es para casos puntuales.
Los links revocados o vencidos se borran automáticamente a los 90 días (su audit log, con ellos).
Seguridad
El único control de acceso es el token (imposible de adivinar: 256 bits). Quien tenga la URL puede ver el contenido, así que tratala como un documento confidencial. Hay límites de aperturas por hora, bloqueo temporal tras varios intentos de contraseña fallidos, y el componente corre en un sandbox que solo puede ejecutar las acciones declaradas.
Permisos
manage_public_links para crear y revocar links desde Configuración. Las automations que generan links no lo necesitan: corren con el contexto de ejecución del paquete.