> For the complete documentation index, see [llms.txt](https://help.hyperflow.global/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.hyperflow.global/docs/builder-hyperflow/gerenciamento-de-aplicativos/fluxos/integracao/zendesk.md).

# Zendesk

O módulo **Zendesk** permite criar e atualizar tickets no Zendesk, ou transferir o atendimento para um agente humano atender diretamente pelo Zendesk, sem sair do fluxo.

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FKMUCh8bLqbecRqiaoS40%2F01-visao-geral-canvas.png?alt=media&amp;token=3dc45f2f-832a-4ff0-ab5b-1b9397b0ba16" alt=""><figcaption><p>Imagem 1 - Visão geral do módulo Zendesk na área de trabalho do fluxo no Hyperflow Integrações.</p></figcaption></figure>

***

## 🧭 Como acessar

{% stepper %}
{% step %}
No menu lateral, clique em **Gerenciamento de aplicativos**.
{% endstep %}

{% step %}
Em seguida, clique em **Fluxos**.
{% endstep %}

{% step %}
Abra ou crie um fluxo e acesse a área de trabalho do fluxo.
{% endstep %}

{% step %}
No painel de módulos, localize a categoria **Integração** (identificada pela cor azul).
{% endstep %}

{% step %}
Arraste o módulo **Zendesk** para a área de trabalho do fluxo.
{% endstep %}
{% endstepper %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FgduSt7fUjAa1MXqBXVpL%2F02-lista-modulo-zendesk.png?alt=media&amp;token=d84111ca-f01c-4517-89e1-3304fc19f109" alt=""><figcaption><p>Imagem 2 - Painel de módulos com a categoria Integração expandida e o módulo Zendesk visível.</p></figcaption></figure>

{% hint style="warning" %}
**Antes de usar este módulo:** é necessário ter uma integração do tipo **Zendesk** já cadastrada, com e-mail, token de API e subdomínio da sua conta Zendesk.
{% endhint %}

***

## 🔍 Conhecendo o módulo

Ao clicar duas vezes no módulo na área de trabalho do fluxo, um painel de configuração é aberto na lateral da tela.

***

### 🔌 Integração

Selecione a integração Zendesk já cadastrada.

***

### 🧩 Ação

Escolha o que o módulo vai fazer:

* **Criar ticket** — abre um novo ticket no Zendesk.
* **Atualizar ticket** — edita um ticket já existente, informado pelo ID.
* **Transferir para um agente (Support)** — envia o atendimento para um agente humano continuar diretamente pelo Zendesk, como uma conversa ao vivo.

{% hint style="warning" %}
A opção **Transferir para um agente** não cria um ticket comum — ela inicia uma conversa ao vivo com um agente do Zendesk. Além do e-mail, token e subdomínio, essa opção exige que a integração Zendesk tenha também os dados de **Sunshine Conversations** configurados.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FKaWKTThJXeyVcVK7DvAU%2F03-acao-opcoes.png?alt=media&amp;token=8041864c-4c4e-4eb4-8a2b-f89c19ef07ca" alt=""><figcaption><p>Imagem 3 - Campo Ação com as três opções disponíveis.</p></figcaption></figure>

***

### 📋 Campos — Criar ticket / Atualizar ticket

| Campo            | O que preencher                             |
| ---------------- | ------------------------------------------- |
| **Assunto**      | Título do ticket                            |
| **Descrição**    | Detalhes do problema ou solicitação         |
| **ID do ticket** | Necessário apenas para **Atualizar ticket** |

Você também pode configurar campos adicionais do Zendesk (como grupo, responsável, tipo, prioridade e campos personalizados) na aba de seleção de campos do painel.

{% hint style="info" %}
Ao **atualizar** um ticket, os campos Assunto e Descrição não aparecem diretamente na tela principal — para reconfigurá-los, use a aba de seleção de campos do painel de configuração.
{% endhint %}

***

### 📋 Campos — Transferir para um agente

| Campo                             | O que preencher                                                                |
| --------------------------------- | ------------------------------------------------------------------------------ |
| **Assunto**                       | Título usado para identificar a conversa                                       |
| **Descrição**                     | Mensagem inicial enviada ao agente                                             |
| **Mesclar com ticket (opcional)** | Informe o ID de um ticket existente, se desejar relacionar essa conversa a ele |

***

### 🔀 Saídas do módulo

O módulo tem duas saídas:

* **Sucesso** — a operação foi concluída.
* **Erro** — não foi possível concluir a operação (por exemplo, credenciais inválidas, ticket não encontrado ou falha de conexão).

{% hint style="info" %}
Na ação **Transferir para um agente**, a saída **Sucesso** só é ativada quando o atendimento é finalizado pelo agente no Zendesk — não no momento em que a conversa é transferida.
{% endhint %}

<figure><img src="https://3829578295-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FRWteFkm020DS5IbXoSgj%2Fuploads%2FNRqCa7YngNcrOU2y6lzr%2F05-saidas-disponiveis.png?alt=media&amp;token=dd8c2371-611a-46d3-bbcc-a154f95e9502" alt=""><figcaption><p>Imagem 4 - Módulo na área de trabalho do fluxo mostrando as saídas Sucesso e Erro.</p></figcaption></figure>

***

## 💡 Caso de uso

**Cenário:** uma empresa quer abrir automaticamente um ticket no Zendesk sempre que um cliente relatar um problema pelo chatbot.

**Configuração:**

1. Adicione o módulo **Zendesk** ao fluxo, no ponto em que o problema já foi identificado.
2. Selecione a integração Zendesk já cadastrada.
3. Na **Ação**, selecione **Criar ticket**.
4. Preencha o **Assunto** e a **Descrição** com as informações coletadas na conversa.
5. Conecte a saída **Sucesso** para confirmar ao cliente que o chamado foi aberto.

**Resultado:** um ticket é criado automaticamente no Zendesk com os dados do problema relatado pelo cliente.

***

## 📌 Dicas úteis

* Use **Criar ticket** e **Atualizar ticket** para registrar solicitações; use **Transferir para um agente** quando o cliente precisar de atendimento humano em tempo real.
* Sempre conecte a saída **Erro** a algum tratamento, já que operações no Zendesk podem falhar por diversos motivos.
* Ao usar **Transferir para um agente**, lembre-se de que a saída **Sucesso** só é ativada quando o atendimento for encerrado, não no momento da transferência.

***

## 📝 Resumo

* O módulo **Zendesk** cria e atualiza tickets, ou transfere o atendimento para um agente via Zendesk.
* A ação **Transferir para um agente** inicia uma conversa ao vivo, diferente de um ticket comum, e exige configuração adicional na integração.
* O módulo tem uma saída de **Sucesso** e uma de **Erro**.