INTEGRACIÓN SENDGRID n8n: AUTOMATIZAR SENDGRID CON N8N

Esta acción te permite enviar emails transaccionales o de marketing directamente desde tus workflows n8n, con control total sobre el remitente, destinatario, asunto, contenido del mensaje y tipo MIME. Es la acción central de la integración SendGrid, ideal para activar envíos automáticos de emails en respuesta a eventos de tus otras aplicaciones conectadas.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid autenticada.
• Resource: Dropdown requerido, configurado en "Mail" para operaciones de envío.
• Operation: Dropdown requerido, configurado en "Send" para enviar el email.
• Sender Email: Campo de texto requerido que especifica la dirección email del remitente (ej: "sender@domain.com").
• Sender Name: Campo de texto opcional para el nombre asociado al email del remitente (ej: "John Smith").
• Recipient Email: Campo de texto requerido para la dirección email del destinatario principal.
• Subject: Campo de texto opcional para el asunto del email.
• Dynamic Template: Interruptor on/off opcional. Cuando está activado, permite usar templates dinámicos de SendGrid en lugar del cuerpo de mensaje estático.
• MIME Type: Dropdown requerido que determina el tipo de contenido del email (Plain Text o HTML).
• Message Body: Área de texto requerida donde introduces el contenido del email a enviar.
• Additional Fields: Sección opcional desplegable para configurar parámetros avanzados (CC, BCC, attachments, etc.).

Casos de uso típicos:

• Envío automático de email de confirmación cuando un cliente completa un pago en Stripe, con los detalles de la transacción extraídos dinámicamente.
• Activación de emails de bienvenida personalizados cuando un nuevo usuario se registra en tu aplicación, con contenido adaptado según su perfil.
• Notificación inmediata a tu equipo de soporte cuando un ticket crítico se crea en tu helpdesk, con toda la información del caso en el cuerpo del mensaje.

Cuándo usarlo: Usa esta acción cada vez que necesites que un evento en una de tus aplicaciones active automáticamente el envío de un email. Es especialmente potente cuando se combina con templates dinámicos de SendGrid para crear emails altamente personalizados sin escribir código.

Esta acción permite modificar las propiedades de una lista de marketing existente en SendGrid, principalmente su nombre. Es útil para workflows que gestionan dinámicamente tus segmentos de contactos o que necesitan reorganizar automáticamente tus listas según criterios de negocio cambiantes.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "List".
• Operation: Dropdown requerido configurado en "Update".
• List ID: Campo de texto requerido donde proporcionas el identificador único de la lista SendGrid que deseas actualizar.
• Name: Campo de texto opcional para especificar el nuevo nombre que quieres asignar a la lista.

Casos de uso típicos:

• Renombrado automático de listas SendGrid cada mes para incluir la fecha (ej: "Webinar Leads Enero 2024" → "Webinar Leads Febrero 2024").
• Actualización del nombre de una lista cuando su propósito cambia según eventos en tu CRM (ej: lista pasa de "Leads" a "Customers").

Cuándo usarlo: Ideal para workflows de organización automatizada de tus segmentos de marketing cuando el contexto o la fecha requieren cambiar el nombre de tus listas para mantener una nomenclatura clara.

Esta acción recupera múltiples listas de contactos desde tu cuenta SendGrid, con opción de limitar el número de resultados. Es fundamental para workflows que necesitan verificar la existencia de listas, obtener sus IDs para operaciones posteriores, o simplemente auditar tu estructura de listas.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "List".
• Operation: Dropdown requerido configurado en "Get Many".
• Return All: Interruptor on/off opcional. Cuando está activado, recupera todas las listas disponibles sin límite.
• Limit: Campo numérico opcional (activo cuando "Return All" está desactivado) que especifica el número máximo de listas a recuperar. En el screenshot, configurado en "100".

Casos de uso típicos:

• Recuperación de la lista completa de tus segmentos SendGrid al inicio de un workflow para verificar si una lista específica existe antes de intentar crear una nueva.
• Obtención automática de IDs de listas basándose en sus nombres para operaciones posteriores de adición de contactos.
• Generación de reportes regulares sobre la estructura de tus listas de marketing.

Cuándo usarlo: Usa esta acción al principio de workflows que necesitan interactuar con listas SendGrid sin conocer previamente sus IDs exactos, o cuando quieres implementar lógica condicional basada en la existencia de ciertas listas.

Esta acción recupera información detallada sobre una lista de contactos específica en SendGrid, identificándola por su ID único. Opcionalmente, puede incluir una muestra de contactos de la lista en los datos devueltos.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "List".
• Operation: Dropdown requerido configurado en "Get".
• List ID: Campo de texto requerido para introducir el identificador único de la lista que deseas recuperar. Actualmente vacío en el screenshot.
• Contact Sample: Interruptor on/off opcional que, cuando está activado, incluye una muestra de contactos de la lista en la respuesta. Actualmente desactivado.

Casos de uso típicos:

• Verificación de las propiedades de una lista específica (nombre, fecha de creación, número de contactos) antes de realizar operaciones masivas.
• Obtención de información detallada sobre una lista para reportes o dashboards de métricas de marketing.

Cuándo usarlo: Ideal cuando conoces el ID de una lista y necesitas confirmar sus características o obtener datos adicionales sobre ella antes de ejecutar operaciones posteriores en tu workflow.

Esta acción elimina permanentemente una lista de contactos de tu cuenta SendGrid, con opción de eliminar también todos los contactos asociados a esa lista o solo la lista en sí.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "List".
• Operation: Dropdown requerido configurado en "Delete".
• List ID: Campo de texto requerido donde proporcionas el identificador único de la lista que deseas eliminar. Actualmente vacío en el screenshot.
• Delete Contacts: Interruptor on/off opcional. Cuando está activado, elimina también todos los contactos asociados a la lista. Cuando está desactivado (como en el screenshot), solo elimina la lista y los contactos permanecen en SendGrid.

Casos de uso típicos:

• Limpieza automática de listas temporales creadas para campañas específicas una vez finalizadas (ej: lista "Black Friday 2024" eliminada el 1 de diciembre).
• Eliminación de segmentos obsoletos cuando tu estrategia de marketing cambia, manteniendo solo listas activas y relevantes.

Cuándo usarlo: Usa esta acción con precaución en workflows de mantenimiento de tu base de datos SendGrid cuando necesites eliminar segmentos que ya no utilizas. Siempre verifica el ID de la lista y decide conscientemente si activar o no "Delete Contacts" según si quieres eliminar también los contactos o solo la segmentación.

Esta acción crea una nueva lista de contactos en tu cuenta SendGrid con el nombre que especifiques. Es la base para construir workflows de segmentación automática de tus contactos según criterios dinámicos.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "List".
• Operation: Dropdown requerido configurado en "Create".
• Name: Campo de texto requerido donde defines el nombre de la nueva lista SendGrid. Soporta valores fijos o expresiones dinámicas para nombrado variable.

Casos de uso típicos:

• Creación automática de una nueva lista cada mes con el nombre del mes y año (ej: "Leads Enero 2024") para segmentar temporalmente tus contactos.
• Generación de listas dinámicas basadas en eventos de negocio (ej: crear automáticamente "Webinar [Topic] [Date]" cuando programas un nuevo webinar en tu calendario).
• Creación de segmentos específicos cuando detectas patrones de comportamiento en tus contactos que justifican una lista dedicada.

Cuándo usarlo: Ideal al inicio de workflows de segmentación automatizada donde necesitas crear el contenedor (la lista) antes de poblarla con contactos. Combina con "Create or Update Contact" para añadir inmediatamente contactos a la lista recién creada.

Esta acción recupera múltiples contactos desde tu cuenta SendGrid, con opciones avanzadas de filtrado y límite de resultados. Es fundamental para workflows que necesitan procesar contactos existentes, verificar su presencia, o sincronizar datos entre SendGrid y otras aplicaciones.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "Contact".
• Operation: Dropdown requerido configurado en "Get Many".
• Return All: Interruptor on/off opcional. Cuando está activado, recupera todos los contactos que coincidan con los criterios. Cuando está desactivado (como en el screenshot), usa el parámetro "Limit".
• Limit: Campo numérico opcional (visible cuando "Return All" está desactivado) que especifica el número máximo de contactos a recuperar. Configurado en "100" en el screenshot.
• Filters: Sección opcional donde puedes añadir condiciones para refinar la búsqueda de contactos (por email, campos personalizados, etc.). Actualmente muestra "No properties" con botón "Add Field" para definir criterios.

Casos de uso típicos:

• Recuperación diaria de todos los nuevos contactos de SendGrid para sincronizarlos con tu CRM o base de datos principal.
• Búsqueda de contactos específicos según criterios personalizados (ej: todos los contactos con campo "Estado" = "Lead Calificado") para operaciones posteriores.
• Auditoría regular de tu base de contactos SendGrid para generar reportes sobre crecimiento o calidad de datos.

Cuándo usarlo: Usa esta acción cuando necesites acceder a múltiples contactos de SendGrid para procesarlos, validarlos, o transferirlos a otras aplicaciones en tu workflow. Los filtros te permiten recuperar exactamente los contactos que necesitas sin tener que procesar toda tu base.

Esta acción recupera información detallada sobre un contacto específico en SendGrid, identificándolo por su ID único. Es útil para workflows que necesitan verificar o actualizar un contacto concreto basándose en eventos de otras aplicaciones.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "Contact".
• Operation: Dropdown requerido configurado en "Get".
• By: Dropdown requerido que especifica cómo identificar el contacto. Configurado en "ID", indicando búsqueda por identificador único.
• Contact ID: Campo de texto requerido donde introduces el ID específico del contacto que deseas recuperar. Actualmente vacío.

Casos de uso típicos:

• Verificación de existencia y datos de un contacto específico antes de intentar actualizarlo o enviarte un email.
• Recuperación de información completa de un contacto cuando tu CRM actualiza un registro y necesitas sincronizar con SendGrid.

Cuándo usarlo: Ideal cuando conoces el ID exacto de un contacto (obtenido previamente de otra operación o desde otra aplicación) y necesitas confirmar sus datos actuales en SendGrid antes de ejecutar operaciones posteriores.

Esta acción elimina contactos específicos de tu cuenta SendGrid, ya sea proporcionando una lista de IDs de contactos o activando una eliminación masiva de todos los contactos. Úsala con extrema precaución debido a su naturaleza destructiva.

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "Contact".
• Operation: Dropdown requerido configurado en "Delete".
• Contact IDs: Campo de texto donde proporcionas los identificadores únicos de los contactos que deseas eliminar. Acepta una lista de IDs. Requerido cuando "Delete All" está desactivado.
• Delete All: Interruptor on/off opcional. Cuando está activado, elimina TODOS los contactos de tu cuenta SendGrid, ignorando el campo "Contact IDs". En el screenshot está desactivado.

Casos de uso típicos:

• Eliminación automática de contactos que se han dado de baja en otras plataformas para mantener la sincronización de opt-outs.
• Limpieza programada de contactos que han rebotado repetidamente o que no han interactuado en períodos prolongados.
• Cumplimiento automático de solicitudes GDPR de eliminación de datos personales cuando un usuario lo solicita en tu aplicación.

Cuándo usarlo: Usa esta acción únicamente en workflows bien testados con validación robusta de los IDs a eliminar. Nunca actives "Delete All" en workflows de producción sin confirmaciones múltiples. Es particularmente útil para workflows de cumplimiento normativo o limpieza de base de datos basada en criterios estrictos.

Esta acción crea un nuevo contacto en SendGrid si no existe, o actualiza sus datos si ya está presente en la base de datos. Es la acción más utilizada en workflows de sincronización de contactos entre aplicaciones, ya que maneja automáticamente la lógica de "upsert" (update or insert).

Parámetros clave:

• Credential to connect with: Dropdown requerido para seleccionar tu cuenta SendGrid.
• Resource: Dropdown requerido configurado en "Contact".
• Operation: Dropdown requerido configurado en "Create or Update".
• Email: Campo de texto requerido donde proporcionas la dirección email del contacto a crear o actualizar. SendGrid usa este campo como identificador único para determinar si el contacto ya existe. Ejemplo: "name@email.com".
• Additional Fields: Sección opcional donde puedes añadir propiedades adicionales del contacto (first name, last name, campos personalizados, listas a las que añadir, etc.) haciendo clic en "Add Field". Actualmente muestra "No properties".

Casos de uso típicos:

• Sincronización automática de nuevos leads desde tu CRM hacia SendGrid, con todos sus datos (nombre, empresa, campo personalizado "Fuente", etc.) en cuanto se crean.
• Actualización inmediata de datos de contactos en SendGrid cuando se modifican en tu aplicación principal, manteniendo ambas bases perfectamente sincronizadas.
• Adición automática de contactos a listas específicas de SendGrid cuando completan acciones en tu sitio web (descarga de recurso, registro a webinar, etc.).

Cuándo usarlo: Esta es tu acción principal para workflows de sincronización de contactos. Úsala cada vez que necesites asegurar que un contacto existe en SendGrid con los datos correctos, sin preocuparte de verificar manualmente si ya existe o no. La lógica de "upsert" simplifica enormemente tus workflows al combinar las operaciones de creación y actualización en una sola acción. Para workflows similares con otras plataformas de email, consulta también la integración con Mailchimp o Brevo.