Sparkcentral by Hootsuite

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

Recuperando credenciais da API do Sparkcentral

O primeiro passo para integrar o Sparkcentral com o Chatlayer.ai é recuperar as Credenciais da API no Sparkcentral.

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

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

  • Para recuperar suas credenciais da API do Sparkcentral, clique no botão Gerar Chaves de 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 à mão e volte para o Chatlayer.ai para iniciar a configuração do Sparkcentral.

  • Vá para 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: EUA ou UE

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

  • Após salvar, a URL do webhook do seu canal recém-criado ficará visível. Copie esta URL do Webhook e volte ao 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 popup permitindo que você configure alguns detalhes do Agente Virtual Personalizado.

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

  • Quando a configuração estiver completa, copie o Segredo Compartilhado em Configuração de Agente Virtual Personalizado e salve o novo Agente Virtual Personalizado.

  • Volte ao 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 nos quais você quer que seu bot esteja ativo.

Configurar encaminhamento (offloading)

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.

Uma vez que essa 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 de sessões de usuário conectadas ao canal Sparkcentral nos seguintes campos:

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 para o internal.channelDetails pode ser o seguinte:

{
 channelId: "12345",
  medium: "twit".
  contactProfile: {
    id: "0-01f116a7f9c-000-b5d575cb,
    mediumContactProfileId: "cd067e88519ab323b15c9944"
    primaryIdentifier: "[email protected]"
    secondaryIdentifier: "[email protected]"
    pictureUrl: "https://avatar_url.com";
    vip: false;
  };
  "contactAttributes": [
    {
      "attribute": "fb-page-title",
      "value": "In-Web Messaging Demo",
      "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 você pode obtê-la por internal.channelDetails.contactProfile.profileUrl

Last updated

Was this helpful?