---
sourceDocument: Xanadu-API-Referenz
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/de-DE/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - de-DE

ft:publication_title :

    - Xanadu-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Konversation -- bereichsbezogen

# Konversation -- bereichsbezogen {#ariaid-title1}

* Freigeben Version: Xanadu
* 
* Aktualisiert 1. August 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

Mit der Konversations -API können Sie Connect-Konversationen erstellen oder ändern.

Um diese Klasse in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie den Namespace-Bezeichner `sn_connect`. Das Connect Scriptable APIs-Plugin (ID: com.glide.connect.scriptable) sollte für den Zugriff auf die Conversation-API aktiviert sein.

## Konversation -- addSubscriber(String sysID) {#ariaid-title2}

Fügt einer Konversation einen Anwender hinzu.
{#conversation-addSubscriber_string__table_e3k_bmx_cbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysID | Zeichenfolge | Sys_ID des Anwenders, den Sie einer Konversation hinzufügen möchten. |
[Tabelle : 1. Parameter]

{#conversation-addSubscriber_string__table_e3k_bmx_cbb} {#conversation-addSubscriber_string__table_f3k_bmx_cbb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 2. Ergebnisse]

{#conversation-addSubscriber_string__table_f3k_bmx_cbb}  

    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.addSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

## Konversation -- erstellen (Zeichenfolgenname) {#ariaid-title3}

Erstellt eine Connect -Konversation.
{#conversation-create_String_String__table_lwg_b4w_cbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Name | Zeichenfolge | Erstellt eine Konversation mit einem bestimmten Namen. |
| Typ | Zeichenfolge | Schließt einen bestimmten Konversationstyp ein. Der Typ wird durch die Typenauswahlliste bestimmt. Das Basissystem enthält die folgenden Typenoptionen: * connect * support * group * peer * qanda * team {#conversation-create_String_String__ul_ut2_4df_wbb} |
[Tabelle : 3. Parameter]

{#conversation-create_String_String__table_lwg_b4w_cbb} {#conversation-create_String_String__table_mwg_b4w_cbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Skriptfähige Konversation |
[Tabelle : 4. Ergebnisse]

{#conversation-create_String_String__table_mwg_b4w_cbb}  

    var conversation = sn_connect.Conversation.create({
        name: "Hello world",
        type: "connect"
    });

## Konversation -- get(String sysID) {#ariaid-title4}

Gibt eine vorhandene Connect-Konversation nach sys_id zurück.
{#conversation-get-string__table_zkg_1x5_bbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| sysID | Zeichenfolge | Die sys_id des Konversationsdatensatzes. |
[Tabelle : 5. Parameter]

{#conversation-get-string__table_zkg_1x5_bbb} {#conversation-get-string__table_alg_1x5_bbb__entry__2}

| Typ | Beschreibung |
|-|-|
| Objekt | Konversationsobjekt |
[Tabelle : 6. Ergebnisse]

{#conversation-get-string__table_alg_1x5_bbb}  

    var conversation = sn_connect.Conversation.get("27b9844c1385030034bb58a12244b037");

## Konversation -- entfernen Sie den Abonnenten (Zeichenfolgen-Sys-ID) {#ariaid-title5}

Entfernt einen Anwender aus einer Konversation.
{#conversation-removeSubscriber_string__table_e3k_bmx_cbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| SysID | Zeichenfolge | Die sys_id des Benutzers, den Sie aus einer Konversation entfernen möchten. |
[Tabelle : 7. Parameter]

{#conversation-removeSubscriber_string__table_e3k_bmx_cbb} {#conversation-removeSubscriber_string__table_f3k_bmx_cbb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 8. Ergebnisse]

{#conversation-removeSubscriber_string__table_f3k_bmx_cbb}  

    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.removeSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

## Konversation -- sendMessage(Zeichenfolgentext, Zeichenfolgenfeld) {#ariaid-title6}

Sendet eine Nachricht an eine Konversation.
{#conversation-sendMessage_String_String__table_kcw_pmv_2bb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| Textkörper | Zeichenfolge | Der Haupttext der Nachricht. |
| Feld | Zeichenfolge | Das Feld, als das die Nachricht erscheinen soll. Verwenden Sie diese Option nur, wenn Sie einer Datensatz-Konversation eine Nachricht hinzufügen. Wählen Sie aus Arbeitsnotizen, Kommentaren oder System. Bei Verwendung des Feldsystems wird die Nachricht als Systemnachricht behandelt. |
[Tabelle : 9. Parameter]

{#conversation-sendMessage_String_String__table_kcw_pmv_2bb} {#conversation-sendMessage_String_String__table_lcw_pmv_2bb__entry__2}

| Typ | Beschreibung |
|-|-|
| void |   |
[Tabelle : 10. Ergebnisse]

{#conversation-sendMessage_String_String__table_lcw_pmv_2bb}  

    var conversation = sn_connect.Conversation.get("2064fa3919010300964f5270e9840fbb");
    conversation.sendMessage({body: "Hello world", field: "work_notes"});