Sparkcentral by Hootsuite

Sparkcentral da Hootsuite permite que você gerencie todos os seus canais de mensagens assíncronas com agentes de atendimento humanos e virtuais.

Obtendo credenciais da API do Sparkcentral

O primeiro passo para integrar o Sparkcentral com o Chatlayer.ai é obter as credenciais da API do Sparkcentral.

• Acesse seu painel do Sparkcentral e abra a página Configurações.

• Quando estiver na página de configurações, selecione a aba Integrações na barra lateral.

• Para obter suas credenciais da API do Sparkcentral, clique no botão Gerar chaves da API no canto superior direito da tela.

• Digite um nome para suas credenciais da API e clique no botão Salvar. Uma nova entrada agora ficará visível na página Integrações contendo seu clientId e clientSecret. Mantenha essas credenciais abertas e volte ao Chatlayer.ai para iniciar a configuração do Sparkcentral.

• Acesse a página de canais no Chatlayer. Clique no ícone de mais ao lado do Sparkcentral para iniciar a configuração do canal.

• Escolha sua região: US ou EU

• Insira seu clientId e clientSecret no formulário e pressione salvar.

• Após salvar, a URL do webhook para o canal recém-criado ficará visível. Copie esta URL do Webhook e volte para o Sparkcentral.

• Retorne ao seu painel do Sparkcentral e abra a página Configurações. Abra a aba Agentes Virtuais na barra lateral da página de configurações e clique no botão Adicionar Agente Virtual Personalizado no canto superior direito. Isso abrirá um pop-up permitindo configurar alguns detalhes para o Agente Virtual Personalizado.

• Digite a URL do webhook do seu agente virtual do Chatlayer.ai na seção Configuração de Agentes Virtuais Personalizados.

• Assim que a configuração for concluída, copie o Segredo Compartilhado em Configuração de Agente Virtual Personalizado e salve o novo Agente Virtual Personalizado.

• Volte para o Chatlayer.ai, insira o segredo compartilhado do webhook e salve a configuração do canal.

• Edite a configuração do agente virtual do Sparkcentral para habilitar os canais em que você quer que seu bot fique ativo.

Configurar transferência

Para transferir a conversa do chatbot para um agente ao vivo no Sparkcentral, você pode criar um bloco de Ação contendo um plugin "send to offload provider". Configure o provedor de offload do Sparkcentral.

Assim que esta Ação for acionada, a conversa será adicionada à fila de agentes do Sparkcentral.

Recuperar detalhes do usuário do Sparkcentral

Você pode encontrar mais informações das sessões de usuário conectadas ao canal do Sparkcentral abaixo:

internal.channelDetails

// export interface SparkcentralSessionDetails {
  channelId: string;
  medium?: string;
  contactProfile?: {
    id: string;
    mediumContactProfileId: string;
    primaryIdentifier: string;
    secondaryIdentifier: string;
    pictureUrl: string;
    vip: boolean;
  };
  contactAttributes?: { attribute: string; value: string; source: string }[];
}

Um exemplo de internal.channelDetails pode ser o seguinte:

{
 channelId: "12345",
  medium: "twit".
  contactProfile: {
    id: "0-01f116a7f9c-000-b5d575cb,
    mediumContactProfileId: "cd067e88519ab323b15c9944"
    primaryIdentifier: "[e-mail]"
    secondaryIdentifier: "[e-mail]"
    pictureUrl: "https://avatar_url.com";
    vip: false;
  };
  "contactAttributes": [
    {
      "attribute": "fb-page-title",
      "value": "Demonstração de mensagens na web",
      "source": "MEDIUM"
    },
    {
      "attribute": "fb-page-url",
      "value": "https://messenger-demoapp-dev/#JansDevSmoochChannel4",
      "source": "MEDIUM"
    },
    {
      "attribute": "fb-browser-language",
      "value": "en-US",
      "source": "MEDIUM"
    },
    {
      "attribute": "fb-domain",
      "value": "messenger-demoapp-dev",
      "source": "MEDIUM"
    },
    {
      "attribute": "fb-sdk-version",
      "value": "1.14.2",
      "source": "MEDIUM"
    }
  ]
}

Se você quiser recuperar a URL do perfil do usuário, então pode recuperá-la por internal.channelDetails.contactProfile.profileUrl