/txnemail/send

Vea la documentación de SMTP para saber como hacer envíos transaccionales utilizando el protocolo SMTP.

Podrá enviar un email indicando sus parámetros o bien utilizar un email previamente creado o una campaña previamente creada. Para enviar un email con sus propios parámetros, utilice el parámetro “message”. Para enviar un email previamente creado, indique su identificador con el parámetro “templateID”. Para enviar un email de una campaña, indique su identificador con el parámetro “campaignID”.

En caso de que utilice una email previamente creado o una campaña, se obtendrán sus parámetros para crear un nuevo email a enviar.

El parámetro “message_id” le permite agrupar todos los emails del mismo tipo o grupo y así obtener una estadística conjunta de todos los emails enviados del mismo grupo.

message_id y grupo de mensajes

Cada mensaje que envíe, tendrá un identificador (ID) único. Puede reutilizar este ID para agrupar todos los mensajes que envíe del mismo tipo o grupo y así tener una estadística unificada de todos los envíos.

Este ID es a elección y puede ser cualquier palabra alfanumérica sin espacios ni caracteres especiales.

Campos personalizados

Cuando envía una campaña previamente guardada en el sistema, puede utilizar campos personalizados para luego reemplazarlos por el valor correspondiente.

Los campos personalizados tiene el formato {{{$nombre_campo}}}
Por ejemplo, si necesita personalizar el nombre del destinatario, podría hacerlo de la siguiente manera:
En el cuerpo del mensaje se encuentra el texto:
{{{$nombre}}}

En el parámetro “custom_fields” define:

{“custom_fields”: [ {“field”: “nombre”, “value”: “John Smith”} ]}

De la misma manera que puede tener campos personalizados en el mensaje, también puede personalizar el email por casa destinatario.

Utilice la variable to[][custom_fields]

Ejemplo:

{ "to":[
{
"email":"johnsmith@mycompany.com",
"name":"John Smith",
"cumtom_field":[
{
"pais":"Canada",
"estado":"Toronto",
}
]
}
],
}

Si necesita usar el nombre o dirección de email del destinatario en campos personalizados deberá usar las etiquetas {{{$to_name}}} y {{{$to_email}}} para nombre e email respectivamente.

Ejemplo de parámetros JSON

El siguiente ejemplo, contiene los parámetros para el envío de un email transaccional.

{
"user_key":"YOUR_USER_KEY",
"message":{
"text":"...texto alternativo...",
"html":"...html Code...
"subject":"Hola {{{$rcpt_name}}}",
"from_name":"John Smith",
"from_mail":"john@mycompany.com",
"reply_to":" john@mycompany.com ",
"bounced_to":" bounced@mycompany.com ",
"auto_text":"yes",
"auto_html":"yes",
"track_clicks":"yes",
"track_opens":"yes",
"custom_fields":[
{
"field":"pais",
"value":"Iceland"
}
],
"attachments":[
{
"name":"imagen1.jpg",
"type":"image/jpeg",
"content":"/9j/77I2ftsq0w4pR9pWVsiusVhkF1KQYFBAYGBQY..."
}
]
},
"to":[
{
"name":"Some guy",
"email":"some@guy.com",
"custom_fields":[
{
"field":"middle_name",
"value":"Jerry"
},
{
"field":"pais",
"value":"US"
}
]
},
{
"name":"Matheu",
"email":"matheu@hotmail.com",
"custom_fields":[
{
"field":"middle_name",
"value":"Paul"
}
]
},
{
"name":"Juan",
"email":"juanpablo@hotmail.com",
"custom_fields":[
{
"field":"middle_name",
"value":"Pablo"
}
]
}
],
"message_id":"93244347",
"custom_fields":[
{
"field":"actividad",
"value":"Comercio"
}
],
"headers":[
{
"name":"X-Myheader",
"value":"mydata"
},
{
"name":"X-Otherheader",
"value":"mydata"
}
],
"send_at":"2017-12-31 14:30:00 -0400"
}

Ejemplo de consulta utilizando la librería net/http de php

(La librería net/http esta disponible en packagist.org para instalación via composer https://packagist.org/packages/net/http).

<?php

// ... print_r($resposeArray); ...
}