シーケンシング

AI による 1 回の通話は 1 回の接点です。シーケンスは、その周囲にあるフォローアップ施策全体を指します。電話をかけ、応答がなければ 1 時間待って再試行し、応答があればリンクを SMS で送る、といった流れです。この計画をキャンバス上で一度描いておけば、エンジンが各連絡先に対して実行し、各ステップの結果を引き継いで処理を進めます。

要約: Finn は 1 回の会話です。シーケンスは時間をまたぐ複数のステップ、つまり通話 → 待機 → 結果による分岐 → 再試行または SMS 送信 → 繰り返し、です。エージェントの一段上のレイヤーにあたります。

シーケンスが必要になる場面

通話するだけならシーケンスは不要です。デプロイメントだけで実行できます。フォローアップのロジックが重要になったときにシーケンスを使います。

• 「電話をかける。応答がなければ 1 時間後に再試行。3 回試したら終了する。」
• 「応答があれば支払いリンクを SMS で送る。留守番電話につながったら翌日にもう一度かける。」
• 「通話 → 1 日待機 → 別のメッセージでもう一度通話。」

「このリストに 1 回ずつ電話する」だけならシーケンスは不要です。「何らかの結果が出るまで各リードにアプローチし続ける」ならシーケンスが適しています。

構成要素（ノード）

シーケンスは、キャンバスにノードをドラッグして相互に接続することで作成します。

Voice ステップの後、シーケンスは結果を保持するため、Condition でその結果に基づいて分岐できます。

• call_answered → true / false
• call_outcome → answered, no_answer, voicemail, failed, …
• call_voicemail → true / false

最初のケイデンスを作成する

定番の流れを作ってみましょう。借り手に電話し、応答がなければ待って再試行、応答があれば支払いリンクを SMS で送る。

1. サイドバーの Sequences →新しいシーケンスを選択します。
2. Start → Voice → Condition をドラッグし、Condition から 2 つの経路を伸ばします。
3. Voice ノード → Finn を選び、アウトバウンドに設定します。
4. Condition ノード → 2 つの分岐を追加します。
   • 応答あり → 条件: call_answered が true。
   • 応答なし → こちらを Default（フォールバック）に設定します。
5. 応答あり → SMS を接続します。
   • 宛先: {contact_phone}
   • メッセージ: Hi {contact_name}, here's your payment link: …
6. 応答なし → 待機（1時間） → 音声（再試行） → 終了 をつなぎます。
7. SMS → 終了 をつなぎます。

グラフに問題がなければ、シーケンスを ライブ に切り替えます。不足がある状態では公開できず、エディタが問題点を具体的に示します。

実行する

シーケンスを開き、実行 → ライブ実行 を選択します。連絡先を1行に1件ずつ入力します:

9876543210
Jane Doe,9876543210
Jane Doe,9876543210,91
+14155551234

（name,phone,countryCode — 数字の部分が電話番号です。）連絡先ごとに個別の ラン が開始されます。履歴 タブですべてのランをリアルタイムに確認できます:

• running — ステップを進行中
• waiting — 通話結果または待機タイマーで一時停止中
• completed — 最後まで到達
• failed — フォールバック未設定のステップでエラー発生

注意: ライブ実行 は 実際の発信とSMS送信 を行います。通話ごとに課金され、事前にウォレット残高が確認されます。何も送信せずに動作を確認するには パスをプレビュー ボタンを使用してください。

タイミングの仕組み

• 音声 ステップは通話終了まで実行を waiting にし、終了後に次の条件で使う call_* の値を設定します。
• 待機 ステップはタイマー終了の直後に再開します（約30秒ごとに確認するため、分・時間単位の精度であり、秒単位ではありません）。
• ランは 永続的 です。再起動後も維持され、二重実行もないため、「2日待機」のステップも安全です。

ヒントと制限

• 現時点では、シーケンスごとに 開始点は1つ です。
• SMS送信 にはアカウントに電話番号が必要です。ない場合、SMSステップはスキップされます（エラーパスを設定していればそちらに進みます）。
• SMS送信の失敗はケイデンスを停止しません（デフォルト）。通話フローはそのまま継続します。
• 1ラン = 1連絡先。500件の連絡先なら、それぞれ独立した500のランが個別のタイムラインで動きます。

未対応の機能

キャンバス上には、WhatsApp、API呼び出し、カスタム関数、ループ、並列分岐、カレンダーやCRMのステップなど、他のノードタイプも表示される場合があります。これらは今後対応予定です。現時点では 音声、待機、条件、SMS のみを使用してください。未対応のノードを含むシーケンスをライブにしようとすると、削除すべきノードが表示されます。

まずはシンプルに。1回の発信、1回の再試行、1通のSMS。それだけでも、未対応のリストが対応済みのリストに変わります。