bento icon close

Como faço para inserir dados em uma lista de contatos com a API Mailify?

Há uma variedade de métodos, mas nós escolhemos um exemplo usando um formulário HTML que será usado para enviar dados para sua lista de contatos. Abaixo está um exemplo de um formulário com um campo de e-mail a ser preenchido:

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

Vamos mudar para o processamento de dados com a API Mailify.

Para usar a API Mailify, em primeiro lugar você tem que verificar que a extensão "php_curl" esteja habilitada na sua configuração do PHP. (Arquivo Php.ini)


Etapa 1 - Copiar o código


Copie esta função PHP no início do arquivo de modo a conectar-se à API com mais facilidade.

<?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 você pode ver, esta função precisa de dois parâmetros:

  • A URL ($url)
  • Data ($data)



Etapa 2 - Achar a URL no Mailify e colar


Para se conectar à API, usaremos a URL da lista de contatos ($url). Copie e cole a URL que aparece em 'Para inserir um contato' na janela da API.


Para encontrar esta URL, siga os passos no nosso guia aqui.


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

Nós só precisamos usar parte da URL, de modo a obter algo como:

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

(tudo que vier a partir da "?" foi deletado)


Então teremos:

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

Etapa 3 - Enviar os dados


Nós agora precisamos enviar os dados ($data) que queremos que seja adicionado a essa lista:

$data é uma tabela com dados que vem da seguinte forma:

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

/! \ Nesse exemplo, $email foi previamente configurado com um endereço de e-mail.


A caixa de 'ação' é obrigatória, pois permite que você escolha qual das três ações você deseja realizar com os dados.

As opções são: 'INSERT', 'UPDATE', 'DELETE'.


O formulário HTML que é mostrado acima contém apenas a coluna 'E-mail', logo a tabela de dados $data só tem a coluna de 'e-mail'.


/!\ A lista de contatos tem apenas a coluna 'E-mail' por padrão. Se você optar por adicionar colunas à sua lista, você irá adicioná-las também a sua lista e relatá-las no gráfico $data.



Exemplo com mais de uma coluna


Esse exemplo mostra o e-mail, nome e sobrenome:

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

Uma vez que os valores forem relatados na tabela $data, você apenas tem que enviá-la para a API com o seguinte comando:

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


/! \ Mailify atualiza sua lista de contatos a cada 4 minutos. Para forçar a lista de atualização, reinicie o software.



Resumo do 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); }  //We now have data to send:   $url = "https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw";   $email = $_POST["email"];  $data=array(       'action' => 'INSERT',       'Email' => $email   );  //Sending data   post_to_url($url, $data);   ?>

Para se conectar à API, é necessário realizar os seguintes passos:


Etapa 1 - Localize a URL para a lista de contatos.

Para encontrar esta URL, siga os passos no nosso guia aqui.


Etapa 2 - Copie a URL da ação que pretende tomar

(INSERT, UPDATE, DELETE)


Exemplo


No nosso exemplo, vamos usar a ação "inserir um contato"


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

A URL é composta por duas partes:


1. → https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw que permite identificar sua lista.

2. → ?action=INSERT&Email=email@yourdomain.com que representa os dados enviados.


O que significam esses caracteres?


A linha de caracteres "action=INSERT" permite que você escolha qual ação realizar (neste caso, a ação é INSERT que significa inserção de contatos para a lista).

O caractere '&' permite que você separe diferentes dados enviados com a URL.

Email=email@seudominio.com corresponde à coluna "Email" que será preenchida com o valor "email@seudominio.com"


/! \ Se sua lista contém um monte de colunas, Mailify irá preencher a URL com todos os dados.


Aqui está um exemplo de um URL que contém um campo para email, nome e sobrenome.


https://api-sd.sarbacane.com/lists/325/7CsS69R44UaSy7TazcRLMw?action=INSERT&Email=contact@domaine.com&NSurname=value&Name=value

Etapa 3 - Colar a URL


Uma vez que a URL foi obtida, você só precisa substituir o conteúdo da variável de URL com a URL contendo seus dados. (O resto do seu código ASP permite enviar a solicitação, portanto você não precisa editá-lo.)

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