# Conectando o Zendesk

O Zendesk é uma plataforma de suporte ao cliente. Com a integração, você pode abrir tickets e adicionar comentários automaticamente a partir dos seus fluxos de atendimento no WhatsApp.

**Como obter o API Token do Zendesk**

1. Faça login no Zendesk e acesse o **Admin no menu lateral esquerdo**
2. No menu lateral, vá em **Aplicativos e integrações → APIs → Tokens da API**
3. Clique em **Adicionar API token**
4. Dê um nome para o token (ex: "Zaptria") e clique em **Create**
5. Copie o token gerado (ele aparece uma única vez — guarde bem!)

**Configurando a integração na Zaptria**

1. Na Zaptria, acesse **Integrações** no menu lateral
2. Encontre o card do Zendesk e clique em **Conectar**
3. Preencha o **Subdomínio** — é a parte inicial da URL da sua conta (ex: se você acessa `suaempresa.zendesk.com`, o subdomínio é `suaempresa`)
4. Informe o **e-mail do administrador** usado na sua conta Zendesk
5. Cole o **API Token** no campo indicado
6. Clique em **Salvar**

O status vai mudar para Conectado ✅

**O que você pode fazer com a integração**

Dentro dos seus fluxos, você pode usar dois blocos de integração com o Zendesk:

* **Criar ticket de suporte** — abre um ticket no Zendesk com os dados do lead (nome, e-mail, telefone e origem). Você pode personalizar o assunto, a descrição e a prioridade (`low`, `normal`, `high` ou `urgent`).
* **Adicionar comentário ao ticket** — adiciona uma mensagem em um ticket já existente. O comentário pode ser público (visível para o cliente) ou interno (apenas para a sua equipe).

**Importante**

Para que o e-mail e o telefone do lead sejam incluídos no ticket, seu fluxo precisa ter blocos que capturem essas informações antes de acionar a integração com o Zendesk. Sem esses dados, o ticket é criado mesmo assim, mas ficará sem as informações de contato do cliente.


---

# 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://zaptria.gitbook.io/ajuda/integracoes/conectando-o-zendesk.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.