アーキテクチャ
連絡先向けサーバーレスワークフローを3段階で構築
設定手順
4ステップでPipedreamワークフローを設定
- 01
SendGridトリガーを設定する
新規連絡先の作成イベントを選び、Twilio SendGridを接続して、フローに適したポーリング間隔を設定します。
- 02
Email to Genderアクションを追加する
GenderAPIアクションを選び、APIキーを安全に接続して、SendGridから受け取ったメールアドレスを割り当てます。
- 03
SendGridの連絡先を更新する
更新アクションを追加し、結果と必要な名前、国、確率などのフィールドを割り当てます。
- 04
有効化前にテストする
実在する個人情報を含まないテスト連絡先を作成し、トリガーと各ステップの出力を確認してからワークフローを有効にします。
実行間隔とテスト
データ量と上限に合わせてポーリングを調整
連絡先数、Pipedreamの制限、利用可能なGenderAPIクレジットに応じて実行間隔を決めます。重複処理を防ぐためイベントIDまたは「処理済み」状態を使用してください。
セキュリティとエラー処理
secretをログへ出力しない
APIキーは接続済みアカウントまたはPipedreamのsecretへ保存します。statusとerrnoで恒久的なエラーを判別し、無制限の再試行を避けてください。
結果は統計的なシグナルです。probabilityを保持して品質基準を定め、個人に重大な影響を与える判断の唯一の基準にしないでください。
よくある質問
GenderAPIとPipedreamの連携
GenderAPIとPipedreamの連携で何ができますか？
Pipedreamイベントから受け取った名前、メールアドレス、ユーザー名をGenderAPIで分析し、構造化されたレスポンスを後続ステップへ渡せます。
この例ではどのサービスを接続しますか？
Twilio SendGridの新規連絡先トリガー、Email to Genderアクション、SendGridの連絡先更新を使用します。
ワークフローはリアルタイムで動作しますか？
遅延はPipedreamで設定したトリガーとポーリング間隔に依存します。有効化前に利用プランの最新制限を確認してください。
GenderAPIはメールアドレスの問い合わせを保存しますか？
いいえ。メールアドレスの問い合わせはレスポンス生成のためだけに処理され、記録されません。
APIキーを安全に管理するには？
接続済みアカウントまたはPipedreamのsecretへ保存してください。コード、ステップ出力、ログへ埋め込まないでください。
エラーはどのように処理しますか？
statusとerrnoで不正入力、クレジット不足、無効なキーを区別し、恒久的なエラーを修正せず再試行しないでください。