> For the complete documentation index, see [llms.txt](https://docs.altu.d1.cx/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.altu.d1.cx/connect/live-chat/transbordo-zendesk-chat.md).

# Transbordo Zendesk Chat

{% hint style="info" %}
Essa integração está disponível somente para o canal Widget.
{% endhint %}

Para configurar o transbordo pelo **Zendesk Chat**, encontre sua integração em **Canais >** **LiveChat** ou clique no botão inferior direito ➕  para criar uma nova integração. 

Ao abrir o formulário, preencha os seguintes campos:

* **Nome**: nome do LiveChat
* **Provedor**: Zendesk Chat
* **Tempo de espera**: tempo de espera, em segundos, da primeira mensagem do agente (deixar 0 para desativar). Caso após o transbordo o agente não responda dentro desse tempo, o live chat será encerrado.
* **Zendesk Account Key**: chave da conta Zendesk, disponível no Zendesk Dashboard.

### Configuração do livechat no builder

Selecione o nó onde será configurado o transbordo para o Zendesk Chat. Na seção **Ações**, clique no “**?**” no canto inferior direito e selecione a opção **Iniciar Live Chat**.

Preencha o atributo parameters com as seguintes propriedades:

* **integration\_id**: ID da integração com o Zendesk Chat criada em Connect > Live Chats
* **tags (opcional)**: um array de strings, com as tags que serão setadas no início do transbordo.
* **visitorInfo (opcional)**: objeto com os dados que serão definidos nas informações do visitante:
  * **display\_name (opcional)**: nome do visitante (máximo 255 caracteres)
  * **email (opcional)**: email do visitante
  * **phone (opcional)**: número de telefone do visitante (valor numérico, máximo 25 caracteres) 
* **historyExtraInfo (opcional)**: informações adicionais que serão enviadas junto ao histórico da conversa como primeira mensagem do usuário para o agente. Este campo pode ser um objeto de chaves e valores ou um array.

{% hint style="info" %}
Essa integração envia somente texto, não há troca de arquivos no momento.
{% endhint %}

### **Exemplo**

```
[
    {
        "name": "start_live_chat",
        "parameters": {
            "integration_id": 1,
            "tags": [
                "altu",
                "livechat"
            ],
            "visitorInfo": {
                "email": "joao.silva@gmail.com",
                "phone": "35988001122",
                "display_name": "João Silva"
            },
            "historyExtraInfo": {
                "Nome": "João Silva",
                "Visitas": 2,
                "Produtos": [
                    1,
                    2,
                    5
                ],
                "Primeira vez": false
            }
        },
        "result_variable": "response"
    }
]
```

Caso o usuário esteja em uma livechat e feche ou recarregue a janela do navegador, ao retornar para o widget poderá acontecer algumas das opções citadas abaixo.:

1. Reabertura do livechat caso o widget tenha continuidade de conversa habilitado e o usuário retorne antes do tempo de inatividade ou 24 horas.
2. O livechat será fechado e continuará o fluxo do bot caso o widget tenha continuidade de conversa habilitado e o usuário retorne depois do tempo de inatividade ou 24 horas.
3. Início de uma nova conversa caso o widget não tenha continuidade de conversa habilitado


---

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

```
GET https://docs.altu.d1.cx/connect/live-chat/transbordo-zendesk-chat.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.