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.
Nota
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.
Nota
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 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 |
Nota
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.
Advertencia
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.
Advertencia
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.
Nota
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.
Advertencia
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
contactynotification_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.
Advertencia
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 comoactive, 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 enpendingindefinidamente. Configura una antes de dirigir un Zap de reactivación a una lista. - Un contacto totalmente nuevo queda
activeincluso 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.
Advertencia
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,
bouncedocomplained, 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.
Nota
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.listen 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: qué permite cada permiso
- Webhooks: los tipos de evento y los payloads que hay detrás de los disparadores
- Contactos
- Listas
- Segmentos
