> For the complete documentation index, see [llms.txt](https://zaptria.gitbook.io/ajuda/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://zaptria.gitbook.io/ajuda/integracoes/conectando-o-zendesk.md).

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