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

 Release :

    - yokohama

ft:locale :

    - de-DE

ft:publication_title :

    - Yokohama-API-Referenz

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Konversation -- Umfang

# Konversation -- Umfang {#ariaid-title1}

* Freigeben Version: Yokohama
* 
* Aktualisiert 30. Januar 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 Minute Lesedauer

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

Um diese Klasse in einer bereichsbezogenen Anwendung zu verwenden, verwenden Sie `sn_Connect `Namespace-Bezeichner. Das Plugin „skriptfähige APIs verbinden" (ID: Com.Glide.Connect.scriptable) muss für den Zugriff auf aktiviert sein Konversation API.

## Konversation -- addSubscriber(Zeichenfolge 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 |
|-|-|
| Ungültig |   |
[Tabelle : 2. Rückgaben]

{#conversation-addSubscriber_string__table_f3k_bmx_cbb}  

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

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

Erstellt ConnectKonversation.
{#conversation-create_String_String__table_lwg_b4w_cbb__entry__3}

| Name | Typ | Beschreibung |
|-|-|-|
| name | Zeichenfolge | Erstellen Sie eine Konversation mit einem bestimmten Namen. |
| Typ | Zeichenfolge | Fügen Sie einen bestimmten Konversationstyp ein. Der Typ wird durch die Typauswahlliste bestimmt. Das Basissystem enthält die folgenden Typoptionen: * Verbinden * Support * Gruppe * 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. Rückgaben]

{#conversation-create_String_String__table_mwg_b4w_cbb}  

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

## Konversation -- GET(Zeichenfolge 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. Rückgaben]

{#conversation-get-string__table_alg_1x5_bbb}  

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

## Konversation -- removeSubscriber (Zeichenfolge sysID) {#ariaid-title5}

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

| Name | Typ | Beschreibung |
|-|-|-|
| Sys-ID | Zeichenfolge | Die sys_ID des Anwenders, 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 |
|-|-|
| Ungültig |   |
[Tabelle : 8. Rückgaben]

{#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 angezeigt werden soll. Verwenden Sie diese Option nur, wenn Sie einer Datensatzkonversation eine Nachricht hinzufügen. Wählen Sie aus Work_Notes, Kommentaren oder System aus. 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 |
|-|-|
| Ungültig |   |
[Tabelle : 10. Rückgaben]

{#conversation-sendMessage_String_String__table_lcw_pmv_2bb}  

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


