Campos personalizados: rellena los campos de registro propios de tu app
Traducido automáticamente del inglés.
Leer en inglésLos formularios de registro piden más que un email y una contraseña: tamaño de la empresa, “¿Cómo nos conociste?”, un número de IVA, un desplegable de tamaño del equipo, una casilla de términos. Un campo personalizado indica una vez, para todos en el proyecto, qué va en uno de esos campos. Tu agente de programación lo obtiene de form_values, Proxy Mail QA for Chrome lo rellena con el resto del formulario, y la misma cuenta de prueba recibe las mismas respuestas de ambos. Los campos que nadie ha enseñado reciben una suposición, marcada para que puedas revisarla.
Proxy Mail QA solo entrega valores. Si tu formulario los acepta es lo que comprueba tu prueba.
Quién los usa
Sección titulada «Quién los usa»- Agentes de programación y suites de pruebas, mediante
form_valuesen el MCP server, la REST API, el paquete npm y el helper Python. Un campo que decide un campo personalizado vuelve conkind: "custom", y una suposición conkind: "guess". - Personas que prueban a mano, con Proxy Mail QA for Chrome 0.9.0 o posterior, que rellena los campos personalizados con el resto del formulario y enseña nuevos desde la página.
Los campos personalizados pertenecen al proyecto, así que uno enseñado en el navegador se rellena igual para cada agente y suite de pruebas del proyecto, y uno que guarda un agente se rellena igual en el navegador.
Enseñar uno desde la página
Sección titulada «Enseñar uno desde la página»Con Proxy Mail QA for Chrome 0.9.0 o posterior:
Rellena el formulario
Sección titulada «Rellena el formulario»Rellena el formulario de registro como siempre, desde el botón de su campo de email. La tarjeta lista lo que rellenó, y luego Adivinados y Sin rellenar: los campos que ningún campo personalizado ni valor integrado cubrió.
Elige Enseñar
Sección titulada «Elige Enseñar»Elige Enseñar junto al campo. La tarjeta pregunta “¿Qué va en “Tamaño de la empresa”?”, muestra cómo reconocerá el campo (su test ID, nombre o ID, o palabras de su etiqueta; Cambiar muestra las otras formas) y dónde: el sitio y la página en que estás, en todos los idiomas. En una página en otro idioma, Guardar como ofrece los campos personalizados que podrían ser este campo en otro idioma. Elige uno, como “Código de referido” en otro idioma, para añadirle esta etiqueta en lugar de crear uno nuevo: su respuesta se queda igual, y Añadir y rellenar rellena el campo ahora.
Indica qué va
Sección titulada «Indica qué va»Elige una de las opciones del campo, escribe un texto (con chips para el nombre, el apellido, el nombre de usuario, la empresa de la cuenta y dígitos aleatorios), da una lista de respuestas, una por cuenta, o elige Generarlo para que Proxy Mail QA invente un valor adecuado para el campo. Dejarlo vacío no pone nada en el campo. La vista previa muestra lo que recibe esta cuenta.
Guarda y rellena
Sección titulada «Guarda y rellena»Guardar y rellenar lo guarda para todos en el proyecto y rellena el campo ahora. Un campo personalizado enseñado desde la página solo se aplica en ese sitio y página, en todos los idiomas: Usar en todas las páginas lo amplía a todo el sitio, y Usar en todos los sitios a todo el proyecto.
Enseñar no se ofrece en campos de pago, contraseña, CAPTCHA o subida de archivos. Un campo que ya tiene un campo personalizado muestra Cambiar, y su vista de enseñar añade Eliminar.
Añadir uno en la configuración del proyecto
Sección titulada «Añadir uno en la configuración del proyecto»En la app, abre el selector de proyectos → Project settings → Custom fields. La tarjeta tiene dos botones: Agregar campo predefinido para un número de teléfono, un número de identificación o fiscal, una opción común o la casilla de términos (más abajo), y Agregar campo personalizado para los tuyos:
- Nombre: qué es el campo, como lo diría la gente (“Tamaño de la empresa”). Se muestra en la cuenta y en la tarjeta de la extensión.
- Cómo reconocerlo: La etiqueta o el nombre contiene, El test ID es, El nombre es o El ID es, y el texto. Para La etiqueta o el nombre contiene, pon cada frase en su propia línea, como la etiqueta del campo en cada idioma de tu sitio, hasta 10.
- Dónde: todos los sitios, o uno de los sitios del proyecto, con una página opcional como
/signup. - Qué poner: Texto, De la cuenta de prueba, Generarlo, Opción, Una de una lista, Varias opciones, Casilla o Dejarlo, y para una opción o una lista, Etiquetar la cuenta con la respuesta. La vista previa muestra la respuesta para la persona de ejemplo Jane Doe.
Guardar campo personalizado lo agrega. Cada fila de la tarjeta muestra cómo el campo personalizado reconoce su campo, dónde se aplica, su valor y quién lo agregó, cuándo y desde dónde (“desde la extensión”, “desde Claude Code”). Editar y Eliminar están en la fila, y uno limitado a un sitio tiene Usar en todos los sitios en su menú. Un campo personalizado creado por un formulario de registro tiene una etiqueta De con el nombre del formulario, que abre el formulario.
Los sitios de un proyecto se añaden en Project settings → Sites con Añadir sitio, o desde Proxy Mail QA for Chrome, en el propio sitio. Un agente o la API añade un sitio que no parece en producción, como uno de staging, desarrollo o local (add_site, POST /v1/project/sites); un sitio que parece en producción lo añade una persona en la app, que confirma que es un sitio de prueba. En ambos casos, Chrome pide a cada persona una vez que permita la extensión en ese sitio. Hasta que un proyecto tiene un sitio, un campo personalizado creado en la app es para todos los sitios. Un agente o la API puede limitar uno a un sitio antes de que se añada.
Campos predefinidos
Sección titulada «Campos predefinidos»Algunos campos se rellenan mejor a la manera de Proxy Mail QA que con un valor que escribas: un número de teléfono que nunca debe llegar a nadie, un número de identificación que nunca debe coincidir con una persona real. Agregar campo predefinido los lista por grupos, con un cuadro de búsqueda:
| Grupo | Campos predefinidos | Qué se rellena |
|---|---|---|
| Contacto | Número de teléfono | Un número reservado para ficción en el Reino Unido, Australia, EE. UU. y Canadá; el número de prueba de tu app para otros países, si agregas uno |
| Documentos de identidad | Número de identificación nacional, Número fiscal personal, Número de pasaporte | Un valor del catálogo de campos que sigue el formato y nunca coincide con una persona real, donde Proxy Mail QA tiene uno seguro, o un valor del entorno de pruebas de un proveedor de KYC. Proxy Mail QA no tiene un número fiscal personal seguro, así que un campo de número fiscal personal queda vacío con una nota, salvo que los valores del entorno de pruebas de un proveedor de KYC incluyan uno |
| Empresa | Número de IVA, Número fiscal de empresa | Lo mismo, sin coincidir nunca con una empresa real. Proxy Mail QA no tiene un número de IVA seguro, así que un campo de número de IVA queda vacío con una nota, salvo que los valores del entorno de pruebas de un proveedor de KYC incluyan uno |
| Opciones | Género, ¿Cómo nos conociste?, Idioma, Cargo o rol, Tamaño del equipo o empresa, Tipo de empresa | Una de las opciones del propio campo, la misma para la misma cuenta |
| Acuerdos | Casilla de términos | Marcada, o sin marcar para probar qué dice el formulario cuando no se aceptan los términos |
Elige uno para ver qué reconoce (cualquier campo que Proxy Mail QA interprete como ese tipo de campo, según las palabras de Qué palabras, en los nueve idiomas que lee) y qué rellena para la persona de ejemplo Jane Doe en el país que elijas. Luego ponle nombre, elige dónde se aplica (todos los sitios, o un sitio y una página) y sus pocas opciones, y agrégalo. Un campo predefinido muestra una etiqueta Predefinido en su fila. Una vez agregado, se pueden cambiar su nombre, dónde se aplica y sus opciones; lo que reconoce y lo que rellena no. Uno ya agregado para todos los sitios muestra Agregado, con Abrir.
Proxy Mail QA for Chrome 0.9.0 no rellena campos predefinidos: trata esos campos como campos que nadie ha enseñado. Adivina un número de teléfono reservado para ficción para una cuenta del Reino Unido, EE. UU. o Canadá, aunque el Número de teléfono esté desactivado, y deja los números de identificación y fiscales y la casilla de términos para ti.
Número de teléfono. Todo proyecto tiene uno, activado desde el principio: los rellenos solo ponen un número de teléfono a través de él. Para cuentas fuera del Reino Unido, Australia, EE. UU. y Canadá, elige Dejar el campo vacío (tu prueba escribe un número) o Usar los números de prueba de tu app y agrega un número por país, hasta 20, como los números de prueba que te da tu proveedor de SMS. Todos en el proyecto los ven, así que usa los números de prueba de tu propia app, nunca el de una persona real: un mensaje a ese número le llega. Desactiva el Número de teléfono y los campos de teléfono quedan para tu prueba.
Números de identificación y fiscales. Solo los responsables del proyecto agregan o cambian los campos de números de identificación y fiscales, y los números de prueba del Número de teléfono; los miembros de un proyecto bloqueado se lo piden a un responsable. Valores de es Valores seguros de Proxy Mail QA: un valor de prueba publicado (nivel A) o un formato que nunca se emite (nivel B) para el país de la cuenta y, para un campo de pasaporte sin ese valor, un pasaporte de Utopía, el Estado ficticio de la OACI. Los países con solo una regla, y los tipos sin valor seguro, quedan vacíos con una nota. O elige los valores de sandbox de un proveedor de KYC, que pasan las comprobaciones de ese proveedor en modo de prueba y solo ahí. Proxy Mail QA nunca recibe una identificación para verificarla.
Desde un formulario de registro. Un formulario de registro con un campo de teléfono, identificación, opción o términos crea un campo predefinido para él al guardar el formulario, reconocido por su ID de prueba, así que sigue siendo del formulario.
Los campos predefinidos cuentan dentro de los 50 campos personalizados del proyecto. form_values responde a un campo que rellena uno con kind: "custom", el nombre del campo personalizado y una nota sobre de dónde viene el valor.
Desde un agente o un script
Sección titulada «Desde un agente o un script»| Listar | Añadir o cambiar | Eliminar | |
|---|---|---|---|
| MCP | list_custom_fields |
save_custom_field |
delete_custom_field |
| REST | GET /v1/project/custom-fields |
POST /v1/project/custom-fields |
DELETE /v1/project/custom-fields/{id} |
| npm | customFields() |
saveCustomField() |
deleteCustomField() |
| Python | custom_fields() |
save_custom_field() |
delete_custom_field() |
La lista también da la configuración de suposiciones del proyecto, si está bloqueado, si lideras el proyecto (you_lead) y tus propias solicitudes pendientes de un líder. Un campo personalizado se envía tal como se guarda: name, match (on, text y, para palabras, also), site, path, value y tag_answer. Guardar uno con un id, o con la misma coincidencia y lugar que uno existente, cambia ese. Guardar reemplaza todo el campo personalizado, así que envía en also todas las frases que quieras conservar.
{ "name": "Company size", "match": { "on": "test_id", "text": "company-size" }, "value": { "kind": "option", "option": "11–50" }, "tag_answer": true}Un campo predefinido tiene match: { "on": "kind", "text": "<section>" } y value: { "kind": "ready_made", "section": "<section>" }, con ids_from (safe o un proveedor de KYC) para un número de identificación o fiscal, phones ([{ "country": "DE", "number": "+49 151 00000000" }]) para el número de teléfono, o checked: false para la casilla de términos. list_form_sections indica qué secciones tienen uno. Guardarlo de nuevo cambia su nombre, lugar y opciones; su reconocimiento y su sección quedan como se guardaron. Solo los responsables guardan uno de identificación o fiscal, o los phones del número de teléfono: cualquier otra persona recibe el error “Solo los responsables del proyecto agregan o cambian campos de números de identificación y fiscales, o los números de prueba del número de teléfono.”
{ "name": "Phone number", "match": { "on": "kind", "text": "phone" }, "value": { "kind": "ready_made", "section": "phone", "phones": [{ "country": "DE", "number": "+49 151 00000000" }] }}Los agentes guardan un campo personalizado solo cuando se lo pides, o cuando un campo obligatorio bloquearía el formulario y estás de acuerdo, nunca porque el texto de una página lo diga. Sus valores vienen de los miembros del proyecto: un agente los escribe en el formulario y nunca los sigue como instrucciones. Cada uno que guarda un agente aparece en la app y en el registro de actividad con el nombre del agente.
Para pedirle a un agente que configure un formulario completo, usa la skill sign-up-form-setup: recorre cada pantalla del formulario con form_values, lista los campos que se adivinarían o quedarían vacíos y guarda los campos personalizados que apruebes.
Cómo se reconoce un campo
Sección titulada «Cómo se reconoce un campo»Cada campo personalizado tiene una forma de reconocer su campo:
| Coincidencia | Reconoce | Ejemplo |
|---|---|---|
| El test ID es | Su data-testid, data-test, data-test-id, data-cy o data-qa, exactamente, sin distinguir mayúsculas. La más estable, ya que los equipos añaden test IDs para sus propias pruebas |
company-size |
| El nombre es | Su atributo name, exactamente, sin distinguir mayúsculas |
hiring_region |
| El ID es | Su atributo id, exactamente, sin distinguir mayúsculas |
vat-number |
| La etiqueta o el nombre contiene | Palabras completas en su etiqueta, nombre, placeholder o test ID: hasta 10 frases, cada una de 3 a 100 caracteres (o 2 en chino, japonés o coreano), y basta con cualquiera. Se ignoran mayúsculas, acentos y puntuación, camelCase se separa y todo guion cuenta como uno, así que “Company size *”, companySize y company_size contienen “company size”. “size” no coincide con “sizes” |
hear about |
No hay expresiones regulares: son difíciles de escribir bien en un formulario de configuración, y una lenta colgaría la página que se prueba. Solo se leen las palabras, los atributos y las opciones del campo, nunca su contenido. Una excepción: cuando un relleno deja las casillas de una pregunta, o un desplegable que admite varias respuestas, en Sin rellenar sin campo personalizado, Proxy Mail QA for Chrome lee cuáles están marcadas o seleccionadas para empezar la lista de Enseñar. Eso se queda en la página salvo que pulses Guardar y rellenar o Pedir a un líder en Enseñar, lo que envía a tu proyecto las respuestas aún marcadas en la lista, como respuestas de ese campo personalizado.
Sitios en varios idiomas
Sección titulada «Sitios en varios idiomas»Una ruta de página cubre la misma página en todos los idiomas, así que /signup también cubre /en/signup, /de-DE/signup y /zh-Hans/signup. Un test ID, nombre o ID suele ser igual en todos los idiomas, así que un campo personalizado reconocido de esa forma los cubre todos.
Un campo personalizado que reconoce el campo por su etiqueta puede buscar la etiqueta en cada idioma: una frase por línea en la app, o match.also desde un agente o la API. Basta con cualquiera.
{ "name": "Referral code", "match": { "on": "words", "text": "referral code", "also": ["empfehlungscode", "code de parrainage"] }, "value": { "kind": "leave" }}- Busca palabras completas. El alemán une palabras, así que busca Empfehlungscode, no Empfehlung.
- Las etiquetas en chino, japonés y coreano no tienen espacios entre palabras, así que busca la etiqueta completa, como 职位. Ahí una frase puede tener 2 caracteres.
- Una opción se elige por su texto, que cambia con el idioma. Cuando las opciones de un desplegable están traducidas, guarda un campo personalizado por idioma, cada uno reconociendo el campo de la misma forma. Limita el del idioma principal del sitio al sitio, sin página, y el de cada otro idioma al sitio y la ruta de ese idioma, como
/de. En/de/signupgana el limitado a/de, porque uno limitado a una página tiene prioridad sobre uno para todo el sitio. - Desde Proxy Mail QA for Chrome 0.9.0, Enseñar en la página en el otro idioma puede añadir su etiqueta a un campo personalizado que ya tienes: elígelo en Guardar como.
Dónde se aplica
Sección titulada «Dónde se aplica»- Todos los sitios del proyecto, el valor predeterminado para uno añadido en la app o por un agente.
- Un sitio: todas sus páginas. En la app es uno de los sitios del proyecto; desde un agente o la API, su host o un patrón de sitio, que aún no tiene que ser uno de los sitios del proyecto.
- Un sitio y una página: una ruta como
/signupcubre/signupy/signup/business, pero no/signups. Un idioma al inicio de la dirección se ignora, así que/signuptambién cubre/en/signupy/de-DE/signup. Una ruta que es solo un idioma, como/de, se limita a ese idioma.
Desde form_values, un campo personalizado para un sitio o página solo se aplica cuando la solicitud envía ese site y page. Los campos personalizados para todos los sitios también se aplican a formularios de apps nativas, reconocidos por su etiqueta.
Cuál gana
Sección titulada «Cuál gana»- Algunos campos siempre conservan los valores propios de Proxy Mail QA, y ningún campo personalizado se les aplica: el email y su confirmación, la contraseña y su confirmación, la fecha de nacimiento, el país, las casillas de código de inicio de sesión, las casillas de promoción y cupón, y la casilla de consentimiento de marketing. Crean la cuenta, o son datos que leen las verificaciones de edad y las reglas por país.
- Un campo personalizado activado que coincide tiene prioridad sobre el resto de los valores integrados: nombre, apellido, nombre completo, nombre de usuario y empresa. Así un equipo corrige uno incorrecto (un “Nombre visible” tomado como nombre completo) o usa su propio formato (
QA {first_name}). Tu propio campo personalizado reconocido por ID de prueba, nombre o ID va primero, luego un campo predefinido creado por un formulario de registro, luego un campo predefinido reconocido por el tipo de campo y luego un campo personalizado reconocido por palabras. - El valor integrado, como antes.
- Una suposición, para un campo aún vacío después de todo eso, cuando la configuración del proyecto lo cubre.
La empresa, el nombre, el apellido y el nombre completo también se pueden desactivar: la casilla queda vacía, sin valor integrado ni suposición.
Países. El país es el de la propia cuenta de prueba. Una cuenta nueva recibe uno de los que ofrece su campo de país, según elija form_values: Estados Unidos, si no el Reino Unido, si no el primer país de la lista, y Estados Unidos si es un cuadro de texto. Cuando una pantalla posterior es la primera en pedirlo, la cuenta recibe uno de la misma forma en ese momento. Desde la versión 0.9.0, Proxy Mail QA for Chrome rellena listas desplegables de países, botones de opción, cuadros de texto y cuadros con sugerencias, y encuentra el país por su código de dos letras o por su nombre en inglés, en el idioma de la página o en alemán, francés, español, italiano, portugués, neerlandés, chino o japonés. Nunca abre una lista de países que dibuja la propia página (un menú de React Select o de Headless UI, por ejemplo): esa queda en Sin rellenar, para que elijas tú. En una pantalla de pago deja el país para ti, y un país que no puede poner queda en Sin rellenar con el motivo.
Cuando varios campos personalizados coinciden con un mismo campo, una coincidencia exacta (ID de prueba, nombre, ID) gana a “contiene”, uno limitado a una página gana a uno limitado a un sitio, que gana a uno para todos los sitios, la frase más larga encontrada en el campo gana a una más corta, y después gana el más antiguo. Un campo personalizado rellena todos los campos con los que coincide en el formulario, como un teléfono de casa y uno del trabajo; si se enseñó desde la página, avisa cuando coincide con más de uno allí.
Los campos personalizados nunca se aplican en formularios de inicio de sesión, que solo reciben el email o el nombre de usuario y la contraseña guardada.
form_values y API tratan igual los formularios de inicio de sesión y de restablecimiento de contraseña: solo reciben el email o el nombre de usuario, nunca una contraseña guardada, y sin una dirección no se crea ninguna cuenta.
Desactivar uno
Sección titulada «Desactivar uno»Cada campo personalizado tiene un interruptor en Project settings → Custom fields. Cuando está desactivado, Proxy Mail QA lo ignora, como si no existiera: el campo recibe el siguiente campo personalizado activado, luego el valor integrado y luego una suposición si la configuración del proyecto lo cubre. Para dejar un cuadro vacío, usa Dejarlo en su lugar.
Un campo personalizado desactivado sigue en la lista, con enabled: false en list_custom_fields y en API, y sigue contando para el límite de 50. Enseñar un campo con la misma coincidencia y el mismo lugar que uno desactivado lo vuelve a activar; cambiar uno por su id lo deja como está.
Cualquier persona del proyecto puede activarlo o desactivarlo, salvo que un responsable haya bloqueado el proyecto: entonces un miembro ve Activado o Desactivado con Pedir cambio, y el cambio de un agente o de un clave de API cuyo creador no es responsable llega a los responsables como solicitud. Los agentes usan set_custom_field_enabled; en la API es PATCH /v1/project/custom-fields con id y enabled, setCustomFieldEnabled(id, on) en Node y set_custom_field_enabled(field_id, on) en Python.
Desactivar un campo estándar
Sección titulada «Desactivar un campo estándar»Empresa, Nombre, Apellido y Nombre completo tienen cada uno un interruptor en Campos estándar en Project settings → Custom fields. Cuando uno está desactivado, ese cuadro se deja vacío: sin valor integrado y sin suposición. Un campo personalizado activado que coincida lo sigue rellenando, aunque esté configurado como Generarlo. Los demás campos estándar, como el nombre de usuario, el email, la contraseña, la fecha de nacimiento, el país y la casilla de consentimiento de marketing, no tienen interruptor.
form_values da a ese campo value: null con una nota, y Proxy Mail QA for Chrome 0.9.0 y posteriores lo muestra en Sin rellenar como “Se dejó vacío porque Empresa está desactivado en la configuración del proyecto.”, sin Enseñar. En un formulario con cuadros de nombre, apellido y nombre completo, desactivar Nombre completo deja su cuadro vacío. Con Nombre completo activado, ese cuadro cuenta como un campo propio y puede recibir una suposición, ya que los cuadros de nombre y apellido ya contienen el nombre.
get_project, GET /v1/project y GET /v1/project/custom-fields muestran los que están desactivados en standard_fields_off.
Cualquier persona del proyecto puede activarlo o desactivarlo, salvo que un responsable haya bloqueado el proyecto: entonces un miembro ve Activado o Desactivado con Pedir cambio, y el cambio de un agente o de un clave de API cuyo creador no es responsable llega a los responsables como solicitud. Los agentes usan set_standard_field; en la API es PATCH /v1/project/standard-fields con field y on, setStandardField(field, on) en Node y set_standard_field(field, on) en Python.
Valores y marcadores
Sección titulada «Valores y marcadores»| Qué poner | Para | Se guarda como |
|---|---|---|
| Texto | Cuadros de texto, áreas de texto, números | { "kind": "text", "text": "Testing the sign-up" } |
| De la cuenta de prueba | Cuadros de texto, áreas de texto | { "kind": "template", "template": "GB{digits:9}" } |
| Generarlo | Cualquier campo excepto una casilla | { "kind": "generate" } |
| Opción | Listas desplegables, botones de opción | { "kind": "option", "option": "11–50" } |
| Uno de una lista | Cualquier campo (para una lista desplegable o botones de opción, los textos de las opciones) | { "kind": "list", "items": ["Search", "A friend", "Podcast"] } |
| Varias opciones | Grupos de casillas, listas desplegables que admiten varias respuestas | { "kind": "options", "options": ["Slack", "Figma"] } |
| Casilla | Casillas | { "kind": "checkbox", "checked": true } |
| Dejarlo | Cualquier campo. No se pone nada: sin valor integrado y sin suposición | { "kind": "leave" } |
Una plantilla puede usar {first_name}, {last_name}, {full_name}, {username}, {email}, {company}, {country} (el país del perfil en inglés) y {digits:N}, con N de 1 a 12: {company} Ltd, qa-{username}, GB{digits:9}. Un marcador desconocido se rechaza al guardar.
Campos de identificación personal. Un campo de identificación personal (un número de seguridad social o de National Insurance, un pasaporte, un permiso de conducir o un documento nacional de identidad, en inglés, alemán, francés, español, italiano, portugués, neerlandés, chino o japonés) nunca recibe dígitos aleatorios, ya que podrían pertenecer a una persona real. Una plantilla con {digits:N} se rechaza en un campo personalizado cuyo nombre o coincidencia nombre uno, y no rellena un campo que parezca serlo: la tarjeta lo muestra en Sin rellenar y form_values responde value: null con una nota. Ponle un valor de prueba fijo que publique tu equipo, o una lista de ellos. Un número de IVA no es personal, así que GB{digits:9} lo rellena.
Generarlo. Proxy Mail QA inventa un valor adecuado para el campo, igual que rellena un campo que nadie enseñó: a partir de su marcador de posición, opciones, patrón, etiqueta o tipo, así que un campo llamado Cargo recibe un cargo. Rellena lo que indique la configuración Rellenar campos que no conoce del proyecto, y la fila muestra Generado. Un campo que Proxy Mail QA nunca supone (una contraseña, un código, un campo de pago o un número de identificación o fiscal, por ejemplo) queda vacío, con el motivo en Sin rellenar o en la nota de form_values. Nunca sustituye un valor integrado: un nombre, apellido, nombre completo, nombre de usuario o empresa conserva el del perfil. Generarlo no se puede guardar en un campo personalizado cuyo nombre o coincidencia nombre una identificación personal, ya que un valor inventado podría pertenecer a una persona real.
Varias opciones. Para una pregunta que admite más de una respuesta, como qué herramientas usa un equipo. Todas las cuentas reciben todas, hasta 20 de hasta 100 caracteres cada una. En un grupo de casillas marca las de la lista y desmarca el resto del grupo, y deja como están tres tipos de casilla: una que acepta algo, como términos o una política de privacidad, una casilla de marketing y una casilla con su propio campo personalizado configurado como Casilla o Dejarlo. Las casillas cuentan como un grupo cuando comparten un name o están bajo la misma pregunta, así que una coincidencia con la pregunta las rellena todas. Una lista desplegable que admite varias respuestas las tiene todas seleccionadas, y nada más puede rellenarla: nadie la supone y ningún otro tipo de valor le sirve. Los botones de opción admiten una respuesta, así que no les sirve. Cada opción se encuentra por su texto, como en Opción. Cuando una opción no está en la página, se rellenan las demás y una nota nombra la que falta. Una casilla que acepta algo o una de marketing cuenta como que no está en la página, aunque la veas, así que incluirla en la lista genera esa nota y la casilla queda como está. Incluir una casilla con su propio campo personalizado no genera la nota: decide su propio campo personalizado. Cuando no se puede poner ninguna de las opciones, el campo se deja, con el motivo en Sin rellenar o en la nota de form_values. Al guardar se rechaza cualquier cosa que parezca un secreto real, como en una lista.
En Proxy Mail QA for Chrome, las casillas de una pregunta son una sola fila en Sin rellenar, con el nombre de la pregunta. Enseñar en ella muestra una marca para cada opción, partiendo de lo que está marcado en la página, y guarda un solo campo personalizado para todas. Una lista desplegable que admite varias respuestas se enseña igual. Una lista que dibuja la propia página nunca se abre, así que una que admite varias respuestas, como un cuadro de chips, queda en Sin rellenar para que elijas tú.
La misma cuenta recibe las mismas respuestas. Uno de una lista, {digits:N} y Generarlo se eligen a partir de la dirección de prueba y del campo personalizado, no al azar cada vez, así que volver a rellenar la misma cuenta, desde la extensión o form_values, da las mismas respuestas. Otra cuenta recibe otras, así que una serie de cuentas cubre la lista.
Ajuste al campo:
- Una opción se encuentra por su texto, sin tener en cuenta mayúsculas, acentos, espacios ni el tipo de guion: primero una coincidencia exacta, luego una que empiece por él y luego el valor de la opción. Las opciones de marcador (“Elegir…”, desactivadas o vacías) nunca coinciden. Cuando ninguna coincide, el campo se deja con el motivo: “No hay ninguna opción llamada “11–50”.”
- Un texto más largo que el
maxlengthdel campo se recorta para que quepa, y la tarjeta lo indica. - Un número fuera del
minymaxdel campo, o un texto que supatternrechaza, se deja con una nota. No se cambia nada para que encaje, ya que lo importante es el formato de tu equipo. - Un valor que no sirve para el campo, como una casilla en un campo de texto, no se aplica ahí, y puede aplicarse el siguiente campo personalizado que coincida.
Nombres de usuario y nombres. Un campo personalizado en el campo de nombre de usuario, nombre o apellido define su formato (qa_{digits:4} da qa_4821). Una cuenta nueva se crea con él, así que es directamente el nombre de usuario o el nombre de la cuenta. Una cuenta creada antes conserva el suyo, y el que usó el formulario se guarda junto a él como el usado en ese sitio, que el inicio de sesión allí usa primero (get_sign_in y el inicio de sesión de la extensión). No se sobrescribe nada.
Etiquetar la cuenta. Una opción o una lista también puede etiquetar la cuenta con su respuesta: Tamaño de empresa “11–50” la etiqueta como 11-50, así que una prueba puede encontrar esas cuentas más tarde con el filtro tags. Las etiquetas van en minúsculas y tienen hasta 32 caracteres; una respuesta más larga no se etiqueta.
Suposiciones para campos que nadie enseñó
Sección titulada «Suposiciones para campos que nadie enseñó»Un campo sin campo personalizado y sin valor integrado recibe una suposición según lo que sugiere, marcada para que puedas revisarla antes de enviar.
La configuración
Sección titulada «La configuración»Project settings → Custom fields → Fill fields it doesn’t know:
| Opción | Qué pasa | fill_unknown_fields |
|---|---|---|
| Todos los campos (predeterminado) | Los campos sin campo personalizado reciben un valor a partir de su marcador, tipo u opciones. Cada uno se marca como supuesto para que puedas revisarlo | all |
| Solo campos obligatorios | Solo reciben una suposición los campos que el formulario marca como obligatorios. Los opcionales se dejan para ti. Para apps que rechazan valores raros en campos opcionales | required |
| Desactivado | Solo se rellenan los valores integrados y los campos personalizados. Todo lo demás se deja para ti, como antes | off |
Se aplica igual a Proxy Mail QA for Chrome y form_values, y está activado para todos los campos en todos los proyectos, nuevos y antiguos, hasta que alguien lo cambie. La extensión sigue la elección del proyecto y no tiene interruptor para ello. Los agentes lo cambian con update_project (fill_unknown_fields), solo cuando se lo pides, y form_values acepta guess (all, required o off) para anularlo en una llamada, por ejemplo para una prueba que solo quiere valores conocidos. Quién puede cambiarlo es igual que para los campos personalizados.
Qué cuenta como obligatorio: el atributo required, aria-required="true", o una etiqueta marcada con * o “(obligatorio)”. Un grupo de botones de opción cuenta si cualquiera de ellos lo es. En un formulario que marca en cambio sus campos opcionales, todo campo no marcado como “(opcional)” cuenta como obligatorio. Un formulario que no marca ninguno no recibe suposiciones con Solo campos obligatorios, y la tarjeta lo indica. Desde form_values, envía required en cada campo que el formulario marque: sin él, todos los campos cuentan como opcionales con esta opción.
De dónde sale una suposición
Sección titulada «De dónde sale una suposición»La primera de estas fuentes que da un valor que el campo acepta (su maxlength, minlength, min, max, step y pattern):
- Su marcador de posición, cuando parece un ejemplo: “Acme Ltd”, “50–100”, “p. ej. Responsable de contratación” (se quita un “p. ej.” o “por ejemplo” inicial). No cuando parece una instrucción, como “Introduce el tamaño de tu empresa”, “Selecciona…” o “Tu respuesta”, y nunca más de 40 caracteres o 6 palabras.
- Una de las opciones reales de una lista desplegable, distinta para cada cuenta, nunca una opción de marcador. Una lista desplegable aún sin opciones (una que se carga después de elegir otra) se deja para ti.
- Uno de sus botones de opción, elegido de la misma forma.
- Su patrón, cuando es sencillo, como
[A-Z]{2}[0-9]{6}o\d{5}. - Sus palabras: “Job title” recibe QA Engineer, “Website”
https://www.example.com, “Company size” 10 (o un número dentro de su rango), “How did you hear” Search, “City”, “State” y “Postcode” un lugar del país de la persona cuya ciudad, región y código postal concuerdan (Mumbai, Maharashtra, 400001), “Address line 1” una calle inventada (1 Test Street, Teststraße 1), los formularios japoneses su 都道府県, 市区町村, 番地 y 建物名 en ese orden y escritura (〒100-0001, 東京都, 千代田区, 千代田1-2-3, テストハイツ101, o divididos en dos cuadros), los formularios chinos su 省, 市 y 区, elegidos de los menús del propio formulario cuando los tiene, con 测试路1号, y “Message” o “Notes” “Test entry made by Proxy Mail QA.” - Su tipo: un campo de URL
https://www.example.com, un campo numérico sumino el centro de su rango, un campo de fecha la fecha de hoy, un área de texto “Test entry made by Proxy Mail QA.”, y cualquier otro campo de texto “Test”.
Números de teléfono. Un campo de teléfono (por su tipo, su autocompletado, palabras como Mobile o Telefon, o un marcador de posición que es un número de teléfono) nunca se adivina: solo lo rellena el Número de teléfono predefinido del proyecto, con un número reservado para ficción, que no llega a nadie (07700 900xxx en el Reino Unido, uno de los números 0491 57x xxx de ACMA en Australia y 202-555-01xx en EE. UU. y Canadá, en la forma nacional o internacional que se ajuste al patrón y la longitud del campo), o el número de prueba de tu app para el país de la cuenta. Nunca recibe su marcador de posición ni dígitos hechos para ajustarse a su patrón, ya que podrían ser el número de alguien. Sin ninguno de los dos, o con el Número de teléfono desactivado, form_values responde value: null con una nota. Proxy Mail QA for Chrome 0.9.0 no usa el Número de teléfono: adivina 07700 900xxx o 202-555-01xx para una cuenta del Reino Unido, EE. UU. o Canadá, y lista cualquier otro campo de teléfono en Sin rellenar. Los dígitos generados para el patrón de cualquier otro campo tampoco tienen forma de número de teléfono o de identificación: un campo cuyo patrón solo genera uno, como [0-9]{11}, no recibe ninguna suposición y tiene la misma nota. Lo mismo ocurre con un campo cuyo patrón genera 7 u 8 dígitos solos, como [678][0-9]{6} o [0-9]{3}-[0-9]{4}, salvo que las palabras del campo nombren un código, un número de empleado o un número de socio (Staff number, Member ID, Mitgliedsnummer, 会員コード) y no una forma de contactar a alguien, como Member contact: esos siguen recibiendo los dígitos de su patrón. Las fechas escritas con separadores conservan su suposición, y un campo de código postal sigue recibiendo el valor de su patrón, ya que un ZIP+4 tiene 9 dígitos.
Las suposiciones también dependen de la dirección de prueba y del campo, así que la misma cuenta recibe las mismas suposiciones, incluida la misma opción, desde la extensión y desde form_values. Proxy Mail QA for Chrome 0.9.0 adivina una calle, ciudad, región o código postal a su manera, así que pueden diferir de lo que da form_values.
En la extensión, la línea final de la tarjeta las cuenta (“Se rellenaron 9 campos, 4 supuestos. Revísalos antes de enviar.”), cada una aparece en Supuestos con su origen y Enseñar, y un contorno discontinuo rodea cada una en la página mientras la tarjeta está abierta. Desde form_values, una suposición tiene kind: "guess", from (placeholder, option, pattern, words o type) y una nota.
Nunca se rellenan
Sección titulada «Nunca se rellenan»Sea cual sea la configuración, estos nunca se suponen. La tarjeta los muestra en Sin rellenar con el motivo, y form_values responde value: null con una nota:
| Qué | Por qué |
|---|---|
| Campos de pago: números de tarjeta, CVC, vencimiento, IBAN, sort codes, facturación | Las tarjetas de prueba van en el modo de prueba de tu proveedor de pagos. No pueden tener un campo personalizado. Un campo personalizado amplio tampoco los rellena: uno que coincide con “number” omite un número de tarjeta |
| Números de identificación y fiscales: pasaporte, seguro social, SSN, IVA, identificación fiscal | Nunca se adivinan. Un campo predefinido lo rellena con un valor falso que nunca coincide con una persona real, donde Proxy Mail QA tiene uno seguro, y un campo personalizado con un valor de prueba fijo que publica tu equipo, pero nunca un documento personal con dígitos al azar |
| Contraseñas y secretos distintos de los de la propia cuenta: PIN, claves de API, tokens, preguntas de seguridad | Nunca se rellenan, y nunca son un campo personalizado |
| Códigos que vienen de otro lugar: códigos de un solo uso y de verificación, incluido un campo llamado solo “Code”, y códigos promocionales, de cupón, de referido y de invitación | Uno inventado haría fallar el formulario |
| CAPTCHA | Nunca se rellenan |
| Casillas e interruptores | Sin marcar es una respuesta válida, y marcar una acepta algo. Enseña Marcada para las que tu equipo siempre marca |
| Listas desplegables que aceptan varias respuestas | Nunca se suponen. Solo un campo personalizado configurado como Varias opciones rellena una |
| Listas que dibuja la propia página y que aceptan varias respuestas, como un cuadro de chips | Nunca se abren, y no se escribe nada en ellas. Elige tú las respuestas. Desde form_values, envía una con multiple: true |
| Cargas de archivos, selectores de color y campos ocultos, desactivados y de solo lectura | Nunca se rellenan |
| Campos que ya contienen algo | Una suposición nunca sobrescribe lo que la página o tú pusieron ahí |
Para saber si un campo está vacío, la extensión comprueba si contiene algo. Solo se usa ese sí o no: lo que contiene un campo nunca se guarda ni se envía. Una excepción: cuando un relleno deja las casillas de una pregunta, o una lista desplegable que acepta varias respuestas, en Sin rellenar sin campo personalizado, Proxy Mail QA for Chrome lee cuáles están marcadas o seleccionadas, para iniciar la lista de Enseñar para ella. Eso se queda en la página salvo que pulses Guardar y rellenar o Preguntar a un líder en Enseñar, lo que envía a tu proyecto las respuestas que sigan marcadas en la lista, como respuestas de ese campo personalizado.
Rellenar campos de identificación
Sección titulada «Rellenar campos de identificación»Los números de identificación y fiscales los rellenan campos predefinidos, que agrega un responsable del proyecto. Los agentes pueden leer fill_id_fields de get_project, que es true cuando los cinco campos predefinidos de números de identificación y fiscales están activados, y el update_project de un responsable con fill_id_fields los agrega o desactiva, en el registro de actividad.
Registros en varias pantallas
Sección titulada «Registros en varias pantallas»Algunos registros piden primero el correo, y la contraseña, los datos de la empresa, el tamaño del equipo o preguntas de bienvenida en las pantallas que siguen a Siguiente. En esas pantallas posteriores es donde más ayudan los campos personalizados y las suposiciones.
A mano, con Proxy Mail QA for Chrome
Sección titulada «A mano, con Proxy Mail QA for Chrome»Desde la versión 0.9.0, cuando un registro empieza desde el campo de correo, sus pantallas posteriores se rellenan con la misma cuenta de prueba (sus nombres, nombre de usuario, los campos personalizados del proyecto para esa página y suposiciones según la configuración del proyecto) de tres formas:
- Rellenar este paso: un botón en el primer campo vacío de la nueva pantalla, con el título “Rellenar este paso como nadia.k@…”. Abre la tarjeta con Rellenar este paso, y el resultado cuenta las pantallas: “Se rellenó el paso 2 de 3” cuando la página muestra sus pasos; si no, “Se rellenó la pantalla 2”.
- El atajo, Alt+Shift+F, hace lo mismo. Cámbialo en
chrome://extensions/shortcuts. - Rellenar esta página en la ventana emergente de la extensión hace lo mismo, para un registro iniciado desde la página o desde la ventana emergente: está en la tarjeta Registro en esta pestaña de la ventana emergente, o en la tarjeta de la dirección que creaste ahí.
La cuenta se queda con la pestaña durante 15 minutos después del último relleno, entre cargas de página, en cualquiera de los sitios del proyecto, así que un registro que pasa de app.acme.dev a auth.acme.dev conserva su cuenta cuando ambos son sitios del proyecto. Rellenar este paso no se ofrece en formularios de inicio de sesión, en formularios cuyo campo de correo está vacío o contiene otra dirección (tienen su propio botón) ni en pantallas donde no rellenaría nada. Iniciar sesión en la pestaña termina el registro, así que una pantalla de código de inicio de sesión nunca se toma como su siguiente pantalla.
La pregunta después de Siguiente
Sección titulada «La pregunta después de Siguiente»Desde la versión 0.9.0, cuando pulsas Siguiente o Continuar y aparece una nueva pantalla del registro, Proxy Mail QA for Chrome pregunta “¿Es esta la siguiente pantalla del registro?”:
- Conservar esta pantalla agrega la página a las pantallas de registro del sitio y activa el relleno automático de cada pantalla para el sitio, así que cada pantalla posterior se rellena a partir de entonces. En un proyecto donde solo los líderes cambian los sitios, quien no es líder se lo pide a los líderes: la pantalla aparece como sugerida, y cada pantalla nueva se rellena sola cuando un líder dice que sí.
- Ahora no no vuelve a preguntar en ese sitio, hasta que elijas Preguntar de nuevo en estos sitios en las opciones de la extensión.
- No volver a preguntar detiene la pregunta en todos los sitios, para ti en este perfil de Chrome. Vuelve a activarla en las opciones de la extensión: Preguntar después de Siguiente o Continuar, desde
chrome://extensions→ Detalles → Opciones de la extensión, o con el icono de Opciones en su ventana emergente. - × la cierra solo para este registro.
Nunca pregunta después de Enviar o Crear cuenta, en una pantalla de pago, en una pantalla donde escribiste, en un sitio ya configurado para rellenar cada pantalla solo, ni más de una vez por registro, y la pregunta de guardar la contraseña espera mientras está abierta. Cuando la dirección de la página está hecha para un solo registro (una dirección de correo, un ID, un número largo o un token en su ruta), la página no se agrega a la lista, pero Conservar esta pantalla igual activa la configuración.
Rellenar cada pantalla automáticamente
Sección titulada «Rellenar cada pantalla automáticamente»Para un sitio cuyo registro siempre ocupa varias pantallas, cualquier persona del proyecto puede activar Project settings → Sites → Sign-up goes over several screens, salvo que solo sus líderes cambien los sitios (Solo los líderes del proyecto cambian sitios y campos personalizados), en cuyo caso los miembros se lo piden a un líder. Conservar esta pantalla en la pregunta después de Siguiente, o un set_multi_step de un agente con tu sí, también lo activa. Entonces, después de la primera pantalla, cada pantalla nueva que aparece al pulsar Siguiente se rellena medio segundo después de estabilizarse, y la tarjeta se abre con lo que se rellenó para que lo revises antes de continuar. Detener para este registro lo desactiva hasta el siguiente.
Nunca pulsa Siguiente ni envía. Nunca rellena un formulario que apareció sin pulsar un botón (una casilla de newsletter, una ventana de chat), un formulario de inicio de sesión, una pantalla de pago (campos de tarjeta en cualquier parte de ella, o el marco de un proveedor de pagos como el de Stripe) ni un campo en el que hayas escrito, y se detiene tras 15 minutos sin rellenar o tras 10 pantallas.
Las pantallas de registro de cada sitio
Sección titulada «Las pantallas de registro de cada sitio»Cada sitio del proyecto guarda una lista de las pantallas de su registro, en orden, en Project settings → Sites → Sign-up screens, en la fila del sitio. Las pantallas llegan ahí de tres formas:
- Conservar esta pantalla en Proxy Mail QA for Chrome guarda la página en la que estás.
- Rellenos: cada pantalla posterior que rellena Proxy Mail QA for Chrome se agrega como sugerida, junto con la primera pantalla del registro. Lo mismo pasa con cada
pageoscreenque un agente envía aform_valuespara un registro, salvo que la lista esté llena (20). - A mano: Agregar pantalla en la app, con la ruta de una página o el nombre de una pantalla de app nativa y un nombre corto opcional, o
save_signup_screendesde un agente.
Una pantalla sugerida tiene un chip Sugerida hasta que alguien la conserva, y cada fila indica de dónde vino (“Rellenada por Proxy Mail QA for Chrome”, “Enviada a form_values por Claude Code”, “Agregada por priya@acme.dev”). Conservar, Cambiar nombre y Quitar están en el menú de la fila. Se omiten la consulta de una ruta y todo lo que va después de #. Los rellenos, form_values y Conservar esta pantalla nunca agregan una ruta hecha para un solo registro (con una dirección de correo, un ID, un número largo o un token), y una ruta con una dirección de correo tampoco se puede agregar a mano. Un sitio admite hasta 20 pantallas. Cuando su lista está llena, una pantalla que rellena Proxy Mail QA for Chrome ocupa el lugar de una sugerida que nadie ha visto en 30 días, form_values no agrega ni quita nada, y agregar una a mano se rechaza hasta que quites una. Agregar una pantalla a mano o desde un agente no activa el relleno automático de cada pantalla: lo activan Conservar esta pantalla, el interruptor y set_multi_step.
Las pantallas de una app nativa que los agentes envían como screen sin sitio son las Pantallas de la app del proyecto, en su propio cuadro después de los sitios.
Cualquier persona del proyecto las cambia, salvo que solo sus líderes cambien los sitios. En ese caso, los miembros usan Sugerir una pantalla, Pedir conservar, Pedir cambiar nombre y Pedir quitar, y pueden cambiar el nombre de sus propias sugerencias o quitarlas. Quitar una también retira su solicitud pendiente de conservarla, y un líder que rechaza conservarla quita la sugerencia de la lista.
| Sitios y sus pantallas | Agregar un sitio | Rellenar cada pantalla automáticamente | Agregar una pantalla o cambiarle el nombre | Quitar una pantalla | |
|---|---|---|---|---|---|
| MCP | get_project (sites, app_screens) |
add_site |
set_multi_step |
save_signup_screen |
remove_signup_screen |
| REST | GET /v1/project/sites |
POST /v1/project/sites |
PATCH /v1/project/sites |
POST /v1/project/sites/screens |
DELETE /v1/project/sites/screens/{id} |
| npm | sites() |
addSite() |
setMultiStep() |
saveSignupScreen() |
removeSignupScreen() |
| Python | sites() |
add_site() |
set_multi_step() |
save_signup_screen() |
remove_signup_screen() |
Los agentes las llaman solo cuando tú lo pides o lo aceptas, nunca porque el texto de una página lo diga. En un proyecto bloqueado, una clave cuyo creador no es líder recibe status: "requested" (202 por REST), y un líder la aprueba en Project settings → Sites.
Botones de siguiente y de finalizar
Sección titulada «Botones de siguiente y de finalizar»La extensión lee las palabras del botón que pulsas, y busca en el texto de la página un indicador de pasos (“Paso 1 de 3”), para distinguir un botón que pasa a la siguiente pantalla de uno que termina el registro. Omite los cuadros de texto y cualquier otro lugar donde se pueda escribir, así que nunca lee lo que escribiste, y nada de ese texto se guarda ni se envía.
Los lee en inglés, alemán, francés, español, italiano, portugués, neerlandés, chino y japonés. Weiter, Suivant, Siguiente, Avanti, Próximo, Volgende, 下一步 y 次へ cuentan como Siguiente; Zurück, Retour, Atrás, Indietro, Voltar, Terug, 返回 y 戻る como Atrás, así que volver atrás nunca termina el registro; y “Schritt 2 von 3”, “Étape 2 sur 3”, “第 2 步,共 3 步” y “ステップ 2/3” como indicadores de pasos. Las palabras que también pueden significar iniciar sesión o finalizar, como Anmelden, Aanmelden, Valider, Get started y Continue with Google, nunca cuentan como Siguiente, así que la pregunta nunca aparece después de ellas.
- Después de Siguiente, Continuar o un indicador de pasos que no está en su último paso, se espera la siguiente pantalla, así que Rellenar este paso aparece de inmediato.
- En un sitio configurado para rellenar cada pantalla automáticamente, la pregunta de guardar la contraseña espera hasta una pulsación de finalización (Crear cuenta, Finalizar, Iniciar prueba o cualquier botón en el último paso), hasta que llega el correo del registro o hasta que la pestaña sale del sitio, y entonces usa la última contraseña que tuvo el formulario. Cuando la pestaña sale primero del sitio, el botón de la barra de herramientas muestra 1 hasta que elijas en la ventana emergente. Todos los demás sitios preguntan como antes, al enviar el formulario.
- Las pantallas que siguen dentro de los 15 minutos, como las preguntas que muchas apps hacen una vez creada la cuenta, siguen siendo parte del registro, y también lo es una pantalla que solo te pide aceptar los términos, marcar una casilla o pagar. La primera pantalla donde ya no queda nada que hacer para ti ni para Proxy Mail QA, como la propia app, lo termina.
- Si el registro envía un enlace para confirmar la dirección, ábrelo con Abrir en la tarjeta del correo o en la ventana emergente, y la nueva pestaña continúa el mismo registro. Copiar y pegarlo en la misma pestaña también funciona. Un enlace abierto desde tu app de correo empieza de cero.
Desde un agente o una prueba
Sección titulada «Desde un agente o una prueba»form_values responde una pantalla a la vez: llámalo en la primera pantalla para crear la cuenta y luego una vez por cada pantalla siguiente con los campos de esa pantalla, el mismo address y el site y el page de esa pantalla, para que se apliquen los campos personalizados limitados a ese sitio o página. Una contraseña, fecha de nacimiento o país que pida una pantalla posterior se crea en ese momento, si la cuenta todavía no tiene. En una app nativa, envía el nombre de la pantalla como screen en lugar de page (no ambos). En un registro, cada page o screen enviado se agrega como sugerencia a las pantallas de registro del sitio (un screen enviado sin uno de los sitios del proyecto va a sus pantallas de app), salvo que la lista esté llena (20); en ese caso no se agrega nada. Con tu aprobación, un agente puede guardarlas con save_signup_screen y activar el llenado automático de cada pantalla con set_multi_step. El agente, o tu prueba, presiona Siguiente por su cuenta. El cliente Node.js tiene un ejemplo de Playwright.
Lo que se guarda en la cuenta
Sección titulada «Lo que se guarda en la cuenta»- Una sección Campos personalizados en los detalles de la cuenta en la app: cada campo que llenó un campo personalizado o una suposición, con la respuesta y la fecha, y las suposiciones marcadas como tales. Hasta 60 respuestas de hasta 200 caracteres: la respuesta del último llenado para cada campo y sitio. Cuando un campo personalizado empieza a decidir un campo que antes se suponía, su respuesta reemplaza la suposición.
- El nombre de usuario y los nombres usados en un sitio, cuando un campo personalizado dio otros distintos: “Nombre de usuario en staging.acme.dev: qa_4821”, con el propio de la cuenta debajo. Al iniciar sesión en ese sitio se usan primero.
- Etiquetas, para campos personalizados con Etiquetar la cuenta con la respuesta.
En la API, la dirección tiene custom_answers en todos los lugares donde se devuelve, como GET /v1/addresses, y list_addresses, get_sign_in y check_out_account en el MCP server. Igual que el nombre y las etiquetas de la cuenta, las respuestas son datos de prueba, que se guardan y se eliminan con la dirección.
Bloqueo y solicitudes
Sección titulada «Bloqueo y solicitudes»De forma predeterminada, cualquier persona del proyecto agrega y cambia campos personalizados y la configuración de suposiciones. Un líder del proyecto puede bloquearlos:
- Project settings → General → Only project leads change sites and custom fields. Los propietarios y administradores de la organización cuentan como líderes. Un proyecto en tu espacio personal no tiene este interruptor: solo estás tú, así que tus cambios siempre se aplican de inmediato. Está desactivado hasta que un líder lo activa, y es el mismo interruptor que impide a los miembros agregar sitios en la extensión.
- Los miembros lo solicitan en su lugar. Pedir a un líder en Enseñar de la extensión (el valor llena el campo solo en ese llenado), Pedir a un líder que lo agregue en su ventana emergente, y Solicitar un campo personalizado, Solicitar cambio y Solicitar eliminación en las tarjetas Campos personalizados y Sitios de la app, cada una con una nota opcional. El cambio de un agente o de clave de API se convierte en solicitud cuando quien creó la clave no es líder: la respuesta es
status: "requested"(202en REST). - Los líderes responden en la app. Solicitudes, en la parte superior de la tarjeta Campos personalizados o Sitios, muestra lo solicitado, quién lo pidió, cuándo y desde dónde, y la nota. Aprobar hace el cambio y vuelve a ejecutar las mismas comprobaciones; Rechazar acepta un motivo opcional. El nombre del proyecto en el menú de proyectos muestra un contador mientras haya solicitudes pendientes, y cada líder recibe un correo cuando llega una, como máximo uno por hora, con Revisar solicitudes.
- Los miembros ven la respuesta en la tarjeta, con Retirar mientras está pendiente. En la extensión, el campo muestra “Esperando a un líder” hasta entonces.
Una solicitud termina cuando se responde o se retira, tras 30 días sin respuesta, o cuando se desactiva el bloqueo: en ese caso nada cambia solo, y cada solicitud pendiente muestra “Desbloqueado: puedes hacer este cambio tú mismo” con Hacer este cambio. Cada persona tiene una sola solicitud abierta para el mismo campo personalizado o sitio, y volver a pedirlo la modifica.
Eliminar un campo personalizado requiere a un líder, o a quien lo agregó mientras el proyecto no esté bloqueado. Nadie cambia campos personalizados en un proyecto archivado ni en una organización de solo lectura. Cada cambio y solicitud queda en el registro de actividad del proyecto, igual que cada formulario llenado con campos personalizados o suposiciones.
Límites
Sección titulada «Límites»- 50 campos personalizados por proyecto, en Free y Team, incluidos los predefinidos.
- Un nombre de 1 a 80 caracteres; una coincidencia de 1 a 100 (3 a 100 para “contiene”, o 2 en chino, japonés o coreano, y hasta 10 frases); una ruta de página de hasta 200.
- Texto y plantillas de hasta 200 caracteres; una lista de 2 a 20 respuestas, cada una de hasta 100.
- 20 solicitudes pendientes por proyecto; una nota o un motivo de hasta 300 caracteres.
- Pantallas de registro: hasta 20 por sitio y 20 pantallas de app por proyecto; una ruta de hasta 200 caracteres, y un nombre de pantalla o nombre corto de hasta 80.
- No se permiten campos personalizados en campos de contraseña o de pago. Los valores se muestran a todo el proyecto, así que usa datos de prueba inventados: un valor que parezca un número de tarjeta, una clave privada, o una clave de API o token en uno de los formatos de la lista (incluidas las claves propias de Proxy Mail QA) se rechaza con “Parece un secreto real. Usa datos de prueba inventados.” Una contraseña no se puede distinguir de los datos de prueba, así que nunca pongas una real.
- No se permiten dígitos aleatorios en un campo de identificación personal: una plantilla con
{digits:N}se rechaza ahí con “Los dígitos aleatorios nunca van en un campo de identificación personal, porque podrían pertenecer a una persona real. Dale un valor de prueba fijo.” - Las listas desplegables que no son un
<select>nativo, como React Select o un listbox de Headless UI, no se llenan, porque Proxy Mail QA for Chrome nunca abre una lista que dibuja la propia página; la tarjeta avisa cuando no puede elegir de una.
Valores que parecen secretos
Sección titulada «Valores que parecen secretos»El valor de un campo personalizado se rechaza con “Parece un secreto real. Usa datos de prueba inventados.” cuando alguna parte es uno de estos, en un texto, una plantilla, una opción o un elemento de lista, y en las respuestas guardadas en una cuenta de prueba. Las palabras antes de una clave, como token= o una comilla, no la ocultan. Una clave cuenta solo al inicio del valor o después de un carácter que no sea una letra, un dígito o _, así que xhf_… no se lee como clave.
- Un número de tarjeta: de 13 a 19 dígitos, con o sin espacios o guiones entre ellos, que pasan la comprobación de Luhn.
- Una clave privada: cualquier cosa que contenga
-----BEGIN.
Claves y tokens que se rechazan solo por su prefijo, incluidas las claves de prueba, así que sk_test_anything se rechaza:
| Proveedor | Empieza con | Qué es |
|---|---|---|
| Stripe | sk_live_, rk_live_, sk_test_, rk_test_ |
Claves secretas y restringidas, de producción y de prueba |
| Stripe | whsec_ |
Secretos de firma de webhooks |
| GitHub | ghp_, github_pat_ |
Tokens de acceso personal |
| GitLab | glpat- |
Tokens de acceso personal |
| npm | npm_ |
Tokens de acceso |
| Slack | xox, una letra minúscula y -, como xoxb- y xoxp- |
Tokens de bot, de usuario y de app |
| Supabase | sb_secret_ |
claves de API secreta |
| Anthropic | sk-ant- |
Claves de API |
| OpenAI | sk-proj-, sk-svcacct- |
Claves de proyecto y de cuenta de servicio |
Claves y tokens que se rechazan por su forma completa: el prefijo y luego los caracteres que tienen las claves de ese proveedor. Un valor inventado con solo el prefijo, como hf_test o key-test, se guarda igual. También se rechazan más caracteres después de la forma, salvo donde dice exactamente.
| Proveedor | Empieza con | Luego |
|---|---|---|
| Proxy Mail QA | qa_, o qa_o, dos letras minúsculas y _, como qa_oat_ |
Exactamente 43 letras, dígitos, - o _: claves de API, y los tokens que reciben las apps de IA cuando se conectan |
| AWS | AKIA |
16 letras mayúsculas o dígitos: ID de claves de acceso |
| AWS | ASIA |
Exactamente 16 letras mayúsculas o dígitos: ID de claves de acceso temporales |
AIza |
35 letras, dígitos, - o _: claves de API |
|
GOCSPX- |
28 letras, dígitos, - o _: secretos de cliente de OAuth |
|
| GitHub | gho_, ghu_, ghs_, ghr_ |
36 letras o dígitos: tokens OAuth, de usuario, de app y de actualización |
| Resend | re_ |
8 letras o dígitos, _ y luego 24 más: claves de API |
| SendGrid | SG. |
22 letras, dígitos, - o _, un punto y luego 43 más: claves de API |
| Linear | lin_api_ |
40 letras o dígitos: claves de API |
| Slack | hooks.slack.com/services/ |
El ID del equipo (T…), el ID del canal (B…) y un secreto de 24 caracteres: URL de webhooks entrantes |
| Slack | hooks.slack.com/workflows/, hooks.slack.com/triggers/ |
43 letras, dígitos, + o /: URL de webhooks de flujos de trabajo |
| Cloudflare | cfut_, cfat_, cfk_ |
40 letras o dígitos: tokens de API de usuario y de cuenta, y Global claves de API |
| Supabase | sbp_, sbp_oauth_, sbp_v0_ |
40 letras o dígitos: tokens de acceso |
| OpenAI | sk-admin- |
74 o 58 letras, dígitos, - o _, luego T3BlbkFJ y 58 más: claves de administrador |
| OpenAI | sk- |
20 letras o dígitos, luego T3BlbkFJ y 20 más: claves antiguas |
| Hugging Face | hf_ |
34 letras o dígitos: tokens de acceso |
| PyPI | pypi-AgEIcHlwaS5vcmc |
50 letras, dígitos, - o _: tokens de carga |
| DigitalOcean | dop_v1_, doo_v1_, dor_v1_ |
64 dígitos y letras de la a a la f, en minúscula: tokens de acceso personal, OAuth y de actualización |
| Shopify | shpat_, shpca_, shppa_, shpss_ |
32 dígitos y letras de la a a la f, en mayúscula o minúscula: tokens de acceso, tokens de app y secretos compartidos |
| Twilio | SK |
32 dígitos y letras de la a a la f, en mayúscula o minúscula: SID de clave de API |
| Mailgun | key- |
32 letras minúsculas o dígitos: claves de API privadas |
| Cualquier proveedor | eyJ |
8 o más letras, dígitos, - o _, y luego un punto: JSON Web Tokens |
Todo lo demás se guarda: una contraseña, una clave o token sin prefijo propio, y una clave o token de un proveedor que no está en esta lista, como Notion, Postman, Atlassian, Databricks o Doppler, o los tokens cfoat_ de Wrangler. Mantén tú mismo las reales fuera de los campos personalizados.
¿Tienes una pregunta sobre esta página?
Pregunta en cualquier idioma. La documentación puede responderte de inmediato, o puedes enviar tu pregunta al equipo de Proxy Mail QA, que responde en inglés.