/civicrm-ses

Primary LanguagePHPOtherNOASSERTION

ses

This extension exposes a webhook page to process bounces from Amazon SES (Simple Email Service) through Amazon SNS (Simple Notification Service) notifications.

The extension is licensed under AGPL-3.0.

Requirements

  • PHP v7.1+
  • CiviCRM 5.19+

Installation

See: https://docs.civicrm.org/sysadmin/en/latest/customize/extensions/#installing-a-new-extension

Usage

The webhook verifies that the Notification or SubscriptionConfirmation it's been originated and sent by the SNS service (as per SNS docs), if the Notification is a SubscriptionConfirmation it automatically subscribes to it, if it's a Bounce, it maps SES' bounce type to Civi's bounce type.

Hard bounce mapping

SES CiviCRM
Undetermined Syntax
General, NoEmail, Suppressed Invalid

Soft bounce mapping

SES CiviCRM
General Syntax
MessageTooLarge, MailboxFull Quota
ContentRejected, AttachmentRejected Spam

Please see Amazon's guide and documentation on how to setup SNS notifications for SES.

Webhook url:

Future features/wishes/would like to do

  • Send using API (instead of SMTP)
  • UI to create Topic and Subscription without leaving CiviCRM
  • Send statistics, and reputation dashlets

Also see: https://github.com/mecachisenros/aws which could replace this extension in the future.

Known Issues

None that I'm aware of, report here if you find any and be aware that this extension is at a beta stage.