跳转至

消息发送器

除了默认的 SMTP 电子邮件后端外,stmails 还支持多个自定义消息发送后端,不仅支持电子邮件活动,还支持任意消息活动,如 SMS、FCM 通知等。

消息发送器是一个 Web 服务,它接受作为 JSON 请求推送的活动消息,该服务可以将其作为 SMS、FCM 等广播。消息发送器在设置 -> 消息发送器 UI 中注册,可以在各个活动中选择。

消息发送器支持可选的 BasicAuth 身份验证。对于 SMS 和 FCM 等消息发送器,活动内容的纯文本格式是理想的选择。

当活动开始时,stmails 会以以下格式向选定的消息发送器端点发送 POST 请求。如果请求成功,端点应返回 200 OK 响应。

广播消息所需的地址,例如电话号码或 FCM ID,应该作为订阅者属性存储和传递。

{
    "subject": "Welcome to stmails",
    "body": "The message body",
    "content_type": "plain",
    "recipients": [{
        "uuid": "e44b4135-1e1d-40c5-8a30-0f9a886c2884",
        "email": "anon@example.com",
        "name": "Anon Doe",
        "attribs": {
            "phone": "123123123",
            "fcm_id": "2e7e4b512e7e4b512e7e4b51",
            "city": "Bengaluru"
        },
        "status": "enabled"
    }],
    "campaign": {
        "uuid": "2e7e4b51-f31b-418a-a120-e41800cb689f",
        "name": "Test campaign",
        "tags": ["test-campaign"]
    }
}