Outros provedores de servi\u00e7os de marketing por e-mail populares s\u00e3o:<\/p>\n
- \n
- Aweber<\/a><\/li>\n
- iContact<\/a><\/li>\n<\/ul>\n
Recentemente, publiquei um artigo sobre integra\u00e7\u00e3o MailChimp usando API MailChimp e PHP<\/a>. Um dos leitores perguntou sobre a integra\u00e7\u00e3o do MailChimp no Laravel. Ent\u00e3o, decidi escrever este artigo para responder \u00e0 pergunta do leitor.<\/p>\n
Posto isto, vamos integrar a newsletter MailChimp na aplica\u00e7\u00e3o Laravel.<\/p>\n
Obtenha a chave da API MailChimp e o ID do p\u00fablico<\/h3>\n
Para integrar a API MailChimp, voc\u00ea precisa obter uma chave de API e um ID de p\u00fablico. Siga as etapas abaixo para obter essas credenciais.<\/p>\n
Fa\u00e7a login em sua conta MailChimp<\/a>. No \u00edcone do usu\u00e1rio, selecione a conta.<\/p>\n
![\"Como](\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20222-6081cf6d90f6e.png\")
<\/a><\/p>\nClique em Extra-> Chaves de API<\/strong>.<\/p>\n
![\"Como](\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20222-6081cf6df1247.png\")
<\/a><\/p>\nNa se\u00e7\u00e3o Suas chaves de API, clique em Criar uma chave e copie sua chave de API que precisamos em um momento.<\/p>\n
![\"Como](\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20222-6081cf6e407f3.png\")
<\/a><\/p>\nAgora voc\u00ea tem sua chave API pronta. Em seguida, obtenha um ID de p\u00fablico ao qual voc\u00ea precisa adicionar seus assinantes. Para isso, clique no menu P\u00fablico e selecione a op\u00e7\u00e3o Configura\u00e7\u00f5es no menu Gerenciar P\u00fablico.<\/p>\n
<\/a><\/p>\nEm Configura\u00e7\u00f5es, clique em ‘Nome e padr\u00f5es do p\u00fablico-alvo’.<\/p>\n
<\/a><\/p>\nNa pr\u00f3xima p\u00e1gina, voc\u00ea encontrar\u00e1 seu ID de p\u00fablico.<\/p>\n
<\/a><\/p>\nInstala\u00e7\u00e3o da biblioteca space \/ laravel-newsletter<\/h3>\n
Spatie<\/a> construiu a fant\u00e1stica biblioteca do boletim informativo Laravel<\/a>. Vou integrar a newsletter MailChimp nesta biblioteca.<\/p>\n
Abra o terminal no diret\u00f3rio raiz do seu projeto e execute o comando:<\/p>\n
composer require spatie\/laravel-newsletter<\/code><\/pre>\nDepois de instalar a biblioteca, execute o comando abaixo para publicar o arquivo de configura\u00e7\u00e3o
config\/newsletter.php<\/code>.<\/p>\nphp artisan vendor:publish --provider=\"SpatieNewsletterNewsletterServiceProvider\"<\/code><\/pre>\nV\u00e1 at\u00e9 o diret\u00f3rio ‘config’ e abra o arquivo ‘newsletter.php’.<\/p>\n
newsletter.php<\/strong><\/p>\n
<?php\n\u00a0\nreturn [\n\u00a0\n\u00a0\u00a0\u00a0\u00a0\/*\n\u00a0\u00a0\u00a0\u00a0\u00a0* The API key of a MailChimp account. You can find yours at\n\u00a0\u00a0\u00a0\u00a0\u00a0* https:\/\/us10.admin.mailchimp.com\/account\/api-key-popup\/.\n\u00a0\u00a0\u00a0\u00a0\u00a0*\/\n\u00a0\u00a0\u00a0\u00a0'apiKey' => env('MAILCHIMP_APIKEY'),\n\u00a0\n\u00a0\u00a0\u00a0\u00a0\/*\n\u00a0\u00a0\u00a0\u00a0\u00a0* The listName to use when no listName has been specified in a method.\n\u00a0\u00a0\u00a0\u00a0\u00a0*\/\n\u00a0\u00a0\u00a0\u00a0'defaultListName' => 'subscribers',\n\u00a0\n\u00a0\u00a0\u00a0\u00a0\/*\n\u00a0\u00a0\u00a0\u00a0\u00a0* Here you can define properties of the lists.\n\u00a0\u00a0\u00a0\u00a0\u00a0*\/\n\u00a0\u00a0\u00a0\u00a0'lists' => [\n\u00a0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\/*\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0* This key is used to identify this list. It can be used\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0* as the listName parameter provided in the various methods.\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0*\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0* You can set it to any string you want and you can add\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0* as many lists as you want.\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0*\/\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'subscribers' => [\n\u00a0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\/*\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0* A MailChimp list id. Check the MailChimp docs if you don't know\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0* how to get this value:\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0* http:\/\/kb.mailchimp.com\/lists\/managing-subscribers\/find-your-list-id.\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0*\/\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'id' => env('MAILCHIMP_LIST_ID'),\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0],\n\u00a0\u00a0\u00a0\u00a0],\n\u00a0\n\u00a0\u00a0\u00a0\u00a0\/*\n\u00a0\u00a0\u00a0\u00a0\u00a0* If you're having trouble with https connections, set this to false.\n\u00a0\u00a0\u00a0\u00a0\u00a0*\/\n\u00a0\u00a0\u00a0\u00a0'ssl' => true,\n\u00a0\n];<\/code><\/pre>\nVoc\u00ea n\u00e3o precisa fazer nenhuma altera\u00e7\u00e3o aqui, exceto o valor ‘ssl’. Se voc\u00ea n\u00e3o tiver um certificado SSL em seu servidor, defina esse valor como falso. Voc\u00ea pode ver as constantes MAILCHIMP_APIKEY e MAILCHIMP_LIST_ID no c\u00f3digo acima. Isso significa que voc\u00ea precisa adicionar essas constantes com os valores reais em seu
.env<\/code>arquivo.<\/p>\n.env<\/strong><\/p>\n
....\n\u00a0\nMAILCHIMP_APIKEY=YOUR_MAILCHIMP_API_KEY\nMAILCHIMP_LIST_ID=YOUR_MAILCHIMP_LIST_ID<\/code><\/pre>\nDepois disso, limpe o cache de configura\u00e7\u00e3o usando o comando:<\/p>\n
php artisan config:clear<\/code><\/pre>\nIntegre o boletim informativo MailChimp no aplicativo Laravel<\/h3>\n
Voc\u00ea instalou e configurou a biblioteca. Agora voc\u00ea est\u00e1 pronto para prosseguir com a integra\u00e7\u00e3o do MailChimp em seu site do Laravel. Vamos criar um formul\u00e1rio de boletim informativo simples em seu arquivo de visualiza\u00e7\u00e3o.<\/p>\n
<form action=\"{{ url('ROUTE_HERE') }}\" method=\"post\">\n\u00a0\u00a0\u00a0\u00a0<div class=\"form-group\">\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<label for=\"exampleInputEmail\">Email<\/label>\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0<input type=\"email\" name=\"user_email\" id=\"exampleInputEmail\" class=\"form-control\">\n\u00a0\u00a0\u00a0\u00a0<\/div>\n\u00a0\u00a0\u00a0\u00a0{{ csrf_field() }}\n\u00a0\u00a0\u00a0\u00a0<button type=\"submit\" class=\"btn btn-primary\">Submit<\/button>\n<\/form><\/code><\/pre>\nCertifique-se de substituir o espa\u00e7o reservado ROUTE_HERE pelo valor real. Em seguida, em seu arquivo de controlador, adicione a fachada do pacote instalado.<\/p>\n
Na fun\u00e7\u00e3o do controlador onde voc\u00ea est\u00e1 postando o formul\u00e1rio, escreva o c\u00f3digo da seguinte forma:<\/p>\n
<?php\nnamespace AppHttpControllers;\n\u00a0\nuse IlluminateHttpRequest;\nuse Newsletter;\n\u00a0\n....\n\u00a0\npublic function store(Request $request)\n{\n\u00a0\u00a0\u00a0\u00a0if (! Newsletter::isSubscribed($request->user_email)) {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0Newsletter::subscribe($request->user_email);\n\u00a0\u00a0\u00a0\u00a0}\n}\n?><\/code><\/pre>\nAqui, estou verificando primeiro se um usu\u00e1rio j\u00e1 foi adicionado \u00e0 lista de assinantes ou n\u00e3o. Caso contr\u00e1rio, adicione-o \u00e0 lista de assinantes. Usei o m\u00e9todo
subscribe()<\/code>que inscreve diretamente o usu\u00e1rio na lista. Se voc\u00ea precisar enviar um e-mail de confirma\u00e7\u00e3o para o usu\u00e1rio antes de se inscrever na lista, substitua a linha abaixo<\/p>\nNewsletter::subscribe($request->user_email);<\/code><\/pre>\ncom<\/p>\n
Newsletter::subscribePending($request->user_email);<\/code><\/pre>\nsubscribePending()<\/code> A fun\u00e7\u00e3o define o status do usu\u00e1rio como ‘pendente’ na lista MailChimp at\u00e9 que o usu\u00e1rio confirme a inscri\u00e7\u00e3o.<\/p>\nO Mailchimp tamb\u00e9m fornece os campos de p\u00fablico que armazenam informa\u00e7\u00f5es extras sobre os usu\u00e1rios diretamente no painel do MailChimp. Por precau\u00e7\u00e3o, se voc\u00ea deseja adicionar campos de p\u00fablico, pode faz\u00ea-lo adicionando mais um par\u00e2metro no m\u00e9todo acima. Aqui, estou adicionando valores para os campos padr\u00e3o de p\u00fablico FNAME e LNAME.<\/p>\n
Newsletter::subscribe($request->user_email, ['FNAME'=>'ENTER_FIRST_NAME', 'LNAME'=>'ENTER_LAST_NAME']);<\/code><\/pre>\nSe voc\u00ea deseja adicionar tags para o assinante, use o
addTags()<\/code>m\u00e9todo. Passe os v\u00e1rios elementos em uma matriz no caso de voc\u00ea precisar atribuir v\u00e1rias tags. No meu caso, estou atribuindo a tag ‘Blogger’ ao assinante.<\/p>\nNewsletter::addTags(['Blogger'], $request->user_email);<\/code><\/pre>\nO usu\u00e1rio pode excluir o assinante da lista usando o c\u00f3digo:<\/p>\n
Newsletter::delete('SUBSCRIBER_EMAIL');<\/code><\/pre>\nEsses s\u00e3o os m\u00e9todos b\u00e1sicos normalmente exigidos no site. Voc\u00ea tamb\u00e9m pode verificar as fun\u00e7\u00f5es adicionais fornecidas por este pacote no GitHub<\/a>.<\/p>\n
Espero que voc\u00ea entenda como integrar a newsletter MailChimp ao seu site Laravel. Por favor, compartilhe seus pensamentos e sugest\u00f5es na se\u00e7\u00e3o de coment\u00e1rios abaixo.<\/p>\n
Artigos relacionados<\/h4>\n
- iContact<\/a><\/li>\n<\/ul>\n