跳转到主要内容

SendGrid

项目描述

License: AGPL-3

SendGrid邮件发送和跟踪

本模块将SendGrid与Odoo集成。它可以通过SendGrid发送事务性电子邮件,使用在SendGrid网页界面上定义的模板。它还支持替换这些模板中的占位符变量。可用的模板列表可以自动获取。通过SendGrid发送的电子邮件将通过Sendgrid Webhook事件进行跟踪。

安装

为了安装此模块,您需要安装python-sendgrid v3 API。

如果您使用的是多数据库安装(带有或不带dbfilter选项),其中/web/database/selector返回的数据库列表包含多个数据库,那么您需要将mail_sendgrid插件添加到宽加载插件列表中(默认情况下,只有web插件),设置--load选项。例如,--load=web,mail_tracking,mail_sendgrid

配置

您可以将以下系统参数添加到配置SendGrid的使用

  • mail_sendgrid.substitution_prefix 用于SendGrid替换标签的前缀符号或字符。默认使用{。

  • mail_sendgrid.substitution_suffix 用于SendGrid替换标签的后缀符号或字符。默认使用}。

  • mail_sendgrid.send_method 使用值‘sendgrid’来覆盖用于发送电子邮件的传统SMTP服务器。默认情况下,SendGrid将与传统系统共存(发送按钮,可选择通常发送或通过SendGrid发送)。

为了使用此模块,必须在服务器命令行选项(或配置文件)中定义以下变量

  • sendgrid_api_key 从SendGrid网页界面获取的有效API密钥 <https://app.sendgrid.com/settings/api_keys>,拥有对邮件发送权限的完全访问权限,以及对于模板引擎权限的读取访问。

可选地,还可以设置以下配置变量

  • sendgrid_test_address 测试目的的电子邮件地址。您可以使用odoo@sink.sendgrid.net,这是一个只会接收并丢弃所有传入电子邮件的地址。

为了使事件跟踪功能正常工作,请确保您已将Sendgrid账户配置为正确的“事件通知URL”。您可以在“设置 -> 邮件设置 -> 事件通知”下完成此操作。将URL设置为https://<your_domain>/mail/tracking/sendgrid/<your_database>

将‘<your_domain>’替换为您的Odoo安装域名,将‘<your_database>’替换为您的数据库名称。

用法

如果您在设计Sendgrid模板并将其与Odoo一起使用
  • 转到“设置 -> 邮件 -> SendGrid模板”

  • 创建一个新的模板

  • 点击“更新”按钮:这将自动导入所有模板

在电子邮件模板“设置 -> 邮件 -> 模板”中,您可以为任何语言附加一个SendGrid模板。您可以用占位符或静态文本替换Sendgrid关键字,就像在电子邮件正文中一样。现在,预览向导会使用SendGrid模板渲染您的电子邮件。

从电子邮件中,使用“发送(SendGrid)”按钮使用Sendgrid发送电子邮件。

Try me on Runbot

已知问题/路线图

  • 扩展SendGrid的功能

错误跟踪器

错误在GitHub问题上进行跟踪。如果遇到问题,请检查是否已报告您的问题。如果是您首先发现的,请帮助我们解决它,提供详细且受欢迎的反馈。

鸣谢

图片

贡献者

维护者

Odoo Community Association

此模块由OCA维护。

OCA,或Odoo社区协会,是一个非营利组织,其使命是支持Odoo功能的协作开发并推广其广泛使用。

要为此模块做出贡献,请访问http://odoo-community.org

项目详情


下载文件

下载适用于您平台的文件。如果您不确定选择哪个,请了解更多关于安装包的信息。

源代码分布

此版本没有提供源分发文件。请参阅有关生成分发存档的教程。

构建的分发

由支持