Conversa - com escopo

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 1 min. de leitura
  • A API de conversa permite que você crie ou modifique conversas do Connect.

    Para usar essa 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 com escopo - get(cadeia de caracteres sysID)

    Obtenha uma conversa existente do Connect por sys_id.

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

    Conversa com escopo - create(String name)

    Crie 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 tipo. O sistema de base inclui as seguintes opções de tipo:
    • conectar
    • suporte
    • grupo
    • par
    • qanda
    • equipe
    Tabela 4. Retorna
    Tipo Descrição
    Objeto Conversa programável
    var conversation = sn_connect.Conversation.create({
        name: "Hello world",
        type: "connect"
    });

    Conversa com escopo - addSubscriber(cadeia de caracteres sysID)

    Adicione um usuário a uma conversa.

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

    Conversa com escopo - removeSubscriber(cadeia de caracteres sysID)

    Remova 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. Retorna
    Tipo Descrição
    vazio
    var conversation = sn_connect.Conversation.get("7caf49111309030034bb58a12244b06c");
    conversation.removeSubscriber("a8f98bb0eb32010045e1a5115206fe3a");

    Conversa com escopo - sendMessage(cadeia de caracteres corpo, cadeia de caracteres campo)

    Envie uma mensagem para uma conversa.

    Tabela 9. Parâmetros
    Nome Tipo Descrição
    Corpo 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. Retorna
    Tipo Descrição
    vazio
    var conversation = sn_connect.Conversation.get("2064fa3919010300964f5270e9840fbb");
    conversation.sendMessage({body: "Hello world", field: "work_notes"});