Envío de email

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:

  1. 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" .
  2. 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.



.

Language
Credentials
Header
Click Try It! to start a request and see the response here!