Package: odoo10-addon-mail-sendgrid
SendGrid Mail Sending and TrackingThis module integratesSendGridwith Odoo. It can send transactional emails
through SendGrid, using templates defined on theSendGrid web interface. It also supports
substitution of placeholder variables in these templates. The list of available
templates can be fetched automatically.
E-mails sent through SendGrid will be tracked using Sendgrid Webhook Events.InstallationYou need to install python-sendgrid v3 API in order to install the module.If you’re using a multi-database installation (with or without dbfilter option)
where /web/databse/selector returns a list of more than one database, then
you need to addmail_sendgridaddon to wide load addons list
(by default, onlywebaddon), setting--loadoption.
For example,--load=web,mail_tracking,mail_sendgridConfigurationYou can add the following system parameters to configure the usage of SendGrid:mail_sendgrid.substitution_prefixAny symbol or character used as a
prefix forSendGrid Substitution Tags.{is used by default.mail_sendgrid.substitution_suffixAny symbol or character used as a
suffix for SendGrid Substitution Tags.}is used by default.mail_sendgrid.send_methodUse value ‘sendgrid’ to override the traditional SMTP server used to send e-mails with sendgrid.
By default, SendGrid will co-exist with traditional system
(two buttons for sending either normally or with SendGrid).In order to use this module, the following variables have to be defined in the
server command-line options (or in a configuration file):sendgrid_api_keyA valid API key obtained from the
SendGrid web interface <https://app.sendgrid.com/settings/api_keys> with
full access for theMail Sendpermission and read access for theTemplate Enginepermission.Optionally, the following configuration variables can be set as well:sendgrid_test_addressDestination email address for testing purposes.
You can useodoo@sink.sendgrid.net, which is an address that
will simply receive and discard all incoming email.For tracking events to work, make sure you configure your Sendgrid Account with the correct Event Notification Url.
You can do it under ‘Settings -> Mail Settings -> Event Notification ‘.
Set the URL tohttps://<your_domain>/mail/tracking/sendgrid/<your_database>Replace ‘<your_domain>’ with your Odoo install domain name
and ‘<your_database>’ with your database name.UsageIf you designed templates in Sendgrid that you wan’t to use with Odoo:Go to ‘Settings -> Email -> SendGrid Templates’Create a new TemplateClick the “Update” button : this will automatically import all your templatesIn e-mail templates ‘Settings -> Email -> Templates’, you can attach a SendGrid template for any language.
You can substitute Sendgrid keywords with placeholders or static text like in the body of the e-mail.
The preview wizard now renders your e-mail with the SendGrid template applied.From e-mails, use the “Send (SendGrid)” button to send the e-mail using Sendgrid.Known issues / RoadmapExtend the features from SendGridBug TrackerBugs are tracked onGitHub Issues. In case of trouble, please
check there if your issue has already been reported. If you spotted it first,
help us smashing it by providing a detailed and welcomed feedback.CreditsImagesSengrid logo:SVG Icon.ContributorsEmanuel Cino <ecino@compassion.ch>Roman Zoller <rzcomp@gmail.com>Isaac Gallart <igallart@puntsistemes.es>MaintainerThis module is maintained by the OCA.OCA, or the Odoo Community Association, is a nonprofit organization whose
mission is to support the collaborative development of Odoo features and
promote its widespread use.To contribute to this module, please visithttp://odoo-community.org.