200人を見つけてメールを送る
販売先の決定から実行中のキャンペーンまで。約200人に絞り込み、個別の一文を入れたメールを書き、メールボックスを選んで、了承を得てから開始します。
このガイドの所要時間は約15分です。検索は無料です。人物の追加には、メールがチェックに通過した人1人につき1クレジットかかるため、約200クレジットが必要です。メールの送信自体はプランに含まれています。
APIキー、プランまたは十分なクレジット、そして接続済みのメールボックスが1つ以上必要です。メールボックスはGET /api/v1/inboxesで確認できます。メールボックスがまだない場合は、Google Workspaceを1ステップで接続するか、アプリでMicrosoft 365を接続するか、その他のプロバイダーのメールボックスを接続するか、POST /api/v1/inboxes/quoteで新しいメールボックスを注文してください。
販売先を決める
役職、業界、国、企業規模を選びます。無料の語句リストを使って正確な名称を取得します。
curl -G "https://app.argorant.com/api/v1/lookups/industries" -H "Authorization: Bearer $ARGORANT_API_KEY" --data-urlencode "q=logistics"件数を約200まで絞り込む
curl -G "https://app.argorant.com/api/v1/people/count" -H "Authorization: Bearer $ARGORANT_API_KEY" \
--data-urlencode "title=Head of Operations,COO" --data-urlencode "industries=Truck Transportation" \
--data-urlencode "country=Netherlands" --data-urlencode "employee_range=51-200"
# {"count": 214}多すぎる場合は、都市、役職レベル、より小さな企業規模を追加します。少なすぎる場合は、役職や国を追加します。件数の確認は無料なので、何度でも試せます。
1ページ分を確認する
curl -G "https://app.argorant.com/api/v1/people/search" -H "Authorization: Bearer $ARGORANT_API_KEY" \
--data-urlencode "title=Head of Operations,COO" --data-urlencode "industries=Truck Transportation" \
--data-urlencode "country=Netherlands" --data-urlencode "employee_range=51-200"役職と企業が合っていれば次に進みます。合っていなければ、フィルターを変えてもう一度件数を確認します。
リストとして保存する
curl -X POST "https://app.argorant.com/api/v1/lists" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: ops-nl-list" -H "Content-Type: application/json" \
-d '{"name":"Ops leaders NL trucking","filters":{"title":"Head of Operations,COO","industries":"Truck Transportation","country":"Netherlands","employee_range":"51-200"}}'list_idを控えておきます。リストには数秒で人物が追加されます。
キャンペーンを作成する
curl -X POST "https://app.argorant.com/api/v1/campaigns" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: ops-nl-campaign" -H "Content-Type: application/json" \
-d '{"name":"NL trucking ops Q4","daily_limit":40,"timezone":"Europe/Amsterdam","window_start":"08:30","window_end":"16:30"}'キャンペーンは下書きの状態です。新しいキャンペーンは平日にプレーンテキストで送信し、include_unsubscribeをtrueに設定しない限り、配信停止の行は入りません。
メールを書く
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/emails" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: ops-nl-emails-1" -H "Content-Type: application/json" \
-d '{"emails":[
{"subject":"Planning at {{company_normalized}}","body":"Hi {{first_name}},\n\n{{custom_opener}}\n\nWe help trucking firms cut empty miles. Worth a short call next week?\n\nBest, Maria"},
{"body":"Hi {{first_name}}, just bringing this back up. Happy to send a two-minute video instead.","delay_days":3}
]}'{{company_normalized}}は、普段呼ばれている企業名です。{{custom_opener}}は人ごとの個別の一文で、次のステップで設定します。[link]のような残ったままのテキストはwarningsで返され、それがなくなるまでキャンペーンは開始できません。
個別の一文を追加する(任意)
誰に対しても自然に読める代替の文を指定して、一文を一度設定します。
curl -X PUT "https://app.argorant.com/api/v1/campaigns/$ID/personalization" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"variables":[{"name":"opener","instruction":"One sentence about something recent at their company.","fallback":"Hope the busy season treats you well."}]}'そのあと、GET .../personalizationは、まだ代替の文が使われている人物を、その企業に関する情報とともに一覧表示します。PATCH .../leads/custom-fieldsは、あなたやエージェントが書いた一文を、1回の呼び出しで最大5,000件保存します。すでに一文がある人物は、"overwrite": trueを送らない限りそのまま残るため、2回目の実行で誤って置き換えることはありません。指示は最大4,000文字、各一文は20〜300文字です(max_length、既定は150)。すべての上限は個別の一文を書くを参照してください。
人物を追加する
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/leads" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Idempotency-Key: ops-nl-leads" -H "Content-Type: application/json" \
-d '{"list_id": 312}'最初の応答は質問になる場合があります(needs_choice: true)。確認済みのアドレスがいくつあり、すべてのアドレスを受け付けるドメインのアドレスがいくつあるかが示されます。ユーザーに確認してから、"grades": ["valid"](推奨)または["valid", "catch_all"]を付けて再度呼び出します。新しく追加する人物1人につき1クレジットかかります。メールがチェックに通過しなかった人物は追加されず、料金もかかりません。
メールボックスを選ぶ
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/senders" -H "Authorization: Bearer $ARGORANT_API_KEY" \
-H "Content-Type: application/json" -d '{"all_connected": true}'了承を得てから開始する
curl "https://app.argorant.com/api/v1/campaigns/$ID" -H "Authorization: Bearer $ARGORANT_API_KEY"メール、人数、メールボックスをユーザーに見せます。launch_blockersは空である必要があります。そのうえで、ユーザーが了承した場合にのみ次を実行します。
curl -X POST "https://app.argorant.com/api/v1/campaigns/$ID/launch" -H "Authorization: Bearer $ARGORANT_API_KEY" -H "Idempotency-Key: ops-nl-launch"返信は受信トレイに届きます。返信を読み、同じスレッドで返答し、パイプラインを追跡する方法は返信に対応するで説明しています。GET /api/v1/campaigns/$ID/analyticsは日ごとの数値を返します。