あらゆるものとの接続
HTTPで入り、HTTPで出、面倒な部分は処理済み
どの自動化ツールも連携数を謳っています。その数は常に大きく、そして常に的外れな問いです。本当に必要なシステムは、2014年に退職した誰かが社内で作ったものだからです。重要なのは、そのすべての土台にあるプロトコルをツールがどれだけうまく扱えるかです。
用意された接続
多くの企業が基盤とするアプリケーションには、準備済みのステップがあります。ショップとマーケットプレイス、会計と請求、スプレッドシートとデータベース、カレンダーとメール、ストレージとメッセージング、CRMとヘルプデスク、決済プロバイダと配送業者。アカウントを一度認証すれば、フィールドにはそのアプリケーションが使う言語で名前が付いており、JSONの言語ではありません。
アプリケーションにポーランド市場特有の事情がある場合 — KSeF対応が必須の請求システム、ラベルが国の規格になっている配送業者など — 準備済みのステップはそれに対応しています。ファミリーはその市場に販売しており、学ぶ必要があったからです。
そして汎用のケース
それ以外はすべてHTTPステップですが、ここのHTTPステップは慰めの代用品ではありません。準備済みの接続と同じ仕組みの上に成り立っており、自分で書くには面倒な部分も同じように処理されます。
面倒な部分
処理済み。もう一度書く必要はありません
認証
APIキー、ベアラートークン、Basic認証、リフレッシュ付きOAuth 2、HMACリクエスト署名、相互TLS。認証情報は一度保存し、名前で参照され、ログや実行記録に出力されることはありません。
ページネーション
カーソル、ページ番号、オフセット、Linkヘッダー、そして空の配列を返すことで終端を知らせるAPI。形式を指定すれば、ステップが全件をたどります。
レート制限
接続ごとの上限であり、それを使うすべてのワークフローで守られます。プロバイダが Retry-After 付きの 429 を返した場合、ステップは要求を連打せずにその時間待機します。
リトライとバックオフ
一時的な障害は、間隔を徐々に広げながら上限付きでリトライされます。ステップは入力に対する純粋な関数なので、リトライではワークフロー全体ではなくそのステップだけが再実行されます。
扱いにくいペイロード
JSON、フォームエンコード、XML、プレーンテキスト、マルチパートアップロードに対応。レスポンスは、4階層の深さにネストされたものを含め、名前で参照できるフィールドに解析されます。
タイムアウト
ステップごとの制限時間を設定できるため、1つの遅い依存先がワーカーを占有し、その後ろの処理が待ち行列に溜まることはありません。制限時間に達した場合の挙動は、ステップごとにお客様が決定できます。
HTTPを話せるシステムなら、会話はすでに始まっています。
真面目に作られた受信Webhook
すべてのワークフローには、実行を開始するURLを持たせられます。そのURLは署名を検証します。一般的なプロバイダが使う形式のHMACに対応し、署名として共有シークレットしか用意できない送信元にも対応します。署名を期待するワークフローへの署名なしリクエストは、黙って処理されるのではなく、拒否され記録されます。
重複排除はペイロード自体の識別子に基づいて行われるため、お客様の 200 を時間内に受信できずに再送した送信元にも、3回ではなく1回だけ実行されます。不正な形式のペイロードは、拒否された理由とともに保持されます。自動化に原因不明の抜けが生じる最も多い原因は、送信元があるフィールドの扱いを勝手に変えたことだからです。
CSVしか話せないシステム
そうしたシステムは実在します。午前4時にSFTPサーバにファイルが現れる、添付ファイルとして届く、共有フォルダに置かれる。ワークフローはそれを監視し、読み取り、各行を1件のレコードとして扱えます。バイトオーダーマーク付き、セミコロン区切り、ヘッダ行がポーランド語のファイルも含めてです。それが実際のエクスポートの姿だからです。
逆方向も機能します。ワークフローはファイルを組み立て、相手のシステムが期待する場所に置けます。2006年製のソフトウェアにとって、それがしばしば唯一のインターフェースなのです。
- ⚡トリガーサプライヤーのSFTPに新規ファイル:
stock-2026-09-09.csv。 - 2解析セミコロン区切り、バイトオーダーマーク、ポーランド語ヘッダ。4,118行。
- 3正規化通貨コードを参照データと照合。2件を無効として除外。
- 4プッシュHTTP
PATCHを200件ずつのバッチで送信。レート制限を遵守。 - !例外2行を担当者宛てにファイルし、行番号と理由を記録。残りの4,116行は正常に処理されました。
モデルを呼び出したステップ数: 0この実行のコスト: なし
認証情報の保管場所
暗号化され、名前で参照され、所有するワークスペースにスコープされ、実行ログ・エラーメッセージ・サポート対応のやり取りに決して表示されません。実行記録には、ステップが supplier-sftp として認証したことだけが示され、supplier-sftp が何であるかは示されません。
30社のクライアントに1つのワークフローを提供する代理店は、クライアントごとに独立した認証情報セットを持ち、ワークフローはシークレットではなくセットを参照します。鍵のローテーションは1か所の編集だけ。 これこそが代理店が当社を選ぶ最大の理由です。
知っておくべき限界: まったくインターフェースを持たないシステム、つまりAPIもWebhookもファイル受渡しもなく、人がブラウザでクリックするしかないものは、当社でも他の誠実な手段でも自動化できません。ここにユーザーを装うヘッドレスブラウザはないのです。相手側がボタンを動かした途端に静かに壊れるからです。