# Sinch Contact Pro

Agora é possível conectar seu bot ao Sinch Contact Pro e garantir uma experiência fluida de encaminhamento do bot para um agente humano.

Continue lendo para um guia passo a passo sobre como configurar isso!

## 1 – Configuração no Sinch Contact Pro

* Faça login no seu domínio Sinch Contact Pro
* Configure um novo **agente** que atuará como o bot
* Crie um novo **fila** especificamente para chatbots 
* Abra o painel de configuração

![](/files/0844e82ff4129b3664ceb029e178598e16df2dc9)

* Clique em “Create new configuration” e vá para “Common settings” 
* Encontre a URL do Visitor ECF Server

![](/files/a5182ac63a3451ddba3a0cdd3caf6acc980a8362)

* Copie isto **URL**, você precisará depois para a configuração no Chatlayer
* Por fim, selecione sua fila de Chatbot recém-criada no Painel de Configuração do Sinch Contact e clique em “Save” 

![](/files/b7d1f602f5f360a8280cb9e13f1fc645f2046467)

## 2 – Configuração no Chatlayer

### Configurando o canal

* Vá para 'Channels' no lado esquerdo
* Clique no sinal '+' na linha 'Sinch Contact' para ver o pop-up abaixo:

![](/files/cf72b5d7d510785636daeea8ec43bc4181af2a4a)

Olhando para a URL que você copiou antes, você pode identificar *Região* e *Nome do Tenant:*

https\://prod-***região***.*domínio***.**com/***nomedotenant***/visitor/ecfs

* Agora preencha o seguinte:
  * Sua região  - https\://prod-***região***.*domínio***.**com/*nomedotenant*/visitor/ecfs
  * Nome do tenant -  https\://prod-*região*.*domínio***.**com/***nomedotenant***/visitor/ecfs

Os outros campos podem ser encontrados no Sinch Contact Pro:

* Nome de usuário e senha: preencha esses campos com o agente virtual recém-criado 

Agora clique em 'Continue' para salvar sua configuração 

> A Configuração na Nuvem possui as seguintes regiões:
>
> * **na**: 'login-na-w2.cc.sinch.com'
> * **eu**: 'login-eu-c1.cc.sinch.com'
> * **au**: 'login-au-s2.cc.sinch.com'
> * **af**: 'login-af-s1.cc.sinch.com'

{% hint style="info" %}
Você possui um ambiente On Premise do Sinch Contact Pro? Ative 'Is On Premise' e preencha o seguinte: Para a URL

[*https://mywebsite.com/integrations/sinch-contact/tenantname*](https://mywebsite.com/integrations/sinch-contact/<tenantname>)

&#x20;O **host** é 'mywebsite.com', e o **nome do tenant** será 'integrations/sinch-contact/tenantname'
{% endhint %}

### Configurando a ação de encaminhamento

* Adicione um bloco de Ação ao seu fluxo que contenha um plugin “Send to offload provider” (por exemplo, após “Not understood”)
* Selecione Sinch Contact nesse plugin e a fila para a qual você deseja encaminhar

![](/files/0585ad51832e9b93621e67cefbcdc8c678389267)

### Compartilhando variáveis com o Sinch Contact Pro

O Chatlayer compartilha as seguintes informações com o Sinch Contact Pro:

* **Primeiro Nome**: `sinchContactPro.firstName` OU `internal.user.firstName`
* **Sobrenome**: `sinchContactPro.lastName` OU `internal.user.lastName`
* **Telefone** **Número**: `sinchContactPro.phoneNumber`
* **Email**: `sinchContactPro.email`

É recomendado preencher as variáveis listadas acima, para que o agente no Sinch Contact Pro saiba com quem está falando.

Você pode querer enviar informações adicionais sobre o usuário ao Sinch Contact Pro, além dos campos acima. Para isso, você pode declarar variáveis de sessão adicionais com o seguinte formato: `sinchContactPro.customFields`. Todas estas serão adicionadas como `dados anexados` campos no Sinch Contact Pro.&#x20;

Por exemplo, para adicionar a localização do usuário como um campo personalizado, você ajustaria o fluxo do seu bot para perguntar a localização do usuário e armazenar a resposta como uma variável em `sinchContactPro.customFields.location`

## Passos finais

{% hint style="info" %}
No exemplo abaixo, usaremos o widget web do Sinch Contact Pro como um canal. Você também pode usar canais como WhatsApp, Facebook Messenger ou o widget web do Chatlayer.
{% endhint %}

* Abra a página onde você configurou seu Widget do Sinch Contact Pro
* Preencha seus dados de contato, selecione a fila “Chatlayer Agents” e inicie a conversa

![](/files/dbcea0ae3497e7f051d91f917baf6c74622e5365)

![](/files/e97118851ced83af93b30ed684c093544aaa3be3)

Após ser transferido para um agente, abra a fila correta e assuma a conversa:

![](/files/9d6fd5e3aa7ac5ad318a077771351650cba4845c)

## Reiniciar o bot após o encaminhamento ser concluído

Isso só funciona se você estiver usando canais conectados ao seu bot que sejam diferentes do web do Sinch Contact Pro [widget](#final-steps), funciona apenas em [este ](#setting-up-channel)configuração.

A parte de retorno do fluxo do seu bot após o encaminhamento ser concluído ficará assim:

![](/files/175e4979331df78beca38064df6733fe71669380)

Três coisas precisam ser configuradas para que esse caso de uso funcione:

1. As variáveis que vão identificar a conversa do bot e a conversa encaminhada que ainda estão ativas ou pausadas precisam ser criadas:

Neste exemplo, criamos `internal.isPaused` para identificar quando o bot está pausado e `internal.offload` para identificar quando o encaminhamento está ativo:

![](/files/0600f5b66f22e867b4fbd301be2d81a9d062f5fb)

2\. O bot precisa identificar que o encaminhamento não está mais ativo:&#x20;

Para isso, construímos um bloco de Condição com as condições: se a variável `internal.offload` não existir, acione o bloco desejado para obter feedback do usuário; no exemplo abaixo o chamamos de "Feedback flow start", caso contrário vá para um bloco vazio, "do nothing" como nomeamos em nosso exemplo, porque a conversa encaminhada ainda está ativa.

![](/files/9d03cd763a7904a3a20e100c6362e6e16bc9356d)

3\. O bot precisa identificar quando a conversa encaminhada não está mais ativa

Um evento precisa ser criado acessando a aba Events no menu lateral esquerdo, na seção Bot Dialogs. Esse evento será acionado quando a variável de encaminhamento for pausada quando o bloco do passo 2 for visitado.

![](/files/d03df3e82f05498baec2da56477d11a5cb8554d3)

Quando a conversa encaminhada for encerrada pelo agente, como na captura de tela abaixo, o bot poderá identificar que `internal.offload` é inexistente.

![](/files/1aa885d2f54bc27d634ea28c6e45e34f9d38b8d2)

E o bot reiniciará a conversa, seguindo a primeira condição do bloco de Condição.

![](/files/521d134026f63d6010a670f5389b20e1e2a7c3df)

E pronto, seu encaminhamento para o Sinch Contact Pro está tudo configurado!

## Enviando dados anexados da chamada para o Sinch Contact Pro

É possível enviar dados anexados da chamada (CAD) ao transferir uma chamada para o Sinch Contact Pro. Isso ajudará a garantir conformidade com leis de privacidade de dados e permitirá garantia de qualidade e auditoria das chamadas na plataforma Contact Pro.

A partir do ponto do fluxo do bot em que o consentimento para gravação foi identificado, você pode redirecionar o usuário para uma mensagem vazia do bot com as variáveis `RecordingEnabled` e `RecordingConsentGiven` com os valores 'yes' ou 'no' dependendo da vontade do chamador.

<figure><img src="https://docs.chatlayer.ai/~gitbook/image?url=https%3A%2F%2F2786867680-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LLTwFwbOqJj4dDhg8Ju%252Fuploads%252FTsCZ3sG5ik5Kxhntpn4q%252Fimage.png%3Falt%3Dmedia%26token%3Deb79b5f5-75a0-4a62-b9ac-4f17cc247df8&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=ad3a0ccb&#x26;sv=2" alt=""><figcaption></figcaption></figure>

Em uma chamada ativa no painel Communications do Sinch Contact Pro, você pode acessar o widget Conversation Details, no menu lateral direito:

<figure><img src="https://docs.chatlayer.ai/~gitbook/image?url=https%3A%2F%2F2786867680-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LLTwFwbOqJj4dDhg8Ju%252Fuploads%252FTPWJPyvlkbPVLgRlJ1lk%252Fimage.png%3Falt%3Dmedia%26token%3D9a91c30e-6fe4-4ff4-99c2-d994abbdd8a6&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=383e9a46&#x26;sv=2" alt=""><figcaption></figcaption></figure>

Você também pode verificar o widget Chatlayer Transcript para ler as transcrições do bot e ouvir a parte gravada do bot, se houver:

Aqui você pode ver uma captura de tela do widget com um clipe de áudio do chatbot em uma conversa em andamento e na página Wrap up do Sinch Contact Pro:

<figure><img src="https://docs.chatlayer.ai/~gitbook/image?url=https%3A%2F%2F2786867680-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LLTwFwbOqJj4dDhg8Ju%252Fuploads%252FPMCWF04K9dVwM4RaTY1n%252Fimage.png%3Falt%3Dmedia%26token%3D71a8c3a6-e370-4a7a-9587-2c0655164cea&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=a0cda7a7&#x26;sv=2" alt=""><figcaption></figcaption></figure>

Em ambos os casos:

* a gravação da chamada não está habilitada para uma parte ou para toda a conversa do bot
* quando a chamada inteira (conversa bot + agente ao vivo) está sendo gravada

você não poderá ouvir a gravação. O widget aparecerá vazio como mostrado nesta imagem:

<figure><img src="https://docs.chatlayer.ai/~gitbook/image?url=https%3A%2F%2F2786867680-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252F-LLTwFwbOqJj4dDhg8Ju%252Fuploads%252FtauqIPk5gh5jQe72FFBP%252Fimage.png%3Falt%3Dmedia%26token%3D1e195336-87cc-4507-bde2-76ea1aacc51e&#x26;width=768&#x26;dpr=4&#x26;quality=100&#x26;sign=85858494&#x26;sv=2" alt=""><figcaption></figcaption></figure>

### Tipo de formato de mensagem de voz para validação de entrada <a href="#voice-message-format-type-for-input-validation" id="voice-message-format-type-for-input-validation"></a>

Você pode salvar qualquer coisa que o usuário esteja dizendo como uma variável usando o tipo de formato de mensagem de voz em uma validação de entrada. Leia mais [aqui](https://docs.chatlayer.ai/buildabot/flow-logic/dialog-state/user-input-bot-dialog#voice-message).


---

# Agent Instructions: 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:

```
GET https://docs.chatlayer.ai/chatlayer-documentation-pt-br/integrateandcode/human-offloading-live-chat/sinch-contact.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.