Your AI Connector Docs

FluentCRM

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

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

FluentCRMは、WordPress内で動作するCRMおよびメールマーケティングプラグインであり、連絡先、タグ、リスト、および送信するキャンペーンを管理します。Your AI Connectorに接続することで、オートメーションに書き込みステップを追加できます。これにより、新しい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は機能せず、エディタ上でフィールドにフラグが立てられます。（以前のステップから取得したものなど）自動化の実行時にのみ誤りであることが判明したIDは、タグなしで静かに実行されるのではなく、エラーでステップを停止させます。

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

アクション

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

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

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

  • Emailは連絡先のメールアドレスです。必須です。通常はトリガーからの連絡先のメールアドレスを使用します。
  • First name（名）、Last name（姓）、Phone（電話番号）は任意です。
  • Status（ステータス）は、Subscribed（購読中）、Pending（保留中）、Unsubscribed（購読解除）、Transactional（トランザクション）のリストから選択します。FluentCRMで必須であり、既存の連絡先にも適用されるため注意が必要です。Subscribedを選択すると、購読解除したユーザーが再購読されます。そのため、本人が参加を希望した場合にのみ選択してください。Pendingを選択すると、FluentCRMのダブルオプトインメールが送信されます。
  • Tag IDsは付与するタグで、カンマ区切りで指定します。任意です。
  • List IDsは追加するリストで、カンマ区切りで指定します。任意です。

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

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

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

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

コンタクトへのタグ追加

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

  • Contact IDは対象の連絡先です。必須です。通常は自動化の前のステップであるFind contact by email（メールアドレスで連絡先を検索）から取得します。
  • Emailは連絡先のメールアドレスです。FluentCRMが更新のたびにメールアドレスを要求するため、必須です。
  • Tag IDsは付与するタグで、カンマ区切りで指定します。必須です。
  • Change status（ステータスの変更）は任意です。Keep current status（現在のステータスを維持）のままにすると、連絡先のステータスは変更されません。そのため、購読解除したユーザーにタグを付けても、自動的に再購読されることはありません。

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

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

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

  • Contact ID、Email、List IDs（カンマ区切り）に加え、同様のChange status（ステータスの変更）オプションがあります。

自動化の例

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

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

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

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

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

知っておくべきこと

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

次のステップ

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