Activepieces 連携

Activepieces のフロー内で Asyntai アシスタントを使う

有料プランが必要： Activepieces 連携は Starter、Standard、Pro プランで利用できます。料金を見る

概要

Activepieces はオープンソースの自動化ツールです。Asyntai のピースが顧客のメッセージをアシスタントに送り、回答を返します。その回答はフローのどこへでも送れます。メール返信、Slack メッセージ、ヘルプデスクのチケット、データベースの行などです。

利用できるアクション

Asyntai のピースには 2 つのアクションがあります:

アシスタントに質問 - 顧客のメッセージを 1 つのアシスタントに送り、回答を返します
カスタム API 呼び出し - 同じ接続で Asyntai API の任意のエンドポイントを呼び出します

注記: ピースは npm からインストールします。自社運用の Activepieces、または Activepieces Cloud のプラットフォーム管理者権限が必要です。

インストール方法

次の手順で Asyntai を Activepieces に接続します:

APIキーを取得する

API 設定ページを開き、キーを作成します:

https://asyntai.com/settings/api/

キーをコピーし、安全に保管してください。このキーを持つ人は誰でも API 経由で Asyntai アカウントにアクセスできます。

Asyntai ピースをインストールする

Activepieces で Settings、次に My Pieces、次に Install Piece を開きます。次のパッケージ名を入力します:

@asyntai/piece-asyntai

アカウントをつなぐ

フローに Asyntai のステップを追加します。新しい接続を作成し、API キーを貼り付けます。Activepieces はキーをすぐに確認し、誤っていればエラーを表示します。

フローを組み立てる

フローは 2 つの部分でできています:

トリガー: Activepieces の任意のトリガー。新着メール、フォーム入力、Webhook など
アクション: Asyntai - アシスタントに質問

トリガーから Asyntai のアクションへ、顧客のメッセージと固定の会話 ID を渡します。

回答を返す

回答を届けるステップをもう 1 つ追加します。Gmail、Slack、ヘルプデスク、SMS サービスなどです。返信本文には Asyntai ステップの answer フィールドを使います。

テストして公開する

実際の顧客の質問でテストします。回答を確認してからフローを公開します。

アシスタントに質問の入力

Assistant Website（必須）- 回答するアシスタント。一覧はアカウントから読み込まれます。
Customer Message（必須）- アシスタントが答えるテキスト。
Conversation ID（必須）- この顧客またはスレッドの固定値。メールアドレスやチケット番号など。
Source Channel（必須）- メッセージの届いた場所。メールのチャネルはアシスタントにメール向けの指示を追加します。

アシスタントに質問の出力

answer - アシスタントの回答。
conversation_id - 回答が属するスレッド。
ai_disclosure - AI の開示文。顧客に表示してください。
success - 呼び出しが成功したかどうか。

ヒント: Asyntai ダッシュボードで指示、よくある質問、ナレッジベースの内容を追加すると回答が良くなります。

会話履歴

Asyntai は送信された会話 ID で履歴を保持します。同じ顧客には同じ値を使うと、アシスタントは前のメッセージを覚えています。新しい値を使うと新しいスレッドが始まります。

呼び出しごとに履歴へメッセージが 1 件追加されるため、再実行すると重複エントリができます。再試行を設定するときは注意してください。

活用例

メール対応: 新着メールが届くとアシスタントが回答を作成し、Gmail が送信します
Slack ヘルプデスク: Slack チャンネルの質問に同じスレッドで回答します
フォーム返信: 問い合わせフォームの送信で数秒以内にメール返信を送ります
チケットの仕分け: 単純なチケットはアシスタントが答え、残りは担当者に回します
SMS 回答: SMS サービスをつなぎ、顧客の電話に回答します

ソースコード

このピースは MIT ライセンスのオープンソースです。npm でのパッケージ名は次のとおりです: