---
sourceDocument: Referência de API do Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/pt-BR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - pt-BR

ft:publication_title :

    - Referência de API do Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Interação - com escopo

# Interação - com escopo {#ariaid-title1}

* Versão de lançamento: Xanadu
* 
* Atualizado 1 de ago. de 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 min. de leitura

A API de interação fornece métodos que permitem definir o comportamento dos registros de interação.

Esta classe requer o plug-in Registro em log, roteamento e enfileiramento de interações (com.glide.interaction) e é executada no namespace `sn_interaction`.

## Interação - aceitar () {#ariaid-title2}

Aceita uma nova interação.
Aceitar uma transferência funciona somente para transferências pendentes. Encontre todas as transferências pendentes na tabela Transferência de agente de interação \[interaction_agent_transfer\].
{#InteractionScoped-accept__table_spy_541_g2b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| Nenhum |   |   |
[Tabela 1. Parâmetros]

{#InteractionScoped-accept__table_spy_541_g2b} {#InteractionScoped-accept__table_tpy_541_g2b__entry__2}

| Tipo | Descrição |
|-|-|
| Booliano | Retorna verdadeiro se a transferência for aceita. |
[Tabela 2. Retorna]

{#InteractionScoped-accept__table_tpy_541_g2b}  

    var now_GR = new GlideRecord('interaction');
    GR.get('b2c0a3af202a1300964f959e0488de75');
    var interaction = sn_interaction.Interaction.getInteraction(GR).accept();

## Interação - criar (opções de objeto) {#ariaid-title3}

Cria uma interação.
{#interaction-create_Object__table_ubv_mql_d2b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| opções | Objeto | Valores de campo para um registro de interação. O campo de canal com o sys_id do canal e os metadados do canal são obrigatórios. Se uma fila não estiver incluída no parâmetro, o sistema retornará a `Interação b2c0a3af202a1300964f959e0488de75 sem fila especificada... regras de correspondência de fila em execução.` |
[Tabela 3. Parâmetros]

{#interaction-create_Object__table_ubv_mql_d2b} {#interaction-create_Object__table_vbv_mql_d2b__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Interação |
[Tabela 4. Retorna]

{#interaction-create_Object__table_vbv_mql_d2b}  

    var interactionObj = sn_interaction.Interaction.create({
    	channel: '28a59893873103002ae97e2526cb0b5d',
    	channel_metadata:{},
    	opened_for: '46d44a23a9fe19810012d100cca80666',
    	queue: 'f3a50867b30303002186a72256a8dcb7'
    });

## Interação - getInteraction(interação GlideRecord) {#ariaid-title4}

Retorna um registro de interação.
{#InteractionScoped-getInteraction_GlideRecord__table_dys_bnd_c2b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| interação | GlideRecord | Registro de interação da tabela de interação \[interação\] que é recuperada do sistema. |
[Tabela 5. Parâmetros]

{#InteractionScoped-getInteraction_GlideRecord__table_dys_bnd_c2b} {#InteractionScoped-getInteraction_GlideRecord__table_eys_bnd_c2b__entry__2}

| Tipo | Descrição |
|-|-|
| Objeto | Interação |
[Tabela 6. Retorna]

{#InteractionScoped-getInteraction_GlideRecord__table_eys_bnd_c2b}  

    var now_GR = new GlideRecord('interaction');
    now_GR.get('608a21bd096a9300964ffbd57ba7dd8d');
    var interaction = sn_interaction.Interaction.getInteraction(now_GR);

## Interação - transferToAgent(String sysID) {#ariaid-title5}

Transfere um registro de interação para um agente usando o sys_id do agente.
Quando uma interação é transferida de um agente para outro, a interação precisa ser aceita ou rejeitada usando as APIs GlideRecord. Use a API GlideRecord para mudar o estado da interação e atualizar. Para obter mais informações, consulte o método GlideRecord - update.  
Nota:  
Este método foi descontinuado.
{#InteractionScoped-transferToAgent_String__table_ryp_4py_c2b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| SysID | Cadeia de caracteres | O sys_id do usuário para o qual você deseja transferir um registro de interação. |
[Tabela 7. Parâmetros]

{#InteractionScoped-transferToAgent_String__table_ryp_4py_c2b} {#InteractionScoped-transferToAgent_String__table_syp_4py_c2b__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 8. Retorna]

{#InteractionScoped-transferToAgent_String__table_syp_4py_c2b}  

    var now_GR = new GlideRecord('interaction');
    GR.get('24b927ef202a1300964f959e0488de2d');
    var interaction = sn_interaction.Interaction.getInteraction(GR);
    interaction.transferToAgent('6816f79cc0a8016401c5a33be04be441');

## Interação - transferToQueue(String sysID) {#ariaid-title6}

Transfere um registro de interação para uma fila de interação.
A transferência de uma interação de uma fila para outra encerra a interação original e cria uma interação na nova fila.  
Nota:  
Este método foi descontinuado.
{#InteractionScoped-transferToQueue_String__table_bzz_kqy_c2b__entry__3}

| Nome | Tipo | Descrição |
|-|-|-|
| SysID | Cadeia de caracteres | O sys_id da fila de interação para a qual você deseja transferir o registro de interação. |
[Tabela 9. Parâmetros]

{#InteractionScoped-transferToQueue_String__table_bzz_kqy_c2b} {#InteractionScoped-transferToQueue_String__table_czz_kqy_c2b__entry__2}

| Tipo | Descrição |
|-|-|
| vazio |   |
[Tabela 10. Retorna]

{#InteractionScoped-transferToQueue_String__table_czz_kqy_c2b}  

    var now_GR = new GlideRecord('interaction');
    GR.get('24b927ef202a1300964f959e0488de2d');
    var interaction = sn_interaction.Interaction.getInteraction(GR);
    interaction.transferToQueue('86fee1933b101300088d832b44efc474');