Code for receiving emails via Discourse API

sudoman · 9월 10, 2018, 8:56오후

Hello Discourse,

Is there a preexisting code base out there for pushing emails to Discourse’s incoming email API?

Thanks,
Andrew

blake · 9월 10, 2018, 11:29오후

From the output of rake routes You can send a POST request to

admin/email/handle_mail

Here is the controller method from handle_mail:

github.com/discourse/discourse

app/controllers/admin/email_controller.rb

main


      
          # frozen_string_literal: true
          
          class Admin::EmailController < Admin::AdminController
            def index
            end
          
            def server_settings
              data = { delivery_method: delivery_method, settings: delivery_settings }
              render_json_dump(data)
            end
          
            def test
              params.require(:email_address)
              begin
                message = TestMailer.send_test(params[:email_address])
                Email::Sender.new(message, :test_message).send
          
                render json: { sent_test_email_message: I18n.t("admin.email.sent_test") }
              rescue => e
                render json: { errors: [e.message] }, status: :unprocessable_entity
              end
            end
          
            def preview_digest
              params.require(:last_seen_at)
              params.require(:username)
              user = User.find_by_username(params[:username])
              raise Discourse::InvalidParameters unless user
          
              renderer = Email::Renderer.new(UserNotifications.digest(user, since: params[:last_seen_at]))
              render json: MultiJson.dump(html_content: renderer.html, text_content: renderer.text)
            end
          
            def advanced_test
              params.require(:email)
          
              receiver = Email::Receiver.new(params["email"])
              text, elided, format = receiver.select_body
          
              render json: success_json.merge!(text: text, elided: elided, format: format)
            end
          
            def send_digest
              params.require(:last_seen_at)
              params.require(:username)
              params.require(:email)
              user = User.find_by_username(params[:username])
              raise Discourse::InvalidParameters unless user
          
              message, skip_reason =
                UserNotifications.public_send(
                  :digest,
                  user,
                  since: params[:last_seen_at],
                  skip_unsubscribe_links: true,
                )
          
              if message
                message.to = params[:email]
          
                begin
                  Email::Sender.new(message, :digest).send
                  render json: success_json
                rescue => e
                  render json: { errors: [e.message] }, status: :unprocessable_entity
                end
              else
                render json: { errors: skip_reason }
              end
            end
          
            # TODO (martin) Remove this in 3.7.0, this endpoint has been broken for years
            # and was used only in the public mail-receiver's fast rejection code,
            # which is removed in https://github.com/discourse/mail-receiver/pull/33
            def smtp_should_reject
              render json: { reject: false }
            end
          
            def handle_mail
              deprecated_email_param_used = false
          
              if params[:email_encoded].present?
                email_raw = Base64.strict_decode64(params[:email_encoded])
              elsif params[:email].present?
                deprecated_email_param_used = true
                email_raw = params[:email]
              else
                raise ActionController::ParameterMissing.new("email_encoded or email")
              end
          
              # If it isn't valid UTF-8, reinterpret as ISO-8859-1 so it can be serialized to JSON.
              email_raw = email_raw.dup.force_encoding("UTF-8")
              email_raw = email_raw.encode("UTF-8", "ISO-8859-1") if !email_raw.valid_encoding?
          
              Jobs.enqueue(:process_email, mail: email_raw, retry_on_rate_limit: true, source: "handle_mail")
          
              if deprecated_email_param_used
                warning =
                  "warning: the email parameter is deprecated. all POST requests to this route should be sent with a base64 strict encoded email_encoded parameter instead. email has been received and is queued for processing"
          
                Discourse.deprecate(warning, drop_from: "3.3.0")
          
                render plain: warning
              else
                render plain: "email has been received and is queued for processing"
              end
            end
          
            private
          
            def delivery_settings
              action_mailer_settings.reject { |k, _| k == :password }.map { |k, v| { name: k, value: v } }
            end
          
            def delivery_method
              ActionMailer::Base.delivery_method
            end
          
            def action_mailer_settings
              ActionMailer::Base.public_send "#{delivery_method}_settings"
            end
          end

mpalmer · 9월 10, 2018, 11:31오후

jshockley · 1월 13, 2020, 10:57오후

비기술적인 사용자로서 API를 통한 수신 이메일의 기능을 이해해야 합니다:

이미 수행한 작업:

주 도메인(서브도메인이 아님)에 대한 POP3 폴링을 통한 수신 이메일
postfix 메일 모듈을 통한 수신 이메일은 작동하지만, 서브도메인에서만 작동합니다 - 제 경우 xxx@community.eleoptics.com - 이는 사용할 수 없으며, 주 도메인이 필요합니다.

현재 설정:

수신 이메일: G Suite Google “Groups” 이메일 주소를 무료 Gmail 계정으로 포워딩 (이메일 주소당 Gsuite 계정을 구매하지 않기 위해). POP3 폴링
발신 이메일: Google Cloud에 설치된 Discourse 서버의 IP로 인증된 GSuite를 통한 SMTP Relay Forwarding.

이것은 작동하지만, 무료 Gmail POP3 폴링 계정은 벗어나고 싶습니다.

더 큰 규모의 배포와 서비스를 위해 이상적으로는 Google Cloud Platform Email API를 사용하여 이메일 송수신을 처리할 계획입니다.

수신 이메일을 discourse로 직접 연결하는 방법에 대해 기술 직원들에게 전달할 수 있는 문서는 어디에 있나요?

위 게시물에 이미 링크되어 있다면 감사합니다. 그렇지 않다면, 더 맥락에 맞는 설명이 필요하다고 추측합니다.

blake:

handle_mail의 컨트롤러 메서드입니다:

github.com

discourse/discourse/blob/master/app/controllers/admin/email_controller.rb#L124

  params.require(:email)
  user = User.find_by_username(params[:username])


  message, skip_reason = UserNotifications.public_send(:digest, user,
    since: params[:last_seen_at]
  )


  if message
    message.to = params[:email]
    begin
      Email::Sender.new(message, :digest).send
      render json: success_json
    rescue => e
      render json: { errors: [e.message] }, status: 422
    end
  else
    render json: { errors: skip_reason }
  end
end


def smtp_should_reject

글		댓글	조회수
No received mails in new Discourse installation Self-hosting	4	2025	12월 9, 2019
Set up reply by email with POP3 polling Self-Hosting email , how-to	1	303979	9월 2, 2025
Receiving emails into Discourse messages. Can this be done? Product Support email	3	1240	2월 23, 2023
Simple email inbox for discourse Product Support email	17	1049	10월 30, 2023
Trying to set up reply by email: ActionController::RoutingError (No route matches [POST] "/admin/email/handle_mail") Self-hosting	3	2510	6월 15, 2018

Code for receiving emails via Discourse API

Related topics