Docs de Autonomy

Bandejas de entrada y teléfonos

Recibe correos de verificación, enlaces mágicos, códigos por SMS y recibos en una ejecución, y consulta todos los mensajes que recibió.

Muchos recorridos salen del navegador: enlaces mágicos, códigos de un solo uso, correos de bienvenida, recibos y verificación por SMS. Autonomy da a cada ejecución sus propias bandejas de entrada y números de teléfono, y guarda cada mensaje con la ejecución que lo recibió.

Bandejas de entrada en una ejecución

Adjunta Fresh inbox per run a un paso que necesite una dirección de correo, como un registro. La ejecución crea una dirección nueva, y el agente la usa en el producto y lee lo que llega: abre el enlace o escribe el código por sí mismo.

  • Los pasos posteriores que dicen «la misma bandeja de entrada» leen la misma dirección. Antes de guardar, Autonomy sugiere adjuntar la bandeja de entrada a un paso que espera un código.
  • Una bandeja de entrada se cierra cuando termina su ejecución. El correo que llega después se rechaza. La dirección queda reservada para tu organización, así que nadie más puede obtenerla.
  • La pestaña Email previews de la ejecución muestra cada correo como HTML, texto y cabeceras.

Una dirección que solo escribes en un paso se puede teclear, pero no leer. Para leer el correo de una dirección que te pertenece, usa tu dominio o la bandeja de entrada de un inicio de sesión.

Códigos y enlaces

El agente lee por sí mismo los códigos y enlaces recibidos, y la ejecución los muestra en claro: en las vistas previas de correo, en las Step Actions y en la evidencia. Solo se enmascaran los valores que guardaste como secretos.

Mientras grabas un caso de prueba en un navegador alojado, ves los códigos que recibe tu sesión para poder completar un paso de verificación. Los demás solo ven que llegó un código, y los códigos nunca se guardan en la grabación ni en el caso de prueba.

Verificación por correo

Elige cómo superan las ejecuciones la verificación por correo en Organization → Integrations → Email verification:

MecanismoÚsalo cuando
Hosted inboxes (recomendado)Tu app acepta cualquier dirección de registro. Funcionan tanto los códigos como los enlaces mágicos, sin configuración.
Test mode (código fijo)Tu app solo acepta dominios aprobados y sus usuarios de prueba reciben un código fijo. Solo códigos.
Your domainTu app solo acepta tu dominio y necesitas enlaces mágicos o una entrega real.

Modo de prueba

Muchos proveedores de autenticación permiten que las direcciones de prueba usen un código de verificación fijo en lugar de un correo real, como las direcciones +clerk_test de Clerk con el código 424242. En el modo de prueba, Autonomy rellena ese código y no se envía ningún correo.

  • Address template: por ejemplo qa+{token}@yourcompany.com. {token} se convierte en un valor aleatorio por ejecución, así que los registros en paralelo nunca chocan.
  • Test addresses: cuentas fijas que usan tus inicios de sesión.
  • Static code: el código que tu backend acepta para ellas. Se guarda en modo de solo escritura.

El modo de prueba da un código, no un enlace. Los recorridos que verifican con un enlace mágico necesitan bandejas de entrada alojadas o tu dominio.

Tu dominio

Recibe correo real en un subdominio que te pertenezca, como qa.yourcompany.com. Las ejecuciones crean direcciones como r-a1b2c3d4@qa.yourcompany.com.

  1. Añade un subdominio dedicado en Email verification.
  2. Demuestra la propiedad: añade el registro TXT que se muestra y haz clic en Verify.
  3. Reenvía el correo: configura un reenvío general (catch-all) del subdominio a la dirección de recepción de tu organización, que aparece en los ajustes. Funcionan Cloudflare Email Routing, el enrutamiento de Google Workspace y las reglas de transporte de Microsoft 365.
  4. Actívalo: envía cualquier correo a test@qa.yourcompany.com. El primer correo reenviado activa el reenvío.

Si tu proveedor de correo envía un correo de confirmación de reenvío a la dirección de recepción, su enlace aparece en los ajustes, solo para propietarios y administradores.

Hasta que el reenvío esté activo, las ejecuciones que necesitan una bandeja de entrada en tu dominio no pueden obtenerla. Autonomy no recurre a sus propias direcciones, porque tu app las rechazaría.

Bandejas de entrada de un proyecto

La pestaña Email inboxes de la página Sign-ins de un proyecto lista sus bandejas de entrada: direcciones de Autonomy, direcciones en tu dominio y bandejas de entrada conservadas de una ejecución. Los inicios de sesión las usan para los códigos y enlaces mágicos enviados por correo. Los propietarios, los administradores y la persona que configuró una bandeja de entrada pueden leer sus últimos mensajes.

Números de teléfono

Cuando un paso pide un número de teléfono, el agente usa un número inventado con el formato que espera el campo. La mayoría de los recorridos solo necesitan un número que parezca correcto.

Cuando la app necesita enviar un SMS al número, por ejemplo cuando pide un código por SMS, el agente vuelve atrás, alquila un número real, cambia el selector de país de la app al país de ese número y lo vuelve a introducir. El paso indica si usó un número inventado o uno alquilado. Adjuntar Test phone number a un paso le dice al agente que el paso necesita un teléfono; sigue la misma regla.

  • Un número alquilado aparece en los recursos creados por la ejecución y se devuelve cuando la ejecución termina.
  • Una cuenta que inició sesión con un número alquilado no se puede conservar como inicio de sesión guardado.
  • Algunos remitentes, como los bancos, Google y WhatsApp, rechazan los números virtuales. La entrega en esos casos no está garantizada.

Números de teléfono de un proyecto

La pestaña Phone numbers de la página Sign-ins de un proyecto lista los números que usan sus inicios de sesión. Para los inicios de sesión que reciben códigos por SMS, la opción recomendada es un número de prueba con código fijo: el número de prueba de tu proveedor de autenticación (como los números ficticios de Firebase o el OTP de prueba de Supabase) y el código fijo que acepta. Configúralo en Organization → Integrations → Phone verification.

Facturación

Cada correo que recibe la bandeja de entrada de una ejecución cuesta $0.05, y cada entrega de SMS verificada, $0.35. Consulta Facturación.

Solución de problemas

El código nunca llega

Comprueba que el producto envía a la dirección que creó la ejecución, no a una de una ejecución anterior. Abre las Email previews de la ejecución: si el correo está ahí, las Step Actions del paso muestran lo que hizo el agente con él. Si no está, el producto no lo envió o tu dominio todavía no está reenviando.

La app rechaza el dominio de la bandeja de entrada

Tu app restringe los dominios de registro. Usa el modo de prueba o recibe el correo en tu dominio.

¿No lo encontraste?

On this page