HN 日本語サマリー

← 一覧へ戻る
Web開発

SendLang: Eメール自動化のためのDSL

SendLang: A DSL for Email Automation (sendlang.com)

9 pointsby ksajadi2 コメント

要約

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"
  }
}

同じファイルがキャンバスとしてレンダリングされる

  1. Entercart_updated

  2. Wait1 hour

  3. Sendcart-reminder

  4. repeat up to 2 · every 24h · until order

    Sendcart-nudge

  5. 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

言語全体を書き留める

両言語のすべての構成要素、生成可能なすべての診断、およびパーサー自体から生成された正規の文法—仕様がコードから静かに逸脱することはありません。