SendGrid

SendGrid es un servicio de envío de correo. NappAI tiene tres componentes para trabajar con tu cuenta de SendGrid:

• Email envía correos, de texto o a partir de una plantilla de SendGrid.
• Contact crea, consulta, actualiza y elimina los contactos de marketing de SendGrid.
• List crea, consulta, cambia y elimina listas de contactos, y añade contactos a una lista.

Son útiles cuando ya usas SendGrid para tus correos y quieres que los envíos y tu base de contactos se alimenten solos desde tus flujos.

Cuándo usarlo

• Un cliente hace un pedido y quieres enviarle la confirmación con la plantilla de tu marca.
• Un agente de IA atiende a un cliente y necesita mandarle un correo con la información que ha pedido.
• Alguien se apunta en tu web y quieres crearlo como contacto en SendGrid y añadirlo a la lista del boletín.
• Un cliente pide que borres sus datos y quieres eliminarlo de tus contactos de SendGrid.

Configuración

Los tres componentes necesitan una credencial sendgrid API con la clave API de tu cuenta de SendGrid. Para Contact y List, la clave tiene que tener activado el permiso de Marketing Campaigns en SendGrid. Consulta Credenciales.

Email

Campo	Qué hace
Credential (obligatorio)	La credencial sendgrid API con la que se accede a tu cuenta.
Operation (obligatorio)	Send Email envía un correo de texto y Send Email with Template envía un correo a partir de una plantilla dinámica de SendGrid. Por defecto, Send Email.
Sender Email	El correo que envía el mensaje. Tiene que ser un remitente verificado en tu cuenta de SendGrid.
Recipient Email	El correo del destinatario. Una sola dirección.
Subject	Solo en Send Email. El asunto del correo.
Body	Solo en Send Email. El texto del correo, sin formato.
Template ID	Solo en Send Email with Template, y obligatorio en ese caso. El identificador de la plantilla dinámica de SendGrid, que empieza por d-.
Template Data (JSON)	Solo en Send Email with Template. Los valores que rellenan las variables de la plantilla, por ejemplo {"nombre": "Ana", "pedido": "1045"}. Déjalo vacío si la plantilla no tiene variables.

Con Send Email with Template, el asunto y el contenido salen de la plantilla.

Contact

Campo	Qué hace
Credential (obligatorio)	La credencial sendgrid API con la que se accede a tu cuenta.
Operation (obligatorio)	Lo que hace el componente. Por defecto, Create.
Email Address	El correo del contacto, que es lo que lo identifica. Obligatorio en todas las operaciones salvo List All.
First Name	El nombre del contacto. En Create y Update.
Last Name	Los apellidos del contacto. En Create y Update. En Update tiene que haber al menos nombre o apellidos.

Operaciones de Contact:

Operación	Qué hace
Create	Crea un contacto con su correo y los datos que rellenes. SendGrid lo procesa en segundo plano, así que puede tardar un poco en aparecer.
Update	Cambia los datos de un contacto, que se busca por su correo.
Get	Trae la ficha de un contacto a partir de su correo, con sus datos, sus listas y sus fechas de alta y de cambio. Si el correo no es un contacto, devuelve found: false en lugar de fallar.
Delete	Elimina un contacto a partir de su correo. SendGrid lo procesa en segundo plano.
List All	Trae los contactos de tu cuenta tal como los devuelve SendGrid.

Opciones avanzadas de Contact, solo en Create y Update:

Campo	Qué hace
Address Line 1	La dirección del contacto.
City	La ciudad.
Postal Code	El código postal.
Country	El país.
Phone Number	El teléfono del contacto.

List

Campo	Qué hace
Credential (obligatorio)	La credencial sendgrid API con la que se accede a tu cuenta.
Operation (obligatorio)	Lo que hace el componente. Por defecto, Get.
List ID or Name	La lista con la que trabajas. Puedes escribir su identificador o su nombre. Obligatorio en todas las operaciones salvo Create.
List Name	Solo en Create, y obligatorio. El nombre de la lista nueva.
Updated List Name	Solo en Update, y obligatorio. El nombre nuevo de la lista.
Email Address	Solo en Add Contact, y obligatorio en ese caso. El correo del contacto que se añade a la lista.

Operaciones de List:

Operación	Qué hace
Get	Trae los datos de la lista indicada.
Create	Crea una lista nueva.
Update	Cambia el nombre de una lista.
Delete	Elimina una lista. Los contactos siguen en tu cuenta.
Add Contact	Añade un correo a la lista. Si el correo no era aún un contacto, SendGrid lo crea.

Resultado

Los tres componentes devuelven su resultado en la salida Data: si la operación ha ido bien y la respuesta de SendGrid. Email devuelve la confirmación del envío y, con plantilla, el remitente, el destinatario y la plantilla usados. Contact devuelve el contacto creado, actualizado o consultado, o la lista de contactos con su número. List devuelve la lista con la que has trabajado, con su identificador.

Los tres se pueden conectar también a un Agente como herramienta, para que el agente decida cuándo enviar un correo o consultar un contacto. Ver Tool Mode.

Ejemplo

Una tienda online quiere confirmar cada pedido con su plantilla de SendGrid.

1. En SendGrid, crea una plantilla dinámica con las variables nombre y pedido, y copia su identificador.
2. En el flujo que recibe los pedidos, añade Email con la operación Send Email with Template.
3. En Sender Email pon tu remitente verificado, en Recipient Email el correo del cliente y en Template ID el identificador de la plantilla.
4. En Template Data (JSON) pasa el nombre del cliente y el número de pedido, por ejemplo {"nombre": "Ana", "pedido": "1045"}.
5. Si quieres que el cliente reciba también tu boletín, añade List con Add Contact, la lista del boletín y el correo del cliente.

Buenas prácticas

• Cuando SendGrid rechaza una operación, el error muestra el motivo que da SendGrid, por ejemplo que el remitente no está verificado o que la lista no existe.
• Verifica antes en SendGrid el correo que usas en Sender Email: si no está verificado, SendGrid rechaza el envío.
• Email envía a un solo destinatario por ejecución. Para enviar a varias personas, pasa los destinatarios uno a uno.
• Para enviar a una lista entera, mejor una campaña de SendGrid que un correo por contacto desde el flujo.