Messaging for In-App and Webのまとめ


MIAWが略称みたい

+ [Messaging for In-App 開発者向け](https://qiita.com/Keiji_otsubo/items/aa8cb83fb57c906c7275)
+ [Messaging for Web](https://developer.salesforce.com/docs/service/messaging-web/overview)
+ [Get Started With APIs for Messaging for Web](https://developer.salesforce.com/docs/service/messaging-web/guide/api-overview.html)
+ [Troubleshoot Messaging for In-App and Web Setup](https://help.salesforce.com/s/articleView?id=sf.miaw_troubleshoot.htm&type=5)
+ [Messaging for In-App and Web](https://qiita.com/Keiji_otsubo/items/9d42c69db4bef24bb7cf)
+ [メッセージング オブジェクト モデル](https://qiita.com/Keiji_otsubo/items/f34dff00ae6d96cb7ff1)
---------------------
+ [メッセージングの用語集](https://help.salesforce.com/s/articleView?id=sf.miaw_glossary.htm&type=5)
+ [Messaging for In-App and Webの　トレイルヘッド](https://qiita.com/Keiji_otsubo/items/9d42c69db4bef24bb7cf)




# エラー

+ [Messaging for In-App and Web, getting error in Digital experience site. : Unable to load Embedded Messaging configuration](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007T4vCcSAJ)

+ [MIAW "No Agents Available" Auto-Reply?](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007bLdSR)

:::note
Your best option is to use Einstein bot to pick up the chat via a Flow and reply with your desired messaging. 


最善の選択肢は、Einstein ボットを使用してフロー経由でチャットを取得し、必要なメッセージで返信することです。
:::

+ [メッセージングセッションとアンケートの紐づけ方法について](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007epyUJ)

+ [【未解決】No records found. Make sure your recipient belongs to an enhanced Messaging channel or Messaging for In-App channel, and try again.Learn More](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007UP7ER)

+ [No records found. Make sure your recipient belongs to an enhanced Messaging channel or Messaging for In-App channel, and try again.Learn More](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007UP7ER)

:::note
after logging this on Salesforce support the response was the Messaging number provision has to be in the Enhanced Channel not standard , hence the functionality can only be used when the platform type is Enhanced in the messaging settings.

Salesforce サポートにこれを記録したところ、「メッセージング番号のプロビジョニングは標準ではなく拡張チャネルにある必要がある」という応答が返されました。そのため、この機能はメッセージング設定でプラットフォーム タイプが拡張されている場合にのみ使用できます。
:::

+ [アプリ内およびウェブのメッセージング - エージェントは利用できません](https://qiita.com/Keiji_otsubo/items/d5a52945cf1565aa37cf)

+ [Testing MAIW getting below error ?](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX00000KCtuq)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/06c76258-1795-4155-b137-57abc4dba0ab.png)

:::note
Are you currently using the fallback messaging feature?  
This could be causing the error 'Looks like something went wrong, and we can't display the conversation.  

https://help.salesforce.com/s/articleView?id=service.messaging_fallback_message.htm&type=5
:::

+ [アプリ内および Web のメッセージングでのチャットの転送に関する問題 (MIAW)](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX00000MYdmW)

+ [MIAW Enhanced BOT Menu options Customer selection Issue](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX00000SUrli)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/ea991e9f-c1b6-4192-a57e-a18baeb851a9.png)



# その他

+ [Multiple Language Requirements with MIAW](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007aial7SAA)

:::note
Look out for the Summer '24 release notes regarding translating Messaging Components

メッセージングコンポーネントの翻訳に関する Summer '24 リリースノートに注目してください。
:::

+ [Switching from Live Agent to MIAW](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007bLIboSAG)

:::note
Congrats on making plans for this exciting change. While I'm hoping that some fellow customers will chime in on the timelines and support needed, I wanted to point you in the direction of some documentation that might be helpful. Based on your description of your business, though, I don't think that this will take you very long to set up.

Here are some docs I wrote about [replacing chat with Messaging for In-App and Web](https://help.salesforce.com/s/articleView?id=sf.miaw_replacing_chat_considerations.htm&type=5). Here is our [setup guide for Messaging for In-App and Web.](https://help.salesforce.com/s/articleView?id=sf.miaw_setup_stages.htm&type=5) Once it's set up, you can [message customers by following these instructions. ](https://help.salesforce.com/s/articleView?id=sf.livemessage_agent.htm&type=5)

この素晴らしい変化に向けて計画を立てていただきありがとうございます。他の顧客がタイムラインや必要なサポートについて意見を述べてくれることを期待していますが、役立つ可能性のあるドキュメントの方向性を示したいと思いました。ただし、あなたのビジネスの説明に基づくと、セットアップにそれほど長い時間はかからないと思います。


ここでは、チャットをアプリ内および Web のメッセージングに置き換えることについて私が書いたドキュメントをいくつか紹介します。ここでは、アプリ内および Web のメッセージングのセットアップ ガイドを示します。セットアップが完了したら、次の手順に従って顧客にメッセージを送信できます。
:::


+ [MIAW Spring 24 リリース概要資料](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007W94ZeSAJ)

:::note
. Block file transfers was actually backported to 246, so [the release note](https://help.salesforce.com/s/articleView?id=release-notes.rn_miaw_prevent_attachments.htm&release=246&type=5) lives in the Winter '24 doc set instead of the Spring '24 doc set. In Spring '24, however, we did expand this ability to customize the enhanced conversation window (beyond just blocking file transfers), and you can find [that release note here.](https://help.salesforce.com/s/articleView?id=release-notes.rn_messaging_enhanced_conversation_component.htm&release=248&type=5) 

2. Save Transcript has evolved and will be released in pilot as the option to download a transcript. Pilot's don't get a release note. 

1. ブロック ファイル転送は実際には 246 にバックポートされたため、リリース ノートはSpring '24 ドキュメント セットではなく Winter '24 ドキュメント セットに存在します。ただし、Spring '24 では、(ファイル転送をブロックするだけでなく) 強化された会話ウィンドウをカスタマイズできるようにこの機能を拡張しました。そのリリースノートはここで見つけることができます。 

2. トランスクリプトの保存が進化し、トランスクリプトをダウンロードするオプションとしてパイロット版でリリースされる予定です。パイロットにはリリースノートがありません。
:::

+ [拡張メッセージング オブジェクト モデル](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007clIL2)


+ [メッセージング設定について、チャットが起動しない](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007Iey0b)

[Add Flexibility and Power with Messaging for In-App and Web (salesforce.com)](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007Iey0b)

ライセンスが必要かな？

+ [拡張メッセージング オブジェクト モデルに変更はありますか?](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007clIL2)

:::note
24 年夏のヘルプ ドキュメントが昨日公開されました。そのヘルプ リンクに再度アクセスすると、標準 SDR と拡張 SDR の両方のプロセスがカバーされていることがわかります。ご不明な点がございましたらお知らせください。

裏話: プレビュー リリース ノートの公開とヘルプ ドキュメントの公開の間には、数週間のギャップがあります。この期間中、ヘルプ ドキュメントには以前のリリースの機能が反映され、リリース ノートには新しいリリースが記載されます。このため、リリース ノート内のすべてのヘルプ ドキュメント リンクには、次のような小さな注記が含まれています (リリース プレビュー中は古くなったり、利用できなくなる可能性があります)。 :) 
:::

+ [今後MIAWに切り替える際には「未検証ユーザー」かつ「Webのみ利用」での利用を検討しています。非同期の最大72時間会話が保持できる機能に期待をしていますが、大型連休に入る際は会話の保持が出来なくなるため、運用方法を模索中です。](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007cm9vZ)

:::note
+ 顧客が7/12（金）の16:00にオペレーターにメッセージ送信
+ オペレーターは16:30に回答、17:00までにに顧客の返信なく営業時間終了
（その後、顧客は営業時間外に返信をしたとする）
+ 次回オペレーターが回答できるのは7/16（火）の9:00

上記の場合ですが、顧客もずっとWEBブラウザで接続したままなのかが気になるところです。会社のデスクトップなら電源を落として帰るかな？（この場合は通常の土日でも同じことが起きそうですが... 　同じユーザとしては認識できない）

ただノートPCでレジュームさせた場合、スマホのWEBブラウザでアプリを落とさなかった場合が気になるところですね。（72時間が過ぎたらセッションは切れているので、ブラウザを更新しても再接続ですよね）

未検証ユーザーなので識別できないのがネックですので、例えば別途ユニークなお問い合わせ番号を発行して、次回問い合わせの時に入力してもらうとかくらいしか思い当たらないですね。（このお問い合わせ番号で探す機能が無かったら使えないかもしれませんが...）
:::

+ [営業時間の設定](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007cmGsU)

:::note
営業時間の設定はできるようです。別のボットへの切り替え機能は言及されてないです。バナーにリンクでも貼れるといいのですが...

顧客を待たせないようにしましょう。営業時間外に顧客が新しいメッセージングセッションを開始できないようにします。営業時間を設定すると、営業時間が終了すると [Web のメッセージング] ボタンが非表示になり、アプリ内のメッセージングの顧客には営業時間が終了したことを知らせるバナーが表示されます。API を使用して、営業時間外にアプリ内のメッセージング会話の受信を防止します。

アプリ内および Web のメッセージングでの営業時間の設定
https://help.salesforce.com/s/articleView?id=sf.miaw_business_hours.htm&type=5

この設定だけでは、抜けがあるような記述です。

アプリ内および Web のメッセージングの両方で、API を使用して営業時間ルールを上書きし、異なるタイミングでチャットボタンを非表示または表示にできます。
:::


# 会話の終了
+ [MIAW で「会話を終了」するために利用できる API はありますか?](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007eqPWY)

:::note
エージェントがチャットを終了しても、エンド ユーザーはメッセージを送信して新しいセッションを開始できます。チャット ウィンドウは、Live Agent で使用されていたように無効になりません。また、ユーザーが [会話の終了] をクリックして会話を終了せずにコミュニティからログアウトし、しばらくしてから再度ログインした場合でも、チャットは開始状態のままであるため、同じ会話を続けることができます。

 

Live Agent では、エンドユーザーがブラウザまたは埋め込みチャットのあるタブを閉じると、チャットは終了していましたが、MIAW ではそうではありません。そのため、ブラウザが閉じられたときやユーザーがログアウトしたときにチャットを閉じるために呼び出すことができる API を探していました。
:::

+ [セッション終了: Miaw のチャット終了動作: メンバーが「チャットを終了」をクリックした場合にのみ、チャットは永続的な会話を停止します。メンバーが沈黙していたり​​、チャットの終了をクリックしていない場合、警告メッセージを自動的に設定し、特定の時間にセッションを自動的に終了することはできますか? ](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX00000KfsNv)

:::note
1. 自動警告タイムアウト機能は、数週間後の2025年春リリースで導入される予定です。

2. 自動切断タイムアウト機能はすでにあります。https ://help.salesforce.com/s/articleView? id=service.messaging_auto_end.htm&type=5
:::

+ [メッセージセッションを終了する方法](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX000000WhAg)



# MIAW のオムニチャネル タブのカラー通知

+ [サービス エージェントは、新しいチャット (作業項目) または新しいメッセージが届いたときにエージェントに通知するために、タブの色の変更/点滅 (サウンド通知の横) に依存しています。サービス コンソールのこれらの色付きタブ通知の背後にあるロジックを調べようとしています。詳細を学べる (Salesforce) ドキュメントを探しています。しかし、見つけるのが難しいようです。 ](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007ifoi5)

>また、ライブ チャットと MIAW の間では、これらのタブの色の通知に違いがあるようです。ビジネス テスターは、その背後にあるロジックを知らないため、不一致を経験しています。これに対して予想される動作について教えてくれる人はいますか? または、詳細情報はどこで入手できますか? 

:::note
また、プロジェクトの要件に応じてタブをカスタマイズする方法も探していました。次のドキュメントを見つけました。このドキュメントには、これを実装する方法の例が含まれています。テストしたところ、完璧に機能し、この方法を使用してタブの色を変更できました。

ドキュメント: [Salesforce API コンソール - タブの強調表示の設定](https://developer.salesforce.com/docs/atlas.en-us.api_console.meta/api_console/sforce_api_console_lightning_setTabHighlighted.htm)
:::

# できないこと

+ [Font size for In-app messaging and Web widget for website](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX000000VmH2)

:::note
We are using In-App Messaging but the code didnt help unfortunatley  it didnt work. Reached out to Salesforce support and they advised this isnt currently a feature. 

From SF Support: 

I would like to inform you that, at present, Salesforce does not provide standard functionality to adjust the size of the field label in the Pre-Chat form. The available option is to modify the size of the field value, but not the label itself.
To achieve your desired outcome, you would need to create a custom LWC (Lightning Web Component) Pre-Chat component. This would allow you to modify the field label size through the CSS code within the custom pre-chat component.

This isnt an option for this customer at the moment so will leave the chat form as is. 

アプリ内メッセージングを使用していますが、残念ながらコードは機能しませんでした。Salesforceサポートに問い合わせたところ、現時点ではこの機能は提供されていないとのことでした。 

SFサポートより: 

現時点では、Salesforce では事前チャットフォームのフィールドラベルのサイズを調整する標準機能は提供されていません。フィールド値のサイズを変更することは可能ですが、ラベル自体を変更することはできません。
望ましい結果を得るには、カスタムLWC（Lightning Web Component）事前チャットコンポーネントを作成する必要があります。これにより、カスタム事前チャットコンポーネント内のCSSコードを通じて項目ラベルのサイズを変更できるようになります。

現時点ではこの顧客にはこのオプションは利用できないため、チャット フォームはそのまま残します。 
:::





+ [Mobileでアプリ内および web のメッセージングは動かない](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007cmX4T)

:::note
既知の問題にあがっている以下の現象と同じでしょうか？

Messages aren't received when iOS safari app runs in background
https://issues.salesforce.com/issue/a028c00000mNUCAAA4/messages-arent-received-when-ios-safari-app-runs-in-background
:::

+ [MIAW キュー](https://qiita.com/Keiji_otsubo/items/7ae461272e80e63ba9a9)

+ [MIAW　メッセージングで全員作業中でも「転送中…」表示になる件について](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX000000Uhmm)

:::note
以下のアイデアに上がっている事象だと思います。 

残念ながら回避策は投稿されていないようです。 


以下に、プロダクトチームが認識をしているみたいなので、改善されるのを待つしかないと思います。 

They also said the SF Product Team is aware of this and is looking to enhance this behaviour as part of a new feature request. 

https://ideas.salesforce.com/s/idea/a0B8W00000QcdnQUAR/miawbot-provides-option-on-how-to-proceed-when-chat-is-not-accepted-by-agent
:::

解決策

:::note
MIAWでボットからエージェントへ転送する際、 

オムニフローを呼んで転送しているかと思いますが、 

そこで呼んでいるオムニフローに、「ルーティングに対応可能かを確認」するアクションを入れ、 

このアクション結果のオンラインエージェント数が0より大きければエージェントへ転送し、 

0以下の場合はボットに戻す処理を追記しました。 

こうすることで、オンラインエージェントがいない場合はボットに戻されるので、転送中…と表示されたままエンドユーザーを待たせることはなくなるかなと思います。

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/5d26fd02-934d-447a-93cf-1fced606b7f5.png)

:::

# 設定？

+ [チャット前のフォームの名をメッセージ内のゲスト名として表示するにはどうすればよいですか?](https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007erlNh)

![image.png](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/328136/adb7ff4c-898a-43a0-9eca-ae2e71119484.png)

+ [アプリ内メッセージとウェブサイトのウェブウィジェットのフォントサイズの変更](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX000000VmH2)

# LiveAgent からの移行

+ [LiveAgent to MIAW](https://trailhead.salesforce.com/trailblazer-community/feed/0D5KX00000TjMVl)

:::note
Please check this article. 

https://trailhead.salesforce.com/trailblazer-community/feed/0D54V00007bLIboSAG

https://www.reddit.com/r/salesforce/comments/1h59jdj/migrating_from_chat_to_miaw/
:::