個人の携帯に頼らずに Craigslist の電話認証を処理する

Craigslist への投稿ワークフローが電話確認で止まり続けるのはなぜか？

不動産管理会社、小規模な採用担当、地域のサービス業は、共有の会社ログインで Craigslist に投稿することがよくあります。いずれサイトが電話番号を求め、キーボードの前にいる人が自分の携帯番号を入力します。数か月後、その人は退職しているのにアカウントは本人の番号に紐づいたままで、次の認証プロンプトはもう会社にいない人に届いてしまいます。

複数のクライアントの出品を管理するエージェンシーも同じことを大規模に経験し、クラシファイド周辺のツールを開発する QA チームは、プロンプトをエンドツーエンドで確認する再現可能な方法を必要とします。OTP Route は、そのどの状況にも、個人ではなくワークフローに属する番号と、チームが確認できる場所に届くコードを提供します。クライアント業務の一般的な進め方はエージェンシー向けのページで説明しています。

Craigslist は電話認証を何に使っているのか？

Craigslist は電話確認を不正利用対策として使っています。アカウント作成時、特定のカテゴリーや地域に投稿するとき、あるいはサイトが出品の背後にいる人物をもう一度確認したいときに表示されることがあります。プロンプトでは短いコードがテキストメッセージで送られ、操作を進める前にそれを入力し直す必要があります。

具体的なルールを決めるのは Craigslist で、変更もあるため、プロンプトが毎回表示されることを前提にしたテストは作らないでください。どちらの結果にも対応できるように設計します。

API で Craigslist の OTP を受信するには？

開発者コンソールで Bearer キー（プレフィックス or_live_）を作成し、https://otproute.com/api/v1 を呼び出します。サービス ID は craigslist です。

1. GET /api/v1/prices?country=<id>&service=craigslist で現在の価格を取得します。
2. POST /api/v1/activations に {"service": "craigslist", "country": "us"} を送って注文します。国 ID は必要なものに置き換えてください。
3. 返ってきた番号を Craigslist のプロンプトに入力し、選択肢が表示された場合はテキストメッセージを選びます。
4. リスナーが activation.sms_received を受け取った時点でコードを取得するか、小さなスクリプトで GET /api/v1/activations/{id} をステータスが変わるまで照会します。
5. 使わなくなった注文は POST /api/v1/activations/{id}/cancel でキャンセルします。

Webhook を使う場合は、エンドポイントのシークレットでタイムスタンプ、ドット、生の本文に対する HMAC-SHA256 を計算して X-OTPRoute-Signature を検証し、古いタイムスタンプは拒否してください。再配信されても問題が起きないよう、結果はアクティベーション ID をキーにして書き込みます。1 回限りのスクリプトにはポーリング、並列で動くものには Webhook が向いています。リクエストの詳細はドキュメントにあります。

Craigslist の電話番号はどの国のものにすべきか？

craigslist のルートは 197 か国で利用できます。Craigslist 自体は北米で最も活発なため、多くのチームは米国またはカナダを選びますが、リストには英国、メキシコ、オーストラリア、フィリピンのほか、ドイツ、スペイン、インド、日本、ブラジル、オランダなど、さらに多くの国があります。

アカウントが実際に活動している市場に合わせた番号を選んでください。トロントの賃貸アカウントを別の大陸の番号で認証すると、Craigslist に不一致として気づかれる可能性があり、カナダ向けオンボーディングフローのテストも、カナダの番号でなければ意味がありません。すべてのルートは国のページで確認できます。

技術に詳しくないメンバーもダッシュボードからコードを取得できるか？

はい。サインインして OTP Gateway を開き、サービスに Craigslist、必要な国を選んで、表示された価格を確認します。番号を Craigslist のプロンプトにコピーしてテキストを要求すると、アクティベーションカードにコードが表示されます。各番号で行える認証は 1 回です。

Craigslist のコードが届かなかったのはなぜか？

Craigslist は受け付ける番号に厳しいことがあり、仮想番号を完全に拒否する場合もあります。その場合、SMS は送信されず、アクティベーションはそのまま失効します。

• 20 分のウィンドウはそのまま走らせておきます。SMS が届かなければ、全額が自動的にウォレットに戻ります。
• 時間をおいて再試行するか、新しく注文して別の番号を使います。
• アカウントの市場に本当に合う場合にのみ、別の国を試します。
• 連続した注文でエンドポイントを叩き続けず、試行の間隔をあけます。

再認証が 1 回限りではなく定期的に発生する場合、一時的な番号は適切なツールではありません。

Craigslist アカウントには、どんなときに専用番号が適しているか？

同じビジネスアカウントが来月も再ログインする必要があるなら、引き続きご自身のものである番号が必要です。専用番号は、米国とカナダでその隙間を埋めます。月額 $1.95 からで、受信 SMS はダッシュボードに表示され、number.sms_received として Webhook に転送されます。ブラウザーからテキストの送信や通話も可能です。プリペイドの各期間はウォレット残高から更新され、Craigslist 用の回線が不要になれば、いつでも手放せます。詳細は仮想番号をご覧ください。

Craigslist を責任を持って使うとはどういうことか？

Craigslist の利用規約と投稿ルールに従ってください。アカウントは実在する個人または事業者 1 つにつき 1 つとし、本物の出品を投稿し、これらの番号をアカウントの増殖やブロックの回避に使ってはいけません。OTP Route は、ご自身のプロダクトのテストと正当なアカウントの運用のためのサービスであり、当社の利用規約（Acceptable Use Policy）が適用されます。Craigslist はその所有者の商標であり、当社は Craigslist と提携していません。

よくある質問

Craigslist の認証用に仮想番号を取得できますか？

OTP Gateway から注文できますが、Craigslist が仮想番号を拒否することがあります。コードが届かなければ、料金は返金されます。

テスト用の Craigslist SMS 認証にはいくらかかりますか？

1 コード $0.20 からで、国によって異なります。確定する前に、画面または価格の呼び出しで最新の Craigslist の価格を確認できます。

Craigslist の電話番号には、どの国が最適ですか？

アカウントやテストケースが対象とする国で、最も多いのは米国かカナダです。ルートは全体で 197 か国をカバーしています。

来週の Craigslist ログインに、同じ OTP Gateway の番号を再利用できますか？

いいえ。Gateway の番号で受け取れるコードは 1 件のみです。繰り返しのログインには、米国またはカナダの専用番号をご利用ください。

OTP Route は Craigslist の音声通話コードを受信できますか？

OTP Gateway は SMS を前提としています。Craigslist が選択肢を表示した場合は、テキストメッセージを選んでください。

お金をかけずに Craigslist 連携のコードをテストできますか？

開発用アカウントでサンドボックスモードを申請すると、エンドツーエンドのテスト用に模擬の番号とコードが得られます。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。