Este endpoint permite enviar correos electrónicos a uno o varios destinatarios, soportando tanto mensajes transaccionales como de mercadeo. Los correos pueden incluir adjuntos, formato HTML, copias CC/BCC y configuraciones de prioridad.
body:
El cuerpo del email puede ser enviado de 2 formas:
- Desde un 'template' previamente almacenado en Hablame (contacte a soporte para enviar y almacenar su plantilla), se le entregará un ID del template el cual debe enviar en la variable "templateId" .
- Enviar directamente el código HTML en la variable "htmlBody".
Si ambas variables estan presentes en el JSON recibido, se dará prioridad a la variable "htmlBody".
variables:
En posible utilizar variables personalizadas que serán reemplazas en el código HTML del body para en envío de email personalizados, para esto se deberá indicar en el HTML de la forma: ###mivariable###
El valor de las variables a reemplazar deben ser indicadas en el campo "variables" del objeto JSON recibido.
<h1 style=\"color:blue;\">¡Hola ###mivariable###!</h1><p>Este es un email con <b>adjuntos</b> y formato HTML.</p>
"variables": {
"mivariable": "Carlos"
},
<h1 style=\"color:blue;\">¡Hola Carlos!</h1><p>Este es un email con <b>adjuntos</b> y formato HTML.</p>
attachments:
Se pueden enviar archivos adjuntos al email, para lo cual se debe especificar la variable "attachments" en el request de la siguiente manera:
"attachments": [
{
"fileName": "documento1.pdf",
"content": "BASE64_ENCODED_DATA",
"mimeType": "application/pdf"
},
{
"fileName": "documento2.pdf",
"content": "BASE64_ENCODED_DATA",
"mimeType": "application/pdf"
}
]
Tenga en cuenta que el peso de los archivos no puede superar los 20MB, y algunos servidores de dominios de email tienes restricciones a tamaños menores.
priority:
La variable "priority" debe indicarse en "true" para enviar el email de manera prioritaria. Esto puede tener costos adicionales.
"priority":true
Objeto JSON completo para envío de email:
{
"sender": {
"email": "[email protected]",
"name": "Juan Pérez"
},
"recipients": {
"to": [
{
"email": "[email protected]",
"name": "Juan Pérez"
}
],
"cc": [
{
"email": "[email protected]",
"name": "Departamento Gerencial"
}
],
"bcc": [
{
"email": "[email protected]",
"name": "Equipo de Auditoría"
}
]
},
"templateId": "welcome_email",
"htmlBody":"<h1 style=\"color:blue;\">¡Hola ###nombre###!</h1><p>Este es un email con <b>adjuntos</b> y formato HTML.</p>",
"subject": "Asunto del email",
"variables": {
"nombre": "Carlos"
},
"attachments": [
{
"fileName": "documento.pdf",
"content": "BASE64_ENCODED_DATA",
"mimeType": "application/pdf"
}
],
"priority":true
}
Limites: 5 solicitudes por segundo para email prioritarios.
Limites: 500 solicitudes por segundo para email de mercadeo.
.