Conversa - com escopo

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura
  • A API de conversa permite que você crie ou modifique conversas do Connect.

    Para usar esta classe em uma aplicação com escopo, use o identificador de namespace sn_connect. O plug-in Connect Scriptable APIs (ID: com.glide.connect.scriptable) deve ser habilitado para acessar a API de conversa.

    Conversa - addSubscriber(String sysID)

    Adiciona um usuário a uma conversa.

    Tabela 1. Parâmetros
    Nome Tipo Descrição
    sysID Cadeia de caracteres Sys_ID do usuário que você deseja adicionar a uma conversa.
    Tabela 2. Retornos
    Tipo Descrição
    vazio
    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.addSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

    Conversa - create(String name)

    Cria uma conversa Connect.

    Tabela 3. Parâmetros
    Nome Tipo Descrição
    nome Cadeia de caracteres Crie uma conversa com um nome específico.
    tipo Cadeia de caracteres Inclua um tipo de conversa específico. O tipo é determinado pela lista de seleção de tipos. O sistema de base inclui as seguintes opções de tipo:
    • conectar
    • suporte
    • grupo
    • colega
    • qanda
    • equipe
    Tabela 4. Retornos
    Tipo Descrição
    Objeto Conversa programável
    var conversation = sn_connect.Conversation.create({
        name: "Hello world",
        type: "connect"
    });

    Conversa - get(String sysID)

    Retorna uma conversa existente do Connect por sys_id.

    Tabela 5. Parâmetros
    Nome Tipo Descrição
    sysID Cadeia de caracteres O sys_id do registro da conversa.
    Tabela 6. Retornos
    Tipo Descrição
    Objeto Objeto de conversa
    var conversation = sn_connect.Conversation.get("27b9844c1385030034bb58a12244b037");

    Conversa - removeSubscriber(String sysID)

    Remove um usuário de uma conversa.

    Tabela 7. Parâmetros
    Nome Tipo Descrição
    SysID Cadeia de caracteres O sys_id do usuário que você deseja remover de uma conversa.
    Tabela 8. Retornos
    Tipo Descrição
    vazio
    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.removeSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

    Conversa - sendMessage(Corpo da cadeia de caracteres, campo da cadeia de caracteres)

    Envia uma mensagem para uma conversa.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Corpo da mensagem Cadeia de caracteres O texto principal da mensagem.
    Campo Cadeia de caracteres O campo como você deseja que a mensagem apareça. Use esta opção somente se adicionar uma mensagem a uma conversa de registro. Escolha entre work_notes, comentários ou sistema. O uso do sistema de campo trata a mensagem como uma mensagem do sistema.
    Tabela 10. Retornos
    Tipo Descrição
    vazio
    var conversation = sn_connect.Conversation.get("2064fa3919010300964f5270e9840fbb");
    conversation.sendMessage({body: "Hello world", field: "work_notes"});