
# FluentCRM

> **対象読者:** WordPressサイト上のFluentCRMでメールリストを管理しており、そこに会話を取り込みたいビジネス向けです。FluentCRMを使用していない場合は、このページをスキップしてください。
>
> 他のCRMやメールツールを使用していますか？APIを備えたツールであれば何でも接続可能です。[リストにないツールの接続方法](connecting-other-tools.md)をご覧ください。

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

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

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

---

## 必要なもの

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

- **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リクエスト**ステップを使用すれば実行可能です。

---

## 次のステップ

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