{"id":13178,"date":"2023-01-09T11:04:43","date_gmt":"2023-01-09T14:04:43","guid":{"rendered":"http:\/\/ajuda.locaweb.com.br\/?post_type=ht_kb&#038;p=13178"},"modified":"2023-10-16T07:38:33","modified_gmt":"2023-10-16T10:38:33","slug":"como-configurar-o-webhook-smtp-locaweb","status":"publish","type":"ht_kb","link":"https:\/\/www.locaweb.com.br\/ajuda\/wiki\/como-configurar-o-webhook-smtp-locaweb\/","title":{"rendered":"Como configurar o Webhook &#8211; SMTP Locaweb"},"content":{"rendered":"<div data-pm-slice=\"1 3 []\" data-en-clipboard=\"true\">    \t\t<div class=\"hts-messages hts-messages--info  hts-messages--withtitle hts-messages--withicon \"   >\r\n    \t\t\t<span class=\"hts-messages__title\"><b>Informa\u00e7\u00e3o!<\/b><\/span>    \t\t\t    \t\t\t\t<p>\r\n    \t\t\t\t\tNeste artigo iremos entender basicamente para que serve o Webhook e como configura-lo para receber seus relat\u00f3rios.    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div><!-- \/.ht-shortcodes-messages -->\r\n    \t\t<\/div>\n<div data-pm-slice=\"1 3 []\" data-en-clipboard=\"true\"><\/div>\n<div>\n<div data-pm-slice=\"1 1 []\" data-en-clipboard=\"true\">\n    \t\t<div class=\"hts-messages hts-messages--alert  hts-messages--withtitle hts-messages--withicon \"   >\r\n    \t\t\t<span class=\"hts-messages__title\"><b>Aten\u00e7\u00e3o<\/b><\/span>    \t\t\t    \t\t\t\t<p>\r\n    \t\t\t\t\t\n<ul>\n<li>Para configurar o Webhook voc\u00ea <b>precisa<\/b> ter um servi\u00e7o de hospedagem. Focaremos na explica\u00e7\u00e3o e configura\u00e7\u00e3o da ferramenta.<\/li>\n<li>Como ser\u00e1 necess\u00e1rio acesso as pastas do seu site, voc\u00ea precisar\u00e1 utilizar um gerenciador FTP, em caso de duvidas para acessar seu gerenciador acesse: <a href=\"https:\/\/ajuda.locaweb.com.br\/wiki\/como-ver-os-dados-de-acesso-ao-ftp-hospedagem-de-sites\/\" rev=\"en_rl_none\">Dados de acesso FTP<\/a>    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div><!-- \/.ht-shortcodes-messages -->\r\n    \t\t<\/li>\n<\/ul>\n<\/div>\n<h6><b>O que \u00e9 Webhook ?<\/b><\/h6>\n<div><\/div>\n<\/div>\n<ul>\n<li>Configurado em seu SMTP Locaweb, serve para voc\u00ea receber seus relat\u00f3rios de <b>Bounces <\/b>e <b>Aberturas <\/b>em tempo real, por meio de um arquivo que vamos chamado de &#8220;myfile.txt&#8221;.<\/li>\n<\/ul>\n<h6><b>Informa\u00e7\u00f5es do relat\u00f3rio<\/b><\/h6>\n<ul>\n<li>\n<div>Destinat\u00e1rio\/Remetente (Bounces\/Aberturas);<\/div>\n<\/li>\n<li>\n<div>Motivo do bounce (descri\u00e7\u00e3o e c\u00f3digo do erro);<\/div>\n<\/li>\n<li>\n<div>Hor\u00e1rio de abertura (Se houve abertura);<\/div>\n<\/li>\n<li>\n<div>Cabe\u00e7alho da mensagem (Bounces\/Aberturas);<\/div>\n<\/li>\n<li>\n<div>Assunto da mensagem (Bounces\/Aberturas);<\/div>\n<\/li>\n<li>Os c\u00f3digos est\u00e3o divididos em dois arquivos &#8220;.php&#8221;, um para que voc\u00ea possa receber os relat\u00f3rios de erros de envio e outro que vai exibir as informa\u00e7\u00f5es de abertura.<\/li>\n<\/ul>\n<h6><b>Configurando o webhook &#8211; Bounces\/Aberturas<\/b><\/h6>\n<ul>\n<li>\n<div>Em um bloco de notas ou editor de c\u00f3digos, crie um arquivo &#8220;.php&#8221;. Exemplo de nome de arquivo: <em>bounces.php<\/em><\/div>\n<\/li>\n<li>\n<div>Copie o c\u00f3digo abaixo e cole o mesmo no arquivo rec\u00e9m criado.<\/div>\n<\/li>\n<li>Em nosso servi\u00e7o de webhooks, existem limita\u00e7\u00f5es nas portas dispon\u00edveis para receber notifica\u00e7\u00f5es. Para garantir o correto funcionamento do servi\u00e7o e o tratamento seguro do tr\u00e1fego, atualmente, s\u00e3o suportadas as portas padr\u00e3o 80 e 443. Recomendamos o uso da porta 443, pois ela \u00e9 reservada para tr\u00e1fego seguro de HTTPS.<\/li>\n<\/ul>\n<h6><strong>C\u00f3digo &#8211; bounces<\/strong><\/h6>\n<div data-pm-slice=\"1 1 []\" data-en-clipboard=\"true\">\n<pre><span class=\"ui-provider ceg ceh c d e f g h i j k l m n o p q r s t cei cej w x y z ab ac ae af ag ah ai aj ak\" dir=\"ltr\">&lt;?php\r\n$bounce_description = $_POST['bounce_description']; \/\/ Descri\u00e7\u00e3o do bounce\r\n$bounce_code = $_POST['bounce_code']; \/\/ Codigo do erro do bounce\r\n$message_sender = $_POST['sender']; \/\/ Remetente\r\n$message_to = $_POST['to']; \/\/ Destinat\u00e1rio\r\n$message_subject = $_POST['subject'];\/\/ Assunto da mensagem\r\n$x_smtplw = $_POST['x-smtplw'];\/\/ cabe\u00e7alho\r\n$myfile = fopen(\"myfile.txt\", \"a\") or die(\"Unable to open file\");\/\/ Abertura do arquivo TXT\r\n$date = date('m\/d\/Y H:i:s', time());\/\/ Gera\u00e7\u00e3o da data para o log\r\n$txt = \"[$date] bounce_description: $bounce_description\\tbounce_code: $bounce_code\\tsender: $message_sender\\tto: $message_to\\tsubject: $message_subject\\tx_smtplw: $x_smtplw\\n\"; \/\/ Definindo uma vari\u00e1vel com o texto formatado\r\nfwrite($myfile, $txt); \/\/ Grava\u00e7\u00e3o do texto no arquivo txt criado\r\nfclose($myfile); \/\/ Fechamento do arquivo\r\n?&gt;<\/span><\/pre>\n<\/div>\n<ul>\n<li data-pm-slice=\"1 1 []\" data-en-clipboard=\"true\">Veja no c\u00f3digo exemplo onde os itens marcados em\u00a0<span style=\"color: #0000ff;\"><b>Azul<\/b>\u00a0<\/span>s\u00e3o as vari\u00e1veis que v\u00e3o receber as informa\u00e7\u00f5es dos itens em\u00a0<span style=\"color: #ff9900;\"><b>Laranja\u00a0<\/b><\/span>que s\u00e3o as informa\u00e7\u00f5es que nossos servidores mandam para sua p\u00e1gina, os itens em\u00a0<span style=\"color: #339966;\"><b>Verde\u00a0<\/b><\/span>s\u00e3o os itens que v\u00e3o formatar o arquivo, gera-lo e fecha-lo.<\/li>\n<li data-pm-slice=\"1 1 []\" data-en-clipboard=\"true\">O mesmo se aplica para o relat\u00f3rio de aberturas, mas alterando o c\u00f3digo.<\/li>\n<\/ul>\n<h6><strong>C\u00f3digo &#8211; aberturas<\/strong><\/h6>\n<div data-pm-slice=\"1 1 []\" data-en-clipboard=\"true\">\n<pre><span class=\"ui-provider ceg ceh c d e f g h i j k l m n o p q r s t cei cej w x y z ab ac ae af ag ah ai aj ak\" dir=\"ltr\">&lt;?php\r\n$message_sender = $_POST['sender']; \/\/ Remetente\r\n$message_to = $_POST['to']; \/\/ Destinat\u00e1rio\r\n$message_subject = $_POST['subject']; \/\/ Assunto da mensagem\r\n$x_smtplw = $_POST['x-smtplw']; \/\/ cabe\u00e7alho\r\n$opened_at = $_POST['opened_at']; \/\/ Data de abertura\r\n$myfile = fopen(\"myfile.txt\", \"a\") or die(\"Unable to open file\"); \/\/ Abertura do arquivo TXT\r\n$date = date('m\/d\/Y H:i:s', time()); \/\/ Gera\u00e7\u00e3o da data para o log\r\n$txt = \"sender: $message_sender\\tto: $message_to\\tsubject:\u00a0 $message_subject\\tx_smtplw: $x_smtplw\\topened at: $opened_at:\u00a0 $openedat\\n\"; \/\/ Definindo uma vari\u00e1vel com o texto formatado\r\nfwrite($myfile, $txt); \/\/ Grava\u00e7\u00e3o do texto no arquivo txt criado\r\nfclose($myfile); \/\/ Fechamento do arquivo\r\n?&gt;<\/span><\/pre>\n<\/div>\n<ul>\n<li>\n<div data-pm-slice=\"1 1 [&quot;ul&quot;,null,&quot;li&quot;,null]\" data-en-clipboard=\"true\">Crie tamb\u00e9m um arquivo com o nome&#8221;myfile.txt&#8221; que ser\u00e1 respons\u00e1vel por receber as informa\u00e7\u00f5es e apresenta-las a voc\u00ea. Este arquivo sera importado para o FTP juntamente com os outros dois por\u00e9m sem nenhum conte\u00fado.<\/div>\n<\/li>\n<\/ul>\n<ul>\n<li>\n<div>Ap\u00f3s\u00a0 a cria\u00e7\u00e3o dos arquivos, acesse um gerenciador FTP (Recomendamos o FileZilla) e fa\u00e7a o upload dos tr\u00eas arquivos dentro da pasta <b>public_html<\/b>.<\/div>\n<\/li>\n<li>\n<div>Agora voc\u00ea precisar\u00e1 adicionar o endere\u00e7o direto dos arquivos que est\u00e3o dentro de seu gerenciador FTP.<\/div>\n<\/li>\n<li>\n<div>Para isso v\u00e1 em: Configura\u00e7\u00f5es &gt; Webhook &gt; Clique em editar para colocar o caminho &gt; Apos colocar o endere\u00e7o clique em salvar.<\/div>\n<\/li>\n<\/ul>\n<h6><strong>Exemplo<\/strong><\/h6>\n<ul>\n<li><b>\u00a0<\/b>O endere\u00e7o exemplo utilizado acima \u00e9 apenas em casos os arquivos estejam diretamente dentro da pasta <b>public_html<\/b>. Caso sej\u00e1 criada uma nova pasta dentro desta voc\u00ea precisar\u00e1 indicar no endere\u00e7o com diret\u00f3rio.<\/li>\n<\/ul>\n<div>    \t\t<div class=\"hts-messages hts-messages--alert  hts-messages--withtitle hts-messages--withicon \"   >\r\n    \t\t\t<span class=\"hts-messages__title\"><b>Importante!<\/b><\/span>    \t\t\t    \t\t\t\t<p>\r\n    \t\t\t\t\tSe o procedimento foi feito corretamente ir\u00e1 aparecer a seguinte mensagem\u00a0\u201c<strong>URL de notifica\u00e7\u00e3o salva com sucesso!<\/strong>\u201d e o c\u00f3digo &#8220;<strong>200<\/strong>&#8220;, caso ele de o erro\u00a0\u201cErro ao acessar a URL de notifica\u00e7\u00e3o.\u201d verifique se o caminho do arquivo esta correto.    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div><!-- \/.ht-shortcodes-messages -->\r\n    \t\t<\/div>\n<div><\/div>\n<h6><b>Exemplos de retorno de bounces\/aberturas <\/b><\/h6>\n<ul>\n<li>Quando o envio for efetuado as informa\u00e7\u00f5es retornaram dentro do &#8220;myfile.txt&#8221;, abaixo segue um exemplo para cada um dos casos de uso:<\/li>\n<\/ul>\n<div><\/div>\n<ul>\n<li>\n<div data-pm-slice=\"1 1 [&quot;ul&quot;,null,&quot;li&quot;,null]\" data-en-clipboard=\"true\"><strong>Bounces<\/strong><\/div>\n<\/li>\n<\/ul>\n<pre>bounce_description: O endere\u00e7o de e-mail especificada n\u00e3o existe  \r\nbounce_code: 5.1.1  sender: remetente@seudominio.com.br \r\nto: destinatario@locaweb.com.br \r\nsubject: Assunto da mensagem  \r\nx_smtplw: cabe\u00e7alho da mensagem<\/pre>\n<ul>\n<li>\n<div data-pm-slice=\"1 1 [&quot;ul&quot;,null,&quot;li&quot;,null]\" data-en-clipboard=\"true\"><strong>Abeturas<\/strong><\/div>\n<\/li>\n<\/ul>\n<pre>sender: remetente@remetente.com.br   \r\nto: destinatario@destinatario.com.br   \r\nsubject: Assunto da mensagem   \r\nx_smtplw: Cabe\u00e7alho da Mensagem   \r\nopened at: 2016-11-22T15:04:51-02:00 (Data e hor\u00e1rio da abertura)<\/pre>\n<ul>\n<li>Para mais exemplos de implementa\u00e7\u00e3o do Webhook <a href=\"http:\/\/developer.locaweb.com.br\/documentacoes\/smtp\/configurando-webhook\/\" target=\"_blank\" rel=\"noopener noreferrer\">clique aqui<\/a>.<\/li>\n<\/ul>\n    \t\t<div class=\"hts-messages hts-messages--info  hts-messages--withtitle hts-messages--withicon \"   >\r\n    \t\t\t<span class=\"hts-messages__title\"><b>Conhe\u00e7a!<\/b><\/span>    \t\t\t    \t\t\t\t<p>\r\n    \t\t\t\t\tAproveite e conhe\u00e7a outros produtos da Locaweb, como o <a href=\"https:\/\/www.locaweb.com.br\/hospedagem-de-sites-com-dominio-gratis\/\" target=\"_blank\" rel=\"noopener noreferrer\">Hospedagem de Sites.<\/a>    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div><!-- \/.ht-shortcodes-messages -->\r\n    \t\t\n","protected":false},"excerpt":{"rendered":"<p>O que \u00e9 Webhook ? Configurado em seu SMTP Locaweb, serve para voc\u00ea receber seus relat\u00f3rios de Bounces e Aberturas em tempo real, por meio de um arquivo que vamos chamado de &#8220;myfile.txt&#8221;. Informa\u00e7\u00f5es do relat\u00f3rio Destinat\u00e1rio\/Remetente (Bounces\/Aberturas); Motivo do bounce (descri\u00e7\u00e3o e c\u00f3digo do erro); Hor\u00e1rio de abertura (Se&#8230;<\/p>\n","protected":false},"author":6,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[115],"ht-kb-tag":[373],"class_list":["post-13178","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-smtp-locaweb","ht_kb_tag-categoriasmtp-locaweb"],"_links":{"self":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/13178","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb"}],"about":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/types\/ht_kb"}],"author":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/users\/6"}],"replies":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/comments?post=13178"}],"version-history":[{"count":96,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/13178\/revisions"}],"predecessor-version":[{"id":33865,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/13178\/revisions\/33865"}],"wp:attachment":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/media?parent=13178"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-category?post=13178"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-tag?post=13178"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}