Botbird for Businessを利用し、ChatGPTと連携したチャットボットを制作することが可能です。

【事前準備】
Botbird for Businessのご登録がまだの方は、こちらからご登録またはお問い合わせ下さい。
https://botbirdbiz.com/

「OpenAI」のアカウント登録を行い、API KEYを取得して下さい。
ChatGPTの利用には、OpenAIのAPIを利用します。下記URLにてアカウント登録、APIキーの取得を行って下さい。
https://platform.openai.com/signup
https://platform.openai.com/account/api-keys

※料金は下記URLを御覧ください。（最初の３ヶ月無料枠有り）
https://openai.com/pricing

---

---

1. Botbird for businessにて、ChatGPT連携設定を行います

https://botbird.biz/member/bot_setting を開き、「CHATGPT連携設定」の欄内に、「OPENAI API KEY」を入力して下さい。またその下にこのChatGPTが回答をする際に参考となるボットの性格付けや言葉遣い、事前情報などを記載して[アップデート]を押してください。

2. 返信の定義を記載します

ChatGPTの返信を利用するには、{chatgpt:○○○○○○○○}という置き換えタグを利用します。

○○○○○○○○には、ChatGPTに渡すメッセージを記載下さい。下記の例では、チャットボット利用者が入力した文言をそのまま{message}という置き換えタグで渡し、返信を行う例です。

その他、日時曜日指定ボットや定期・ランダムボットでも「{chatgpt:挨拶して}」などと指定してメッセージ配信を行うことが可能です。

※ご注意下さい

ChatGPTの返信は必ずしも正確なものではなく、誤情報をチャットボット利用者様に与えてしまう可能性もございます。下記のような対応を検討されることを強くおすすめ致します。

・返信優先度を低くし、自作シナリオで答えられなかった場合に利用する。

・上記の例のように「【ChatGPTによる自動生成回答・不正確な場合があるのでご注意下さい】」などと必ず付記し、注意喚起を行う。

Botbird for Business 運営事務局です。
平素はサービスをご利用下さいまして、誠に有難うございます。

Twitter公式より、APIについて2023/2/9より有料化されるとの案内が出されました。
現在Botbird for Businessでは、「Twitterへのボット投稿（およびその設定）」において無料のTwitterAPIを利用しておりますので、何らかの影響が発生される可能性が想定されます。

Starting February 9, we will no longer support free access to the Twitter API, both v2 and v1.1. A paid basic tier will be available instead — Twitter Dev (@TwitterDev) February 2, 2023

有料化後の「Twitterへのボット投稿」機能をどのように継続可能するかは、Twitter社からの詳細案内を待ち、ご案内申し上げます。

なお、Twitterへのボット投稿をご利用されていない皆様への影響はございません。Twitter以外へのボット投稿や返信はこれまで通り機能継続致します。
今後とも、Botbird for Businessをよろしくお願い申し上げます。

Botbird for Businessを利用し、ZOOMアプリの「チャット」機能上でのチャットボットを制作することが可能です。（「ミーティング」中のチャット画面ではなく、常時社内等でコミュニケーションするための「チャット」画面です）

【事前準備】
Botbird for Businessのご登録がまだの方は、こちらからご登録またはお問い合わせ下さい。
https://botbirdbiz.com/
※Zoomのアカウント体系やAPI設定画面等の内容は随時更新追加が行われています。必ず公式ヘルプ・ドキュメントを参照しながら設定を行って下さい。恐れ入りますが、このページのヘルプ内容を利用して設定を行った場合に発生した損害等への保証は出来かねますので予めご了承下さい。

「ZOOM 有償プラン」の登録を行って下さい。※管理者のみで可能
ZOOMとBotbird for Businessの連携は、管理者が「ZOOM API」を利用して2種類の「App」設定を作成することによって行います。ZOOM APIを利用するためには管理者にZOOMの有償プランご登録が必要です。詳しくはこちらをご覧下さい。
https://zoom.us/pricing

ZOOMに、ボット利用者専用のグループを作成し、利用者ユーザーの登録を行って下さい。
ZOOMでのボット利用には、所定のグループに入っていることが必要となります。このチャットボットを利用して良いユーザーは、必ず所定のグループに参加させて下さい。

【設定時の注意事項】
各設定を行う場合、以下のページを同時に開きながら設定を行うとスムーズに設定することが出来ますのでご参考下さい。

・ZOOM App Market Place
https://marketplace.zoom.us/
・Botbird for Business
https://botbird.biz/member/login

---

---

1. Botbird for businessにて、Zoom用のWebhook URLを取得します

https://botbird.biz/member/bot_setting を開き、「Webhook URLの指定（Zoom Chatbot appに設定）」の欄内のURLをクリップボードやメモ帳等にコピーしておいてください。

2. Zoom App Marketplaceで「①Chatbotアプリ」を作成します

1）ZOOMのApp作成ページを開きます。

下記ページからログインして下さい。 https://marketplace.zoom.us/user/build

・Develop => Build App を選択します。

・スクロールし、「Chatbot」を選択して「Create」ボタンを押します。

・チャットボットの名前（例：chatbot app）を記載します。

・Developmentの下にある、Client IDと Client Secretをメモ帳等に保存して下さい。これが後に入力する「ZOOM Chatbot app Client ID」「ZOOM Chatbot app Client secret」となります。

・Redirect URL for OAuthに、特に指定がなければ https://zoom.us　などと入力下さい。

・Add allow lists にも、同様のURL（https://zoom.us)と入力下さい。

・Information メニューでは、必要に応じて説明をご入力下さい。

・Developer Contact Information section に、Name と Email address を記載下さい。

・Feature メニューから、Verification Tokenを取得します。これが、後に入力する「ZOOM Chatbot app Verification Token」となります。

・Feature メニューの、 Chat Subscriptionを入力します。

• Bot endpoint URL : developmentとproductionの両方に、本ページ上部の「１」で取得した、WebhookのURLを貼り付けて、「Save」ボタンを押します。

• Bot JID が表示されますので、「development」の欄の値を（＠以下も含め全て）取得して下さい。これが後に入力する「ZOOM Chatbot app Bot JID」となります。

・Chat Subscription 欄の右端にある、下向き矢印をクリックしてください。

・Slash Command の欄の[+]ボタンを押し、Command 欄に任意のアルファベットでの起動コマンドを記載します（実際には利用されませんが、入力が必要です。また、既に他の企業等が利用しているコマンドは使えないため、固有名詞のようなコマンド[zoombotmetabirds20220831]等の、世界で１つのコマンドとなるように入力して下さい）。

・その後忘れず、Saveボタンを押して下さい。

3) Scopeの設定

・こちらはこのままの設定で進んでください。

4）ボットのZOOMへのインストール

・Local Test メニューの Test the App Locally で[Add] ボタンを押してZOOMにインストールして下さい。（Testと有りますが、これが実際に利用するZOOMチャットボットとなります）

・[Allow]ボタンを押すと利用が許諾され、上で追加されたURL（https://zoom.us 等)にリダイレクトされます。

・これで「①Chatbotアプリ」の作成が完了です。ZOOMアプリのチャット画面、「BOTS」欄から利用が可能です。（もし見つからない場合は、連絡帳（Contacts）の中から見つけて下さい）

3. Zoom App Marketplaceで「②OAuthアプリ」を作成します

1）ZOOMのApp作成ページを開きます。

下記ページからログインして下さい。 https://marketplace.zoom.us/user/build

・Develop => Build App を選択します。

・スクロールし、「Server-to-Server OAuth」を選択して「Create」ボタンを押します。

・名前を記載し、（例：oauth app ）Createボタンを押して下さい。

・アプリ設定が作成され、詳細設定画面にリダイレクトされます。

2）設定の取得

・Account ID、Client ID,、Client Secret を保存下さい。これが、後に入力する「ZOOM Account ID」「ZOOM OAuth app Client ID」「ZOOM OAuth app Client secret」となります。

3）: 自社情報の設定

・Information メニューから、Company name、 担当者の名前とメールアドレスを記載ください。

・Scopes メニューから、Add Scopes ボタンを押し、権限設定を行います。

・ポップアップページから、User => View all user information (user:read:admin) を選び、Doneを押して下さい。

・また同様に、Group => View groups (group:read:admin) を選び、Doneを押して下さい。

・結果として、下記２つのScopeが設定されます。

・最後に、Activationメニューから、「Activate your app」を選択します。

・これで、この「②OAuthアプリ」も作成完了です。

4. ZOOMのグループIDを取得します。

・ZOOM管理画面の、「管理者」→「ユーザー管理」→「グループ」で、今回のチャットボットの利用対象者が所属するグループの設定画面を開きます。

・ブラウザのURL欄に表示される、グループID（zoom.us/account/group#/detail/xxxxxxxxxxxxx/detail のxxxxxxxxxxxxx部分のランダム英数字）を保存します。これが、「ZOOM Group ID」となります。

5. Botbird for businessにて、Zoom連携設定します

https://botbird.biz/member/bot_setting を開き、上部で取得した「ZOOM Account ID」「ZOOM Group ID」「ZOOM Chatbot app Bot JID」「ZOOM Chatbot app Client ID」「ZOOM Chatbot app Client secret」「ZOOM Chatbot app Verification Token」「ZOOM OAuth app Client ID」「ZOOM OAuth app Client secret」を入力し、[アップデート]を押してください。

6. 完了です

ZOOMのチャット画面からチャットボットに話しかけ、動作確認を行って下さい。

【事前準備】
Botbird for Businessのご登録がまだの方は、こちらからご登録またはお問い合わせ下さい。
https://botbirdbiz.com/
※Slackのアカウント体系やAPI設定画面等の内容は随時更新追加が行われています。必ず公式ヘルプ・ドキュメントを参照しながら設定を行って下さい。恐れ入りますが、このページのヘルプ内容を利用して設定を行った場合に発生した損害等への保証は出来かねますので予めご了承下さい。

「Slack」の登録を行って下さい。
登録方法については、こちらをご覧下さい。
https://slack.com/

【設定時の注意事項】
各設定を行う場合、以下のページを同時に開きながら設定を行うとスムーズに設定することが出来ますのでご参考下さい。

・Slack API : Application
https://api.slack.com/apps
・Botbird for Business
https://botbird.biz/member/login

---

---

1. Botbird for businessにて、Slack用のWebhook URLを取得します

https://botbird.biz/member/bot_setting を開き、「Webhook URLの指定（Slackに設定）」の欄内のURLをクリップボードやメモ帳等にコピーしておいてください。

2. Slack「カスタムアプリ」を作成します

１）SlackウェブサイトのAPPページから、[Create New App](または[Create an App])を押して下さい
https://api.slack.com/apps

２）From scratch を選択します

３）任意のApp Nameを入力し、配信先のWorkspaceを選択して[Create App]を押して下さい

４）Basic Information – Building Apps for Slack – Add features and functionality で、「Bots」を選んで下さい

５）App Home – First, assign a scope to your bot token で、[Review Scope to Add]を押して下さい

６）OAuth & Permissions が開きます

７）OAuth & Permissions – Scopes – Bot Token Scopesで、[Add an Oauth Scope]を押し、下記の権限をこのカスタムアプリに与えてください

chat:write / chat:wirte.customize / chat:write.public / links.write / links.read / users:read / app_mentions:read / channels:history / groups:history / im:history / mpim:history / incoming-webhook

８）OAuth & Permissions – OAuth Tokens for Your Workspace で、[Install to Workspace]を押し、次の画面で利用するチャンネルを選んで[許可する]を押して下さい。この「投稿先SlackチャンネルID」はクリップボードやメモ帳等にコピーしておいてください

９）Auth & Permissions – OAuth Token & Redirect URL で、「xoxb-」から始まる「Bot User Oauth Access Token」をクリップボードやメモ帳等にコピーしておいてください

１０）Basic Information – Building Apps for Slack – Add features and functionality に戻り、「Interactive Components」を選んで下さい

１１）Interactivity & Shortcuts のInteractivityスイッチをOnにして、Request URLに上で取得したWebhook URLを入力し、画面下の[Save Changes]ボタンを押して下さい

１２）Basic Information – Building Apps for Slack – Add features and functionality に戻り、「Event Subscriptions」を選んで下さい

１３）Event Subscriptions のEnable EventsスイッチをOnにして、Request URLに上で取得したWebhook URLを入力し、「Verified✓」と表示されることを確認して下さい

１４）その下のSubscribe to bot eventsで下記のイベントを追加して、画面下の[Save Changes]ボタンを押して下さい

app_mention / link_shared / message.channels / message.groups / message.im / message.mpim

１５）Basic Informationに戻り、 「App Credentials」から「Signing Secret」と「Verification Token」ををクリップボードやメモ帳等にコピーしておいてください

１６）App Home – Show Tabs – Messages Tab に移動し、 Allow users to send Slash commands and messages from the messages tab を有効にします。

この設定が無効な場合は、Slack内でbotに対してダイレクトメッセージを送ることができません。

3. Botbird for businessにて、Slack連携設定します

https://botbird.biz/member/bot_setting を開き、「Verification Token」「Signing Secret」「Bot User Oauth Access Token」「投稿先SlackチャンネルID」を入力し、[アップデート]を押してください。

4. Slackチャンネルにカスタムアプリを追加します

１）Slackアプリを開き、指定のチャンネルを開いて「アプリを追加する」を選びます

上記のリンクが表示されていない場合は、チャンネルの「Details」から[More] > [Add apps]を選択してください。

２）作成したカスタムアプリを[追加]します

5. 完了です

こちらは2020年夏頃より提供している新バージョンをご利用の方を対象にしています。バージョンの確認方法はこちら(旧バージョンのCSS編集方法)内の「■ バージョンの確認方法」をご覧ください。

---

CSSを編集し、WEBチャットの見た目を自由に変更することができます。

■ CSSの編集方法

１)　デフォルトのCSSを取得する

https://botbird.biz/css/botbirdbiz_custom.css より編集用のCSSを入手します(右クリックで保存できます)。

２)　CSS内容を編集する

お手元のエディタソフトを利用し、CSSを編集します。
以下に、代表的なid・classの一例を記載します。

.chatBoxHeader：WEBチャットボックスのタイトル

.speech-bubble-user：ユーザーが発話した内容(吹き出し)
※吹き出し横の三角は::after要素で定義

.speech-bubble-bot：ボットが返答した内容(吹き出し)
※吹き出し横の三角は::after要素で定義


#inputBox：ユーザーが入力するテキストボックス
#inputBoxSubmitBtn：送信ボタン

３)　編集したCSSファイルをサーバーにアップロードする

先ほど編集したCSSファイルを、サーバーにアップロードします。どのディレクトリにアップロードしても構いません。アップロードが完了したら、CSSファイルのパスを控えておきます。

４)　WEBページ内で編集したCSSファイルを読み込む

WEBチャットを表示するページ内で、さきほどアップロードしたCSSファイルを読み込みます。

<link rel="stylesheet" href="(CSSの保存場所)/botbirdbiz_custom.css">

---

以上が、CSSのカスタマイズ(独自CSSの読み込み)方法です。