# Sparkcentral da Hootsuite

[Sparkcentral by Hootsuite](https://sparkcentral.com/) 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. 

![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-M8Vn8P1V9XLeo1Mxbj0%2F-M8Vnmk8tjRNZ0qXvqDT%2Fimage.png?alt=media\&token=cbf0d187-7dfa-43ee-a177-cb41793b06c0)

* Para recuperar suas credenciais da API do Sparkcentral, clique no botão Gerar Chaves de API no canto superior direito da tela. 

![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FaHK64jdTWk5vKH5LMTd1%2Fimage.png?alt=media\&token=322cd9ae-b993-4db4-bed6-a724ee9860b4)

* 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.

![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2Fcdj5LNoiHeDpg8rtOSnL%2Fimage.png?alt=media\&token=5dfb2e7d-2476-4c24-bca8-7fc85e3f7f7f)

* 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. 

![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2FDZ7ydexFmVvfqdbOPkoP%2Fimage.png?alt=media\&token=451ee9a0-d919-4024-afa6-3037efb52f40)

![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F5CnTGPJ3dNPOKmm5knrB%2Fimage.png?alt=media\&token=c40d26c7-da91-4a84-b96c-81ac4c405c80)

* 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.

![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LLTwFwbOqJj4dDhg8Ju%2Fuploads%2F7f7LU5nFIv3a7tfpzR5q%2Fimage.png?alt=media\&token=1b75bf5b-3215-437e-9017-d1b900ff95fe)

## 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.

![](https://181262846-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LLTwFwbOqJj4dDhg8Ju%2F-M8VrWZMYkPk-TbP_h3Z%2F-M8Vuw7pjRzR_fhDXimY%2Fimage.png?alt=media\&token=7448f73f-38e9-43ab-aa49-b3ad45e135b9)

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:  

{% hint style="info" %}
internal.channelDetails
{% endhint %}

```
// 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: "user_email@test.com"
    secondaryIdentifier: "user_email@test.com"
    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`