DM Champ Docs

FluentCRM

対象読者: WordPressサイト上のFluentCRMでメールリストを管理しており、そこに会話を取り込みたいビジネス向けです。FluentCRMを使用していない場合は、このページをスキップしてください。

他のCRMやメールツールを使用していますか？APIを備えたツールであれば何でも接続可能です。リストにないツールの接続方法をご覧ください。

FluentCRMは、WordPress内で動作するCRMおよびメールマーケティングプラグインであり、連絡先、タグ、リスト、および送信するキャンペーンを管理します。DM Champに接続することで、オートメーションに書き込みステップを追加できます。これにより、新しいWhatsAppリードが適切なタグが付いたFluentCRMの連絡先として登録され、構築済みのメールシーケンスが自動的に引き継がれます。エクスポートやコピー＆ペースト、金曜日まで待つといった作業は不要です。

WordPressサイトに何もインストールする必要はありません。お客様自身のログイン情報を使用してサイトを接続し、FluentCRMがすでに公開しているAPIを呼び出します。

利用可能状況: オートメーションはすべてのアカウントで利用可能です。サイドバーにすでに表示されており、有効化やリクエストは不要です。

必要なもの

FluentCRMはWordPress REST APIを利用しているため、WordPress接続とまったく同じ詳細情報が必要です。

  • FluentCRMが動作しているWordPressサイト（https経由でアクセス可能、WordPress 5.6以降）。
  • Pretty permalinksが有効であること（設定 → パーマリンク設定で「基本」以外を選択）。これが/wp-json/アドレスを機能させるために必要です。
  • オートメーションを実行するWordPressユーザーのアプリケーションパスワード: ユーザー → プロフィール → アプリケーションパスワード → 新規追加から作成します。WordPressはパスワードをスペースで区切られたブロックとして一度だけ表示します。スペースを含めてコピーしてください。

そのユーザーには、WordPressでFluentCRMを管理する権限が必要です。実際のログインパスワードが使用されることはなく、後でアプリケーションパスワードを削除すれば、この接続のみを正確に取り消すことができます。

FluentCRMの接続

接続は、FluentCRMステップを初めて使用する際に、オートメーション内から行います。

  1. サイドバーのオートメーション（AI Studioグループ内）を開き、オートメーションを開くか作成します。
  2. ステップを追加し、ステップピッカーでFluentCRMを検索します。
  3. 実行したいアクションを選択します。ステップで最初に接続を求められます。
  4. 3つのフィールドに入力します。
    • サイトURLは、FluentCRMが動作しているWordPressサイトのアドレスで、https://で始まります。
    • WordPressユーザー名は、そのユーザーがサインインに使用するユーザー名であり、メールアドレスではありません。
    • アプリケーションパスワードは、上記で作成したパスワードをスペースを含めて貼り付けます。
  5. 接続をクリックします。

保存前に、FluentCRMから連絡先を1件読み出すことで、サイトに対して詳細情報を確認します。詳細が間違っている場合や、/wp-json/が解決できないサイトの場合は、画面上で理由とともに拒否されます。アプリケーションパスワードは暗号化されて保存され、二度と表示されることはありません。

タグとリストはIDで指定

構築前に知っておくべき唯一の点です。タグやリストを受け取るすべてのフィールドでは、名前ではなくID番号をカンマ区切りで指定する必要があります。1, 2は機能しますが、Newsletter, VIPは機能しません。

番号はFluentCRM内で確認できます。FluentCRMメニューのタグまたはリストを開くと、各行のIDがアドレスバーに表示されます。使用する予定のものをいくつか書き留めておけば完了です。

アクション

各アクションはオートメーションキャンバス上のステップであり、すべてのフィールドで、通常のデータ挿入ボタンを使用して前のステップからのデータを受け入れることができます。

コンタクトの作成または更新

コンタクトを追加するか、すでにそのメールアドレスを持つコンタクトを更新します。同じメールアドレスを2回送信しても失敗するのではなく更新されるため、事前に確認することなくすべての新しいリードに対してこれを実行できます。

  • Email はコンタクトのメールアドレスです。必須。通常はトリガーからのコンタクトのメールアドレスを指定します。
  • First name、Last name、Phone は任意です。
  • Status は subscribed、pending、unsubscribed、または bounced です。空のままにすると subscribed になります。
  • Tag IDs はコンタクトに付与するタグで、カンマ区切りで指定します。任意です。
  • List IDs はコンタクトを追加するリストで、カンマ区切りで指定します。任意です。

メールアドレスによるコンタクトの検索

メールアドレスでコンタクトを検索し、そのID、タグ、リストを返します。

  • Email は検索するアドレスです。必須。

その出力は、コンタクトIDに基づいて動作する以下のステップで必要となります。

コンタクトへのタグ追加

既存のコンタクトに1つ以上のタグを付与します。

  • Contact ID は対象のコンタクトです。必須。通常は、オートメーション内の前の「メールアドレスによるコンタクトの検索」ステップから取得します。
  • Email はコンタクトのメールアドレスです。FluentCRMは更新のたびにメールアドレスを要求するため、必須です。
  • Tag IDs は付与するタグで、カンマ区切りで指定します。必須。
  • Status は任意で、デフォルトは subscribed です。

コンタクトからのタグ削除

フィールドは同じですが、タグを付与するのではなく削除します。

コンタクトのリストへの追加

  • コンタクトID、メールアドレス、リストID（カンマ区切り）、および同様のオプションのステータス。

自動化の例

WhatsApp経由のすべての新規リードはFluentCRMに登録され、その流入元に基づいてタグ付けされます。

  1. トリガー: 新規コンタクトからのメッセージ受信。
  2. コンタクトの作成または更新: トリガーから取得したコンタクトのメールアドレス、名、電話番号、およびメインリストのリストIDを使用します。
  3. コンタクトへのタグ追加は、ここでは不要です。ステップ2で既にタグIDを付与できるためです。タグが会話の後半で付与される場合にこれを使用してください。

タグが後から付与される、より実用的なバージョンは以下の通りです：

  1. トリガー: AIエージェントによってコンタクトにタグ（例: asked about pricing）が追加された場合。
  2. メールアドレスによるコンタクトの検索: コンタクトのメールアドレスを使用します。
  3. コンタクトへのタグ追加: ステップ2のID、同じメールアドレス、および価格設定シーケンス用のFluentCRMタグIDを使用します。

FluentCRM独自の自動化機能により、そのタグをトリガーとするメールシーケンスが送信されます。会話はWhatsAppで行われ、ナーチャリングはメールで行われるため、手動でデータを移動させる必要はありません。

知っておくべきこと

  • コンタクトIDを必要とするステップは、検索ステップの後に配置します。 これが標準的な構成です。まずコンタクトを検索し、その検索ステップが返したIDに対してアクションを実行します。
  • 出力は後続のステップに引き継がれます。 アクションが返すデータはすべて、後のステップで変数として利用可能です。
  • タグやリストのフィールドには、名前ではなくIDを使用してください。 そのフィールドに名前を入力しても一致しません。
  • 一部のホスティング環境では、WordPressが認識する前にAuthorizationヘッダーが削除されることがあります。 これにより、正しいアプリケーションパスワードが無効と見なされる場合があります。詳細情報が正しいにもかかわらず接続が拒否される場合は、ホスティング会社に問い合わせてください。
  • FluentCRMを監視するトリガーはありません。 変更をポーリングする機能はありません。FluentCRMで自動化を開始するには、自動化にWebhookトリガーを追加し、そこで提供されるアドレスに対してFluentCRMの送信Webhookを設定してください。
  • 上記のリストにない操作でも、 HTTPリクエストステップを使用すれば実行可能です。

次のステップ

  • 自動化: トリガー、ステップ、条件、およびワークフローの構築方法。
  • WordPress: 同じサイト上の投稿とユーザー（同じ接続詳細を使用）。
  • MemberPress: WordPressサイト上のメンバーシップと支払い。
  • リストにないツールの接続: カスタム関数、API、およびWebhook。