{"id":28578,"date":"2021-06-14T16:10:00","date_gmt":"2021-06-14T13:10:00","guid":{"rendered":"https:\/\/themewp.inform.click\/?p=28578"},"modified":"2021-10-18T03:59:53","modified_gmt":"2021-10-18T00:59:53","slug":"integracao-mailchimp-em-um-site-usando-api-mailchimp-e-php","status":"publish","type":"post","link":"https:\/\/themewp.inform.click\/pt-pt\/integracao-mailchimp-em-um-site-usando-api-mailchimp-e-php\/","title":{"rendered":"Integra\u00e7\u00e3o MailChimp em um site usando API MailChimp e PHP"},"content":{"rendered":"<p><a href=\"https:\/\/mailchimp.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">MailChimp<\/a> \u00e9 um dos mais populares servi\u00e7os de marketing por e-mail que gerencia os assinantes do seu site. Usando MailChimp, voc\u00ea pode enviar um boletim informativo para seus assinantes. No boletim informativo, voc\u00ea pode escrever sobre seu novo conte\u00fado, ofertas ou an\u00fancios em seu site. Os boletins informativos s\u00e3o \u00fateis para trazer o p\u00fablico de volta ao site.<\/p>\n<p>Outros provedores de servi\u00e7os de marketing por e-mail populares s\u00e3o:<\/p>\n<ul>\n<li><a href=\"https:\/\/aweber.com\/?483788\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Aweber<\/a><\/li>\n<li><a href=\"https:\/\/www.icontact.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">iContact<\/a><\/li>\n<\/ul>\n<p>A maioria dos sites coloca um formul\u00e1rio de inscri\u00e7\u00e3o onde coleta o e-mail do usu\u00e1rio. Este e-mail ir\u00e1 diretamente para o MailChimp como um assinante.<\/p>\n<p>Neste artigo, estudamos como fazer a integra\u00e7\u00e3o do MailChimp usando suas APIs e PHP cURL. Vamos adicionar um e-mail ao MailChimp. Em outras palavras, veremos como adicionar assinantes ao MailChimp usando sua API.<\/p>\n<p>Antes de continuar, certifique-se de ter cURL habilitado no servidor. Estamos interagindo com a URL externa que nada mais \u00e9 do que terminais do MailChimp. Requer cURL para enviar solicita\u00e7\u00f5es e receber respostas.<\/p>\n<p>Dito isso, vamos ver como algu\u00e9m pode adicionar um assinante \u00e0s suas listas do MailChimp por meio da API.<\/p>\n<p>Voc\u00ea pode integrar esta integra\u00e7\u00e3o MailChimp em qualquer site baseado em PHP. Por exemplo, em sites que s\u00e3o constru\u00eddos usando WordPress, Laravel, etc.<\/p>\n<h3>Obtenha a chave da API MailChimp e o ID do p\u00fablico<\/h3>\n<p>Para interagir com a API MailChimp, voc\u00ea precisa obter a chave da API e o ID de p\u00fablico. Siga as etapas abaixo e fa\u00e7a o download.<\/p>\n<p><a href=\"https:\/\/login.mailchimp.com\/\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Fa\u00e7a login<\/a> em sua conta MailChimp. No \u00edcone do usu\u00e1rio, selecione a conta.<\/p>\n<p><a href=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceecd1991.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceecd1991.png\" alt=\"Integra\u00e7\u00e3o MailChimp em um site usando API MailChimp e PHP\" ><\/a><\/p>\n<p>Clique em <strong>Extra-&gt; Chaves de API<\/strong>.<\/p>\n<p><a href=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceed59a78.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceed59a78.png\" alt=\"Integra\u00e7\u00e3o MailChimp em um site usando API MailChimp e PHP\" ><\/a><\/p>\n<p>Na se\u00e7\u00e3o Suas chaves de API, clique em Criar uma chave. Copie sua chave de API que precisamos em um momento.<\/p>\n<p><a href=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" alt=\"Integra\u00e7\u00e3o MailChimp em um site usando API MailChimp e PHP\" ><\/a><\/p>\n<p>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<p><a href=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" alt=\"Integra\u00e7\u00e3o MailChimp em um site usando API MailChimp e PHP\" ><\/a><\/p>\n<p>Em Configura\u00e7\u00f5es, clique em &#8216;Nome e padr\u00f5es do p\u00fablico-alvo&#8217;.<\/p>\n<p><a href=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" alt=\"Integra\u00e7\u00e3o MailChimp em um site usando API MailChimp e PHP\" ><\/a><\/p>\n<p>Na pr\u00f3xima p\u00e1gina, voc\u00ea encontrar\u00e1 seu ID de p\u00fablico.<\/p>\n<p><a href=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" data-rel=\"lightbox\"><img decoding=\"async\" class=\"SDStudio-light-box-enable SDStudio-editor-tools-md-imp\" src=\"https:\/\/themewp.inform.click\/wp-content\/uploads\/2021\/04\/post-20217-6081ceedbf604.png\" alt=\"Integra\u00e7\u00e3o MailChimp em um site usando API MailChimp e PHP\" ><\/a><\/p>\n<h3>Adicionar assinante \u00e0 lista MailChimp<\/h3>\n<p>Neste est\u00e1gio, voc\u00ea est\u00e1 pronto com sua chave de API e id de p\u00fablico. Agora, tudo o que precisamos fazer \u00e9 enviar uma solicita\u00e7\u00e3o HTTP para a API MailChimp junto com os par\u00e2metros necess\u00e1rios.<\/p>\n<p>Voc\u00ea pode encontrar uma lista de todas as chamadas de API em sua <a href=\"https:\/\/developer.mailchimp.com\/documentation\/mailchimp\/reference\/overview\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">documenta\u00e7\u00e3o oficial<\/a>. Para o nosso tutorial, precisamos de sua chamada de API <a href=\"https:\/\/developer.mailchimp.com\/documentation\/mailchimp\/reference\/lists\/members\/#create-post_lists_list_id_members\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">Add a new list member<\/a>.<\/p>\n<p>Esta chamada de API requer uma chave de API com um endere\u00e7o de e-mail e status. Para o status, podemos passar o valor &#8216;inscrito&#8217; ou &#8216;pendente&#8217;. Se um valor for &#8216;inscrito&#8217;, o endere\u00e7o de e-mail ser\u00e1 adicionado diretamente \u00e0 lista do MailChimp. E se um valor estiver &#8216;pendente&#8217;, um e-mail de confirma\u00e7\u00e3o ser\u00e1 enviado ao usu\u00e1rio. Ap\u00f3s a confirma\u00e7\u00e3o, o usu\u00e1rio se torna um assinante.<\/p>\n<p>Para integrar esta API, coloque o c\u00f3digo abaixo em seu arquivo PHP. Certifique-se de substituir os marcadores de posi\u00e7\u00e3o pelos valores reais.<\/p>\n<pre><code>&lt;?php\n$email = 'EMAIL_ADDRESS';\n$list_id = 'LIST_ID';\n$api_key = 'API_KEY';\n\u00a0\n$data_center = substr($api_key,strpos($api_key,'-')+1);\n\u00a0\n$url = 'https:\/\/'. $data_center .'.api.mailchimp.com\/3.0\/lists\/'. $list_id .'\/members';\n\u00a0\n$json = json_encode([\n\u00a0\u00a0\u00a0\u00a0'email_address' =&gt; $email,\n\u00a0\u00a0\u00a0\u00a0'status'\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 =&gt; 'subscribed', \/\/pass 'subscribed' or 'pending'\n]);\n\u00a0\ntry {\n\u00a0\u00a0\u00a0\u00a0$ch = curl_init($url);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_USERPWD, 'user:'. $api_key);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application\/json']);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_TIMEOUT, 10);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_POST, 1);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_POSTFIELDS, $json);\n\u00a0\u00a0\u00a0\u00a0$result = curl_exec($ch);\n\u00a0\u00a0\u00a0\u00a0$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\n\u00a0\u00a0\u00a0\u00a0curl_close($ch);\n\u00a0\n\u00a0\u00a0\u00a0\u00a0if (200 == $status_code) {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0echo \"The user added successfully to the MailChimp.\";\n\u00a0\u00a0\u00a0\u00a0}\n} catch(Exception $e) {\n\u00a0\u00a0\u00a0\u00a0echo $e-&gt;getMessage();\n}<\/code><\/pre>\n<p>No c\u00f3digo acima, na execu\u00e7\u00e3o bem-sucedida, voc\u00ea obter\u00e1 200 como c\u00f3digo de resposta. Tamb\u00e9m tratamos do erro se ele lan\u00e7ar por algum motivo.<\/p>\n<p>O 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 elemento de matriz na solicita\u00e7\u00e3o POST acima. Aqui, estou adicionando valores para os campos padr\u00e3o de p\u00fablico FNAME e LNAME.<\/p>\n<pre><code>&lt;?php\n...\n...\n$json = json_encode([\n\u00a0\u00a0\u00a0\u00a0'email_address' =&gt; $email,\n\u00a0\u00a0\u00a0\u00a0'status'\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 =&gt; 'subscribed', \/\/pass 'subscribed' or 'pending'\n\u00a0\u00a0\u00a0\u00a0'merge_fields'\u00a0 =&gt; [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'FNAME' =&gt; 'ENTER_FIRST_NAME',\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0'LNAME' =&gt; 'ENTER_LAST_NAME'\n\u00a0\u00a0\u00a0\u00a0]\n]);<\/code><\/pre>\n<h3>Adicionar Marcas ao Assinante<\/h3>\n<p>Voc\u00ea pode querer organizar seus contatos do MailChimp com tags. Para atribuir tags ao assinante, voc\u00ea precisa enviar uma solicita\u00e7\u00e3o POST para a API MailChimp. Consulte o c\u00f3digo a seguir que atribui tags Blogger e YouTuber a um assinante.<\/p>\n<pre><code>&lt;?php\n$email = 'EMAIL_ADDRESS';\n$list_id = 'LIST_ID';\n$api_key = 'API_KEY';\n\u00a0\n$data_center = substr($api_key,strpos($api_key,'-')+1);\n$subscriber_hash = md5(strtolower($email));\n\u00a0\n$url = 'https:\/\/'. $data_center .'.api.mailchimp.com\/3.0\/lists\/'. $list_id .'\/members\/'. $subscriber_hash .'\/tags';\n\u00a0\n$json = json_encode([\n\u00a0\u00a0\u00a0\u00a0'tags' =&gt; [\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0['name' =&gt; 'Blogger', 'status' =&gt; 'active'],\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0['name' =&gt; 'YouTuber', 'status' =&gt; 'active'],\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0]\n]);\n\u00a0\ntry {\n\u00a0\u00a0\u00a0\u00a0$ch = curl_init($url);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_USERPWD, 'user:'. $api_key);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application\/json']);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_TIMEOUT, 10);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_POST, 1);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_POSTFIELDS, $json);\n\u00a0\u00a0\u00a0\u00a0$result = curl_exec($ch);\n\u00a0\u00a0\u00a0\u00a0$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\n\u00a0\u00a0\u00a0\u00a0curl_close($ch);\n\u00a0\n\u00a0\u00a0\u00a0\u00a0if (204 == $status_code) {\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0echo \"The tags added successfully to the User.\";\n\u00a0\u00a0\u00a0\u00a0}\n} catch(Exception $e) {\n\u00a0\u00a0\u00a0\u00a0echo $e-&gt;getMessage();\n}<\/code><\/pre>\n<p>O usu\u00e1rio pode remover tags fornecendo um valor &#8216;inativo&#8217; para a chave de status.<\/p>\n<h3>Excluir um assinante da lista MailChimp<\/h3>\n<p>A API MailChimp fornece uma chamada de API para <a href=\"https:\/\/developer.mailchimp.com\/documentation\/mailchimp\/reference\/lists\/members\/#delete-delete_lists_list_id_members_subscriber_hash\" target=\"_blank\" rel=\"noopener nofollow\" class=\"external external_icon\">excluir um endere\u00e7o de e-mail de uma lista<\/a>. De acordo com a documenta\u00e7\u00e3o para excluir um assinante, precisamos enviar uma solicita\u00e7\u00e3o DELETE para a API. Desta vez, voc\u00ea deve passar o hash md5 de um endere\u00e7o de e-mail para o endpoint da API.<\/p>\n<pre><code>&lt;?php\n$email = 'EMAIL_ADDRESS';\n$list_id = 'LIST_ID';\n$api_key = 'API_KEY';\n\u00a0\n$data_center = substr($api_key,strpos($api_key,'-')+1);\n\u00a0\n$url = 'https:\/\/'. $data_center .'.api.mailchimp.com\/3.0\/lists\/'. $list_id .'\/members\/'. md5(strtolower($email));\n\u00a0\ntry {\n\u00a0\u00a0\u00a0\u00a0$ch = curl_init($url);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_USERPWD, 'user:'. $api_key);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_TIMEOUT, 10);\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'DELETE');\n\u00a0\u00a0\u00a0\u00a0curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);\n\u00a0\u00a0\u00a0\u00a0$result = curl_exec($ch);\n\u00a0\u00a0\u00a0\u00a0$status_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);\n\u00a0\u00a0\u00a0\u00a0curl_close($ch);\n} catch(Exception $e) {\n\u00a0\u00a0\u00a0\u00a0echo $e-&gt;getMessage();\n}<\/code><\/pre>\n<p>Espero que voc\u00ea entenda sobre a integra\u00e7\u00e3o da API MailChimp em um site usando PHP. Por favor, compartilhe suas id\u00e9ias e sugest\u00f5es no coment\u00e1rio abaixo.<\/p>\n<h4>Artigos relacionados<\/h4>\n<ul>\n<li><a href=\"https:\/\/themewp.inform.click\/pt-pt\/integracao-do-mailchimp-no-wordpress-sem-usar-um-plug-in\/\" title=\"Integra\u00e7\u00e3o do MailChimp no WordPress sem usar um plug-in\">Integra\u00e7\u00e3o do MailChimp no WordPress sem usar um plug-in<\/a><\/li>\n<li><a href=\"https:\/\/themewp.inform.click\/pt-pt\/como-integrar-o-boletim-informativo-mailchimp-no-aplicativo-laravel\/\" title=\"Como integrar o boletim informativo MailChimp no aplicativo Laravel\">Como integrar o boletim informativo MailChimp no aplicativo Laravel<\/a><\/li>\n<li><a href=\"https:\/\/themewp.inform.click\/pt-pt\/integracao-mailchimp-com-formulario-de-contato-7-plugin\/\" title=\"Integra\u00e7\u00e3o MailChimp com Formul\u00e1rio de Contato 7 Plugin\">Integra\u00e7\u00e3o MailChimp com Formul\u00e1rio de Contato 7 Plugin<\/a><\/li>\n<\/ul>\n<p><div id=\"PostUnique_PostSource\" style=\"padding-top: 50px\">Fonte de grava\u00e7\u00e3o:  <a target=\"_blank\" rel=\"noopener nofollow\" href=\"\/\/artisansweb.net\" class=\"external external_icon\">artisansweb.net<\/a><\/div><\/p>\n","protected":false},"excerpt":{"rendered":"<p>Seguindo este artigo, voc\u00ea ser\u00e1 capaz de lidar com a integra\u00e7\u00e3o da API MailChimp em seu site. Neste guia, usamos MailChimp API e PHP CURL para enviar<\/p>\n","protected":false},"author":1,"featured_media":21624,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":"","_wp_rev_ctl_limit":""},"categories":[278],"tags":[848],"class_list":["post-28578","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-php-9","tag-affiai-pt-pt"],"_links":{"self":[{"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/posts\/28578","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/comments?post=28578"}],"version-history":[{"count":0,"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/posts\/28578\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/media\/21624"}],"wp:attachment":[{"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/media?parent=28578"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/categories?post=28578"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/themewp.inform.click\/pt-pt\/wp-json\/wp\/v2\/tags?post=28578"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}