Como fazer a integração do MailChimp em seu site

Pretende integrar a newsletter MailChimp no seu site? MailChimp é um dos populares serviços de email marketing, que gerencia os assinantes do seu site. Neste artigo, estudamos a integração do MailChimp em PHP.

Existem vários fornecedores de serviços de marketing por email na Internet, como Aweber e iContact. Mas sem dúvida o MailChimp é mais popular entre as pessoas.

Integrar o MailChimp ao site é muito simples. Você só precisa adicionar algum código e poderá gerenciar seus assinantes facilmente.

Já escrevi um artigo que também explica como integrar o MailChimp ao seu site. Nesse artigo, escrevi o código para interagir com a API MailChimp. Neste artigo, usaríamos a biblioteca GitHub para nossa integração MailChimp

Dito isso, vamos dar uma olhada na integração do MailChimp em seu site.

Obtenha a chave da API MailChimp e o ID do público

Para começar, você precisa obter uma chave de API e ID de público de sua conta do MailChimp. A chave API é obrigatória ao fazer uma chamada para a API MailChimp. O ID de público é a chave de identificação na qual os novos assinantes devem se inscrever.

Faça login em sua conta MailChimp. No ícone do usuário, selecione a conta.

Clique em Extra-> Chaves de API.

Na seção Suas chaves de API, clique em Criar uma chave e copie sua chave de API que precisamos em um momento.

Agora você tem sua chave API pronta. Em seguida, obtenha um ID de público ao qual você precisa adicionar seus assinantes. Para isso, clique no menu Público e selecione a opção Configurações no menu Gerenciar Público.

Em Configurações, clique no nome do público e padrões.

Na próxima página, você encontrará seu ID de público.

Adicionar assinante à lista MailChimp

Agora você está pronto com sua chave de API e id de lista. Em seguida, você precisa instalar esta biblioteca GitHub usando o Composer.

Abra o terminal no diretório raiz do seu projeto e execute o comando:

composer require drewm/mailchimp-api

Depois de instalar a biblioteca, incluiríamos o ambiente da biblioteca em nosso arquivo PHP. Fazemos isso da seguinte maneira.

<?php
require_once "vendor/autoload.php";
 
use DrewMMailChimpMailChimp;
 
$api_key = 'YOUR_API_KEY';
$list_id = 'LIST_ID';
 
$MailChimp = new MailChimp($api_key);

Certifique-se de substituir os marcadores pelos valores reais.

Para adicionar um assinante à lista, temos que passar o endereço de e-mail e o status. O status pode ser inscrito ou pendente. Se o valor do status for inscrito, o endereço de e-mail será adicionado diretamente à lista do MailChimp. E se o valor do status estiver pendente, um e-mail de confirmação será enviado ao usuário. Após a confirmação, o usuário será adicionado à lista.

Podemos adicionar inscritos à lista específica, escrevendo o código abaixo:

//subscribe a user
$result = $MailChimp->post("lists/$list_id/members", [
     'email_address' => 'PASS_EMAIL_ADDRESS_HERE',
     'status'        => 'subscribed',
]);
 
if(isset($result['id'])) {
    echo 'User subscribed successfully.';
}

Você pode querer adicionar campos de público para o assinante. Esses campos de público costumavam armazenar informações extras sobre o usuário. Digamos que você queira adicionar valores para os campos FNAME, LNAME que vem por padrão no MailChimp. Nesse caso, após o código de assinatura acima, adicione o código abaixo.

$subscriber_hash = MailChimp::subscriberHash('PASS_EMAIL_ADDRESS_HERE');
$MailChimp->patch("lists/$list_id/members/$subscriber_hash", [
    'merge_fields' => ['FNAME'=>'FIRST_NAME', 'LNAME'=>'LAST_NAME']
]);

O usuário também pode atribuir tags aos assinantes. Você pode organizar contatos com marcas. Digamos que eu queira adicionar uma tag ‘Blogger’ ao assinante, então o código será o seguinte.

$subscriber_hash = MailChimp::subscriberHash('PASS_EMAIL_ADDRESS_HERE');
$MailChimp->post("lists/$list_id/members/$subscriber_hash/tags", [
    'tags' => [
                ['name' => 'Blogger', 'status' => 'active'],
            ]
]);

Você pode atribuir várias tags usando mais elementos da matriz. Se você deseja remover a tag, passe o valor do status como ‘inativo’.

Excluir um assinante da lista MailChimp

Para excluir um assinante de sua lista do MailChimp, você só precisa passar o hash md5 do e-mail para o método delete da instância do MailChimp. A biblioteca fornece uma função subscriberHashque cria o hash md5 do endereço de e-mail.

//delete a subscriber
$subscriber_hash = $MailChimp->subscriberHash('PASS_EMAIL_ADDRESS_HERE');
$result = $MailChimp->delete("lists/$list_id/members/$subscriber_hash");

É isso! É tudo sobre como adicionar ou excluir assinantes do MailChimp. Espero que você entenda sobre a integração do MailChimp em um site com PHP. Por favor, compartilhe seus pensamentos no comentário abaixo.

Artigos relacionados

• Grave dados na planilha do OneDrive usando Microsoft Graph API e PHP
• Speech-To-Text usando Amazon Transcribe em PHP
• Como integrar a API do Planilhas Google com PHP