# Atajos de Apple URL: https://docs.clatri.com/apple-shortcuts/ > Registra en Clatri tus pagos con Apple Pay, los SMS de tu banco, las notificaciones de sus apps y sus correos con automatizaciones de Atajos. **Atajos (Shortcuts)** es la herramienta del iPhone lanzada en 2018 para crear automatizaciones en tu celular. A continuación vamos a ver cómo puedes usarla para automatizar el registro de tus gastos en Clatri usando Apple Pay y las notificaciones que te envía tu banco por mensaje de texto. Lo primero que tienes que hacer es ir a la aplicación Atajos y darle a **+** para crear una nueva automatización. Si tienes iOS 27 en un iPhone 15 Pro o superior, es probable que la app te deje crear tu automatización simplemente describiéndola con un prompt; en todo caso, aquí veremos la manera manual de hacerlo. Necesitas una sesión iniciada en Clatri y una suscripción activa. Abre Clatri una vez después de instalarla o actualizarla: así conecta las automatizaciones con tu cuenta. ## Cómo se lee una automatización Una automatización tiene dos partes, y en la pantalla cada una es una **caja**: 1. **El disparador** («When…»): lo que tiene que pasar. Por ejemplo, pagar con una tarjeta o recibir un SMS. 2. **Las acciones**: lo que hace el iPhone cuando pasa. Por ejemplo, enviarle a Clatri los datos del pago. (1) **Disparador.** Se reconoce por el icono de la app que lo provoca: la tarjeta azul de Wallet, la burbuja verde de Mensajes, la campana roja de notificaciones o el sobre de Mail. (2) **Acción.** Las de Clatri llevan el icono de Clatri. La flecha › despliega sus campos. Las cajas grises con el icono de ramas son **If / Si**, **Otherwise / Si no** y **End If / Fin de Si**: deciden qué acción se ejecuta. La caja naranja con una **x** es **Set Variable / Establecer variable**. ## Buscar un disparador Toca **+**. Se abre un buscador con el filtro **Automation**. Los disparadores están agrupados: en **Apps** encuentras **Wallet** y **Notification**. (1) **Wallet**: cuando pagas con una tarjeta de Wallet. (2) **Notification**: cuando una app, como la de tu banco, te envía una notificación. Este disparador llegó con iOS 27. Para **Message** (SMS) y **Email**, escribe su nombre en el buscador. Una automatización puede tener **varios disparadores**. Entre ellos aparece la palabra **or**: basta con que ocurra uno. ## Las salidas: lo que trae cada disparador Cuando un disparador se activa, entrega una **salida**: un paquete con los datos de lo que pasó. Esa salida aparece como una pastilla azul con su icono, y la usas para llenar los campos de las acciones. | Disparador | Salida | Lo que contiene | |---|---|---| | Wallet | Transaction | Card or Pass, Merchant, Amount, Name | | Message | Message | Content, Sender… | | Notification | Notification | App, Title, Body… | | Email | Email | Subject, Content, Sender, Recipients, Attachments | Al tocar un campo y elegir **Select Variable**, el iPhone te muestra las salidas disponibles. Al tocar una pastilla, se abre su menú **Get / Obtener** para elegir qué parte quieres: A la izquierda, el campo recibe el **comercio**. A la derecha, el **importe**. Nunca escribas a mano un importe, un comercio o una tarjeta: así cada pago envía sus propios datos. ## Variables: cuándo sí y cuándo no Casi nunca necesitas crear variables. **La salida del disparador ya es una variable**: el iPhone la crea solo y le pone nombre (Transaction, Message, Notification, Email). Conectar un campo directo a esa salida es lo normal, aunque uses varias partes de ella en la misma acción. Solo hay un caso en el que sí hace falta **Set Variable**: cuando necesitas **una parte que está dentro de otra parte**. El menú **Get** de una salida solo baja **un nivel**. **Amount** no es un número suelto: es un importe con su moneda. Clatri necesita las dos cosas por separado y el menú de Transaction no deja bajar hasta ellas. La solución es guardar Amount en una variable propia. Esa variable queda en el primer nivel y su menú sí muestra **Currency Code** y **Currency Amount**: (1) Hay **dos filas «Currency Amount»**. Para el número usa la de abajo, la que está **debajo de Currency Code**. La de arriba es el importe completo con su moneda. Para la moneda, elige **Currency Code** en este mismo menú. En resumen: | Si necesitas… | Haz esto | |---|---| | Una parte de la salida (Merchant, Content, Title, Body, Subject…) | Conéctala directo. Sin variable. | | Varias partes de la misma salida | Conéctalas directo, cada una en su campo. Sin variable. | | Una parte que está dentro de otra (la moneda dentro de Amount) | Una **Set Variable** con la parte de afuera; luego elige lo de adentro en el menú de la variable. | Por eso en esta guía hay **una sola** variable, `WalletAmount`, y solo para Apple Pay. SMS, notificaciones y correos no necesitan ninguna. ## Las acciones de Clatri Clatri ofrece una acción por cada origen. Todas se llaman **Record transaction from…** y cada una ya sabe de dónde viene el dato: no hay que elegir un origen. | Acción | Qué hace Clatri | |---|---| | **Record transaction from Apple Pay** | Recibe importe, moneda, comercio y tarjeta exactos y registra el gasto. **Last 4 digits** es opcional: déjalo vacío salvo que Clatri no reconozca la tarjeta. | | **Record transaction from SMS** | Lee el mensaje y registra **una compra** cuando el texto trae importe, moneda, comercio y fecha. | | **Record transaction from notification** | Igual que el SMS, leyendo el título y el cuerpo juntos. En el chat la verás como «Notificación de Nu». | | **Record transaction from email** | Muestra el correo en el chat, importa los **PDF adjuntos** (hasta 5 y 20 MB) como documentos y el asistente lee cuerpo y adjuntos juntos. Si un extracto trae muchos movimientos, los importa. | En español las acciones aparecen como «Registrar transacción desde Apple Pay», «…desde SMS», «…desde una notificación» y «…desde un correo». **Ask Clatri** es para conversar con el asistente y no se usa en estos flujos. :::info Una transferencia no es siempre un traslado entre tus cuentas Si el banco dice que transferiste dinero, Clatri no lo trata automáticamente como un traslado entre tus cuentas: también puede ser un pago, un gasto o un préstamo. Solo es un traslado si la otra cuenta es tuya. Por ahora, las transferencias que llegan por SMS o notificación quedan en el chat para que las revises; no se registran solas. ::: ## La automatización completa, paso a paso Este ejemplo usa una sola automatización con tres disparadores: - **Apple Cash** con Apple Pay. - **SMS** de un banco (en el ejemplo, Bancolombia, que escribe desde el **85540**), solo para dos tarjetas. - **Notificaciones** de la app de Nu. Cuando se activa un disparador, **solo su salida trae datos**; las otras quedan vacías. Así, con dos **If … has any value**, la automatización sabe por cuál camino ir: ### 1. Los disparadores (1) En el disparador de Wallet marca **solo las tarjetas que no entran por otro camino**. Aquí es Apple Cash, porque Nu ya entra por notificación y las tarjetas del banco por SMS. Si dejas una tarjeta en dos disparadores, cada compra se registra dos veces. (2) El filtro es opcional. Las apps también avisan de cosas que no son compras; Clatri no las registra, pero te deja una tarjeta en el chat para revisar. Deja **Automation** activado para que corra sola, sin pedirte confirmación. **Notify** puede quedar apagado: Clatri te avisa del resultado por su cuenta. ### 2. El camino del SMS (1) **If Message has any value**: solo entra si el disparador fue un SMS. Debe tener **una sola** condición; borra cualquier fila vacía «Condition». (2) Filtra las tarjetas que quieres registrar por SMS. Las terminaciones del ejemplo son ficticias: usa las tuyas. Para crear este If: agrega la primera condición, toca **+** al final para agregar la segunda y cambia **All** por **Any**. :::warning Usa «contains», no «is» Con **is**, el SMS completo tendría que ser exactamente «\*0042», y eso nunca pasa. La condición correcta es **contains**. ::: ### 3. El camino de la notificación y el de Apple Pay (1) Escribe **Nu** a mano: este disparador es solo de Nu, así que el nombre siempre es el mismo. (2) La única variable de la automatización, como se explicó arriba. (3) Amount = WalletAmount → la **segunda** Currency Amount. Currency Code = WalletAmount → Currency Code. Merchant y Card van directo a Transaction; Card es **Card or Pass**, no la Transaction completa. Para agregar una acción, usa el buscador de la parte de abajo del editor y escribe **Clatri**. Para If, Otherwise y Set Variable, escribe **If** o **Set Variable**. Apaga **Show When Run** en las tres acciones de Clatri para que no te interrumpan. Guarda y vuelve a abrir la automatización para comprobar las conexiones: tocando cada pastilla debes ver marcada la opción correcta en su menú **Get**. ### 4. Correos con extractos (opcional) Si tu banco te envía extractos o comprobantes por correo, crea otra automatización con el disparador **Email**, filtrando por el remitente del banco: Clatri solo procesa adjuntos **PDF**; ignora logos, imágenes y otros archivos. Si el PDF tiene contraseña, prueba las que tengas guardadas en Clatri y, si ninguna funciona, te la pide en el chat. Si el cuerpo y el PDF describen el mismo movimiento, lo registra una sola vez. El correo de ejemplo es ficticio. ## Una sola fuente por tarjeta Cada compra debe llegar a Clatri por **un solo** camino. Si el mismo pago entra por Apple Pay y por la notificación del banco, se registra dos veces. | Tarjeta o cuenta | Camino recomendado | |---|---| | Tarjetas cuyo banco envía SMS | **SMS**, filtrando sus terminaciones | | Tarjetas cuyo banco envía notificaciones (por ejemplo, Nu) | **Notificación**. Cubre también compras con la tarjeta física y en línea, no solo Apple Pay. | | Tarjetas sin SMS ni notificaciones útiles (por ejemplo, Apple Cash) | **Apple Pay** | | Cuentas conectadas con Plaid | Ninguno: ya llegan solas. No las marques en los disparadores. | ## Comprobar que funciona Haz una compra real y abre el chat de Clatri. Verás una tarjeta con el origen («Apple Pay», «Mensajes», «Notificación de Nu» o el correo) y, debajo, la respuesta del asistente. Clatri también te envía una notificación con el resultado. **No pulses ▶ para probar.** Una ejecución manual no tiene una compra real y puede crear un evento nuevo. «Recibido para procesar» todavía no significa «gasto registrado»: el resultado está en el chat. Si Clatri necesita saber qué tarjeta o qué cuenta fue, te lo pregunta ahí. ## Si aparece un error | Mensaje | Qué hacer | |---|---| | **Connect the message content in this action** | El campo Content quedó vacío. Conéctalo a la salida del disparador. | | **Clatri did not receive a payment amount / currency** | Revisa Amount y Currency Code: deben salir de `WalletAmount`. No se envió nada. | | **Open Clatri once to connect automations to your signed-in account** | Abre Clatri con tu sesión iniciada. También pasa cuando la conexión caduca. | | **Event saved on this iPhone, awaiting delivery** | No había conexión. Abre Clatri para que lo reenvíe. **No vuelvas a ejecutar la acción**: crearías otro evento. | | **Clatri accepts up to 5 PDF attachments and 20 MB per email** | El correo trae demasiados adjuntos o son muy pesados. | | **Couldn’t communicate with a helper application** | Es un fallo de iOS. Revisa el chat de Clatri antes de repetir nada. | Al cerrar sesión o cambiar de usuario se descartan los eventos que estaban pendientes en este iPhone. ## Detalles
Cómo elige Clatri la tarjeta, la cuenta y la entidad Clatri busca la terminación recibida entre las tarjetas activas de tu usuario. Una tarjeta identificada determina también su entidad. No deduce la tarjeta solo porque diga Visa o Mastercard. **Débito:** si todas las tarjetas candidatas son de débito, de la misma entidad, de la misma cuenta y en la misma moneda, Clatri registra el gasto en esa cuenta aunque no sepa si fue la tarjeta física o la virtual. No inventa los últimos cuatro dígitos. **Crédito:** siempre necesita identificar una tarjeta concreta. Si hay dudas, Clatri pregunta en el chat antes de registrar. Wallet puede entregar la terminación de la tarjeta virtual del dispositivo, distinta de la física. Si Clatri no reconoce tu tarjeta, escribe sus últimos cuatro dígitos en **Last 4 digits** en una automatización que use **solo esa tarjeta**. Nunca fijes unos dígitos en una automatización que acepta varias tarjetas.
Compras en otra moneda La moneda que entrega Wallet es la de la compra. Clatri convierte el importe a la moneda de la tarjeta o de la cuenta con una cotización de mercado del momento del pago, y lo marca como **conversión estimada**: el banco puede cobrar otra tasa o comisiones. Puedes corregir el importe y tocar **Confirmar importe final** en el gasto. Si el pago ya viene en la moneda de la tarjeta, no hay conversión.
Entrega, reintentos y avisos Cada evento se guarda primero en el iPhone y después se envía con un identificador fijo. Si no hay conexión, se reintenta al abrir Clatri; un reenvío nunca crea un segundo gasto. Los PDF de los correos esperan en el iPhone fuera de la copia de seguridad y se borran al llegar al servidor. Clatri envía una notificación con el resultado: gasto registrado, necesita una aclaración, revisa el mensaje o el correo llegó al chat. Los avisos no muestran importes, comercios ni tarjetas en la pantalla bloqueada. Varias compras iguales el mismo día (por ejemplo, pasajes de metro) son compras distintas y se registran por separado.