Hello! ¡Hola!

Estás visitando la web Mailify en ES. ¿No es tu idioma favorito? Haz clic aquí para cambiar
You're visiting Mailify webpage in ES. Not your favorite language? Click here to check if yours is available


This looks wrong? Your feedback will help us improve your user experience. Feel free to get in touch!

close

Manual Mailify
Descubre todas las funcionalidades de Mailify

API

API es una extensión disponible en Mailify. Activándola, puedes añadir/modificar/eliminar los datos disponibles en tus listas de contactos, listas negras por simples peticiones HTML con el método GET.


Después de activarlo, se añadirá el botón “Acceso API” en la lista de acciones de tus listas.

API - Sarbacane Desktop

Insertar datos en una lista de contactos vía API Mailify

Existen varios métodos posibles, te proponemos un ejemplo con lenguaje de programación. Empecemos por crear un formulario HTML que servirá de base para enviar los datos a tu lista de contactos.


Aquí te damos un ejemplo de formulario con el campo email a rellenar:

<form action="" method="POST">
        <input type="text" placeHolder="Email" name="email" />
        <input type="text" placeHolder="Nom" name="nom" />
        <input type="text" placeHolder="Prenom" name="prenom" />
        <input type="submit">
</form>

Pasamos al procesamiento de los datos con la API Mailify.

Para conectarse a la API necesitamos recuperar la URL de nuestra lista de contactos.
La URL se muestra en la aplicación Mailify en el menú “Listas de contactos” => “Acceso API”.


Screen Sarbacane Desktop - Accées API LDD

/!\ Si la opción "Acceso API" no aparece, verifica que la extensión está activada el menú "Extensiones" (1) y luego "API lista de contactos" (2).


Screen Sarbacane Desktop - Activation API

Haciendo clic en "Acceso API" se abre una lista de opciones que permiten añadir, modificar y eliminar las direcciones de la lista de contactos.


Screen Sarbacane Desktop - Activation API

Copia y pega la URL de la acción a efectuar (INSERT, UPDATE, DELETE).


Veamos por ejemplo una inserción.

Exemple:

https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw?action=INSERT&Email=pablo@dominio.com

Esta URL esta compuesta por dos partes:


La primera parte:
https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw que permite indentifiar tu lista.


Y la segunda:
?action=INSERT&Email=pablo@dominio.com que representa los datos enviados en la URL.



Descomponiendo la cadena de carácteres:


La cadena de caracter “action=INSERT” permite ejecutar la acción a efectuar (INSERT significa insertar en una lista).


El caracter ‘&’ permite separar los diferentes datos enviados en la URL.

Email=email@dominio.com corresponde a la columna “Email” que será rellenado con el valor “email@dominio.com”.

/!\ Si tu lista contiene varias columnas, la url mostrada por Mailify se completa con los diferentes datos.


Un ejemplo con una URL que contiene un campo email, apellidos y nombre:

https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw?action=INSERT&Email=contacto@dominio.com&Apellido=valor&Nombre=valor

Una vez obtenida la URL, solo falta reemplazar el contenido de la variable URL por tu URL con tus datos. (El resto del código ASP permite enviar la solicitud, no hay que editarlo.)

<%
url="https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw?action=INSERT&Email=contact@domaine.com&Nom=valeur&Prenom=valeur"
Set xmlhttp = CreateObject("MSXML2.ServerXMLHTTP.6.0")
xmlhttp.open "GET", url, false
xmlhttp.send data
%>

Para utilizar la API Mailify comprueba que la extensión “php_curl” esta activada en su configuración PHP. (archivo php.ini)


¡Pasemos a la acción!

Como algunos datos son idénticos para cada llamada a la API, copie esta función PHP al inicio del archivo que permitirá crear tu cadena de inicio y conectarte a la API más fácilmente.

<?php
function post_to_url($url, $data) {
   $fields = '';
   foreach($data as $key => $value) {
      $fields .= $key . '=' . $value . '&';
   }
   rtrim($fields, '&');

   $post = curl_init();
   curl_setopt($post, CURLOPT_URL, $url);
   curl_setopt($post, CURLOPT_POST, count($data));
   curl_setopt($post, CURLOPT_POSTFIELDS, $fields);
   curl_setopt($post, CURLOPT_RETURNTRANSFER, 1);

   $result = curl_exec($post);

   curl_close($post);
}
?>

Como lo puedes ver, para ser llamada, esta función necesita 2 parámetros:

  • una URL ($url)
  • datos ($data)


En Mailify, la URL está disponible en el menú “Listas de contactos” para cada lista de contactos creada, clicando en “Acceso API”.

acceso api

/!\ Si la opción "Acceso API" no aparece, verifica que la extensión está activada el menú "Extensiones" (1) y luego "API lista de contactos" (2).


activacion api

En una lista de contactos ya existente, haz clic en “Acceso API” y aparecerá una ventana explicativa de las funciones para añadir, modificar o eliminar contactos en la lista con las URLs correspondientes.


info api

Para conectarse a la API use la URL de la lista de contactos ($url). Copia-pega la URL que aparece con este formato en la ventana “Acceso API”:


https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw?action=INSERT&Email=contacto@ dominio.com

Solo necesitas guardar una parte de la URL, para obtener lo siguiente:

https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw

Se obtiene entonces:

<?php
$url = "https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw";
?>

Ahora hay que enviar los datos ($data) a añadir en esta lista. $data es una tabla que contiene los datos y se presenta de la siguiente forma:

<?php
$data=array(
    'action' => 'INSERT',
    'Email' => $email
);
?>

/!\ En este ejemplo $email ha sido inicializado anteriormente con una dirección email.


La casilla “acción” es obligatoria y permite elegir que acción hay que efectuar en los datos.

Tres valores son posibles: “INSERT”, “UPDATE”, “DELETE”.
El formulario HTML de ejemplo de arriba contenía únicamente un campo “Email”, la tabla $data solo contiene el valor “Email” para apuntar el ejemplo.


/!\ Por defecto, una lista de contactos sólo contiene la columna Email. Si decide añadir columnas a tu lista, habrá que añadirlas en la lista y registrarlas en la tabla $data.


Ejemplo con una lista que contiene las columnas email, apellidos, nombre:

<?php
$data=array(
    'action' => 'INSERT',
    'Email' => $email,
    'Apellidos' => $apellidos,
    'Nombre' => $nombre
);
?>

Una vez los valores presentes en la tabla ‘$data’, basta con enviar esta a la API gracias a este comando.

<?php
post_to_url($url, $data);
?>

Ahora sus datos están en tu lista de contactos.
/!\ Mailify actualiza su lista de contactos cada 4 minutos. Para forzar la actualización de la aplicación, reinicie la aplicación.


Resumen del archivo de código PHP:

<?php
function post_to_url($url, $data) {
   $fields = '';
   foreach($data as $key => $value) {
      $fields .= $key . '=' . $value . '&';
   }
   rtrim($fields, '&');

   $post = curl_init();
   curl_setopt($post, CURLOPT_URL, $url);
   curl_setopt($post, CURLOPT_POST, count($data));
   curl_setopt($post, CURLOPT_POSTFIELDS, $fields);
   curl_setopt($post, CURLOPT_RETURNTRANSFER, 1);

   $result = curl_exec($post);

   curl_close($post);
}

// Recuperamos los valores a enviar
$url = "https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw";
$email = $_POST["email"];

$data=array(
    'action' => 'INSERT',
    'Email' => $email
);

//Envío de los datos
post_to_url($url, $data);
?>

Insertar datos en una lista negra vía API Mailify

¿Cómo insertar datos en una lista de bajas vía API Mailify

El método es el mismo como para insertar datos en una lista de contactos via API Mailify, solo cambia la URL de llamada de la API. Te invitamos entonces a consultar la FAQ que permite insertar datos en una lista de contactos.


¿Cómo recuperar la URL de llamada de tu lista negra?


acceso api

/!\ Si la opción "Acceso API" no aparece, verifica que la extensión está activada el menú "Extensiones" (1) y luego "API lista de contactos" (2).


activacion

Go Top