{"id":39224,"date":"2026-10-23T16:40:15","date_gmt":"2026-10-23T19:40:15","guid":{"rendered":"https:\/\/www.locaweb.com.br\/ajuda\/?post_type=ht_kb&p=39224"},"modified":"2026-10-23T16:40:15","modified_gmt":"2026-10-23T19:40:15","slug":"como-enviar-e-mails-com-anexo-pela-api-do-smtp-locaweb","status":"publish","type":"ht_kb","link":"https:\/\/www.locaweb.com.br\/ajuda\/wiki\/como-enviar-e-mails-com-anexo-pela-api-do-smtp-locaweb\/","title":{"rendered":"Como enviar e-mails com anexo pela API do SMTP Locaweb"},"content":{"rendered":" \t\t
\r\n \t\t\tInforma\u00e7\u00e3o!<\/span> \t\t\t \t\t\t\t

\r\n \t\t\t\t\tPara enviar anexos pela API do SMTP Locaweb, a mensagem \u00e9 montada no formato MIME multipart\/mixed e enviada dentro do campo body. O header Content-Type da requisi\u00e7\u00e3o informa esse formato e o separador (boundary) entre as partes.<\/span> \t\t\t\t<\/p>\r\n \t\t\t \t\t\t\r\n \t\t<\/div>\r\n \t\t\n

Como funciona<\/b><\/h2>\n

A mensagem tem duas partes ou mais:<\/span><\/p>\n

    \n
  • Texto do e-mail: o conte\u00fado que o destinat\u00e1rio l\u00ea.<\/span><\/li>\n
  • Anexo: o arquivo convertido em Base64, com nome e tipo.<\/span><\/li>\n<\/ul>\n

    A API interpreta a estrutura e entrega o e-mail com o arquivo anexado.<\/span><\/p>\n

    Formato da requisi\u00e7\u00e3o<\/b><\/h2>\n

    Endpoint: POST https:\/\/api.smtplw.com.br\/v1\/messages<\/span><\/p>\n

    Headers:<\/span><\/p>\n

      \n
    • Content-Type: application\/json<\/span><\/li>\n
    • x-auth-token: SEU_TOKEN<\/span><\/li>\n<\/ul>\n

      \u00a0Exemplo pr\u00e1tico de envio com anexo “relatorio.pdf” demonstrando visualmente o corpo e o anexo do e-mail. (Envio.png)<\/p>\n

      \"Exemplo
      \n<\/span><\/p>\n

      \"Imagem<\/p>\n

       <\/p>\n

      \u00a0(Boundary_Requisicao)<\/span><\/p>\n

      O valor de boundary declarado no header marca o in\u00edcio de cada parte do body, e a mensagem termina com o mesmo valor seguido de –.<\/span><\/p>\n

      Modelo do JSON:<\/span><\/p>\n

      {<\/span>\r\n<\/span>\"subject\": \"Assunto do e-mail\",<\/span>\r\n<\/span>\"from\": \"remetente@seudominio.com.br\",<\/span>\r\n<\/span>\"to\": \"destinatario@dominio.com.br\",<\/span>\r\n<\/span>\"headers\": {<\/span>\r\n<\/span>\u00a0 \u00a0 \"Content-Type\": \"multipart\/mixed; boundary=\\\"LW_BOUNDARY_123\\\"\"<\/span>\r\n<\/span>},<\/span>\r\n<\/span>\"body\": \"--LW_BOUNDARY_123\\r\\nContent-Type: text\/plain; charset=utf-8\\r\\n\\r\\nTexto do e-mail aqui.\\r\\n\\r\\n--LW_BOUNDARY_123\\r\\nContent-Type: application\/pdf; name=\\\"arquivo.pdf\\\"\\r\\nContent-Transfer-Encoding: base64\\r\\nContent-Disposition: attachment; filename=\\\"arquivo.pdf\\\"\\r\\n\\r\\nBASE64_DO_ARQUIVO\\r\\n--LW_BOUNDARY_123--\\r\\n\"<\/span>\r\n<\/span>}<\/span>\r\n\r\n<\/span>\r\n\r\n    \t\t
      \r\n    \t\t\tImportante!<\/span>    \t\t\t    \t\t\t\t
      \r\n    \t\t\t\t\t<\/b><\/pre>\n
       Regras do body:<\/span><\/p>\n
        \n
      • O boundary informado no header deve ser o mesmo usado no body. Cada parte come\u00e7a com –LW_BOUNDARY_123 e a mensagem termina com –LW_BOUNDARY_123–.<\/span><\/li>\n
      • As linhas s\u00e3o separadas por \\r\\n, com uma linha em branco entre os cabe\u00e7alhos de cada parte e o conte\u00fado.<\/span><\/li>\n
      • O arquivo vai em Base64, quebrado em linhas de 76 caracteres.<\/span><\/li>\n
      • A parte do anexo leva o Content-Type do arquivo, Content-Transfer-Encoding: base64 e Content-Disposition: attachment; filename=”…”<\/span><\/li>\n
      • O from deve ser um remetente cadastrado e confirmado no painel do SMTP Locaweb.<\/span><\/li>\n<\/ul>\n
            \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div>\r\n    \t\t<\/b><\/p>\n
        Exemplo pronto<\/b><\/h2>\n
        O script abaixo l\u00ea o arquivo, converte para Base64, identifica o tipo e monta o JSON automaticamente. Ele roda em Linux com curl e python3.<\/span><\/p>\n
        TOKEN=\"SEU_TOKEN\"<\/span>\r\n<\/span>URL=\"https:\/\/api.smtplw.com.br\/v1\/messages\"<\/span>\r\n<\/span>FROM=\"remetente@seudominio.com.br\"<\/span>\r\n<\/span>TO=\"destinatario@dominio.com.br\"<\/span>\r\n<\/span>ASSUNTO=\"Relat\u00f3rio do m\u00eas\"<\/span>\r\n<\/span>TEXTO=\"Ol\u00e1! Segue em anexo o relat\u00f3rio.\"<\/span>\r\n<\/span>ARQUIVO=\"\/caminho\/do\/arquivo\/relatorio.pdf\"<\/span>\r\n<\/span>\r\n<\/span>python3 \"<\/span>FROM\"\"<\/span>TO\" \"<\/span>ASSUNTO\"\"<\/span>TEXTO\" \"$ARQUIVO\" > envio.json <<'PY'<\/span>\r\n<\/span>import json, sys, base64, os, mimetypes<\/span>\r\n<\/span>frm, to, assunto, texto, arquivo = sys.argv[1:6]<\/span>\r\n<\/span>nome = os.path.basename(arquivo)<\/span>\r\n<\/span>tipo = mimetypes.guess_type(arquivo)[0] or \"application\/octet-stream\"<\/span>\r\n<\/span>b64 = base64.b64encode(open(arquivo, \"rb\").read()).decode()<\/span>\r\n<\/span>linhas = \"\\r\\n\".join(b64[i:i+76] for i in range(0, len(b64), 76))<\/span>\r\n<\/span>B = \"LW_BOUNDARY_123\"<\/span>\r\n<\/span>body = (<\/span>\r\n<\/span>\u00a0 \u00a0 f\"--{B}\\r\\nContent-Type: text\/plain; charset=utf-8\\r\\n\\r\\n{texto}\\r\\n\\r\\n\"<\/span>\r\n<\/span>\u00a0 \u00a0 f\"--{B}\\r\\nContent-Type: {tipo}; name=\\\"{nome}\\\"\\r\\n\"<\/span>\r\n<\/span>\u00a0 \u00a0 \"Content-Transfer-Encoding: base64\\r\\n\"<\/span>\r\n<\/span>\u00a0 \u00a0 f\"Content-Disposition: attachment; filename=\\\"{nome}\\\"\\r\\n\\r\\n\"<\/span>\r\n<\/span>\u00a0 \u00a0 f\"{linhas}\\r\\n--{B}--\\r\\n\"<\/span>\r\n<\/span>)<\/span>\r\n<\/span>print(json.dumps({<\/span>\r\n<\/span>\u00a0 \u00a0 \"subject\": assunto, \"from\": frm, \"to\": to,<\/span>\r\n<\/span>\u00a0 \u00a0 \"headers\": {\"Content-Type\": f'multipart\/mixed; boundary=\"{B}\"'},<\/span>\r\n<\/span>\u00a0 \u00a0 \"body\": body<\/span>\r\n<\/span>}))<\/span>\r\n<\/span>PY<\/span>\r\n<\/span>\r\n<\/span>curl -s -i -X POST \"$URL\" \\<\/span>\r\n<\/span>-H \"Content-Type: application\/json\" \\<\/span>\r\n<\/span>-H \"x-auth-token: $TOKEN\" \\<\/span>\r\n<\/span>-d @envio.json | grep -iE \"^HTTP|^location\"<\/span>\r\n\r\n<\/span><\/pre>\n
         <\/p>\n
        \u00a0    \t\t
        \r\n    \t\t\tDica!<\/span>    \t\t\t    \t\t\t\t
        \r\n    \t\t\t\t\t<\/span>Preencha TOKEN, FROM, TO, ASSUNTO, TEXTO e ARQUIVO. O nome do anexo \u00e9 o pr\u00f3prio nome do arquivo. O retorno esperado \u00e9 HTTP\/1.1 201 Created e um location com o ID da mensagem.<\/span>    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div>\r\n    \t\t<\/span><\/p>\n
        V\u00e1r<\/b>ios anexos<\/b><\/h2>\n
        Para enviar mais de um arquivo, repita a parte do anexo antes do fechamento LW_BOUNDARY_123–. Estrutura do body com dois anexos:<\/span><\/p>\n
        --LW_BOUNDARY_123<\/span>\r\n<\/span>Content-Type: text\/plain; charset=utf-8<\/span>\r\n<\/span>Texto do e-mail<\/span>\r\n<\/span>\r\n<\/span>--LW_BOUNDARY_123<\/span>\r\n<\/span>Content-Type: application\/pdf; name=\"relatorio.pdf\"<\/span>\r\n<\/span>Content-Transfer-Encoding: base64<\/span>\r\n<\/span>Content-Disposition: attachment; filename=\"relatorio.pdf\"<\/span>\r\n<\/span>(Base64 do PDF)<\/span>\r\n<\/span>\r\n<\/span>--LW_BOUNDARY_123<\/span>\r\n<\/span>Content-Type: image\/png; name=\"grafico.png\"<\/span>\r\n<\/span>Content-Transfer-Encoding: base64<\/span>\r\n<\/span>Content-Disposition: attachment; filename=\"grafico.png\"<\/span>\r\n<\/span>(Base64 da imagem)<\/span>\r\n<\/span>\r\n<\/span>--LW_BOUNDARY_123--<\/span>\r\n\r\n<\/span><\/pre>\n
        No JSON, essas quebras de linha s\u00e3o escritas como \\r\\n.<\/span><\/p>\n
        Limites e tipos de arquivo<\/b><\/h2>\n
        O campo body aceita at\u00e9 1 MB, j\u00e1 com os anexos em Base64. Como o Base64 aumenta o arquivo em cerca de 33%, cabem por volta de 700 KB de anexos por mensagem.<\/span><\/p>\n\n\n\n\n\n\n\n\n
        Item<\/b><\/th>\nLimite<\/b><\/p>\n
        \u00a0<\/span><\/th>\n<\/tr>\n<\/thead>\n
        Tamanho do body (texto + anexos em Base64)<\/span><\/td>\n1 MB<\/span><\/td>\n<\/tr>\n
        Destinat\u00e1rios por mensagem<\/span><\/td>\n1.000<\/span><\/td>\n<\/tr>\n
        Envios por minuto<\/span><\/td>\n1.000<\/span><\/td>\n<\/tr>\n
        Cabe\u00e7alhos por mensagem<\/span><\/td>\n50<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
         <\/p>\n\n\n\n\n\n\n\n\n\n\n
        Extens\u00e3o<\/b><\/th>\nContent-Type<\/b><\/p>\n
        \u00a0<\/span><\/th>\n<\/tr>\n<\/thead>\n
        .pdf<\/span><\/td>\napplication\/pdf<\/span><\/td>\n<\/tr>\n
        .png<\/span><\/td>\nimage\/png<\/span><\/td>\n<\/tr>\n
        .jpg<\/span><\/td>\nimage\/jpeg<\/span><\/td>\n<\/tr>\n
        .zip<\/span><\/td>\napplication\/zip<\/span><\/td>\n<\/tr>\n
        .docx<\/span><\/td>\napplication\/vnd.openxmlformats-officedocument.wordprocessingml.document<\/span><\/td>\n<\/tr>\n
        .xlsx<\/span><\/td>\napplication\/vnd.openxmlformats-officedocument.spreadsheetml.sheet<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
        O script de exemplo identifica o tipo automaticamente.<\/span><\/p>\n
        Consultar o status do envio<\/b><\/h2>\n
        O ID da mensagem vem no header location da resposta. Para acompanhar o envio:<\/span><\/p>\n
        curl -s https:\/\/api.smtplw.com.br\/v1\/messages\/ID_DA_MENSAGEM -H “x-auth-token: SEU_TOKEN”<\/span><\/p>\n\n\n\n\n\n\n\n
        Status<\/b><\/th>\nSignificado<\/b><\/p>\n
        \u00a0<\/span><\/th>\n<\/tr>\n<\/thead>\n
        Enfileirado<\/span><\/td>\nA mensagem est\u00e1 na fila para envio<\/span><\/td>\n<\/tr>\n
        Enviado<\/span><\/td>\nA mensagem foi enviada\u00a0<\/span><\/td>\n<\/tr>\n
        Erro<\/span><\/td>\nFalha no envio; o detalhe aparece no campo response\u00a0<\/span><\/td>\n<\/tr>\n<\/tbody>\n<\/table>\n
         <\/p>\n
        \u00a0    \t\t
        \r\n    \t\t\tConhe\u00e7a!<\/span>    \t\t\t    \t\t\t\t
        \r\n    \t\t\t\t\tPara arquivos maiores que os limites da API (acima de 700 KB), use o envio via SMTP (servidor smtplw.com.br, porta 587) ou inclua um link para download no corpo do e-mail.    \t\t\t\t<\/p>\r\n    \t\t\t    \t\t\t\r\n    \t\t<\/div>\r\n    \t\t<\/span><\/p>\n","protected":false},"excerpt":{"rendered":"
        Como funciona A mensagem tem duas partes ou mais: Texto do e-mail: o conte\u00fado que o destinat\u00e1rio l\u00ea. Anexo: o arquivo convertido em Base64, com nome e tipo. A API interpreta a estrutura e entrega o e-mail com o arquivo anexado. Formato da requisi\u00e7\u00e3o Endpoint: POST https:\/\/api.smtplw.com.br\/v1\/messages Headers: Content-Type: application\/json…<\/p>\n","protected":false},"author":55,"comment_status":"closed","ping_status":"closed","template":"","format":"standard","meta":{"footnotes":""},"ht-kb-category":[115],"ht-kb-tag":[],"class_list":["post-39224","ht_kb","type-ht_kb","status-publish","format-standard","hentry","ht_kb_category-smtp-locaweb"],"_links":{"self":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/39224","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\/55"}],"replies":[{"embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/comments?post=39224"}],"version-history":[{"count":1,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/39224\/revisions"}],"predecessor-version":[{"id":39228,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb\/39224\/revisions\/39228"}],"wp:attachment":[{"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/media?parent=39224"}],"wp:term":[{"taxonomy":"ht_kb_category","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-category?post=39224"},{"taxonomy":"ht_kb_tag","embeddable":true,"href":"https:\/\/www.locaweb.com.br\/ajuda\/wp-json\/wp\/v2\/ht-kb-tag?post=39224"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}