> ## Documentation Index
> Fetch the complete documentation index at: https://www.notifuse.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Zapier

> Conecta Notifuse a Zapier: envía tus correos transaccionales desde cualquier aplicación, lanza Zaps con los eventos de contactos, listas y segmentos, y crea o suscribe contactos.

Zapier conecta Notifuse con miles de aplicaciones sin escribir código. Notifuse ofrece disparadores y acciones:

- Los **disparadores** inician un Zap cuando ocurre algo en Notifuse: se crea o se actualiza un contacto, alguien se suscribe a una lista o se da de baja, un contacto entra en un segmento o sale de él. Notifuse envía cada evento a Zapier en el momento en que ocurre; Zapier no consulta periódicamente.
- Las **acciones** permiten que otra aplicación actúe en Notifuse. La principal es el **envío**: un Zap elige una de tus notificaciones transaccionales y Notifuse la envía con tu plantilla, tu remitente y tu proveedor de correo. Las acciones también pueden crear o actualizar un contacto, o suscribirlo a una lista.

## Antes de empezar

Necesitas una **Clave API** y la **URL de la API** de Notifuse. Al conectar Zapier en **Configuración** → **Integraciones** obtienes las dos.

También necesitas **HTTPS**: Zapier solo llama a endpoints servidos por HTTPS con un certificado de una autoridad de certificación pública, y una instancia autoalojada tiene que ser accesible desde internet.

## Paso 1: conecta Zapier

Abre **Configuración** → **Integraciones** en el espacio de trabajo donde quieres que trabaje Zapier. Haz clic en **Añadir integración** y elige **Zapier** en **Aplicaciones conectadas**. Solo el propietario del espacio de trabajo puede conectarlo.

El único campo es una **etiqueta**. Da nombre a la conexión dentro de Notifuse y nada más depende de ella. Un espacio de trabajo puede tener varias conexiones de Zapier, así que usa la etiqueta para indicar para qué sirve cada una. El valor predeterminado, "Zapier", basta si solo necesitas una.

Haz clic en **Conectar Zapier**. Notifuse genera una clave API con solo los permisos que necesita esta integración: lectura y escritura en **Transaccional**, **Suscripciones de webhook**, **Contactos** y **Listas**, más lectura en **Segmentos**. No tienes que marcar nada.

Fíjate en **Transaccional** antes de conectar. Permite que un Zap envíe correos, pero también crear, editar y eliminar notificaciones transaccionales, probar plantillas y proveedores, y retransmitir por el puente SMTP. Un token filtrado podría enviar correo a través de tu proveedor, a tu costa y en contra de tu reputación de envío, aunque no puede leer tu historial de mensajes. Si una conexión de Zapier no necesita enviar, restringe la clave (consulta _Gestionar la conexión después_).

El token se muestra **una sola vez**, en el panel que sustituye al formulario. Cópialo antes de pulsar **Hecho**: ninguna pantalla de Notifuse puede volver a mostrarlo. El mismo panel muestra la **URL de la API** para el paso 2, con un botón para copiarla.

> [!NOTE]
>
> **Notifuse deriva la dirección de la clave de tu etiqueta.** La construye como `zapier-<label>-<random>`: pasa la etiqueta a minúsculas y sustituye por un guion todo lo que no sea una letra, un dígito o un guion bajo. Si dejaste el valor predeterminado, la dirección es `zapier-<random>`. Las direcciones de las claves API son únicas en toda la instalación de Notifuse, no por espacio de trabajo. La parte aleatoria permite que dos espacios de trabajo conecten cada uno un Zapier "Marketing" sin conflicto, y nunca tienes que buscar un nombre libre. El panel de conexión muestra la dirección resultante, y la tarjeta de la conexión también la muestra después: así relacionas una tarjeta con su fila en **Configuración** → **Equipo y claves API**.

> [!NOTE]
>
> **También puedes crear la clave a mano** en **Configuración** → **Equipo y claves API** → **Nueva clave**, donde concedes tú mismo los permisos (la tabla de abajo indica qué marcar). Una clave así es una clave API normal sin conexión asociada: no aparece ninguna tarjeta en **Configuración** → **Integraciones**, y solo eliminar su fila en **Configuración** → **Equipo y claves API** la revoca. Dale a Zapier su propia clave en vez de reutilizar otra. [Administradores y claves API](https://www.notifuse.com/es/docs/features/admins-api-keys.md) tiene la referencia completa de permisos.

### Qué puede hacer la clave

Al conectar Zapier, todo esto se concede por ti. La tabla muestra a qué tiene acceso el token en manos de Zapier, y qué marcar si creas la clave a mano en **Configuración** → **Equipo y claves API** o si la restringes después.

| Lo que quieres usar                                                                                          | Permisos que necesita la clave                                                                   |
| ------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------ |
| Conectar la cuenta, el selector de espacio de trabajo y las etiquetas de campos personalizados en una acción | Ninguno: cualquier clave puede hacerlo                                                           |
| Cualquier disparador (activar y desactivar un Zap)                                                           | Lectura y escritura en **Suscripciones de webhook**                                              |
| Los datos de ejemplo de cualquier disparador (lo que Zapier te muestra mientras construyes un Zap)           | Lectura en **Contactos**                                                                         |
| Disparadores de contactos                                                                                    | Lectura en **Contactos**                                                                         |
| Disparadores de listas y el selector de listas                                                               | Lectura en **Listas** y lectura en **Contactos**                                                 |
| Disparadores de segmentos y el selector de segmentos                                                         | Lectura en **Segmentos** y lectura en **Contactos**                                              |
| La acción **Send Transactional Email** y el selector de notificaciones                                       | Lectura **y** escritura en **Transaccional**                                                     |
| Guardar en el contacto los campos de contacto rellenados en un envío                                         | Escritura en **Contactos**. Sin ella el envío funciona igual, pero solo se registra la dirección |
| CC o CCO en un envío                                                                                         | También lectura en **Contactos**, porque el asunto se renderiza con los datos del contacto       |
| La acción **Create or Update Contact**                                                                       | Escritura en **Contactos**                                                                       |
| La acción **Subscribe Contact to List**                                                                      | Lectura **y** escritura en **Listas**                                                            |

> [!NOTE]
>
> **La lectura llena los desplegables; la escritura ejecuta el paso.** Cada selector lee los elementos entre los que eliges, así que con solo escritura no se puede configurar una acción. Con escritura en **Listas** pero sin lectura en **Listas**, el paso **Subscribe Contact to List** no se puede guardar: su selector de listas devuelve un error de permisos, y la lista es un campo obligatorio.
>
> Todos los disparadores necesitan lectura en **Contactos**, no solo los de contactos: los registros de ejemplo que Zapier muestra mientras construyes un Zap salen de tus contactos, sea cual sea el disparador elegido. Una clave sin ese permiso llena sus desplegables pero falla en **Test trigger**.

> [!WARNING]
>
> **La escritura en Transaccional, en Suscripciones de webhook y en Listas llega más lejos de lo que sugieren sus nombres.** La escritura en Transaccional envía correo a través de tu proveedor, y también permite editar y eliminar tus notificaciones transaccionales, probar proveedores y usar el puente SMTP. Un disparador se suscribe a eventos y hace que sus payloads se entreguen a Zapier. Suscribir una dirección a una lista crea o sobrescribe el registro de ese contacto, y enviarle un correo también. Protege esta clave como protegerías tu base de contactos y tus credenciales de envío.

## Paso 2: tu URL de la API

El formulario de conexión de Zapier tiene un campo **API URL**. El panel **Conectar Zapier** muestra su valor, antes de conectar y junto al token después.

- **Notifuse Cloud**: el campo llega rellenado con la API de Cloud, `https://v3.notifuse.com`. Déjalo como está.
- **Autoalojado**: pega la dirección que muestra el panel. Es la dirección con la que abres la consola de Notifuse, solo el esquema y el dominio, sin nada después del dominio ni barra final. No vacíes el campo: una API URL vacía significa Notifuse Cloud, no "esta instancia".

Tu instancia tiene que ser accesible desde internet, por HTTPS, con un certificado de una autoridad de certificación pública. Let's Encrypt sirve.

> [!WARNING]
>
> **No se admiten `http://` sin cifrar, los certificados autofirmados ni las autoridades de certificación internas**, ni tampoco una instancia accesible solo desde dentro de tu red. Zapier exige HTTPS con un certificado de confianza pública. Si tu instancia está detrás de un firewall, ten en cuenta que Zapier solo publica un conjunto fijo de direcciones IP de salida para tu lista de permitidos en sus planes de pago.

## Paso 3: conecta tu espacio de trabajo

En Zapier, crea un Zap, busca **Notifuse** y elige un disparador o una acción. Cuando Zapier te pida conectar una cuenta, pega la clave API y, si usas una instancia autoalojada, tu URL de la API.

Después, cada disparador y cada acción de Notifuse te pide en un desplegable qué **espacio de trabajo** usar.

> [!NOTE]
>
> **Una conexión de Zapier cubre un solo espacio de trabajo.** Una clave API de Notifuse pertenece a un único espacio de trabajo, así que el desplegable solo ofrece ese y lo selecciona por ti. Si tienes varios espacios de trabajo, conecta Zapier desde **Configuración** → **Integraciones** en cada uno y añade una conexión de Zapier distinta para cada uno. Zapier nombra las conexiones con el nombre del espacio de trabajo y el host, así que es fácil distinguirlas.

## Gestionar la conexión después

La conexión aparece como una tarjeta en **Configuración** → **Integraciones**, con tu etiqueta, la dirección de la clave que generó y la fecha de conexión. Puedes renombrarla o eliminarla, y los efectos son muy distintos:

- **Renombrarla** solo cambia la etiqueta de la tarjeta. La clave conserva la dirección con la que se generó, así que el nombre y la dirección pueden no coincidir después; por eso la tarjeta muestra los dos. No hay que volver a introducir nada en Zapier.
- **Eliminarla revoca la clave.** Todos los Zaps que usan esa clave dejan de funcionar en cuanto confirmas. Una clave revocada no se puede restaurar, y al volver a conectar se genera una nueva que tienes que pegar en Zapier. Eliminar el espacio de trabajo revoca sus claves de Zapier de la misma forma.

Los permisos de una clave se cambian en **Configuración** → **Equipo y claves API**. Amplía o restringe ahí la clave de Zapier: el cambio se aplica desde su siguiente petición y **el token no cambia**, así que no hay nada que volver a introducir en Zapier. Eliminar ahí la fila de la clave también la revoca, igual que eliminar la tarjeta, pero deja la tarjeta apuntando a una clave que ya no existe.

## Disparadores

| Disparador                         | Se activa cuando                                             |
| ---------------------------------- | ------------------------------------------------------------ |
| **New Contact**                    | Se añade un contacto al espacio de trabajo                   |
| **Updated Contact**                | Cambian los datos de un contacto existente                   |
| **New List Subscriber**            | Un contacto pasa a ser suscriptor activo de una lista        |
| **Contact Unsubscribed from List** | Un contacto se da de baja de una lista                       |
| **Contact Joined Segment**         | Un contacto empieza a cumplir las condiciones de un segmento |
| **Contact Left Segment**           | Un contacto deja de cumplir las condiciones de un segmento   |

Los disparadores de listas y segmentos te permiten elegir una lista o un segmento concreto. Elige uno: así Notifuse solo envía a Zapier los eventos de esa lista o ese segmento, en lugar de los de todas las listas del espacio de trabajo, lo que reduce las tareas que consume tu Zap y la carga de tu instancia.

### New List Subscriber cubre tres formas de entrar

Un contacto puede pasar a ser suscriptor activo de una lista de tres formas, y solo la primera es una suscripción nueva:

- Se **suscribe** por primera vez.
- **Confirma** una suscripción con doble confirmación que estaba pendiente.
- **Se vuelve a suscribir** después de haberse dado de baja, de un rebote o de una denuncia de spam.

**New List Subscriber se activa en los tres casos.** Un contacto que vuelve nunca genera un evento de primera suscripción, así que un Zap que solo vigilara ese evento perdería a todos los suscriptores que vuelven sin mostrar ningún error. Cada ejecución lleva el evento concreto, de modo que puedes ramificar en Zapier para tratar de forma distinta a los nuevos suscriptores y a los que vuelven.

### Updated Contact ignora los guardados sin cambios

**Updated Contact** solo se activa cuando cambian los datos de un contacto. Guardar un contacto sin cambios, o que una tarea en segundo plano toque un registro, no genera ningún evento, así que las actualizaciones internas rutinarias no ejecutan tus Zaps.

### Zapier gestiona sus propias suscripciones de webhook

Al activar un Zap de Notifuse se crea una suscripción en **Configuración** → **Webhooks**, marcada como creada por Zapier. Al desactivar el Zap se elimina.

> [!WARNING]
>
> **No elimines a mano una suscripción de webhook creada por Zapier.** El Zap al que pertenece deja de recibir eventos y no vuelve a crear la suscripción por sí solo: tienes que desactivar y volver a activar el Zap en Zapier, lo que funciona aunque la suscripción ya no exista. Elimina el Zap en su lugar y deja que él haga la limpieza.

Una entrega fallida se reintenta, así que un Zap puede ejecutarse alguna vez dos veces para el mismo evento. Si tu Zap hace algo que no debe ocurrir dos veces, como cobrar una tarjeta o enviar un mensaje, añade un filtro de Zapier o un paso de deduplicación.

## Acciones

| Acción                        | Qué hace                                                                                                                    |
| ----------------------------- | --------------------------------------------------------------------------------------------------------------------------- |
| **Send Transactional Email**  | Envía una de tus notificaciones transaccionales a un contacto y rellena las variables de su plantilla con los datos del Zap |
| **Create or Update Contact**  | Crea el contacto si la dirección de correo es nueva y, si no, lo actualiza                                                  |
| **Subscribe Contact to List** | Crea o actualiza el contacto **y** lo suscribe a las listas que elijas, en un solo paso                                     |

Las tres acciones identifican al contacto por la **dirección de correo**, así que volver a ejecutarlas con la misma dirección actualiza el mismo contacto en lugar de crear un duplicado.

Los campos de contacto personalizados aparecen en estas acciones con las etiquetas que les diste. Ponles nombre primero en **Configuración** → **Campos personalizados**: los campos sin etiqueta están ocultos, así que si falta un campo en Zapier, lo normal es que todavía no tenga etiqueta.

### Enviar consiste en elegir, no en redactar

**Send Transactional Email** no lleva el correo en sí. La plantilla, el remitente, el seguimiento y la gestión de bajas se quedan en Notifuse. El Zap elige qué notificación enviar, quién la recibe y los valores con los que se renderiza su plantilla.

En el paso, elige una **Notification** en el desplegable, asigna un **Email** para el destinatario y rellena **Template Data** con una fila por cada `{{ variable }}` que use tu plantilla. Una variable que no proporcionas se renderiza vacía sin error, así que si llega un correo con un hueco, revisa primero la ortografía de esa fila comparándola con la plantilla.

Dos detalles sobre Template Data:

- **Los valores llegan como texto.** Mostrar un valor funciona. Una comparación como `{% if total > 100 %}` no se cumplirá, porque compara con el texto `"120"`, no con el número.
- **Notifuse define `contact` y `notification_center_url`**, y el Zap no puede sobrescribirlos. Las filas con esos nombres se ignoran.

Las notificaciones sin canal de correo no aparecen en el desplegable, porque enviarlas solo podría fallar.

### Enviar también escribe el contacto

Un envío crea el contacto si la dirección es nueva, así que puedes escribir a alguien en su primer pedido sin un paso aparte.

**Cualquier campo de contacto que rellenes sobrescribe lo que hay guardado.** Si asignas First Name desde una fuente que a veces viene vacía, esas ejecuciones vacían el nombre guardado. Un campo que dejas vacío en el Zap no toca el valor guardado; un campo asignado tiene prioridad. Para solo enviar, rellena únicamente la dirección de correo.

### Usa Message External ID para todo lo que no deba enviarse dos veces

Zapier reintenta un paso fallido, y un reintento vuelve a ejecutar toda la acción. Una notificación de envío duplicada es una molestia menor; un restablecimiento de contraseña o una confirmación de pedido duplicados son un problema real.

Rellena **Message External ID** con un valor estable que venga del disparador, como un número de pedido, un id de factura o el id del registro de origen. Un envío con un valor que Notifuse ya ha visto devuelve el mensaje original en lugar de enviar un segundo correo. Si lo dejas vacío, cada ejecución envía.

El paso no puede decirte cuál de los dos casos ocurrió: en Zap History, un envío deduplicado y uno nuevo se ven iguales, ambos correctos y con el mismo id de mensaje.

> [!WARNING]
>
> **Probar el paso envía un correo real.** El botón **Test action** de Zapier envía de verdad, no hace una simulación, igual que cualquier ejecución real. Usa una dirección tuya mientras construyes el Zap.

### El estado de la suscripción no siempre es activo

**Subscribe Contact to List** devuelve el estado resultante de cada lista. No siempre es `active`, y eso puede parecer un error:

- **Un contacto que se dio de baja antes vuelve como `pending`, no como `active`**, y recibe el correo de confirmación de la lista. Notifuse impone la doble confirmación a quien se haya dado de baja antes, digan lo que digan los ajustes de la lista. Esta regla de cumplimiento no se puede desactivar. El Zap no ha fallado: el contacto tiene que confirmar antes de recibir nada. Una lista sin plantilla de doble confirmación no tiene correo de confirmación que enviar, así que esos contactos se quedan en `pending` indefinidamente. Configura una antes de dirigir un Zap de reactivación a una lista.
- **Un contacto totalmente nuevo queda `active` incluso en una lista con doble confirmación**, y no recibe correo de confirmación, porque la petición viene de una clave API autenticada y no de un formulario de suscripción público.

> [!WARNING]
>
> Antes de dirigir un Zap de captación de leads a una lista con doble confirmación, ten en cuenta que las direcciones nuevas se saltan el paso de confirmación. Añade personas a una lista mediante Zapier solo con su consentimiento, como harías al importar un archivo.

En otros tres casos la acción informa de éxito sin añadir un suscriptor nuevo. No se ven igual en la salida, lo que importa si filtras por el resultado:

- **Una dirección que ha rebotado o ha denunciado spam no se vuelve a suscribir.** Vuelve con su estado final, `bounced` o `complained`, que un paso Filter basado en **Status** detecta.
- **Un contacto que ya está activo en la lista no se toca.** Volver a ejecutar el Zap no cambia nada, y la suscripción vuelve como `active`.
- **Una dirección de un dominio de correo desechable se descarta sin aviso.** Es el único caso sin nada que mostrar: el paso termina con éxito, **sin ninguna suscripción** y con **Status** vacío. No se escribe ni la suscripción ni el contacto.

> [!NOTE]
>
> **Filtra por el valor del estado, no por si existe un estado.** _Continue if Status exists_ deja pasar una dirección rebotada igual que una activa, porque las dos tienen un estado, y solo detiene el caso del dominio desechable. Para comprobar que "el contacto ya está suscrito", verifica que **Status** sea `active`, o que **Memberships** no esté vacío si suscribes a varias listas a la vez.

## Solución de problemas

### La prueba de conexión falla

- Revisa la API URL: tiene que empezar por `https://` y no llevar ninguna ruta después del dominio. El panel de conexión mostró el valor exacto, y al volver a abrir la tarjeta solo se ve la etiqueta. Si ya no lo tienes, usa el esquema y el dominio de la dirección con la que abres la consola de Notifuse.
- Abre `https://your-domain/api/workspaces.list` en un navegador. La respuesta esperada es un error de autenticación, que demuestra que la dirección es accesible; un tiempo de espera agotado, un error de conexión o un aviso de certificado significan que Zapier tampoco puede llegar a ella.
- Comprueba que el certificado lo emite una autoridad de certificación pública, y que no es autofirmado ni interno.
- Si la clave se revocó en Notifuse (al eliminar la conexión de Zapier o al quitar su fila en **Configuración** → **Equipo y claves API**), la conexión deja de funcionar de inmediato. Zapier informa de un fallo de autenticación y ofrece volver a conectar la cuenta: conecta Zapier de nuevo y pega el token nuevo.

### Un paso falla con un error de permisos

El mensaje indica el permiso que falta. Añádelo a la clave desde **Configuración** → **Equipo y claves API**; el cambio se aplica en la siguiente petición y el token sigue siendo el mismo. No vuelvas a conectar Zapier para arreglarlo: una conexión nueva genera una clave con los mismos permisos estándar, y el paso falla en el mismo sitio.

Si **Send Transactional Email** falla por **Transaccional**, o su selector de notificaciones está vacío e informa de un error de permisos, la conexión es anterior a Notifuse 39.1, la versión que añadió el envío a los permisos estándar. Marca lectura y escritura en **Transaccional** para la clave en **Configuración** → **Equipo y claves API** y el paso funcionará en su siguiente ejecución, sin volver a conectar ni cambiar el token.

### Un Zap ha dejado de recibir eventos

Abre **Configuración** → **Webhooks** en Notifuse y mira la suscripción de ese Zap:

- **Desactivada con un motivo indicado.** Notifuse desactiva una suscripción automáticamente tras una larga serie de entregas fallidas y registra el motivo. Vuelve a activarla cuando hayas corregido la causa, o simplemente desactiva y vuelve a activar el Zap en Zapier para recrearla.
- **No aparece.** Alguien la eliminó a mano, o el Zap se desactivó. Desactiva y vuelve a activar el Zap.

El registro de entregas de cada suscripción muestra cada evento enviado, la respuesta de Zapier y el payload. Es la forma más rápida de saber si Notifuse llegó a enviar un evento.

### La prueba del disparador no encuentra datos

Zapier busca actividad reciente que coincida para construir su ejemplo. Si una lista no ha tenido suscriptores últimamente, o un segmento no ha tenido miembros nuevos, no hay nada que mostrar. Crea un contacto de prueba, suscríbelo a la lista y vuelve a lanzar la prueba.

## Limitaciones

- **Una conexión cubre un solo espacio de trabajo.** Varios espacios de trabajo significan varias conexiones.
- **Eliminar un contacto no activa ningún Zap**, ni tampoco los eventos de envíos masivos o automatizaciones.
- **Todavía no hay paso de búsqueda**: no puedes consultar un contacto en mitad de un Zap sin una acción que escriba.
- **Los campos personalizados necesitan una etiqueta** para aparecer en una acción.
- **Un envío no puede llevar archivos adjuntos.** La API los acepta, pero Zapier pasa a un paso una referencia a un archivo y no el archivo en sí, así que no hay nada que adjuntar.
- **Un envío no puede redactar un correo.** Envía una notificación que configuraste en Notifuse; no puede aportar su propio cuerpo. Puedes sobrescribir el asunto, el texto de vista previa, el nombre del remitente y la dirección de respuesta para un mensaje concreto.

## Documentación relacionada

- [Administradores y claves API](https://www.notifuse.com/es/docs/features/admins-api-keys.md): qué permite cada permiso
- [Webhooks](https://www.notifuse.com/es/docs/features/webhooks.md): los tipos de evento y los payloads que hay detrás de los disparadores
- [Contactos](https://www.notifuse.com/es/docs/features/contacts.md)
- [Listas](https://www.notifuse.com/es/docs/features/lists.md)
- [Segmentos](https://www.notifuse.com/es/docs/features/contacts.md#contact-segmentation-engine)
