SendLang: Eメール自動化のためのDSL
SendLang: A DSL for Email Automation (sendlang.com)
要約
SendLangは、Eメールのライフサイクル管理を自動化するための2つの言語、SendQLとSendFlowを提供します。SendQLは対象者を定義し、SendFlowは時間経過に伴うアクションを定義します。これらの言語はプレーンテキストファイルとしてバージョン管理システムに保存でき、コードと同様のレビュープロセスを経ることができます。また、コーディングエージェントによる生成も可能で、タイプチェッカーによる検証を経てから実行されます。
全文翻訳
ライフサイクルメールのための言語レイヤー
SendLangは、メールのライフサイクルを定義します。誰にメッセージを送るか(SendQL)と、いつ送信するか(SendFlow)です。メッセージ自体ではなく、テンプレートはそのままに、プラットフォームが送信を行います。SendFlowはSendQLをネイティブに扱います。
人間とコーディングエージェントによって書かれることを想定しています。公開された文法、反復処理のための型チェッカー、承認を求める差分があります。方法を見る。
テンプレート言語ではなく、送信も行いません。React Email、MJML、WYSIWYGエディタはそのまま使用できます。SendLangは、かつてドラッグ&ドロップキャンバスに閉じ込められていたターゲティングとタイミングを管理します。
SendFlow
trial-onboarding.flow
workflow "Trial onboarding" v1 {
enter on segment "trial-started"
exit "converted" when attr.plan != "trial"
send "welcome" via topic "onboarding"
wait 2d
if not exists(open where template = "welcome") {
send "welcome-reminder" via topic "onboarding"
wait 2d
}
send "activation-tips" via topic "onboarding"
wait up to 7d until count(activity.login within 7d) >= 2 {
timeout: send "need-a-hand" via topic "onboarding"
}
}
既に本番環境で使用されています
SendLang
1つのファミリー、2つの言語
SendQLは名詞、SendFlowは動詞です。これらが一体となって誰にといつを管理します。何を、つまりメール自体は、テンプレート内に留まります。そして、連絡先データとイベントストリームを、差分で確認できるキャンペーンに変換します。
SendQL
誰に
セグメント定義クエリ言語です。すべてのクエリは、どの連絡先がセグメントに一致するかを記述する単一のブール式です。
SendQL
segment.sendql
attr.plan = "pro"
and attr.country in ["US", "CA", "MX"]
and not suppressed
SendFlow
いつ
.flowファイルに保存されるドリップワークフロー言語です。上から下に読み取られ、すべての条件にSendQLを埋め込みます。
SendFlow
onboarding.flow
workflow "Nudge" v1 {
enter on segment "trial-started"
wait 2d
if not exists(open within 2d) {
send "nudge" via topic "onboarding"
}
}
なぜ言語なのか
ライフサイクルメールをバージョン管理する
他のすべてのツールは、コホートやライフサイクルキャンペーンをビジュアルエディタの中に閉じ込めます。それらを言語にすることで、差分を付け、レビューし、コーディングエージェントに渡せるテキストになります。
winback.flow
-workflow "Winback" v1 {
- enter on segment "inactive-90d"
- exit "reactivated" when count(open within 14d) >= 1
-
- send "we-miss-you" via topic "marketing"
- wait 3d
+workflow "Winback" v1 {
+ enter on segment "inactive-90d"
+ exit "reactivated" when count(open within 14d) >= 1
+
+ send "we-miss-you" via topic "marketing"
+ wait up to 5d until exists(click within 5d) {
+ timeout: send "last-call" via topic "marketing"
+ }
}
バージョン管理に存在する
すべてのセグメントとワークフローはプレーンテキストファイルです。差分を付け、プルリクエストでレビューし、ロールバックできます。ターゲティングとドリップロジックは、コードの他の部分と同じ厳密さを獲得します。
送信前に失敗する
スペルミスのある属性は、行と列を持つ型エラーであり、誰も気づかないまま1週間送信されるキャンペーンではありません。
コーディングエージェントが書ける
これが大きな点です。キャンバスはエージェントにとって行き止まりですが、言語はエージェントが既に作業しているループです。結果を記述し、ファイルをドラフトさせ、レビューを通過したらマージします。
コーディングエージェント
キャンペーンをエージェントに引き渡す
代替案は、エージェントが既に書けるコードではなく、開けないキャンバスでした。ライフサイクルターゲティングとタイミングは、ドラッグ&ドロップエディタ内にあり、リポジトリ内のすべてのツールからアクセスできませんでした。キャンバスはコーディングエージェントにとって行き止まりです。読み取ったり、変更したり、何を変更したかを伝えたりできません。言語は、エージェントが既に作業しているループです。ファイルを読み取り、ファイルを書き込み、チェッカーを実行し、プルリクエストを開きます。これは設計の副作用ではありません。設計の理由です。
「トライアル終了の3日前に、彼らにメールを送る。3日以内にクリックしなかった場合は、アップグレードオファーを送る。」
SendFlow
trial-ending.flow
workflow "Trial ending" v1 {
enter on 3d before attr.trial_ends_at
exit "upgraded" when attr.plan != "trial"
send "trial-ending" via topic "onboarding"
wait up to 3d until exists(click where template = "trial-ending" within 3d) {
timeout: send "upgrade-offer" via topic "marketing"
}
}
ci
sendflow-fmt -l flows/
sendflow-lint -registry registry.json flows/\*\.flow
flows/trial-ending.flow: ok
ドキュメントは機械可読
すべてのページにはMarkdownのツインがあり、llms.txt / llms-full.txtは、両言語全体を単一のフェッチでエージェントに提供します。スクレイピングするものはなく、推測するものもありません。
文法、推測ではない
正規のEBNFと予約語リストはパーサー自体からエミットされるため、エージェントが読む仕様は、それが書くものを判断するコードから逸脱することはありません。
型チェッカーはフィードバックループ
すべてのパースおよび型エラーには、行、列、および修正名を指定するメッセージが含まれます。エージェントは、実行がクリーンになるまでチェッカーに対して反復処理を行います。そして、何も送信されません。
あなたは依然として承認者
gotoなし、無制限ループなし、評価するものなし。エージェントがあなたに提示できる最悪のものは、終了するワークフローであり、連絡先に到達する前に差分として読み取ります。
SendQL
誰を正確に意味するかを記述する
SendQLは、連絡先属性と並んで、イベントをファーストクラスのソースとして読み取ります。これは、事前計算されたロールアップしか見ず、生のストリームを見ないエンジンが残したギャップです。
属性とリスト
演算子、[...]セット、contains / starts with / ends with、およびリストまたはセグメントメンバーシップを使用して連絡先データを照合します。
イベントをファーストクラスのソースとして
事前計算されたエンゲージメントロールアップだけでなく、生のイベントストリームを直接クエリします(count、exists、sum、avg、last、first)。
同意と抑制
配信ルールをインラインで表現します:「トピック」に購読済み、「トピック」からオプトアウト済み、すべてから購読解除済み、抑制されていない。
ウィンドウと最近性
within 30dまたは2つの日付の間で任意のイベントソースに時間ウィンドウをバインドし、now - 14dで最近性について推論します。
SendQL
segments.sendql
// 意欲の高いトライアルユーザーで、メール送信も安全。
attr.plan = "trial"
// 3〜14日前にサインアップ
and now - attr.signup_date between 3d and 14d
// 既に送信したメールにエンゲージした
and count(open within 14d) >= 1
and exists(click where url contains "/pricing" within 7d)
// 製品を使用しているが、購入していない
and count(activity.login within 7d) >= 2
and not exists(activity.order)
// オプトイン済みで、抑制されていない
and subscribed to "product-updates"
and not suppressed
SendFlow
cart-abandonment.flow
workflow "Cart abandonment" v1 {
enter on activity.cart_updated where not exists(activity.order within 1h)
exit "purchased" when exists(activity.order)
reentry per occurrence
wait 1h
hold out 10%
send "cart-reminder" via topic "marketing"
repeat up to 2 every 24h until exists(activity.order) {
send "cart-nudge" via topic "marketing"
}
}
同じファイルがキャンバスとしてレンダリングされる
-
Entercart_updated
-
Wait1 hour
-
Sendcart-reminder
-
repeat up to 2 · every 24h · until order
Sendcart-nudge
-
Exitpurchased
SendFlow
構造、gotoなし
ワークフローは上から下に読み取られ、フローチャートに損失なくマッピングされます。シーケンス、待機、分岐、重み付け分割、および1つのバウンドされた繰り返しです。gotoや無制限ループはありません。
1つのトリガー、複数の終了点
セグメント、アクティビティ、メールイベント、または連絡先自身の期日前の期間で入力します。名前付き終了点は、発生した瞬間にコンバージョンを報告します。
時間指定ステップ
wait 2d、期日または属性まで待機、またはタイムアウトアーム付きで条件まで最大7日間待機します。
分岐、分割、保留
フォールスルーif / else if / else、合計100%になる重み付け分割({ 30%: ... 70%: ... })、および10%の保留。
バウンドされたループのみ
単一のループはrepeat up to N every duration until a conditionです。gotoや無制限ループは決してありません。
どのようにフィットするか
SendFlowはSendQLを話す
セグメントを定義するために書く述語は、ワークフロー内のすべての条件を駆動するのと同じ構文です。
A SendQL segment
SendQL
engaged.sendql
count(open within 14d) >= 1
ワークフロー内の同じ述語
SendFlow
winback.flow
workflow "Winback" v1 {
enter on segment "inactive-90d"
exit "reactivated" when count(open within 14d) >= 1
send "we-miss-you" via topic "marketing"
wait up to 5d until exists(click within 5d) {
timeout: send "last-call" via topic "marketing"
}
}
- 厳密なスーパーセット
- 1つの共有トークンストリーム
- 1つの型チェッカーと診断
Design
設定ではなく、言語のように構築
両言語はプロファイル番号でバージョン管理され、実行エンジンからクリーンに分割され、機械チェック可能な文法まで指定されています。
設計による構造化
シーケンス、分岐、バウンドされた繰り返し、時間指定待機、名前付き終了点—フローチャートに損失なくマッピングされる制御フローサブセット。
イベントをファーストクラスとして
生のイベントストリームの選択は、連絡先属性と並んで配置されるため、状態だけでなく行動に基づいてセグメント化できます。
ゴールデンピン留めされた文法
正規のEBNFはパーサーから生成され、テストによってピン留めされるため、仕様がコードから静かに逸脱することはありません。
正確な診断
パースと型チェックは別々のステージであり、すべてのエラーには正確なトークンを指す行と列が含まれます。
標準フォーマッタ
SendFlowは、ワークフローのgofmtである「唯一の」レイアウトプリンターを提供するため、リポジトリ内のすべてのワークフローが同じように読み取られます。
キャンバス、損失なく
制御フローは十分に制限されているため、ワークフローはフローチャートに損失なくマッピングされ、元に戻すことができます(コメントを含む)。テキストとキャンバスは、1つのものの2つのビューです。
Documentation
言語全体を書き留める
両言語のすべての構成要素、生成可能なすべての診断、およびパーサー自体から生成された正規の文法—仕様がコードから静かに逸脱することはありません。