Como integrar o boletim informativo MailChimp no aplicativo Laravel

Você deseja integrar a funcionalidade de newsletter do MailChimp ao seu aplicativo Laravel? MailChimp é um serviço de email marketing que nos permite enviar newsletters aos nossos assinantes. Neste artigo, mostro como integrar a newsletter do MailChimp ao site do Laravel.

MailChimp é um dos mais populares serviços de marketing por e-mail, que gerencia os assinantes do seu site. Usando o MailChimp, seus assinantes receberão um boletim informativo sobre novos conteúdos, anúncios, ofertas e muito mais, dependendo de sua escolha. Este é um tipo de sistema automatizado. O dono do site não precisa se lembrar de enviar a newsletter aos assinantes. O MailChimp funciona por conta própria, o que nos economiza muito tempo.

Outros provedores de serviços de marketing por e-mail populares são:

• Aweber
• iContact

Recentemente, publiquei um artigo sobre integração MailChimp usando API MailChimp e PHP. Um dos leitores perguntou sobre a integração do MailChimp no Laravel. Então, decidi escrever este artigo para responder à pergunta do leitor.

Posto isto, vamos integrar a newsletter MailChimp na aplicação Laravel.

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

Para integrar a API MailChimp, você precisa obter uma chave de API e um ID de público. Siga as etapas abaixo para obter essas credenciais.

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 em ‘Nome e padrões do público-alvo’.

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

Instalação da biblioteca space / laravel-newsletter

Spatie construiu a fantástica biblioteca do boletim informativo Laravel. Vou integrar a newsletter MailChimp nesta biblioteca.

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

composer require spatie/laravel-newsletter

Depois de instalar a biblioteca, execute o comando abaixo para publicar o arquivo de configuração config/newsletter.php.

php artisan vendor:publish --provider="SpatieNewsletterNewsletterServiceProvider"

Vá até o diretório ‘config’ e abra o arquivo ‘newsletter.php’.

newsletter.php

<?php
 
return [
 
    /*
     * The API key of a MailChimp account. You can find yours at
     * https://us10.admin.mailchimp.com/account/api-key-popup/.
     */
    'apiKey' => env('MAILCHIMP_APIKEY'),
 
    /*
     * The listName to use when no listName has been specified in a method.
     */
    'defaultListName' => 'subscribers',
 
    /*
     * Here you can define properties of the lists.
     */
    'lists' => [
 
        /*
         * This key is used to identify this list. It can be used
         * as the listName parameter provided in the various methods.
         *
         * You can set it to any string you want and you can add
         * as many lists as you want.
         */
        'subscribers' => [
 
            /*
             * A MailChimp list id. Check the MailChimp docs if you don't know
             * how to get this value:
             * http://kb.mailchimp.com/lists/managing-subscribers/find-your-list-id.
             */
            'id' => env('MAILCHIMP_LIST_ID'),
        ],
    ],
 
    /*
     * If you're having trouble with https connections, set this to false.
     */
    'ssl' => true,
 
];

Você não precisa fazer nenhuma alteração aqui, exceto o valor ‘ssl’. Se você não tiver um certificado SSL em seu servidor, defina esse valor como falso. Você pode ver as constantes MAILCHIMP_APIKEY e MAILCHIMP_LIST_ID no código acima. Isso significa que você precisa adicionar essas constantes com os valores reais em seu .envarquivo.

.env

....
 
MAILCHIMP_APIKEY=YOUR_MAILCHIMP_API_KEY
MAILCHIMP_LIST_ID=YOUR_MAILCHIMP_LIST_ID

Depois disso, limpe o cache de configuração usando o comando:

php artisan config:clear

Integre o boletim informativo MailChimp no aplicativo Laravel

Você instalou e configurou a biblioteca. Agora você está pronto para prosseguir com a integração do MailChimp em seu site do Laravel. Vamos criar um formulário de boletim informativo simples em seu arquivo de visualização.

<form action="{{ url('ROUTE_HERE') }}" method="post">
    <div class="form-group">
        <label for="exampleInputEmail">Email</label>
        <input type="email" name="user_email" id="exampleInputEmail" class="form-control">
    </div>
    {{ csrf_field() }}
    <button type="submit" class="btn btn-primary">Submit</button>
</form>

Certifique-se de substituir o espaço reservado ROUTE_HERE pelo valor real. Em seguida, em seu arquivo de controlador, adicione a fachada do pacote instalado.

Na função do controlador onde você está postando o formulário, escreva o código da seguinte forma:

<?php
namespace AppHttpControllers;
 
use IlluminateHttpRequest;
use Newsletter;
 
....
 
public function store(Request $request)
{
    if (! Newsletter::isSubscribed($request->user_email)) {
        Newsletter::subscribe($request->user_email);
    }
}
?>

Aqui, estou verificando primeiro se um usuário já foi adicionado à lista de assinantes ou não. Caso contrário, adicione-o à lista de assinantes. Usei o método subscribe()que inscreve diretamente o usuário na lista. Se você precisar enviar um e-mail de confirmação para o usuário antes de se inscrever na lista, substitua a linha abaixo

Newsletter::subscribe($request->user_email);

com

Newsletter::subscribePending($request->user_email);

subscribePending() A função define o status do usuário como ‘pendente’ na lista MailChimp até que o usuário confirme a inscrição.

O Mailchimp também fornece os campos de público que armazenam informações extras sobre os usuários diretamente no painel do MailChimp. Por precaução, se você deseja adicionar campos de público, pode fazê-lo adicionando mais um parâmetro no método acima. Aqui, estou adicionando valores para os campos padrão de público FNAME e LNAME.

Newsletter::subscribe($request->user_email, ['FNAME'=>'ENTER_FIRST_NAME', 'LNAME'=>'ENTER_LAST_NAME']);

Se você deseja adicionar tags para o assinante, use o addTags()método. Passe os vários elementos em uma matriz no caso de você precisar atribuir várias tags. No meu caso, estou atribuindo a tag ‘Blogger’ ao assinante.

Newsletter::addTags(['Blogger'], $request->user_email);

O usuário pode excluir o assinante da lista usando o código:

Newsletter::delete('SUBSCRIBER_EMAIL');

Esses são os métodos básicos normalmente exigidos no site. Você também pode verificar as funções adicionais fornecidas por este pacote no GitHub.

Espero que você entenda como integrar a newsletter MailChimp ao seu site Laravel. Por favor, compartilhe seus pensamentos e sugestões na seção de comentários abaixo.

Artigos relacionados

• Integração MailChimp com Formulário de Contato 7 Plugin
• Integração do MailChimp no WordPress sem usar um plug-in