---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Conversation - Dans le champ d'application

# Conversation - Dans le champ d'application {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute de lecture

L'API Conversation vous permet de créer ou de modifier des conversations de Connexion.

Pour utiliser cette classe dans une application incluse dans le périmètre, utilisez l'identificateur `d'espace` de noms sn_connect. Le module d'extension Connect Scriptable API (ID : com.glide.connect.scriptable) doit être activé pour accéder à l'API de conversation .

## Conversation : addSubscriber(String sysID) {#ariaid-title2}

Ajoute un utilisateur à une conversation.
{#conversation-addSubscriber_string__table_e3k_bmx_cbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| sysID | Chaîne | Sys_ID de l'utilisateur que vous souhaitez ajouter à une conversation. |
[Tableau 1. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 2. Renvoie]

{#conversation-addSubscriber_string__table_f3k_bmx_cbb}  

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

## Conversation : create(nom de chaîne) {#ariaid-title3}

Crée une Connexion conversation.
{#conversation-create_String_String__table_lwg_b4w_cbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| nom | Chaîne | Créez une conversation avec un nom spécifique. |
| type | Chaîne | Incluez un type de conversation spécifique. Le type est déterminé par la liste de choix de type. Le système de base comprend les options de type suivantes : * connexion * soutien * groupe * pair * Qanda * équipe {#conversation-create_String_String__ul_ut2_4df_wbb} |
[Tableau 3. Paramètres]

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

| Type | Description |
|-|-|
| Objet | Conversation pouvant contenir des scripts |
[Tableau 4. Renvoie]

{#conversation-create_String_String__table_mwg_b4w_cbb}  

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

## Conversation : get(String sysID) {#ariaid-title4}

Renvoie une conversation Connect existante par sys_id.
{#conversation-get-string__table_zkg_1x5_bbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| sysID | Chaîne | Le sys_id de l'enregistrement de conversation. |
[Tableau 5. Paramètres]

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

| Type | Description |
|-|-|
| Objet | Objet de conversation |
[Tableau 6. Renvoie]

{#conversation-get-string__table_alg_1x5_bbb}  

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

## Conversation : removeSubscriber(String sysID) {#ariaid-title5}

Supprime un utilisateur d'une conversation.
{#conversation-removeSubscriber_string__table_e3k_bmx_cbb__entry__3}

| Nom | Type | Description |
|-|-|-|
| SysID | Chaîne | Le sys_id de l'utilisateur que vous souhaitez supprimer d'une conversation. |
[Tableau 7. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 8. Renvoie]

{#conversation-removeSubscriber_string__table_f3k_bmx_cbb}  

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

## Conversation : sendMessage(corps de la chaîne, champ de chaîne) {#ariaid-title6}

Envoie un message dans une conversation.
{#conversation-sendMessage_String_String__table_kcw_pmv_2bb__entry__3}

| Nom | Type | Description |
|-|-|-|
| Corps | Chaîne | Texte principal du message. |
| Champ | Chaîne | Champ dans lequel vous souhaitez que le message s'affiche. N'utilisez cette option que si vous ajoutez un message à une conversation d'enregistrement. Choisissez entre work_notes, commentaires ou système. L'utilisation du système de champs traite le message comme un message système. |
[Tableau 9. Paramètres]

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

| Type | Description |
|-|-|
| nul |   |
[Tableau 10. Renvoie]

{#conversation-sendMessage_String_String__table_lcw_pmv_2bb}  

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