> For the complete documentation index, see [llms.txt](https://docs.chatlayer.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/human-offloading-live-chat/sparkcentral-beta.md).

# Sparkcentral by Hootsuite

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

![](/files/062218283bcc981c7f5b38c4ac19d9d99163a135)

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

![](/files/cbb79c7cb68520b93b96e8a7f5e2a17bf211c395)

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

![](/files/d00e382af802aa2187c7d8051f9464d2f90ee3db)

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

![](/files/c0a9f33a59085687227907f9b3a645ca68d7eca2)

![](/files/da3952310114439808bced277aea9b4cfebc85ce)

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

![](/files/7aa74a1ef3942ff05cdbd4ea1828621d75492ad8)

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

![](/files/103dc3349c62c6ba02dd771714df21912b956a40)

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:

{% 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 de 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": "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`


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/human-offloading-live-chat/sparkcentral-beta.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.