Topics

Configuring Brightspot for email submissions


In This Guide

The following procedures describe how to configure Brightspot for submitting content over email.


Configuring the bounce and complaint interface

If you configured bounce and complaint notifications in your Amazon SES console, you can optionally turn on support for these notifications in Brightspot.

To configure the bounce and complaint interface:

  1. Select Click menu > Admin > Sites & Settings > Sites > Global. The Edit Global widget appears.
  2. Under Main, expand AWS SES.
  3. Turn on Enable Bounce and Complaint Notification Service.
  4. Set the queue name fields to match the AWS SES queue names.
  5. Click Save.

Activating mail ingestion

To activate email ingestion:

  1. Select Click menu > Admin > Sites & SettingsSites > Global. The Edit Global widget appears.
  2. Under Main, expand Mail Publishing.
  3. Set S3Region to the AWS region where your SQS queue resides.
  4. Set Queue Name to the name of the queue.
  5. Click Save.

Configuring an email ingestor

An email ingestor performs the following:

  • Strips the signatures that some email clients automatically attach to the end of an email’s body.
  • Provides the “from” address on the confirmation email Brightspot sends to an editor who submitted content via email.

To configure an email ingestor:

  1. Click menu > Admin > Sites & Settings > Sites > Global. The Edit Global widget appears.
  2. Under CMS, expand Email to CMS.
  3. If you want to use a different ingestor than the current one, do the following:

    1. Click search. A content picker appears.
    2. If you want to use one of the available publishers, select it and skip to step 3j.
    3. Click New Mail to Content Mapper. A content edit page appears.
      Mail to content mapper
    4. In the Display name field, enter a name for this ingestor.
    5. In the Signature Stripping Pattern field, do one of the following:

      • Select Standard to select patterns that typically introduce an email signature.
      • Select Custom to compose patterns that you expect to introduce an email signature.
    6. In the Response From Email field, enter a “from” email address that Brightspot uses when sending a confirmation or error message to the editor regarding the submission. The domain name must match the Brightspot domain configured in your AWS SES (Simple Email Service). If it does not match the Brightspot domain, or is blank, Brightspot does not send confirmation emails.
    7. Click Save.
    8. Click Back to Select Mail Publisher. You return to the content picker.
    9. Select the ingestor you just created. You return to the Edit Global widget.
    10. Click Save.

Mail content mappings

Brightspot uses mail content mappings to transform an email submission to an actual item, such as to an article or an image. This section describes how to configure the fields in an article or an image so that editors can submit them over email.

To create a mail content mapping:

  1. Select Click menu > Admin > Sites & Settings.
  2. In the Sites widget, select the site to which you want emailed submissions to be published. The site you select will become the owner of article or images emailed to the site.
  3. Under CMS, expand Email to CMS.
  4. Under Mail Content Mappings, click add_circle_outline. A Mail Content Mapping form appears.

    Mail content mapping

  5. In the Receiving Email field, enter a “to” address to which editors submit content for a given content type.
    • For the username, as a best practice use the content type, such as article or image.
    • For the domain, use the Brightspot domain in your AWS SES (Simple Email Service) configuration.
    • Examples of “to” addresses are article@brightspot.example.com and image@brightspot.example.com.
    Caution
    If you are configuring mail content mappings for multiple sites, ensure that the receiving email addresses are unique across sites.

  6. Under Parsing Method, set Field Delimiter to the symbol for indicating a field name in an email. For example, if you enter #, then editors prefix the field names in their emails with an octothorpe.
  7. Under Content type, and using the following table as a reference, configure the converter to be used for an email sent to this address, and then set the field options. For some fields, you can select a markdown or simple processor to convert the field. If you configure a field to use a markdown processor, editors can include text formatting such as boldface and italics.
  8. To publish submitted articles immediately, turn on Publish Immediately.
  9. Click Save.

Options for article and image converters

Converter
Field
Description
Article Email ConverterHeadline ProcessorSet the type of processor for the field used as a headline, and specify the name of the field as found in the article content type.
Body ProcessorSet the type of processor for the field used for body text, and specify the name of the field as found in the article content type.
Section ProcessorSpecify the name of the section field as found in the article content type. Editors can enter comma-separated values to associate the article with one or more sections.
Tags ProcessorSpecify the name of the tags field as found in the article content type. Editors can enter comma-separated values to associate and articles with one or more tags.
Image Email ConverterCaption ProcessorSet the type of processor for the field used for a caption, and specify the name of the field as found in the image content type.
Tags ProcessorSpecify the name of the tags field as found in the image content type. Editors can enter comma-separated values to associate the image with one or more tags.