ActiveCampaignと​Qualisendを​連携する

• Qualisendのアカウント。お持ちでない場合はこちらから作成できます。
• 連携に必要な、Qualisendワークスペースでのオーナーまたは管理者の権限。連携後は、編集者もクリーニングを実行できます。
• Settings → Developerにアクセスでき、コンタクトとカスタムフィールドを編集できるActiveCampaignのユーザー。QualisendはこのユーザーのAPIキーを使って動作します。
• 検証したいコンタクトの数に足りるクレジット。

Tag contacts with resultsを選ぶと、Qualisendは検証した各コンタクトの5つのカスタムフィールドに書き込みます。フィールドは結果が初めて保存されるときに作成され、すべてのリストで使えるようになります。新しい結果は前回の結果を上書きします。

各ステータスの意味はステータスの説明をご覧ください。

ActiveCampaignでフィールドを活用する

問題のあるアドレスをキャンペーンから外すには、Qualisend Statusがundeliverableのコンタクトを除外するセグメントを作成します。riskyのコンタクトへの送信も控えたい場合は、条件に追加してください。結果ごとの対処法では、ステータスと主なフラグごとに推奨される対応を紹介しています。絞り込みにはScoreではなくStatusを使ってください。Scoreはテキストとして保存されるため、「より大きい」「より小さい」の比較は正しく機能しない場合があります。

ActiveCampaignは、新しいコンタクトをWebhookでQualisendに1件ずつ送れます。Qualisendはそのアドレスを検証し、同じ5つのフィールドに保存します。Webhookの追加はActiveCampaign側で行ってください。Qualisendが自動で作成することはありません。

自社でホストしているフォームの場合は、検証API（英語）をご覧ください。

• 検証リクエストが届き始めると、カードにActiveと最後の検証の時刻が表示されます。
• 配信不可や使い捨てアドレスのようにすぐ判定できる結果は、通常1分以内にActiveCampaignに反映されます。それ以外は、先にメールボックスを実際に確認する必要があります。15分たっても終わらない検証はunknownとして保存されます。
• ActiveCampaignが2分以内に同じアドレスを2回送ってきた場合、検証は1回だけです。ActiveCampaignは同じWebhookを複数回送ることがあります。
• ActiveCampaignはコンタクトの情報をすべてWebhookに送りますが、Qualisendが使うのはメールアドレスだけです。
• 検証1回につき1クレジットを使い、unknownの場合は返却されます。クレジットがなくなるとカードにPaused - out of creditsと表示され、チャージするまで新しいコンタクトは検証されません。その間に追加されたコンタクトは後から検証されないため、該当するリストをクリーニングしてください。

リストまたはすべてのコンタクトを定期的にクリーニングするには、Verify & cleanをクリックする前に、RepeatをAuto-clean every 7 days、Auto-clean every 14 days、Auto-clean every 30 daysのいずれかに設定します。そのクリーニングはすぐに実行され、次回は選んだ間隔の後に実行されます。件数の多い対象では、自動クリーニングのたびに同じ先頭1,500件が再検証されます。

設定したスケジュールは、ActiveCampaignページのScheduled auto-cleansに、次回の実行日と前回の実行結果とともに表示されます。

• Last run: clean：実行されました。
• Last run: no contacts：リストが空でした。
• Last run: error：クレジット不足などの理由で実行できませんでした。
• Skipped - reconnect ActiveCampaign：予定の時点でActiveCampaignの連携が解除されていました。

Cancelでスケジュールを停止できます。自動クリーニングも通常どおりクレジットを消費します。

• クリーニングは、重複を除いたアドレス1件につき1クレジットです。同じ実行内の重複は1件と数えます。
• 実行全体に必要なクレジットは、開始時に確保されます。残高が足りない場合、クリーニングは開始されません。
• unknownの結果はクレジットが返却され、クリーニングを停止すると未使用分のクレジットが戻ります。Verify & export a clean listでも、クレジットの扱いは同じです。
• 自動クリーニングを含め、1回の実行で検証されるのは、選んだリスト（またはAll contacts）の先頭1,500件で、毎回同じコンタクトです。対象がそれより多いかどうかは、What to cleanの下の件数でわかります。それ以上を検証するには、1,500件以下のリストに分けてそれぞれクリーニングするか、CSVを使ったクリーニング（英語）を利用してください。
• 選択欄には最初の100件のリストが表示されます。
• クレジットとプランについては料金ページをご覧ください。

QualisendのActiveCampaignページでDisconnectをクリックします。確認画面はなく、すぐに反映されます。連携を解除できるのはオーナーと管理者だけです。

今後使わない場合は、先に自動クリーニングをキャンセルしてください。連携を解除している間は表示されなくなります。

連携を解除した後：

• QualisendはAPIキーとAPI URLを削除します。
• Qualisendのフィールドとその値は、ActiveCampaignに残ります。
• WebhookはActiveCampaignに残りますが、そこから送られるデータをQualisendは受け付けません。Settings → DeveloperのManage Webhooksから削除してください。
• 過去の結果はQualisendのワークスペースに残ります。

後で再び連携すると、既存のWebhookがまた使えるようになります。

ActiveCampaignでReset API Keyをクリックした場合は、連携を解除し、新しいキーで連携し直してください。Webhookはそのまま使えます。